התקנה
יישום אינטרנט עבור iPhone, iPad ו- Android
היישום האינטרנט AirCode Ø הוא הלקוח הקבוע ללא חנות. הוא משרת על ידי הדוגמה המבוצעת שלך, לא חבילה בערוץ ההורדה החתום, ולכן הוא נשאר זמין באופן עצמאי מ- Google Play, App Store ו- TestFlight.
- הפעל את ההזדמנות AirCode Ø ותן לה כתובת יציבה HTTPS . זהו Quickstart ו- גישה מרחוק
- פתח את התקנת היישום האינטרנט המוקדמת, הקלד את מקור ההזדמנות HTTPS , ובחר פתח את דף ההתקנה. אותו תבנית זמינה גם Download. האתר מאשר את הערך באופן מקומי ו אף פעם לא שולח או מאחסן אותו.
- חותמים על המקרה. Chromium חושפת את הצעת ההתקנה שלה; iPhone ו iPad להשתמש ב- Share → הוסף זרם Home Screen .
- פתח את האייקון המותקן. מאפשר דחוף הודעות רק אם אתה רוצה אזהרות אפליקציה סגורה; iOS ו- iPadOS מציעים שליטה זו רק מ- Home Screen אפליקציית אינטרנט.
ההתקנה מתבצעת במקור. כתובת HTTP LAN אינה יעד נייד שלם של PWA , ושינוי המקור של HTTPS דורש התקנה נפרדת וייתכן שיהיה צורך באמת שוב. היישום האינטרנט מתעדכן מהדוגמה באמצעות עובד השירות שלו; זה לא APK, IPA, או חנות חבילה.
האפליקציה האינטרנט נושאת את מרחב העבודה הבסיסי התגובה. Native Mobile הוא הבחירה הטובה ביותר כאשר אתה צריך החלפת שרתים מאובטחים בתוך אפליקציה, קבצים מחוץ לאפליקציה מאובטחים ומנוהלים, משימות רקע מוגבלות ואמינות, שיתוף/סריקה מקוריים, חפצים, עדיפות ערוץ הודעות, או קישורים עמוקים למערכת ההפעלה.
שרת Linux
תוכנית ההתקנה מתפרסמת רק אחרי שהמניפסט של הגרסה, סכומי הביקורת ובדיקות החתימה עברו בהצלחה. לפני הרצת הפקודה, ודאו שגרסת השרת מסומנת כזמינה בדף ההורדות.
curl -fsSL https://dl.aircodezero.com/install.sh | bash
פקודה זו מתקינה את גרסת ה-stable העדכנית ביותר. אפשרויות ההתקנה שבהמשך מאפשרות לבחור במקומה גרסת בטא או גרסה מסוימת.
• המשתמש המותקן:
- מזהה את הפלטפורמה שלך (
linux-x64,linux-arm64), - הורד את tarball השחרור ומאשר את sha256 checksum ו- Ed25519 חתימה,
- התקנת
~/.aircode/versions/<version>עם~/.aircode/currentsymlink, - קישורים
aircodeל-~/.local/bin, - בודק את תלונות המערכת (
git,tmux) ומספר לך בדיוק מה לעשות להתקין אם משהו חסר.
אין צורך בשורש. הכל חי במדריך הבית שלך. הפעלת מחדש את מתקן ההתקנה תיקנה או עדכנה את ההתקנה. אם ~/.local/bin אינו נמצא ב- PATHשל הקליפה הנוכחית, ההוראות הסופיות משתמשות במסלול ה- ~/.aircode/current/bin/aircode המפעיל באופן מיידי וגם מציגות את הייצוא האופציונלי של PATH .
לאחר מכן, התחל את הדוגמה מתיקייה אשר צריכה להכיל את הפרויקטים הנבחרים:
cd /srv/workspaces
aircode start
ב- Linux, aircode start יוצר את הגדרת המסלול, בוחר פורט חופשי, יוצר ומדפיס סיסמה גישה, מפעיל שירות משתמש systemd ומאפשר התאוששות לאחר התרסקות ופעילות מחדש. הוא גם מנסה להפעיל systemd linger ומדפיס פקודה אחת מדויקת תיקון אם המארח דורש אישור מנהל. אין צורך בקובץ יחידה כתוב ביד.
אם התקנה זו עדיין מחזיקה במכשיר הסטורי aircode.service , המכשיר הראשון aircode start מסיר את המכשיר בבטחה לפני יצירת השירות המקיף את המסלול, כך ששני השרתים לא יכולים להתחרות באותו פורט. יחידות הבעלות על ידי מזומן או התקנה שונים לעולם לא משתנים.
אפשרויות התקנה: --channel beta (ערוץ ברירת המחדל הוא stable), --version x.y.z ו---no-modify-path. האפשרות ההיסטורית --service נשארת תואמת עם היחידה הישנה; התקנים חדשים צריכים להשתמש ב- aircode start.
דרישות מערכת
| דרישה | הערות |
|---|---|
| Linux x64 / arm64 | Ubuntu 22.04+, Debian 12+, Fedora (אחרונה) — glibc |
git, tmux |
sudo apt-get install -y git tmux |
| סוכן CLIs | מותקן ואותנטי עם חשבונות שלך; השתמש בגרסאות ה- שנבדקו ב- Quickstart לאינטגרציות רגישות לגירסה של TUI |
| מערכתd | נדרש עבור קבוע aircode start; לא נדרש עבור קדמי aircode serve |
זמני ההפעלה של Node.js מובנים – אין צורך בכרטיס מערכת.
Docker
האימג’ הציבורי aircodezero/aircode מריץ את אותה חבילת שרת Linux שפורסמה ושמותקנת באמצעות install.sh. Node.js, לקוח הווב, Claude Code, Codex, Grok Build ו-Kimi Code כלולים בו. הוא מתפרסם עבור linux/amd64 ו-linux/arm64 עם התגים stable ו-beta, וגם עם תגי גרסה מדויקים כמו 0.1.30.
הפעילו אותו בכל מארח Docker בפקודה אחת:
docker run -d --name aircode --restart unless-stopped --stop-timeout 30 -p 7860:7860 -v aircode-home:/home/aircode aircodezero/aircode:stable
Docker Compose
האתר מספק קובץ compose.yaml מוכן לשימוש. שמרו אותו בתיקייה נפרדת והפעילו אותו משם:
curl -fsSLO https://aircodezero.com/docker/compose.yaml
docker compose up -d
פריסה ב-Hostinger
פריסה ב-Hostinger הפריסה המודרכת מכינה את הגישה של הדפדפן לפני פתיחת Hostinger.
- יש לבחור VPS עם Ubuntu 24.04 ועם Docker (x86-64). KVM 2 (2 vCPU, 8 GB RAM) מתאים לבדיקה קטנה. יש לבדוק את המחיר והחידוש לפני התשלום.
- Docker Manager פותח את התצורה המוכנה. יש לבחור Deploy ואז בקישור Open של הפרויקט עם HTTPS.
- יש להמשיך בדפדפן שבו התחילה הפריסה, לאשר את כתובת המופע ולבחור סיסמה. יש לשמור את נתוני האתר בדפדפן עד לסיום ההגדרה.
גישה ראשונה
שלבים אלה מיועדים להתקנת Docker ידנית (docker run או קובץ Compose הנייד). עבור Hostinger יש להשתמש בהגדרת HTTPS שלעיל.
פתחו את http://<server-address>:7860. בהפעלה הראשונה, הקונטיינר מדפיס פעם אחת ביומנים שלו סיסמה שנוצרה:
docker logs aircode
כדי לבחור את הסיסמה בעצמכם, הגדירו את משתנה הסביבה AIRCODE_AUTH_PASSWORD בעת יצירת הקונטיינר. אפשר לשנות את הסיסמה מאוחר יותר בהגדרות האפליקציה.
כתובת HTTPS פרטית
ב-AirCode Ø, פתחו את הגדרות → גישה מרחוק ובחרו היכנס כדי לחבר את חשבון AirCode Ø שלכם. לאחר מכן השרת מקבל את כתובת ה-HTTPS הפרטית שלו דרך ה-Relay:
https://<name>.tunnel.aircodezero.com
החיבור ל-Relay הוא יוצא בלבד, כך שאין צורך לפתוח פורט. לפרטים נוספים ראו גישה מרחוק.
נתונים ועדכונים
הפרויקטים, ההתחברויות לספקים, השיחות וההגדרות נשמרים כולם בווליום aircode-home. מחיקת הווליום מוחקת אותם.
כדי לעדכן, משכו את האימג’ החדש וצרו מחדש את הקונטיינר. עם Docker Compose, הריצו את הפקודה הזו ליד compose.yaml:
docker compose pull && docker compose up -d
עם docker run, משכו את האימג’, עצרו והסירו את הקונטיינר, ואז הריצו שוב את אותה פקודת docker run:
docker pull aircodezero/aircode:stable
docker stop aircode && docker rm aircode
הקונטיינר לעולם אינו מפעיל גרסה ישנה יותר מגרסה שהווליום שלו כבר הריץ. אם תהליך השרת נעצר בתוך הקונטיינר, הקונטיינר מפעיל אותו מחדש, והסשנים של הסוכנים שורדים את ההפעלה מחדש הזו.
macOS
אפליקציית שולחן העבודה (מומלץ): הורד את .dmg מהדף ההורדה דף הורדה. הוא מקיף את השרת המלא (הפגישות המקומיות) ומתחבר גם לשרתים מרחוקים.
ללא ראש / CLI: אותו אחד-לינר כמו Linux עובד על macOS 13+ (darwin-arm64, darwin-x64). התקנת tmux באמצעות Homebrew תחילה, ולאחר מכן להשתמש aircode serve; קבוע aircode start כעת דורש Linux systemd.
Windows
התקנה של היישום שולחני מתוך דף ההורדה דף הורדה. פגישות מקומיות פועלות באופן מקורי ב- Windows דרך ConPTY. התקנת ה-Installer מקימה את השרת ואת זמני ההפעלה שלו Node.js , ולכן WSL, הפצה Linux , והתקנה של מערכת Node אינם נדרשים. הוא גם מוסיף את aircode למשתמש הנוכחי PATH, המאפשר לשרת המוטבע להפעיל מ- PowerShell או Command Prompt. פתחו טרמינל חדש לאחר ההתקנה וראו את Windows הפניה שורת הפקודה. האפליקציה יכולה גם להתחבר לשרתים מרוחקים AirCode Ø .
מצבי הפעלה של שולחן עבודה
| מטרה | התחלה | תוצאות |
|---|---|---|
| לקוח מרחוק בלבד | פתח את AirCode Ø ולאחר מכן בחר את להתחבר לשרת מבלי להגדיר Local | חלון האלקטרון מוריד את שרת הרחוק הנבחר AirCode Ø |
| לקוח מקומי + שרת | Open AirCode Ø, בחר תיקיית פרויקטים, ולאחר מכן בחר Run on this machine | Electron פותח ומנהל את השרת המקורי המוטבע, ולאחר מכן מוריד את מרחב העבודה שלו |
| Server בלבד | הפעל את aircode serve --projects-root "D:\Projects" ב- PowerShell או בהזמנה |
השרת המצורף פועל בחזית ללא חלון אלקטרוני |
אל תפעילו את ההפעלה של שולחן העבודה עם --serve: היא פותחת את Electron ואינה מספקת מצב שרת בלבד. השתמש בפקודה aircode המותקנת ב- PATH עבור שרת מסוף בלבד.
לאחר הגדרת Local, הפעלת שולחן העבודה הרגילה מבטיחה שהשרת המובנה פועל, גם כאשר חלון מחובר לשרת מרחוק. השרת המנוהל על ידי שולחן העבודה מקשיב רק ל- 127.0.0.1. כדי להתחבר ממכשיר אחר, השתמש ב- Remote Access או הפעל שרת CLI עם כתובת חיבור רשת פרטית מפורשת.
ב- Windows, סגירת כל חלון שולחן העבודה משאירה את AirCode Ø ואת השרת המובנה שלה פועל באזור ההודעות. בחר Quit מתוך הסמל הזה כדי לעצור את השרת המובנה. שרת CLI הוא תהליך נפרד והוא יכול להתקיים יחד על שער אחר; ראה אפליקציית Desktop coexistence.
רכיבים אופציונליים כבדים
שום דבר גדול לא הורד באופן מוטעה:
aircode browser install # pinned Chromium for the agent browser
aircode doctor browser # verify it
Knowledge נשאר מילולי עד שתתקין באופן מפורש מודל של קבצים מקומיים מההגדרות שלו. המודל מאוחר יותר מאובטח ומשמש באופן לא מקוון; אינדקס מעולם לא מעורר הורדת מודל מוטעית.