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 x64 | ingot-server-<version>-linux-x64.tar.gz |
| Linux arm64 | ingot-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>.
התחלה מהירה
- התקינו את ה-CLI ingot (Node.js 22):
npm install -g @ingotide/cli. - פרסו את החבילה, למשל לתוך
/opt. - בלוח הבקרה, פתחו את מפרסם › טוקנים וצרו טוקן עם הגשת פרויקטי Web (ingot serve) (הרשאה
web:serve). - הריצו
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"
- פתחו את הפרויקט מ-פרויקטי 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_PUBLISH | 1 מפרסם את התיקייה כפרויקט 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 נפתחים כטקסט רגיל | תוספי השפות חסרים בתיקיית החבילה; הורידו אותה מחדש. |