استضافة open-kritt ذاتيًا على VPS: الإعداد والأمان
تعلّم تشغيل open-kritt على VPS عبر Docker Compose، وتثبيت إصدار محدد، وفتح الواجهة عبر نفق SSH على المنفذ 5173، وضبط ميزانية المزوّد قبل الفحص.
لماذا تستضيف open-kritt ذاتياً على VPS بدلاً من حاسوبك المحمول
استضف open-kritt ذاتياً على خادم يمكنك تدميره وإعادة بنائه. تشغّل الأداة وكلاء التحليل بصلاحيات root داخل حاويات مهام مؤقتة، وتمنح كل وكيل نسخة قابلة للكتابة من التعليمات البرمجية مع وصول مباشر إلى الإنترنت، وتربط Docker socket الخاص بالمضيف بخدمة المحرك. يُعد ذلك مقايضة معقولة على جهاز مخصص لهذه المهمة. لكنه خيار سيئ على الجهاز الذي يحتفظ بمفاتيح SSH الخاصة بك.
تدفع أربع خصائص في الإعداد الافتراضي إلى هذه التوصية، وجميعها واردة في README وcompose file الخاصين بالمشروع.
صُمِّم الوكلاء ليكونوا ذوي صلاحيات واسعة. يذكر README أن الوكلاء المزوّدين بالأدوات يعملون بصلاحيات root داخل حاويات مهام مؤقتة، مع نسخ مستودعات قابلة للكتابة ووصول مباشر إلى الإنترنت، حتى يتمكنوا من تثبيت الأدوات، وتجميع الأهداف، وتشغيل الاختبارات، وبناء إثباتات مفهوم. الفحص ليس أداة lint تقرأ الملفات. بل هو تنفيذ عشوائي للتعليمات البرمجية طلبته أنت. وهذا الوصول إلى الإنترنت يعمل في الاتجاهين: أي شيء يجلبه الوكيل أثناء البحث في هدف ما هو نص غير موثوق يصل إلى prompt الخاص به، وهو التعرض نفسه الذي تقبله عندما تمنح الوكيل إمكانية البحث على الويب بنفسه.
يحتوي المحرك على Docker socket. docker-compose.yml يربط Docker socket الخاص بالمضيف بخدمة المحرك، لأن المحرك ينشئ حاوية فحص واحدة ويشغّلها لكل مهمة. يمكن لأي عملية تصل إلى ذلك socket تشغيل حاوية تربط نظام ملفات المضيف. لذلك يُعد المحرك عملياً root على أي مضيف يعمل عليه.
لا توجد شاشة تسجيل دخول. تُشحن الواجهة الخلفية من دون مصادقة للتطبيق. ويعني الوصول إلى المنفذ الوصول إلى نتائج فحوصك وإلى رصيدك لدى المزوّد.
التعليمات البرمجية التي تفحصها ليست ملكك غالباً. توجيه الوكلاء إلى مستودع تابع لجهة أخرى يعني تشغيل عملية بناء ذلك المستودع على جهازك، بصلاحيات root، مع الوصول إلى الشبكة.
إذا قرأت سبب وجوب تشغيل وكلاء البرمجة داخل آلة افتراضية مؤقتة، فهذه هي طُرز التهديد نفسها، ولكن بدرجة أعلى. امنح open-kritt جهاز VPS لا يحتوي على أي شيء آخر، وشغّل ذلك VPS من خلال حساب مستخدم منفصل بأقل الصلاحيات بدلاً من root.
ما الذي يفعله open-kritt فعلياً
يقسّم open-kritt (المستودع هو Kritt-ai/open-kritt، ومرخّص بموجب AGPL-3.0) أبحاث الثغرات إلى مهام صغيرة، ويشغّل هذه المهام بالتوازي عبر وكلاء للذكاء الاصطناعي، ثم يزيل التكرارات ويرتّب النتائج. تعرّف سير العمل كسلسلة من المطالبات المركّزة، وتتلقى كل خطوة سياقاً منظماً من الخطوات السابقة. يكون هدف الفحص مستودع git بعيداً أو محلياً. ومحرك التحليل هو Codex أو Claude Code. بعد ظهور نتيجة محتملة، يمكن للبرامج النصية اللاحقة الاختيارية محاولة التحقق منها أو إنشاء إثبات مفهوم لها. يُعد تصميم هذه السلسلة عملاً اعتيادياً مع الوكلاء، وليس عملاً أمنياً. لذلك، إذا كانت المطالبات والأدوات وتمرير السياق لا تزال غير مألوفة لك، فستفيدك معرفة كيفية تركيب الوكلاء في نتائجك أكثر من أي إعداد في هذا الدليل.
ما تحصل عليه في النهاية هو قائمة مرتّبة من النتائج المحتملة. تعامل معها على أنها قائمة انتظار للفرز، لا على أنها تقرير.
ما تحتاج إليه قبل البدء
- VPS يعمل بنظام Ubuntu 24.04 أو Debian 12 أو Rocky Linux 9. تذكر وثائق التثبيت هذه التوزيعات بوصفها التوزيعات المُختبرة، على معماريتَي x86_64 وARM64.
- Docker Engine مع إضافة Compose.
- Node.js 20 أو إصدار أحدث على المضيف، لأن CLI
./krittيعمل على المضيف بدلاً من العمل داخل حاوية. - موفّر نموذج واحد: تسجيل دخول إلى Codex، أو
OPENAI_API_KEYأوCODEX_API_KEYأوANTHROPIC_API_KEYأوOPENROUTER_API_KEY. GITHUB_TOKENفقط إذا كنت تخطط لفحص المستودعات الخاصة. يوضح.env.exampleالمُضمَّن ذلك صراحةً: لا يمكن تشغيل عمليات الفحص باستخدام رمز GitHub وحده.
ثبّت Docker وNode 20 أولاً
curl -fsSL https://get.docker.com | sudo sh
sudo usermod -aG docker $USERسجّل الخروج ثم سجّل الدخول مجدداً لتطبيق عضوية المجموعة الجديدة، ثم تأكد من وجود إضافة Compose.
docker compose versionتعني سلسلة الإصدار أن Compose مثبّت كإضافة. تعني docker: 'compose' is not a docker command أن لديك بدلاً منها الملف التنفيذي المستقل القديم docker-compose، وأن open-kritt يستدعي docker compose. تعادل العضوية في مجموعة docker صلاحيات root على المضيف، لذلك أضف إليها الحساب الذي يشغّل open-kritt فقط. للاطلاع على الإصدار الأطول من هذا الإعداد، راجع تشغيل Docker على VPS.
يأتي Ubuntu 24.04 مع Node 18 في مستودعه الخاص، وتخرج واجهة CLI عند استخدام أي إصدار أقل من 20. وصل Node 20 نفسه منذ ذلك الحين إلى نهاية دورة حياته ولم يعد يتلقى تحديثات، لذلك ثبّت Node 22 من NodeSource. فهو يستوفي الفحص نفسه الذي يتطلب الإصدار 20 أو أحدث.
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
node -vيجب أن يطبع node -v القيمة v22. هنا، وسترفض واجهة CLI أي قيمة أقل من v20.. في Rocky Linux 9، البديل المكافئ هو sudo dnf module enable nodejs:22 -y ثم sudo dnf install -y nodejs.
استنسخ open-kritt وثبّت إصداراً موسوماً
git clone https://github.com/Kritt-ai/open-kritt
cd open-kritt
git fetch --tags
git tag --list
git checkout v1.4.1يتغير main باستمرار. أما الوسم فلا يتغير. اعتباراً من 12 October 2026، أحدث وسم هو v1.4.1، وقد نُشر في 16 August 2026، ويعرض git tag --list ما هو موجود في يوم الاستنساخ. أضاف v1.4.0 (12 August 2026) آلية قبول مهام التشغيل المراعية للذاكرة الموضحة في قسم تحديد الحجم أدناه، وأصلح v1.4.1 خطأً كان يجعل أداة الترتيب تتجاهل قواعد الترتيب التي يحددها المستخدم. يؤدي الانتقال إلى وسم إلى وضع المستودع في حالة detached HEAD، وهذا صحيح هنا: فأنت تتعامل مع هذا الاستنساخ على أنه نشر مثبت، وليس فرعاً ستجري عليه عمليات commit. للترقية لاحقاً، اقرأ ملاحظات الإصدار، ثم شغّل git fetch --tags، وانتقل إلى الوسم الجديد، وشغّل ./kritt start مرة أخرى، لأن start يعيد إنشاء الصور.
لا تشغّل ./kritt مع sudo. توضح الوثائق ذلك صراحةً. تدير واجهة CLI أدلة بيانات اعتماد خاصة بالمشروع ضمن .data/، ولذلك يؤدي تشغيلها بصفة root إلى جعل ملكية تلك الأدلة لـ root، فلا يستطيع التشغيل العادي التالي الكتابة فيها.
إعداد الوصول إلى النموذج باستخدام ./kritt setup
./kritt setupينشئ الأمر .env من .env.example إذا لم يكن موجوداً، ويعرض حالة كل بيانات اعتماد، ويتيح لك تعيينها أو إلغاء تعيينها. لا يعرض القيم مطلقاً في الطرفية. يُنشأ كل من .env وملف بيانات اعتماد المحرك بالوضع 0600.
إذا أردت تنفيذ ذلك يدوياً:
cp .env.example .env
chmod 600 .env
mkdir -p .data/codex
chmod 700 .data/codexبعد ذلك، حرّر مفتاح المزوّد داخل .env واترك الملف بالوضع 0600. في كلتا الحالتين، تصبح بيانات اعتماد صالحة للمزوّد موجودة على ذلك الخادم، وهذا سبب إضافي لعدم وضع أي شيء آخر على الخادم. أنشئ مفتاحاً لهذا المشروع وحده، حتى لا يؤدي إلغاؤه لاحقاً إلى تعطيل أي شيء مهم لك. يشرح إبعاد الأسرار عن متناول وكلاء الذكاء الاصطناعي هذه الممارسة على نطاق أوسع.
عيّن حداً أقصى للإنفاق لدى موفّر الخدمة قبل الفحص الأول
صُمّم open-kritt لتوزيع العمل على عدة مهام، وهذا التوزيع هو ما تدفع مقابله. الإعدادات الافتراضية في .env.example ضمن الإصدار v1.4.1 محافظة: ENGINE_WORKER_COUNT=2، وهو موصوف في الملف بأنه إعداد افتراضي محافظ لجهاز صغير مزوّد بـ2 vCPU، وENGINE_MAX_CONCURRENT_SCANS=1. وفوق ذلك يوجد ENGINE_WORKERS_PER_ACCOUNT=15، وهو الحد الأقصى لاستدعاءات النموذج الجذرية المتزامنة المسموح بها ضمن حساب موفّر خدمة واحد، وENGINE_CODEX_MAX_SUBAGENTS_PER_SESSION=5، لأن جلسة Codex قد تشغّل ما يصل إلى خمسة وكلاء فرعيين. عند زيادة عدد العاملين على VPS أكبر، يزداد معه عدد استدعاءات النموذج الجارية.
لا يفرض المستودع أي حد أقصى للإنفاق. ولا يوجد إعداد للميزانية في .env.example. شروط الإيقاف الخاصة بالمحرك هي حدود العاملين، إضافة إلى ENGINE_HARNESS_TIMEOUT_SECONDS، الذي تكون قيمته الافتراضية 7200 ثانية لكل تشغيل لـharness. المقصود بـharness هنا هو الحلقة التي تواصل استدعاء النموذج باستخدام الأدوات والسياق إلى أن ينتهي التشغيل لسبب ما. لذلك، يمثّل هذا المهلة الزمنية وقتاً فعلياً على البرنامج المحيط بالنموذج، ولا يحدّ ما ينفقه النموذج داخله. لذلك يجب أن يكون الحد الأقصى لدى موفّر الخدمة. افتح لوحة تحكم موفّر الخدمة وعيّن حداً شهرياً صارماً قبل الفحص الأول، وليس بعده. يوضّح التحكم في تكلفة وكيل الذكاء الاصطناعي على VPS إعدادات كل موفّر خدمة.
يوجد أيضاً إجراء إيقاف محلي. يؤدي ضبط ENGINE_WORKER_COUNT=0 إلى إيقاف التقاط المهام الجديدة مؤقتاً. ويمكنك تغيير قيم العاملين نفسها من شاشة Settings بعد تشغيل المكدس.
لا يذكر هذا الدليل سعراً لكل فحص، لأن التكلفة تعتمد على حجم المستودع، وسير العمل الذي تنشئه، والنموذج المستخدم. شغّل فحصاً واحداً على مستودع صغير واحد، ثم راجع صفحة الاستخدام لدى موفّر الخدمة قبل توجيهه إلى أي مستودع كبير.
شغّل الحزمة وتحقق من سلامتها
./kritt startيتحقق ذلك من .env ومن بيانات اعتماد واحدة على الأقل، ثم يشغّل docker compose up --build. يستغرق البناء الأول وقتاً طويلاً لأنه يبني صور الواجهة الأمامية والواجهة الخلفية والمحرك وواجهة التنفيذ وقاعدة البيانات. كما أنه يعمل في الواجهة الأمامية، لذلك يؤدي إغلاق جلسة SSH إلى إيقاف الحزمة. شغّله داخل tmux، أو شغّله في وضع منفصل بعد نجاح البناء الأول. لا يستمر أي من الخيارين بعد إعادة التشغيل تلقائياً. لذلك، إذا أردت تشغيل الحزمة مجدداً بعد إعادة تشغيل الخادم، فإن نمط وحدة systemd الوارد في الحفاظ على تشغيل وكيل مستضاف ذاتياً عبر عمليات إعادة التشغيل ينتقل مباشرة إلى هذه الحالة.
docker compose up -d --build
docker compose psيجب أن يعرض docker compose ps كلاً من open-kritt-frontend وopen-kritt-backend وopen-kritt-engine وopen-kritt-executor-view وopen-kritt-db. ثم تحقق من أن الواجهة الخلفية تستجيب على الخادم نفسه.
curl -s http://127.0.0.1:3002/api/healthتعني استجابة JSON أن الواجهة الخلفية تعمل. أما Failed to connect to 127.0.0.1 port 3002: Connection refused فتعني أنها لا تعمل، وسيبيّن docker compose logs backend السبب. أوقف كل شيء باستخدام docker compose down من دليل المستودع.
خيار إضافي واحد: يحمّل docker compose exec backend npm run seed بيانات تجريبية، وهي طريقة بسيطة لعرض الواجهة قبل أن تنفق أي مبلغ على فحص حقيقي.
الوصول إلى الواجهة على المنفذ 5173 عبر نفق SSH
ترتبط كل خدمة في ملف compose بالعنوان 127.0.0.1 افتراضياً: الواجهة الأمامية على المنفذ 5173، والواجهة الخلفية على المنفذ 3002، وعرض المنفّذ على المنفذ 8090، وPostgres على المنفذ 5432. اترك عمليات الارتباط هذه كما هي، وأعد توجيه المنفذ عبر SSH من جهازك.
ssh -N -L 5173:127.0.0.1:5173 you@your-server-ipافتح http://localhost:5173 في المتصفح المحلي لديك أثناء تشغيل هذا الأمر. يعني -N أن الاتصال ينفّذ إعادة التوجيه من دون فتح shell. أضف -L 8090:127.0.0.1:8090 ثانية إلى الأمر نفسه عندما تريد الوصول إلى عرض المنفّذ أيضاً.
قد تميل إلى ضبط FRONTEND_BIND_ADDRESS=0.0.0.0 وتجاوز النفق. لا تفعل ذلك. لا تحتوي الواجهة الخلفية على شاشة تسجيل دخول، ولذلك يستطيع أي شخص يصل إلى تلك الصفحة بدء عمليات الفحص واستهلاك رصيد مزوّد الخدمة لديك. للمقارنة، صُمّم Vaultwarden ليكون متاحاً عبر الإنترنت، ولا يزال تأمينه يعتمد على الرمز المميز للمسؤول وملف النسخ الاحتياطي، وهما وسيلتان لا يوفّرهما open-kritt لك. وتوجد مشكلة ثانية خفية: تتم معالجة منفذ الحاوية المنشور قبل تطبيق السياسة الافتراضية لـufw، ولذلك تبدو قاعدة ufw deny 5173 صحيحة لكنها لا تحظر أي شيء. يوضّح منافذ Docker التي تتجاوز ufw سلسلة القواعد التي تسبب ذلك.
تحديد حجم VPS
تكون القيمة الافتراضية لـ ENGINE_MIN_FREE_STORAGE_GB هي 20، ويرفض المحرك بدء حاوية فحص جديدة لكل مهمة عندما تنخفض مساحة التخزين الحرة عن هذه القيمة. توجد الصور المبنية، وذاكرة التخزين المؤقت لعمليات checkout، وبيانات Postgres، ومساحات عمل المهام على القرص نفسه، لذلك لا يبدأ VPS بسعة 20 GB أي فحص على الإطلاق. اعتبر 40 GB الحد الأدنى، وزِد السعة إذا كنت تفحص مستودعات كبيرة. لا تحاول استعادة تكلفة الخادم بوضع خدمة تستهلك مساحة تخزين كبيرة بجانبه، لأن الحدين المقاسين للذاكرة ولقرص التخزين في هذه المقارنة بين PhotoPrism وImmich يوضحان مدى سرعة استهلاك مكتبة الوسائط للمساحة اللازمة للفحص. وينطبق الأمر نفسه على الإضافات الزخرفية التي تبدو خفيفة بجانب أداة الفحص: واجهة أمامية للمتصفح تعيد تصميم مكتبة Jellyfin كمتجر تأجير من التسعينيات تجر معها خادم وسائط كاملاً وعمليات transcoding الخاصة به إلى القرص، لذلك ضعها على مضيف مختلف.
تتبع الذاكرة حساباً بسيطاً، وقد وصلت الإعدادات المرتبطة بها في v1.4.0، لذلك تنطبق على الوسم المثبت أعلاه، ولا تنطبق على الوسوم الأقدم. يحتجز ENGINE_MEMORY_RESERVE_GB=2 الذاكرة للمحرك وقاعدة البيانات وواجهة API والعبء المؤقت قصير الأجل. يحمل كل مشغّل فحص بعد ذلك حجزاً مبدئياً قدره ENGINE_SCAN_RUNNER_MEMORY_RESERVATION_MB=1536 وحداً أقصى صارماً قدره ENGINE_SCAN_RUNNER_MEMORY_MB=1536. لذلك يحتاج مشغّلان إلى نحو 5 GB قبل تشغيل أي شيء آخر. لا يسمح المحرك إلا بالمشغّلات التي تتسع لها الميزانية المتبقية، لذلك تنتظر عمليات الفحص في قائمة الانتظار بدلاً من فشلها على خادم صغير. وهذا أفضل بكثير من أن ينهيها قاتل نفاد الذاكرة. ويحدد الحساب نفسه الحد الأدنى لأي أداة تمنح كل وحدة عمل حاويتها الخاصة، ولهذا تصل حاوية OpenBot الواحدة ومتصفح واحد لكل زميل AI إلى حد الذاكرة قبل أن تصل إلى حد CPU بوقت طويل.
تكون إعدادتا prune مضبوطتين على true افتراضياً: ENGINE_AUTO_PRUNE_DOCKER_BUILD_CACHE وENGINE_AUTO_PRUNE_UNUSED_DOCKER_IMAGES. بعد اكتمال مهمة، يزيل المحرك ذاكرة التخزين المؤقت غير المستخدمة للبناء، والصور غير المستخدمة، وحاويات الفحص المتوقفة. ويحتفظ بالصور التي تشير إليها أي حاوية، وحاويات الخدمات، وbind mounts، وبيانات قاعدة البيانات، وبيانات الاعتماد، وvolumes. وهذا سبب إضافي لعدم مشاركة المضيف: إذ تعمل أداة prune لم تضبطها أنت على Docker daemon نفسه.
إعدادات المحرك التي ينتهي معظم المستخدمين إلى تغييرها
ENGINE_WORKER_COUNT: إجمالي خانات العمال المشتركة بين خطوات الفحص والمعالجة اللاحقة. اضبطها على 0 لإيقاف التقاط المهام الجديدة مؤقتاً.ENGINE_MAX_CONCURRENT_SCANS: عدد عمليات الفحص التي يُسمح بها في الوقت نفسه. تنتظر عمليات الفحص في قائمة الانتظار حتى تصبح مجموعة العمليات النشطة فارغة.ENGINE_MAX_WORKERS_PER_SCAN: تؤدي القيمة 0 إلى توزيع الخانات الإجمالية بالتساوي بين عمليات الفحص.ENGINE_HARNESS_TIMEOUT_SECONDS: قيمتها الافتراضية 7200. وهذه أطول مدة يمكن أن تستمر فيها مهمة واحدة خارجة عن السيطرة. يقبل المحرك القيم من 60 إلى 86400، وأي قيمة خارج هذا النطاق، بما في ذلك 0، تعود إلى 7200.ENGINE_MIN_FREE_STORAGE_GB: الحد الأدنى لمساحة التخزين. يؤديENGINE_IGNORE_LOW_STORAGE=trueإلى تعطيل إجراء الحماية، ويحذّر الملف من أن ذلك قد يملأ قرص المضيف.ENGINE_SCAN_RUNNER_MEMORY_MB: الحد الأقصى الصارم للذاكرة لكل مشغّل. تؤدي القيمة 0 إلى إزالة الحد.ENGINE_SCAN_RUNNER_MEMORY_RESERVATION_MB: الحجز المبدئي لكل مشغّل، والذي يستخدمه قرار السماح بالتشغيل. يؤدي خفضه إلى حجز أقل من الذاكرة الخاملة المتاحة، بينما يظل الحد الأقصى الصارم محتجزاً للارتفاعات المفاجئة.
فحص مستودع محلي دون تسريبه
يكون LOCAL_REPOS_PATH مضبوطاً افتراضياً على ./local_repos، ويُربط داخل حاويتي backend وengine بصلاحية القراءة فقط. لذلك يظهر أي مستودع تضعه في ذلك المجلد على المضيف داخل الحاويات فوراً. استخدم نسخة مستنسخة حديثاً، وليس شجرة العمل الخاصة بك. تحصل حاوية المهمة على نسخة قابلة للكتابة، وتعمل بصلاحية root داخلها، وتملك وصولاً إلى الإنترنت الصادر. وهذا يعني أنه يمكن تغيير أي شيء موجود في تلك النسخة أو إرساله خارج الخادم. احذف ملفات .env والمفاتيح الخاصة قبل نسخ المشروع إليها.
ما تحصل عليه وما لا تحصل عليه
تحصل على نتائج مرشحة مرتبة. لا تحصل على ثغرات تم التحقق منها. يحدد الترتيب وإزالة التكرار ترتيب قائمة انتظار الفرز لديك. لكنهما لا يثبتان أن الإدخال حقيقي. يمكن لبرامج ما بعد المعالجة محاولة التحقق وإنشاء إثبات مفهوم. وهذه أقوى إشارة توفرها الأداة. لكن فشل برنامج ما بعد المعالجة لا يثبت أن النتيجة خاطئة. يقرأ شخص كل نتيجة مرشحة على أي حال. هذه الفجوة بين النتيجة المرشحة والإثبات هي سبب أهمية طلب دليل من وكيل يمكنك إعادة تشغيله بنفسك هنا أيضاً: فالنتيجة التي يمكنك إعادة إنتاجها عند الطلب أهم من نتيجة مرتبة يجب أن تثق بها دون تحقق.
لا يزعم هذا الدليل عدد الأخطاء الحقيقية التي يعثر عليها open-kritt، لأننا لم نقس ذلك. ومن يذكر معدل اكتشاف لقاعدة التعليمات البرمجية لديك لم يشغّل الأداة على قاعدة التعليمات البرمجية لديك. افحص أولاً مستودعاً تعرفه جيداً: فالنتائج التي يمكنك تقييمها بنفسك هي أرخص وسيلة متاحة لمعايرة الأداة.
يكون التفويض أكثر أهمية هنا من معظم الأدوات المستضافة ذاتياً. إذ يترجم الوكلاء التعليمات البرمجية وينفذونها ويتصلون بالشبكة، ولذلك قد تلامس خطوة إثبات المفهوم أنظمة حية. وجّه الأداة إلى تعليمات برمجية تملكها أو أنت متعاقد لاختبارها، واكتب نطاق الهدف قبل تشغيل أي شيء. إذا ضبطت ANTHROPIC_API_KEY واستخدمت محرك Claude Code، فإن ممارسات العزل المتبعة في تشغيل Claude Code بأمان على VPS تنطبق على هؤلاء الوكلاء أيضاً.
FAQ
لماذا يحتاج open-kritt إلى VPS خاص به؟
لأن وكلاء التحليل يعملون بصلاحيات root داخل حاويات مهام مؤقتة تحتوي على نسخ قابلة للكتابة من شيفرتك وتتمتع بوصول مباشر إلى الإنترنت. كما أن خدمة المحرك تربط Docker socket على المضيف حتى تتمكن من تشغيل حاوية لكل مهمة. يمكن لأي عملية تصل إلى ذلك الـsocket تشغيل حاوية تربط نظام ملفات المضيف. لذلك يجب التعامل مع المكدس بالكامل على أنه يعمل بصلاحيات root على مضيفه. يكون ذلك مقبولاً على VPS مخصص، كما أن إعادة بناء الخادم لا تكلّفك شيئاً. أما على محطة العمل التي تستخدمها يومياً، فستصبح مفاتيح SSH وملفات تعريف المتصفح ضمن حد الثقة نفسه مع الشيفرة التي تفحصها.
هل يمكنني تعريض المنفذ 5173 بدلاً من استخدام نفق SSH؟
لا ينبغي لك ذلك. تُشغّل النسخة الموزعة من الواجهة الخلفية من دون مصادقة على مستوى التطبيق. لذلك يكون المنفذ هو الحاجز الوحيد بين الإنترنت ونتائج الفحص ورصيد المزوّد. يربط ملف compose كل خدمة بالعنوان 127.0.0.1 لهذا السبب. شغّل ssh -N -L 5173:127.0.0.1:5173 you@your-server-ip وافتح http://localhost:5173 محلياً بدلاً من ذلك. لا تُعد قاعدة ufw بديلاً مناسباً، لأن Docker يتعامل مع المنفذ المنشور قبل تطبيق السياسة الافتراضية لـufw.
كيف أمنع open-kritt من إنفاق مبلغ يتجاوز ما خططت له؟
عيّن حداً صارماً في وحدة تحكم مزوّد النموذج قبل إجراء الفحص الأول، لأن open-kritt لا يوفّر إعداداً خاصاً بالميزانية. أبقِ إعدادات التزامن الافتراضية الموزعة كما هي خلال عمليات التشغيل الأولى، ENGINE_WORKER_COUNT=2 وENGINE_MAX_CONCURRENT_SCANS=1، وتذكّر أن حساب المزوّد الواحد يسمح افتراضياً بما يصل إلى 15 استدعاءً متزامناً لنموذج root، بينما قد تشغّل جلسة Codex ما يصل إلى خمسة وكلاء تابعين. يوقف ENGINE_WORKER_COUNT=0 التقاط المهام الجديدة، وهو أسرع إجراء إيقاف محلي.
ما الإصدار الذي ينبغي أن أستخرجه؟
استخدم tag، وليس main. يعرض git fetch --tags متبوعاً بـgit tag --list ما هو متاح، ويُعد v1.4.1، المنشور في 16 August 2026، أحدث إصدار حتى 12 October 2026. يضمن التثبيت أن تؤدي إعادة البناء بعد أشهر إلى إنتاج المكدس نفسه. كما يجعل الترقية قراراً تتخذه بعد قراءة ملاحظات الإصدار، بدلاً من أن تكون أثراً جانبياً لاستنساخ المستودع في يوم مختلف.
لا يبدأ الفحص أبداً. ما الذي ينبغي أن أتحقق منه؟
تحقق أولاً من مساحة القرص الحرة، لأن المحرك لن يشغّل حاوية فحص خاصة بالمهمة عندما تقل مساحة التخزين الحرة عن ENGINE_MIN_FREE_STORAGE_GB، وقيمته الافتراضية 20 GB. ثم تحقق من أن قيمة ENGINE_WORKER_COUNT ليست 0، لأن هذه القيمة توقف التقاط المهام الجديدة. بعد ذلك، تأكد من إعداد بيانات اعتماد النموذج فعلياً عبر تشغيل ./kritt setup، لأن وجود GITHUB_TOKEN وحده لا يكفي لتشغيل عمليات الفحص. يوضح docker compose logs engine سبب تخطي المهمة.