Windows קו הפקודה

הגדרת AirCode Ø Windows מתקינה פקודה aircode עבור PowerShell ו- Command Prompt. הוא משתמש ב- Node.js Runtime ו- ConPTY שכבר מוטבעים ביישום שולחן העבודה; WSL ו- Node.js אינם נדרשים.

פתח את טרמינל חדש לאחר התקנת או עדכון AirCode Ø כך שהוא מקבל את המשתמש מעודכן PATH, ולאחר מכן אישר את הפקודה:

aircode version
aircode serve --help

התקנה פותרת את הפקודה ביחס לתיקיה ההתקנה שלה, ולכן בחירת תיקיה מותאמת אישית בהתקנה נתמכת.

פקודה שולחן עבודה או פקודה שרת?

אם אתה רוצה …	שימוש
חיבור חלון אלקטרוני לשרת מקומי או מרחוק	פתח את אפליקציית שולחן העבודה AirCode Ø
הפעל את השרת המקומי המוטבע ולהשתמש בו מ- Electron	פתח את אפליקציית שולחן העבודה ובחר פעל במכונה זו
הפעל שרת ללא חלון אלקטרוני	פתח את המטרמינל והפעיל את `aircode serve`

ההפעלה של שולחן העבודה אינה נקודת כניסה --serve נתמכת: היא תמיד פותחת את Electron. הפקודה aircode משתמשת בזמן ההפעלה והמשקל של השרת המותקנים עם אפליקציית שולחן העבודה, אך מתחילה תהליך נפרד. ראה מצבי עבודה של שולחן העבודה עבור סיכום מחזור החיים המלא.

התחל שרת

serve הוא הפקודה המוגדרת כברירת מחדל, ולכן טפסים אלה שווים:

aircode serve --projects-root "D:\Projects"
aircode --projects-root "D:\Projects"

השרת פועל בחזית וכותב יומנים לטרמינל זה. הקש על Ctrl+C כדי לעצור אותו בצורה נקיה. לכל פרוייקט שורש מקבל את המצב הבודד של זמני ההפעלה שלו ואת מקום השם של הפגישה. כאשר הפורט המועדף כבר משמש על ידי שורש אחר, AirCode Ø בוחר את הפורט הבא הזמין באופן אוטומטי.

אפשרויות שירות

אפשרות	כברירת מחדל	מטרה והגדרת שווה ערך
`--projects-root <dir>`	מדריך הנוכחי	שורש אשר תת-התבניות AirCode Ø מציג כפרויקטים. המנהל חייב כבר להיות קיים. תגית: `AIRCODE_PROJECTS_ROOT`; JSON: `projectsRoot`
`--host <address>`	Tailscale IP אחרת `127.0.0.1`	ממשק הרשת שבו שרת HTTP מקשיב. תגית: `AIRCODE_HOST`; JSON: `host`
`--port <number>`	`7860`	HTTP פורט 1 עד 65535. פורט עסוק מפורש נכשל במקום לשנות בשקט. תגית: `AIRCODE_PORT`; JSON: `port`
`--public-url <url>`	אין	ציבורי HTTP(S) בסיס URL המשמש בקישורים והודעות. תגית: `AIRCODE_PUBLIC_URL`; JSON: `publicUrl`
`--config <file>`	קובץ הגדרות משתמש	החלפת קובץ הגדרת JSON . תגית: `AIRCODE_CONFIG`
`--state-dir <dir>`	מנהל המצב של המשתמש	מחליף את תיקיית המצב של זמנית. תגית: `AIRCODE_STATE_DIR`
`--password <value>`	שנוצר או מוגדר	גישה לסיסמה עבור תהליך זה. נוח אך גלוי בהיסטוריה של הקליפה ואולי בדיקה בתהליך. תגית: `AIRCODE_AUTH_PASSWORD`; JSON: `authPassword`
`--password-file <file>`	אין	קריאת הסיסמה של גישה קובץ פרטי
`--no-password`	מחוץ	ביטול אימות מפורש; שימוש רק על ממשק מאמין בכוונה
`-h`, `--help`	—	הצג עזרה בפקודה מבלי להתחיל את השרת

קובץ ההגדרה הסטנדרטי של Windows הוא %USERPROFILE%\.config\aircode\config.json; מצב ההגדרה המוצג כברירת מחדל לתיקיות ספציפיות שורש תחת %USERPROFILE%\.local\state\aircode\instances.

יש לציין מסלולים המכילים מרחקים. --option value ו- --option=value מקבלים. אפשרויות שורת הפקודה מקבלות עדיפות על משתנים סביבתיים, אשר מקבלים עדיפות על config.json, ולאחר מכן הגדרות כברירת מחדל.

בהפעלה הראשונה, AirCode Ø מייצר סיסמה, מאחסן אותה בקובץ התצורה שנבחר, ומדפיס אותה פעם אחת. --password זמין כאשר נדרשת הפצה מלאה של שורת הפקודה, אך ניתן לחשוף את הערך שלה באמצעות בדיקה של תהליך וסטודיו של צל. עדיף --password-file, קובץ תצורה מוגן, או AIRCODE_AUTH_PASSWORDהמוצע באופן מאובטח. ביטול auth חייב להיות מפורש עם --no-password.

דוגמאות

שורשים מרובים בו זמנית

פתחו טרמינל אחד בשורש הראשון:

cd "$HOME\Desktop"
aircode

לאחר מכן פתחו טרמינל אחר בשורש אחר:

cd "$HOME\Documents"
aircode

אם Tailscale הקדיש את 100.84.12.30 למחשב, שני הבאנרים יכולים לדווח על http://100.84.12.30:7860 ו- http://100.84.12.30:7861. הדוגמאות אינן משתפות את מצב ההפעלה או את הפגישות. הפעלת aircode שוב ממקור שכבר פעיל מדווחת על ה- URL הקיימת שלו במקום להתחיל כפול.

מכונה מקומית בלבד

aircode serve `
  --projects-root "D:\Projects" `
  --host 127.0.0.1 `
  --port 7860

פתח את http://127.0.0.1:7860.

Tailscale או פרטית VPN

הקשר את כתובת ה- VPN המדויקת שהוקצה למכונה Windows :

aircode serve `
  --projects-root "D:\Projects" `
  --host 100.84.12.30 `
  --port 7860

מכשירים אחרים ברשת פרטית זהה יכולים לפתוח את http://100.84.12.30:7860. עדיף לכתובת מדויקת VPN לעומת 0.0.0.0.

רשת מקומית

aircode serve `
  --projects-root "D:\Projects" `
  --host 192.168.1.25 `
  --port 7860

Windows Firewall עשוי לבקש אם לאפשר את החיבור. לאפשר רק את הפרופילים הרשת שאתה מתכוון להשתמש.

פרוקסי הפוך או מנהרה URL

aircode serve `
  --projects-root "D:\Projects" `
  --host 127.0.0.1 `
  --port 7860 `
  --public-url "https://aircode.example.com"

--public-url רק אומר AirCode Ø איזה כתובת להכניס קישורים שנוצרו. זה לא לפתוח יציאת חומת האש, להפעיל פרוקסי הפוך, או ליצור מנהרה. שימוש ב- גישה מרחוק עבור המנהרה היציאה המובנית, Tailscale, או הדרכה רשת פרטית.

הגדרת ומצב נפרדים

aircode serve `
  --projects-root "D:\Projects" `
  --config "D:\AirCodeData\config.json" `
  --state-dir "D:\AirCodeData\state"

אם טרמינל אחר צריך להפעיל פקודה מחזור חיים נגד הדוגמה הזו, הגדר תחילה את אותה תיקיה של המצב:

$env:AIRCODE_STATE_DIR = "D:\AirCodeData\state"
aircode status
aircode stop

אפליקציית שולחן העבודה

השרת הקדמי CLI והשרת המקומי המנוהל על ידי חלון שולחן העבודה הם תהליכים נפרדים. aircode status ו- aircode stop מכוונים רק לשרת הקדמי CLI ; הם לא מדווחים או שולטים על השרת המנוהל על ידי שולחן העבודה. לפני שתשתמש שוב באותו מארח ובתוך אותו פורט, הוציא את AirCode Ø מהאייקון של אזור ההודעות שלו, ולא רק על ידי סגירת החלון. לחלופין, תן לשרת CLI פורט נוסף.

החל מטרמינל מראה את היישום האינטרנט AirCode Ø ואת API המאושר שלה. זה לא הופך את תיקיית הפרויקטים לשיתוף קובץ ציבורי: גישה לקובץ נשארת מוקדמת לפרויקטים תחת projectsRoot ומוחזקת על ידי השרת.

הגדרות נוספות

מסלולי סוכנים מבוצעים, גבולות הפגישה, שליטה בדפדפן, ידע, תזמורת, הודעות ואופטימיזציה של טוקן נשארים זמינים באמצעות משתנים סביבתיים ו- config.json. ראה Configuration עבור העליונות המלאה של התצורה וההגדרות הנפוצות.