בטא בקרוב. הפיצ׳ר עדיין בפיתוח, ולכן שמות ופרטים עשויים להשתנות לפני השחרור.

Ingot ללא ממשק (ingot serve)

Ingot ללא ממשק (Headless) מריץ את ה-IDE המלא של Ingot על שרת, VM או מחשב ביתי משלכם, בלי שולחן עבודה ובלי חלון. מפעילים אותו עם ingot serve ופותחים את הפרויקט כ-Ingot Web מכל דפדפן בכתובת ingotide.com/w/<id>: אותם קבצים, עורכים, טרמינלים, סוכנים וצ׳אט כמו באפליקציית הדסקטופ.

  • אותו חשבון. מתחברים ב-ingotide.com עם חשבון Ingot, כמו בדסקטופ.
  • אותה תוכנית. בקשה מ-Ingot Web נספרת בדיוק כמו בקשה מאפליקציית הדסקטופ: אותו שימוש ואותן מגבלות.
  • מכסת פרויקטי Web. כל תיקייה שאתם מגישים היא פרויקט Web ומשתמשת באחד מפרויקטי ה-Web של התוכנית (Bronze ‏3, Silver ‏5, Gold ‏7). ראו מגבלות ומחירים.

שום דבר לא רץ בשבילכם בענן של Ingot. ה-IDE רץ על המכונה שלכם ומחזיק חיבור יוצא ומוצפן אחד ל-relay של Ingot, שמעביר אליו את הדפדפן. לא צריך לפתוח שום פורט נכנס.

הורדה

הורידו את החבילה לשרת שלכם מ-הורדה › Ingot ללא ממשק. החבילות מתפרסמות עם כל גרסה של Ingot, מאותו מקום כמו מתקיני הדסקטופ. פלטפורמה שעדיין אין לה חבילה מפורסמת מציגה שם יגיע עם הגרסה הראשונה, בלי קישור.

שרתחבילה
Linux x64ingot-server-<version>-linux-x64.tar.gz
Linux arm64ingot-server-<version>-linux-arm64.tar.gz
macOS (Apple Silicon)ingot-server-<version>-mac-arm64.tar.gz
macOS (Intel)ingot-server-<version>-mac-x64.tar.gz
Windowsעדיין אין חבילה. השתמשו בחבילת Linux x64 בתוך WSL 2.

כל חבילה כוללת את ה-backend של ה-IDE (עם המודולים הנייטיב למערכת ולארכיטקטורה), את ה-frontend לווב, את תוספי השפות ואת bin/ingot-server. היא צריכה Node.js 22 על השרת.

ב-macOS, אם ההורדה בהסגר, הריצו פעם אחת xattr -dr com.apple.quarantine <folder>.

התחלה מהירה

  1. התקינו את ה-CLI ‏ingot ‏(Node.js 22): npm install -g @ingotide/cli.
  2. פרסו את החבילה, למשל לתוך /opt.
  3. בלוח הבקרה, פתחו את מפרסם › טוקנים וצרו טוקן עם הגשת פרויקטי Web ‏(ingot serve) (הרשאה web:serve).
  4. הריצו ingot serve עם תיקיית הפרויקט:
tar -xzf ingot-server-<version>-linux-x64.tar.gz -C /opt
export INGOT_SERVE_APP=/opt/ingot-server-<version>-linux-x64
export INGOT_WEB_TOKEN=ingot_pub_...
ingot serve ~/shop --name "Shop"
  1. פתחו את הפרויקט מ-פרויקטי Web בלוח הבקרה, או בקישור ש-ingot serve מדפיס. התחברו עם אותו חשבון וה-IDE המלא נפתח.

הפרויקט נשאר מחובר עד שעוצרים את ingot serve ‏(Ctrl+C). ‏Ingot מאזין רק ב-127.0.0.1 (פורט 3100, או --port); ה-relay מגיע אליו מהמכונה עצמה.

דגלברירת מחדל
[folder]התיקייה הנוכחית
--port <port>3100 (מקומי בלבד)
--name <name>name בקובץ .ingot/web.json, ואחריו שם התיקייה
--app <dir>INGOT_SERVE_APP
--token <token>INGOT_WEB_TOKEN, אחריו INGOT_PUBLISH_TOKEN, אחריו ingot login

הגדרות השיתוף של פרויקט (תפקיד ברירת מחדל, פורט תצוגה מקדימה, כתובות מורשות, תפוגת קישור) מגיעות מהקובץ .ingot/web.json שלו, כמו בדסקטופ.

פרסום ללא השגחה

ingot serve מפעיל את bin/ingot-server עם כמה משתני סביבה. אפשר להגדיר אותם בעצמכם ולהפעיל את bin/ingot-server ישירות, למשל מ-systemd, בלי ה-CLI:

משתנהמשמעות
INGOT_WEB_PUBLISH1 מפרסם את התיקייה כפרויקט Web ברגע ש-Ingot עולה
INGOT_WEB_PROJECTהתיקייה לפרסום
INGOT_WEB_TOKENטוקן מפרסם עם ההרשאה web:serve
INGOT_WEB_NAMEשם פרויקט, לא חובה (ברירת מחדל: .ingot/web.json, ואחריו שם התיקייה)
INGOT_PORTפורט מקומי (ברירת מחדל 3100, תמיד ב-127.0.0.1)
INGOT_NODEהקובץ הבינארי של Node.js 22, אם node ב-PATH הוא גרסה אחרת

פרסום חוזר של אותה תיקייה מאותה מכונה משתמש באותו פרויקט Web; הוא לא תופס מקום חדש.

הרצה קבועה עם systemd

# /etc/systemd/system/ingot-shop.service
[Unit]
Description=Headless Ingot (shop)
After=network-online.target
Wants=network-online.target

[Service]
User=dev
WorkingDirectory=/home/dev/shop
EnvironmentFile=/etc/ingot/shop.env
ExecStart=/opt/ingot-server/bin/ingot-server /home/dev/shop
Restart=on-failure

[Install]
WantedBy=multi-user.target
# /etc/ingot/shop.env  (sudo chmod 600: only root reads it; systemd passes it to the service)
INGOT_WEB_PUBLISH=1
INGOT_WEB_PROJECT=/home/dev/shop
INGOT_WEB_NAME=Shop
INGOT_WEB_TOKEN=ingot_pub_...
INGOT_PORT=3100

אחר כך sudo systemctl enable --now ingot-shop, ו-journalctl -u ingot-shop -f ללוגים. כדי להשתמש ב-CLI במקום, הגדירו INGOT_SERVE_APP ו-INGOT_WEB_TOKEN בקובץ הסביבה והשתמשו ב-ExecStart=/usr/bin/ingot serve /home/dev/shop.

Docker

אימג׳ Docker: מתוכנן. עדיין אין אימג׳ רשמי; בינתיים השתמשו בחבילה עם systemd.

אבטחה

  • בעלים בלבד. רק החשבון שפרסם פרויקט פותח אותו כ-IDE מלא. כל מי שיש לו קישור שיתוף מקבל לכל היותר את הצופה לקריאה בלבד: בלי טרמינל, סוכנים או הגדרות, ובלי קבצים שנראים כמו סודות.
  • טוקנים. ingot serve מזדהה עם טוקן מפרסם, כמו בפרסום הרחבה. תנו לו רק את ההרשאה web:serve, הרחיקו אותו מהיסטוריית ה-shell ומקבצים שכולם יכולים לקרוא (השתמשו ב-EnvironmentFile= עם הרשאות 600), ובטלו אותו ב-מפרסם › טוקנים אם הוא דלף. טוקנים פגים.
  • ה-relay לא שומר קוד. הקוד עובר דרך ה-relay של Ingot ולעולם לא נשמר בשרת של Ingot. השרת שומר רק את שם הפרויקט, את הגדרות השיתוף ומתי היה פעיל לאחרונה.
  • TLS, לא מקצה לקצה. התעבורה מוצפנת במעבר עם TLS בין השרת שלכם ל-relay, ובין ה-relay לדפדפן. היא לא מוצפנת מקצה לקצה: ה-relay מפענח אותה כדי להעביר אותה, ולא שומר אותה.
  • מקומי בלבד. ‏Ingot מאזין ב-127.0.0.1. אל תחשפו את הפורט שלו; החיבור ל-relay הוא יוצא.
  • הריצו כמשתמש רגיל. ה-IDE המלא (כולל טרמינל וסוכנים) רץ כמשתמש של השירות, אז השתמשו בחשבון בלי הרשאות מיוחדות שמגיע רק למה שהפרויקט צריך.
  • עצירה בכל רגע. עצרו את השירות, השתמשו ב-עצירה או מחיקה בלוח הבקרה, או בטלו את הטוקן. ראו אבטחה ב-Ingot Web לגישה קצרת מועד ולמגבלות קצב.

פתרון בעיות

בעיהמה לעשות
"The Ingot server build was not found"הפנו את --app או INGOT_SERVE_APP לתיקייה שפרסתם (יש בה lib/backend/main.js).
"Ingot server needs Node.js 22"התקינו Node.js 22, או הגדירו את INGOT_NODE לקובץ הבינארי שלו.
לטוקן אין הרשאת webצרו טוקן עם web:serve ב-מפרסם › טוקנים.
"Web projects are all in use"הוסיפו פרויקט נוסף או מחקו אחד ב-פרויקטי Web.
הקישור מציג מנותקבדקו שהשירות רץ (systemctl status ingot-shop) ושהמכונה מגיעה לאינטרנט.
קבצי .ts נפתחים כטקסט רגילתוספי השפות חסרים בתיקיית החבילה; הורידו אותה מחדש.