إعداد
تطبيقات الويب iPhone, iPad و Android
تطبيق الويب AirCode Ø هو المستخدم الدائم غير المتاجر. يتم توفيرها من قبل إمكانية التحقق الخاصة بك، وليس في قناة التحميل المذكورة، لذلك لا يزال متاحاً بشكل مستقل من Google Play، App Store، TestFlight.
- بدء ملاحظة AirCode Ø وقدمها عنوان HTTPS المستقر. هذا هو Quickstart و الوصول عن بعد.
- قم بفتح تطبيق Web App Setup، أدخل مصدر مصطلح HTTPS ، ثم اختيار فتح صفحة تثبيت. كما هو متاح على نفس المكان Download. ويستخدم موقع الويب قيمة المحلي و لا يقدم أو تخزينها.
- انقر على الوضع. Chromium يظهر إرسالها الخاص؛ iPhone و iPad استخدم المساعدة Share → Add to Home Screen flow.
- قم بتشغيل الهواتف التي يتم تثبيتها. تفعيل إرسال الإشعارات فقط إذا كنت تريد إشارات التطبيق المغلقة؛ iOS و iPadOS تقدم هذا التحكم فقط من Home Screen تطبيق ويب.
يتم تشغيل الإستخدام من الأصل. عنوان HTTP LAN ليس هدف محمول كامل PWA ، وتغيير مصدر HTTPS يتطلب تثبيت منفصل ويمكن أن يتطلب إدماج مرة أخرى. تحديث التطبيق على شبكة الإنترنت من الحالة من خلال عامل الخدمة، وليس APK، IPA، أو حزمة متجر.
تطبيق الويب يتناول مساحة العمل الأساسية المباشرة. لا تزال الهواتف الذكية الأصلية الخيار الأفضل عندما تحتاج إلى تحويل الخادم في التطبيق آمن، الملفات المختصة المختصة خارج التطبيق، وظائف الخلفية المحدودة الموثوق بها، وتبادل / تسجيل الأصلية، والتطبيقات، أو ترجيح قناة الإشعارات، أو روابط عميقة من نظام التشغيل.
خادم Linux
لا يُنشر برنامج التثبيت إلا بعد اجتياز بيان الإصدار والمجاميع الاختبارية وفحوص التوقيع. قبل تشغيل الأمر، تحقق من أن إصدار الخادم مُعلَّم بأنه متاح في صفحة التنزيل.
curl -fsSL https://dl.aircodezero.com/install.sh | bash
يثبّت هذا الأمر أحدث إصدار stable. وتتيح خيارات برنامج التثبيت أدناه اختيار إصدار تجريبي أو إصدار محدد بدلًا منه.
المختبر :
- يتم تشخيص منصةك (
linux-x64,linux-arm64) ، - تنزيل tarball الإصدار ويحقق sha256 مجموعات التحقق و 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
تثبيت التطبيق على جهاز الكمبيوتر من صفحة تحميل صفحة Download. يتم تشغيل جلسات محددة بشكل طبيعي على Windows من خلال ConPTY. يتم دمج المستخدم ومرحلة تشغيل Node.js ، لذلك لا تتطلب WSL، توزيع Linux ، وتثبيت نظام Node. كما يضيف aircode إلى PATHالمستخدم الحالي ، مما يسمح بتشغيل المورد المدمج من PowerShell أو Command Prompt. فتح محرك جديد بعد تثبيت وإرسال Windows إشارة خطة المرور. يمكنك أيضا اتصال التطبيق إلى خادمات AirCode Ø عن بعد.
أدوات التشغيل لسيارات الكمبيوتر
| الهدف | بداية | النتائج |
|---|---|---|
| المستخدم عن بعد فقط | افتح AirCode Ø ثم اختار اتصال إلى خادم دون إعداد الموقع | نافذة Electron تنزيل المورد عن بعد AirCode Ø |
| المستخدم المحلي + المورد | Open AirCode Ø، اختر ملف مشاريع ، ثم اختر Run on this machine | Electron يبدأ ويسيطر على المورد الداخلي المدمج، ثم يتم تحميل مساحة عملها |
| Server فقط | إجراء aircode serve --projects-root "D:\Projects" في PowerShell أو إرسال إرسال الإرسال |
المورد المشترك يعمل في المرتبة الأولى دون نافذة Electron |
لا تقوم بتشغيل التطبيق على الكمبيوتر مع --serve: فإنه يفتح Electron ولا يوفر وضع مجاني للخدمة. استخدم إرسال aircode في PATH لخدمة محمولة فقط.
بعد تكوين Local ، يضمن بدء تشغيل الكمبيوتر العادي أن المورد المدمج يعمل ، حتى عندما يكون نافذة متصلة بالخدمة عن بعد. يتابع المورد المخترع الذي يسيطر عليه جهاز الكمبيوتر فقط على 127.0.0.1. لتواصل من جهاز آخر، استخدم الوصول عن بعد Access Remote أو بدء خادم CLI مع عنوان ربط شبكة خاصة واضح.
في Windows، يترك إغلاق كل نافذة على المكتب AirCode Ø وخدمته المملوكة التي تعمل في منطقة الإشعارات. اختر إلغاء من هذا التصوير لوقف المورد المدمج. يعتبر سرور CLI عملية منفصلة ويمكن أن تتواجد في محطة مختلفة؛ انظر تطبيق المكتب المتواجد.
المكونات الغذائية الاختيارية
لا شيء كبير يتم تنزيلًا ملموسًا:
aircode browser install # pinned Chromium for the agent browser
aircode doctor browser # verify it
Knowledge يبقى لغويا حتى يتم تثبيت نموذج إدراج محلي بشكل واضح من إعداداته. ثم يتم تحديد النماذج واستخدامها خارج الإنترنت، ولا تسبب الإندونيسيون أيضًا في تحميل النماذج المباشرة.