استضافة KiroCrew على VPS ليعمل دائماً
شغّل KiroCrew داخل Docker على VPS مع systemd، واحفظ الذاكرة والمهام بعد إعادة التشغيل، مع وصول SSH ونسخ احتياطية واسترجاع سريع بعد الترقية.
لماذا تستضيف KiroCrew ذاتياً على VPS بدلاً من حاسوب محمول
تؤتي استضافة KiroCrew ذاتياً ثمارها فقط على جهاز لا يدخل في وضع السكون مطلقاً، لذلك يُعد VPS المكان المناسب له، وليس الحاسوب المحمول. يحتفظ KiroCrew بسجل الجلسات، والذاكرة الدلالية، والمهام المجدولة، وقائمة انتظار الموافقات على القرص، ويعيد تحميلها كلها عند إعادة تشغيل العملية. لا يفيد أيٌّ من ذلك إذا لم تكن العملية قيد التشغيل عند الساعة 03:00، حين يحين موعد تنفيذ مهمة مجدولة، كما أن الحاسوب المحمول المغلق لا يشغّلها.
KiroCrew مساحة عمل مفتوحة المصدر للوكلاء من فريق Kiro، ومرخّصة بموجب Apache 2.0، مع إصدار 0.1.0 في 22 July 2026. تتولى عملية واحدة، تُسمى gateway، إدارة الحالة وتقديم لوحة تحكم ويب على المنفذ 5476. يمكنك الوصول إلى هذه البوابة من لوحة التحكم، أو من واجهة سطر الأوامر kirocrew، أو من قناة محادثة مثل Slack. إن gateway هي الشيء الوحيد الذي تستضيفه ذاتياً، لذلك يركّز هذا الدليل على إبقائها قيد التشغيل، وإبعادها عن الإنترنت العام، وإمكانية إعادتها بعد ترقية سيئة.
هناك أمران ينبغي معرفتهما قبل البدء. منذ 0.11.0، تستخدم عمليات تثبيت KiroCrew الجديدة التي لا تحتوي على اختيار محفوظ لـharness الإعداد الافتراضي KAS من دون الحاجة إلى kiro-cli؛ أما الاختيارات الصريحة الحالية لـKiro CLI فتظل محفوظة. يستخدم الاستدلال على Kiro backends خطة Kiro الخاصة بك، لذلك اعتباراً من 1 November 2026، لا يكون هذا الإعداد الافتراضي غير متصل بالإنترنت. المشروع حديث العهد ويتطور بسرعة أيضاً: انتقلت إصداراته المستقرة من 0.1.3 في 5 August 2026 إلى 0.10.0 في 25 October 2026، مع إصدارَي 0.8.0 في 9 October و0.9.0 في 16 October بينهما، كما كان إصدار 0.11.0 المرشح للإصدار متاحاً بالفعل كإصدار تمهيدي في 25 October. افترض أنك ستحتاج إلى التراجع عن ترقية في مرحلة ما، وثبّته بطريقة تتيح لك ذلك. إذا لم تكن قد شغّلت وكيلاً على خادم من قبل، فإن تشغيل وكيل برمجي على VPS يشرح القواعد الأساسية التي يعتمد عليها هذا الدليل. وإذا كانت جهة الوكيل أحدث عهداً بالنسبة إليك من جهة الخادم، فسيجعل تعلّم ماهية حلقة الوكيل وأدواتها وذاكرتها فعلياً أولاً الخيارات التالية تبدو قرارات، لا تعاويذ.
ما يحتاج إليه KiroCrew ومكان تخزين حالته
يتطلب التثبيت الأصلي Python 3.12 أو إصداراً أحدث، وNode.js 22.12.0 أو إصداراً أحدث إذا أنشأت لوحة المعلومات من المصدر، مع أن المشروع يوصي باستخدام Node 24 LTS. تحتاج الواجهة الخلفية لـKiro CLI إلى kiro-cli، مع المصادقة باستخدام kiro-cli login أو مفتاح API للاستخدام الآلي. منذ 0.10.0، يعمل محرّك KAS المضمّن من دون تثبيت kiro-cli، وقد جعل 0.11.0 هذا المحرّك الخيار الافتراضي عند التثبيتات الجديدة التي لا تحتوي على اختيار محفوظ للـharness. لا يحتاج تثبيت الحاوية إلى أي من ذلك على المضيف. فهو يحتاج إلى Docker فقط. وهذا هو السبب الرئيسي لتفضيله.
تُخزَّن الحالة في ~/.kiro/crew، وينقل متغير البيئة KIROCREW_HOME هذه البيانات إلى موقع آخر. ويتضمن هذا الموقع ما يلي:
config.json: إعدادات البوابة وبيانات اعتماد قنوات الدردشة..env: الأسرار.workspace/memory/: التفضيلات وملاحظات المشروع وسجل الدردشة.memory.dbوmemory_index.db: الفهارس الدلالية وفهارس البحث في النص الكامل.models/: نموذج التضمين، ويُنزَّل عند التشغيل الأول.security_events.jsonl: سجل أحداث الأمان.
هذا المجلد هو التثبيت نفسه. انسخه إلى VPS جديد، وستكون قد نقلت وكيلك. لذلك يكتسب قسم النسخ الاحتياطي أدناه أهمية أكبر من قسم التثبيت.
خطط لاستهلاك القرص بدلاً من الذاكرة RAM. البوابة عبارة عن عملية Python. وما يحمّل الخادم فعلياً هو ما يشغّله الوكيل، مثل عملية بناء أو مجموعة اختبارات. يزداد حجم مجلد الحالة مع سجل الدردشة، ويُنزَّل نموذج التضمين عند أول تشغيل. لذلك قِس الحجم على خادمك باستخدام du -sh ~/.kiro/crew بعد مرور بضعة أسابيع، بدلاً من الاعتماد على أي رقم نُشر خلال الأشهر الأولى من المشروع. ويختلف ذلك عن بيئة تشغيل تمنح كل عامل حاويته ومتصفحه الخاصين، حيث يجعل استضافة زملاء OpenBot للذكاء الاصطناعي ذاتياً تقدير الذاكرة RAM أولوية قبل تقدير مساحة القرص.
أي مسار من مسارات التثبيت الأربعة ينبغي استخدامه
ينشر المشروع أربعة مسارات: تطبيق سطح المكتب، وone-line wheel، والمصدر، وDocker. يجلب مثبّت one-line حزمة wheel وينشئ مشغّل kirocrew؛ وإذا لم يكن دليله مضافاً إلى PATH، فإنه يطبع تعليمات لإضافته:
curl -fsSL https://download.crew.kiro.dev/cli.sh | shيقبل المعلّم channel والمعلّم version:
curl -fsSL https://download.crew.kiro.dev/cli.sh | sh -s -- --channel insider
curl -fsSL https://download.crew.kiro.dev/cli.sh | sh -s -- --version 0.8.0تُنشر صورة الحاوية في ghcr.io/kirodotdev/kirocrew، لكل من linux/amd64 وlinux/arm64 ضمن كل وسم. يعتمد البناء من المصدر على git clone بالإضافة إلى make build، وهو مخصّص لمن يغيّرون الشيفرة، لا لمن يشغّلونها.
استخدم الحاوية. يضع التثبيت الأصلي من المصدر حزم Python وNode على المضيف نفسه الذي يشغّل خدماتك الأخرى، بالإضافة إلى kiro-cli عند استخدام الواجهة الخلفية Kiro CLI، لذلك قد يتركك التحديث الفاشل مضطراً إلى تفكيك هذه التغييرات يدوياً. تحتفظ الحاوية ببيئة التشغيل في صورة واحدة، وبالحالة في وحدة تخزين واحدة، ما يجعل التراجع تغييراً للوسم وإعادة تشغيل.
ثبّت الصورة على وسم إصدار، وليس على stable
يستخدم المثال الخاص بالمشروع وسم stable:
docker run -d --name kirocrew \
-p 127.0.0.1:5476:5476 \
-v kirocrew-home:/home/kirocrew \
ghcr.io/kirodotdev/kirocrew:stablestable وسم متحرك، وكذلك latest الذي يشير إلى الإصدار نفسه. وهو يشير إلى أحدث إصدار مستقر، أياً كان، لذلك قد يؤدي السحب التالي إلى تغيير الإصدار الذي تشغّله من دون اختيارك، كما أن الوسم لا يسجل الإصدار الذي كان مستخدماً. أما وسوم الإصدارات فهي غير قابلة للتغيير، لذا ثبّت الصورة على أحدها. أحدث إصدار مستقر حتى 1 November 2026 هو 0.11.1، وقد نُشر في 31 October 2026 لمعالجة عاجلة لمشكلات سلامة الذاكرة وإصلاحات KAS في 0.11.0. يستخدم المثال 0.8.0 أدناه Kiro CLI. وتوجد أيضاً وسوم insider وnightly؛ ويتبع nightly البنيات الصادرة من main.
اكتب /opt/kirocrew/compose.yaml:
services:
kirocrew:
image: ghcr.io/kirodotdev/kirocrew:0.8.0
container_name: kirocrew
restart: unless-stopped
ports:
- "127.0.0.1:5476:5476"
volumes:
- kirocrew-home:/home/kirocrew
volumes:
kirocrew-home:شغّله، ثم تحقّق من نقطة نهاية الصحة التي تستخدمها الصورة أيضاً من أجل HEALTHCHECK الخاص بها:
cd /opt/kirocrew
docker compose up -d
docker compose ps
curl -s http://127.0.0.1:5476/api/healthمن المفترض أن يشير docker compose ps إلى أن الحاوية سليمة خلال نحو دقيقة، ويستجيب /api/health من دون رمز مميز، وكذلك /api/live و/api/ready، ما يجعلها صالحة للاستخدام كنقاط فحص. إذا بقيت الحالة عند starting، فاقرأ docker logs kirocrew قبل تغيير أي شيء. ينزّل التشغيل الأول نموذج التضمين في الخلفية؛ ويستخدم بحث الذاكرة مطابقة الكلمات المفتاحية إلى أن يكتمل التنزيل.
أبقِه قيد التشغيل باستخدام systemd
يعيد restart: unless-stopped تشغيل الحاوية بعد تعطلها وبعد إعادة التشغيل، ما دام Docker نفسه يبدأ عند الإقلاع. يوضّح ملف الوحدة هذه التبعية صراحةً، ويوفّر أمراً واحداً يوقف الحزمة كاملة قبل إجراء نسخة احتياطية. يشرح بدء حزمة Docker Compose عند الإقلاع النمط العام. هذا هو الشكل المستخدم مع KiroCrew في /etc/systemd/system/kirocrew.service:
[Unit]
Description=KiroCrew gateway
Requires=docker.service
After=docker.service
[Service]
Type=oneshot
RemainAfterExit=yes
WorkingDirectory=/opt/kirocrew
ExecStart=/usr/bin/docker compose up -d
ExecStop=/usr/bin/docker compose down
TimeoutStartSec=0
[Install]
WantedBy=multi-user.targetsudo systemctl daemon-reload
sudo systemctl enable --now kirocrew
systemctl status kirocrewيجب أن يعرض systemctl status kirocrew القيمة active (exited)، وهي النتيجة السليمة لهذه الوحدة. استخدام Type=oneshot مع RemainAfterExit=yes صحيح هنا لأن docker compose up -d يعيد النتيجة فور بدء الحاوية: يتتبع systemd حقيقة أن الحزمة تعمل، وليس عملية تعمل في المقدمة. إذا كتبت Type=simple بدلاً من ذلك، فسيرى systemd أن الأمر انتهى فوراً، ويضع علامة على أن الخدمة متوقفة، ثم يستسلم أو يدخل في حلقة إعادة تشغيل، بحسب إعداد Restart=. عند التثبيت الأصلي، يوفّر المشروع البديل الخاص به، kirocrew service install، الذي يكتب /etc/systemd/system/kirocrew.service ويشغّل البوابة بصلاحيات مستخدمك. لا تشغّل الوحدتين معاً. يتناول خدمات systemd والمؤقتات على VPS هذا الموضوع بتفصيل أوسع. تكون الوحدة التي تفشل في العودة صامتة ما لم تجعلها ترسل تنبيهاً، لذلك أضف معالج OnFailure= الذي يرسل تنبيهاً إلى خادم ntfy الخاص بك، وستعرف من هاتفك أن البوابة متوقفة بدلاً من اكتشاف ذلك عبر مهمة مجدولة لم تُشغَّل مطلقاً.
التشغيل الأول: سجّل الدخول واحصل على رمز لوحة المعلومات
تبدأ الحاوية تشغيل البوابة، لكن بيئة تشغيل Kiro CLI الافتراضية في صورة 0.8.0 المثبتة ما زالت تحتاج إلى المصادقة. سجّل الدخول داخل الحاوية، أو مرّر KIRO_API_KEY عبر بيئة الحاوية للاستخدام الآلي:
docker exec -it kirocrew kiro-cli loginيطبع ذلك رمز جهاز وعنوان URL تفتحه في متصفحك. بعد ذلك أنشئ رمزاً للوحة المعلومات:
docker exec kirocrew kirocrew token --ttl 2hعنوان URL للوحة المعلومات هو http://localhost:5476/?token=<the token>. تنتهي صلاحية الرموز: يجب فتح الرابط المطبوع خلال خمس دقائق من إنشائه، ويطلب هذا الأمر ملف تعريف ارتباط للوصول لمدة ساعتين، بينما الحد الأقصى الموثّق هو عشرون ساعة. يحصل المتصفح أيضاً على ملف تعريف ارتباط للتحديث مع فترة خمول متحركة مدتها 30 يوماً، لذلك تتجدد الجلسة النشطة من دون رابط آخر. إذا حُمّلت لوحة المعلومات فارغة أو أعادتك مباشرة إلى خارجها، فالسبب المعتاد هو انتهاء صلاحية الرمز. أنشئ رمزاً آخر وافتحه فوراً. لا تلصق رمزاً في تذكرة أو رسالة محادثة، لأن من يملكه يملك وكيلك.
الوصول إلى لوحة التحكم عبر SSH، وعدم نشر المنفذ 5476 إطلاقاً
أعد النظر في عنوان الربط في المثال الوارد في المشروع: -p 127.0.0.1:5476:5476. يستمع البوابة داخل الحاوية على 0.0.0.0، لأن الوصول إليها يجب أن يكون ممكناً عبر تعيين المنفذ، لكن التعيين نفسه ينشر المنفذ على loopback في المضيف فقط. احذف البادئة 127.0.0.1:، وستصبح البوابة متاحة على الإنترنت العام لأي شخص يفحص ذلك المنفذ. ولن تنقذك قاعدة ufw أيضاً: ينشر Docker المنافذ بكتابة قواعد DNAT التي توجّه حركة الشبكة قبل تطبيق قواعد ufw، ولذلك لا يفعل ufw deny 5476 شيئاً مع المنفذ المنشور. عند استخدام Docker للواجهة الخلفية الافتراضية iptables، تتمثل استجابة Docker الخاصة في وضع قواعد التصفية في سلسلته DOCKER-USER. ينجح ذلك، لكن هذه القواعد ترى العنوان والمنفذ الداخليين للحاوية ما لم تطابق باستخدام إضافة conntrack، ولذلك يظل الربط على loopback هو الضابط الأبسط والأقل عرضة للخطأ. أما الواجهة الخلفية nftables في Docker فتستخدم جداول nftables وسلاسل أساسية منفصلة للتصفية المخصصة. يشرح تجاوز منافذ Docker لقواعد ufw هذه الآلية بالتفصيل.
أعد توجيه المنفذ عبر SSH من حاسوبك المحمول بدلاً من ذلك:
ssh -N -L 5476:127.0.0.1:5476 you@your-server.example.comاترك هذا الأمر قيد التشغيل وافتح http://localhost:5476/?token=<the token> محلياً. لجعل إعادة التوجيه تلقائية عند كل اتصال، أضفها إلى ~/.ssh/config:
Host your-server.example.com
LocalForward 5476 127.0.0.1:5476إذا كان المنفذ 5476 مستخدماً بالفعل على حاسوبك المحمول، فغيّر الرقم الموجود على اليسار فقط: ssh -N -L 45476:127.0.0.1:5476 you@your-server.example.com، ثم انتقل إلى http://localhost:45476/?token=... في المتصفح. لا تحتاج إلى إعداد إضافي لمنفذ loopback أو إلى إعادة إنشاء الحاوية: يطابق Origin المحلي عبر loopback قيمة Host الخاصة بالطلب نفسه، ولذلك ينجح فحص CSRF. ستستخدم عمليات إعادة توجيه متراكمة بهذه الطريقة بمجرد مشاركة وكيل ثانٍ للخادم، لأن الاستضافة الذاتية لـ open-kritt لفحص الأمان تضيف لوحة تحكم أخرى لا تستمع إلا على loopback في الخادم نفسه، على المنفذ 5173.
تحدد سلوكان موثقان الإعدادات التي يمكنك تغييرها من لوحة التحكم. أولاً، تعتبر البوابة أي طلب يحتوي على رؤوس إعادة التوجيه (Forwarded أو X-Forwarded-* أو X-Real-IP) طلباً بعيداً، وترفض نقاط نهاية كتابة الإعدادات وكشف الأسرار لهذه الطلبات. يضيف reverse proxy هذه الرؤوس، أما إعادة توجيه ssh -L العادية فلا تضيف أياً منها، ولذلك تبدو محلية ولا تُرفض لهذا السبب. ثانياً، تكون صفحات بيانات اعتماد القنوات والعروض التي تكشف الأسرار للقراءة فقط في صورة الحاوية لأي متصفح لا يتصل محلياً اتصالاً مباشراً، كما أن الصورة لا تتضمن محرر نصوص. إذا تعذر حفظ بيانات اعتماد قناة من لوحة التحكم، فذلك سلوك متوقع وليس خطأ. عدّل الإعدادات على المضيف بدلاً من ذلك:
docker cp kirocrew:/home/kirocrew/.kiro/crew/config.json .
# edit config.json here
docker cp config.json kirocrew:/home/kirocrew/.kiro/crew/config.json
docker exec -u 0 kirocrew chown kirocrew:kirocrew /home/kirocrew/.kiro/crew/config.json
docker restart kirocrewللوصول من الهاتف، يشير المشروع إلى tailscale serve الخاص بـ Tailscale، الذي يُبقي لوحة التحكم داخل tailnet الخاص بك بدلاً من نشرها على اسم مضيف عام. استخدم ذلك بدلاً من reverse proxy عام. ينتقل الرمز المميز في URL، ويُكتب URL في كل سجل وصول يمر عبره. تتعلق هذه القاعدة بما يوجد خلف المنفذ، لا بالمنفذ نفسه: فشيء مثل Halcyon، الذي يعيد بناء مكتبة Jellyfin على هيئة متجر فيديوهات من حقبة التسعينيات يمكن تصفحه مخصص لفتحه من أشخاص آخرين، ولذلك يصلح أن يكون وراء reverse proxy، أما البوابة التي يمكنها تنفيذ أوامر على خادمك فلا تصلح لذلك.
امنح الوكيل أضيق نطاق تأثير ممكن
يفحص الحاوي دعم العزل عند بدء التشغيل الأول، وتحدد النتيجة ما إذا كان بإمكان الوكلاء تنفيذ أي شيء. إذا كان عزل مساحات الأسماء متاحاً، تعمل العمليات الفرعية للوكيل ضمن بيئة معزولة. وإذا لم يكن متاحاً ولم يكن KIROCREW_ALLOW_UNSANDBOXED=1 مضبوطاً، يُرفض التنفيذ بدلاً من تشغيله دون عزل. لذلك، يكون هذا غالباً سبب ظهور البوابة بحالة سليمة بينما تتوقف كل المهام. يُحفظ القرار في docker logs kirocrew الناتج عن ذلك التشغيل الأول. ينشر المشروع أيضاً ملف تعريف seccomp (وضع الحوسبة الآمنة) يمكنك تطبيقه:
curl -fsSL https://raw.githubusercontent.com/kirodotdev/KiroCrew/main/docker/seccomp/kirocrew-seccomp.json \
-o /opt/kirocrew/kirocrew-seccomp.json security_opt:
- seccomp:./kirocrew-seccomp.jsonعلى مضيف مفعّل عليه AppArmor، يوضح دليل Docker الخاص بالمشروع أن ملف تعريف seccomp لا يمثل سوى نصف التغيير، لأن Docker يرفق أيضاً ملف تعريف AppArmor الخاص به، وهو docker-default، ويقرن ملف التعريف مع apparmor=unconfined. يرفع هذا الخيار قواعد AppArmor الخاصة بكل حاوية فقط؛ أما ملف تعريف seccomp، والإمكانات التي أُسقطت، والمستخدم غير root، فتظل مطبقة.
إذا ضبطت KIROCREW_ALLOW_UNSANDBOXED=1، فكن واضحاً بشأن ما تغيّر: أصبحت الحاوية الآن الحد الفاصل الوحيد بين الوكيل وخادمك. ويستحق تحذير المشروع التكرار كاملاً. لا تربط مسارات من المضيف لا تسمح للوكيل بالوصول إليها مباشرة. عملياً، يستبعد ذلك Docker socket، وأي bind mount لـ /، وأي دليل يحتوي على بيانات خدمة أخرى.
أما بقية الإعدادات فتنطبق على كل وكيل مسموح له بتشغيل الأوامر. قيّد بيانات اعتماده بالمستودع الواحد أو الحاوية التخزينية الواحدة التي يحتاج إليها، ولا تستخدم مطلقاً رمزاً شخصياً بصلاحيات تمتد إلى الحساب كله. شغّله كمستخدم مخصص لا يحتوي مجلده المنزلي على أي شيء آخر؛ وهذا هو الغرض من المستخدمين ذوي أقل الصلاحيات على VPS. عندما يكتب الوكيل الشيفرة ثم يشغّلها، وفّر له جهازاً مسموحاً له بإتلافه: يُعد استخدام VM مؤقت لوكلاء البرمجة حداً فاصلاً أقوى من أي خيار في ملف compose هذا، لأنك تحذفه بدلاً من تنظيفه. وينطبق المنطق نفسه على تشغيل OpenClaw بأمان على VPS واستضافة وكيل Hermes ذاتياً على VPS. وتُعد الأدوات أيضاً جزءاً من نطاق التأثير: فعندما تمنح الوكيل إمكانية البحث على الويب، تصبح كل صفحة يجلبها إدخالاً غير موثوق، ولذلك فإن توجيهه إلى نسخة SearXNG الخاصة بك قرار يتعلق بحقن الأوامر في المطالبات بقدر ما يتعلق بإعداد الاتصال. كما يستهلك العمل المجدول المال أثناء نومك، لأن الاستدلال على الواجهات الخلفية لـ Kiro يستخدم خطتك في Kiro؛ لذلك اضبط الحدود الموضحة في التحكم في تكلفة وكيل ذكاء اصطناعي على VPS قبل إضافة مهمة ليلية.
انسخ نسخة احتياطية من وحدة الحالة قبل كل ترقية
اعثر على اسم الوحدة الفعلي أولاً. تضيف Compose اسم المشروع إلى أسماء الوحدات المسماة، ويكون اسم المشروع افتراضياً هو اسم الدليل. لذلك تُنشأ الوحدة المعلنة باسم kirocrew-home في /opt/kirocrew/compose.yaml باسم kirocrew_kirocrew-home:
docker volume lsأوقف البوابة قبل نسخ أي شيء. memory.db وmemory_index.db هما قاعدتا بيانات SQLite، ونسخ قاعدة بيانات أثناء الكتابة إليها قد يلتقط معاملة مكتوبة جزئياً، فتُستعاد كملف تالف. تذكر تعليمات الترحيل الخاصة بالمشروع القاعدة نفسها: انقل الذاكرة فقط عندما تكون البوابات متوقفة. ولا تقتصر قاعدة الإيقاف أولاً على KiroCrew. وإذا كان خادم صور يستخدم الخادم نفسه، فإن مقارنة PhotoPrism وImmich تعرض أوامر النسخ الاحتياطي الدقيقة التي يحتاج إليها كل منهما.
sudo systemctl stop kirocrew
docker run --rm -v kirocrew_kirocrew-home:/data:ro -v "$PWD":/backup \
alpine tar czf /backup/kirocrew-2026-08-06.tgz -C /data .
sudo systemctl start kirocrewانسخ الأرشيف إلى خارج الخادم. وتستخدم الاستعادة الأمر نفسه بعد إيقاف الحاوية، مع وضع tar xzf بدلاً من tar czf:
sudo systemctl stop kirocrew
docker run --rm -v kirocrew_kirocrew-home:/data -v "$PWD":/backup \
alpine tar xzf /backup/kirocrew-2026-08-06.tgz -C /data
sudo systemctl start kirocrewالانتقال إلى مضيف جديد يختلف عن الاستعادة في مكانها، وقد حدد المشروع متطلباته بدقة. تنتقل سجلات المحادثات وملاحظات المشروع الموجودة ضمن workspace/memory/، وكذلك ملفا قاعدة البيانات وconfig.json. أما ملفات PID وسجل الأحداث الأمنية و.env فمرتبطة بالمضيف القديم، لذلك اتركها وانقل الأسرار مرة أخرى إلى الخادم الجديد.
كيفية التراجع عن ترقية سيئة
الترقية قصيرة، وهي آمنة فقط لأنك ثبّتَّ إصداراً محدداً. خذ النسخة الاحتياطية أولاً، ثم غيّر الوسم:
sudo systemctl stop kirocrew
# take the backup here, as above
sudo nano /opt/kirocrew/compose.yaml # set the new image tag
sudo systemctl start kirocrew
docker compose -f /opt/kirocrew/compose.yaml ps
curl -s http://127.0.0.1:5476/api/healthيسحب docker compose up -d الصورة إذا لم تكن موجودة على الخادم، لذلك يكفي تعديل الوسم لتنفيذ الترقية. التراجع هو التسلسل نفسه باستخدام الرقم القديم، ويعيد لك الصورة نفسها التي كانت لديك قبل الترقية، لأن وسوم الإصدارات غير قابلة للتغيير.
يتراجع الملف الثنائي دون مشاكل. أما الحالة فقد لا تتراجع بالطريقة نفسها. يمكن لبوابة أحدث إعادة كتابة config.json أو ترحيل قواعد بيانات الذاكرة إلى بنية لا تقرؤها بوابة أقدم، ولا يوجد مسار موثّق لخفض الإصدار للحالة حتى 12 October 2026. يوضح دليل التثبيت حالة واحدة بعبارة مباشرة: لا يمكن التراجع عن البيانات التي نُقلت من دليل ~/.kirocrew القديم، وسيبدأ إصدار يسبق ~/.kiro/crew بحالة فارغة. لذلك، إذا بدأ تشغيل الصورة الأقدم ثم تصرفت على نحو غير معتاد، فلا تحاول تصحيح المشكلة. أوقفها، واستعد النسخة الاحتياطية التي أخذتها قبل الترقية، ثم ابدأ من جديد. هذا هو السبب الكامل لتقديم النسخة الاحتياطية، ولهذا يفشل نهج الترقية الآن وإنشاء النسخة الاحتياطية لاحقاً في مشروع حديث إلى هذا الحد.
ما الذي لم يُثبت هنا
كن صريحاً بشأن حداثة هذا البرنامج. صدر الإصدار 0.1.3 في 5 August 2026، وبحلول 12 October 2026 كان خط الإصدارات المستقرة قد وصل إلى 0.8.0. لا تزال معظم ملاحظات الإصدار سجلات تغييرات آلية؛ أما ملاحظات 0.8.0 فمكتوبة يدوياً، لكنها لا تتضمن قسماً عن الترحيل، كما أن سجل الإصدارات العام لا يغطي سوى نحو ثلاثة أشهر. لا يستند أي شيء في هذا الدليل إلى نتائج طويلة الأمد، لذلك تعامل مع نمو الذاكرة وحجم قاعدة البيانات وموثوقية المجدول على أنها أمور يجب قياسها على خادمك، لا أموراً يمكن افتراضها.
هناك سلوكان يستحقان الاختبار بنفسك قبل الاعتماد عليهما. أولاً، اختبر ما إذا كان خفض الإصدار يقرأ الحالة التي كتبها إصدار أحدث. أجرِ الاختبار على نسخة من volume عندما لا تكون النتيجة مؤثرة، وليس أثناء انقطاع الخدمة. ثانياً، اختبر ما يفعله gateway عندما تنتهي صلاحية تسجيل الدخول إلى Kiro في وقت يحين فيه تشغيل مهمة مجدولة. كلاهما من المشكلات الحدّية التي يعالجها مشروع حديث بهدوء بين الإصدارات، ومن السهل التحقق منهما الآن.
FAQ
لماذا لا تفتح لوحة KiroCrew على عنوان IP العام لخادمي؟
لأن المثال المنشور يربط المنفذ بعنوان loopback. يربط -p 127.0.0.1:5476:5476 منفذ الحاوية بعنوان loopback على المضيف فقط، وهذا مقصود. يمكنك الوصول إليها عبر إعادة توجيه المنفذ من خلال SSH باستخدام ssh -N -L 5476:127.0.0.1:5476 you@your-server، ثم فتح http://localhost:5476/?token=<token> على حاسوبك المحمول. إن إزالة البادئة 127.0.0.1: لجعلها قابلة للوصول تضع البوابة على الإنترنت العام، ولن يعزلها ufw، لأن قواعد Docker الخاصة بـDNAT للمنافذ المنشورة توجّه حركة الشبكة قبل تطبيق قواعد ufw. استخدم سلسلة DOCKER-USER في Docker مع الواجهة الخلفية iptables، أو استخدم سلاسل nftables أساسية منفصلة مع الواجهة الخلفية nftables، لتصفية المنافذ المنشورة. ويظل إبقاء الربط على loopback أبسط.
أين يخزّن KiroCrew بياناته، وما الذي ينبغي أن أنسخه احتياطياً؟
توجد كل البيانات ضمن ~/.kiro/crew، وهو /home/kirocrew/.kiro/crew داخل صورة الحاوية، وينقلها KIROCREW_HOME إلى موقع آخر. انسخ الدليل بأكمله، أو وحدة Docker بأكملها، بعد إيقاف البوابة. memory.db وmemory_index.db قاعدتا بيانات SQLite، لذلك قد تكون النسخة التي تُؤخذ أثناء كتابة البوابة غير متسقة. عند النقل إلى مضيف جديد، تنتقل workspace/memory/ وملفا قاعدة البيانات وconfig.json، بينما تنتمي ملفات PID وسجل الأحداث الأمنية و.env إلى المضيف القديم.
هل ينبغي أن أستخدم وسم stable أم وسم إصدار؟
استخدم وسم إصدار. يتغير stable في كل مرة يصدر فيها إصدار جديد، لذلك قد يتغير الإصدار الذي تشغّله عند تنفيذ عملية السحب التالية، كما أن الوسم نفسه لا يخبرك بما هو قيد التشغيل. أما وسوم الإصدارات، مثل 0.8.0، فهي غير قابلة للتغيير. وهذا ما يجعل الرجوع إلى إصدار سابق يعمل: تعيد الرقم القديم فتحصل على الصورة نفسها. في 1 November 2026، أحدث إصدار مستقر هو 0.11.1.
لماذا يرفض الوكيل تشغيل أي أوامر؟
تتحقق الحاوية من دعم sandbox عند تشغيلها لأول مرة. إذا تعذر عليها عزل العمليات الفرعية للوكيل ولم يكن KIROCREW_ALLOW_UNSANDBOXED=1 مضبوطاً، فإنها ترفض تنفيذها بدلاً من تشغيلها دون عزل. لذلك تبدو البوابة سليمة بينما تتوقف كل مهمة. يعرض docker logs kirocrew قرار sandbox الناتج عن ذلك التشغيل الأول. يؤدي ضبط المتغير إلى جعل الحاوية الحد الفاصل الوحيد بين الوكيل والمضيف. لذلك، إذا ضبطته، فلا تربط أي شيء لن تسلّمه إلى الوكيل مباشرة.
هل أحتاج إلى حساب Kiro لاستضافة KiroCrew ذاتياً؟
نعم، بالنسبة إلى خلفيات Kiro، اعتباراً من 1 November 2026. KiroCrew برنامج حر بموجب Apache 2.0، لكن الاستدلال عبر تلك الخلفيات يستخدم خطة Kiro الخاصة بك. تستخدم حاوية 0.8.0 المثبتة Kiro CLI: شغّل docker exec -it kirocrew kiro-cli login ووافق على رمز الجهاز في متصفحك، أو مرّر KIRO_API_KEY عبر بيئة الحاوية للاستخدام الآلي. إلى أن تُضبط المصادقة، تبدأ تلك البوابة وتُحمّل لوحة المعلومات، لكن harness الافتراضي فيها لا يملك نموذجاً للتحدث إليه. ومنذ 0.10.0، يتوفر أيضاً محرك KAS مضمّن لا يحتاج إلى تثبيت kiro-cli؛ وقد جعل 0.11.0 KAS الخيار الافتراضي للتثبيتات الجديدة التي لا تملك اختيار harness محفوظاً، مع الإبقاء على اختيارات Kiro CLI الصريحة. يستخدم KAS تسجيل الدخول الخاص بـCrew بدلاً من kiro-cli login. يتيح دليل الواجهة الخلفية المخصصة للمشروع لـharness من نوع claude إرسال جولات النموذج الرئيسية إلى نقطة نهاية متوافقة مع Anthropic تختارها، لكن يظل تسجيل الدخول عبر kiro-cli مطلوباً للميزات الخاصة بـKiro.