موقع يُرجع خطأ 502. وبدلًا من نسخ السجلات إلى روبوت دردشة، تطلبون من وكيل ذكاء اصطناعي على الخادم فحص الملفات ذات الصلة وشرح المشكلة. هذا أحد الاستخدامات العملية لـ Codex CLI على VPS بنظام Linux.
يغطي هذا الدليل التثبيت، وتسجيل الدخول من جلسة SSH، ومهمة أولى بصلاحيات مقيّدة. ثم نشرح الاختبار الحقيقي الذي يقف وراء الفيديو الخاص بنا: حيث حدّد Codex عدم تطابق في المنفذ على موقع تجريبي معطَّل عمدًا.
ما الذي يعمل وأين: وكيل Codex وأدوات سطر الأوامر الخاصة به يعملان على VPS لديكم. أما مع إعداد OpenAI الموصوف هنا، فيعمل نموذج الذكاء الاصطناعي في سحابة OpenAI. تحتاجون إلى حساب ChatGPT مؤهَّل خاص بكم أو وصول إلى OpenAI API بفوترة منفصلة. ولا يشمل VPS من SharpHeberg هذا الوصول.
قبل أن تبدؤوا
- VPS بنظام Linux يمكنكم الوصول إليه عبر SSH، مع وصول HTTPS صادر. أوامر الحزم أدناه موجَّهة لـ Debian وUbuntu.
- مستخدم Linux عادي مع توفر sudo لتثبيت حزم النظام. شغّلوا Codex بهذا المستخدم، وليس بصفة root.
- حساب OpenAI مع وصول إلى Codex. تحققوا من التوفر الحالي لخطتكم وحدودها؛ ففوترة API منفصلة عن اشتراك ChatGPT.
- مشروع تجريبي أو بيئة staging. أبقوا بيانات اعتماد الإنتاج وملفات العملاء غير ذات الصلة خارج الحساب ومساحة العمل التي يصل إليهما الوكيل.
لا تحتاجون إلى استضافة أوزان النموذج ولا إلى توفير GPU لسير العمل المعتمد على السحابة هذا. أما الموارد التي تستهلكها مشاريعكم وأدوات البناء والخدمات فتبقى مهمة عند اختيار VPS.
نطاق التحقق: أُجري عرضنا التشخيصي على VPS بنظام Debian 12 مخصّص للتجارب باستخدام Codex CLI 0.164.0. استخدمت تلك التجربة المعزولة حساب تشخيص ذا صلاحيات مرتفعة؛ وليس هذا إعداد الحساب الذي نوصي به للإنتاج. كما فحصنا المثبّت المستقل الرسمي في مجلد تثبيت معزول على Linux x86-64، وتحققنا من إصدار CLI وخياري تسجيل الدخول وsandbox. لم نختبر كل إصدار من Ubuntu ولا كل إعداد لـ VPS.
1. اتصلوا بـ VPS الخاص بكم
من حاسوبكم، اتصلوا بحساب SSH الحالي لديكم غير الجذري (non-root). استبدلوا المستخدم والعنوان المثاليين:
ssh youruser@YOUR_VPS_IP
إذا كان خادمكم لا يحتوي إلا على حساب root، فأنشئوا حسابًا منفصلًا وتحققوا منه أولًا باتباع تعليمات إدارة نظام التشغيل لديكم. ينبغي ألا تمنحوا وكيل ذكاء اصطناعي صدفة root لمجرد البدء.
على Debian أو Ubuntu، ثبّتوا أدوات التنزيل والمشاريع المستخدمة في هذا الدليل:
sudo apt update
sudo apt install ca-certificates curl git less
تثبّت هذه الأوامر حزم نظام؛ وهي لا ترقّي الخادم بأكمله ولا تغيّر جدار الحماية لديكم.
2. ثبّتوا Codex CLI
توثّق OpenAI مثبّتًا مستقلًا لأنظمة macOS وLinux، إضافةً إلى بديلين عبر npm وHomebrew. لا يتطلب المسار المستقل تثبيت Node.js وnpm أولًا. راجعوا دليل التثبيت الرسمي لـ Codex CLI.
نزّلوا المثبّت إلى مجلدكم الخاص لتتمكنوا من فحصه قبل تشغيله:
mkdir -p "$HOME/codex-setup"
curl -fsSL https://chatgpt.com/codex/install.sh -o "$HOME/codex-setup/install.sh"
less "$HOME/codex-setup/install.sh"
اضغطوا q للخروج من less. بعد مراجعة السكربت، شغّلوه بصفة مستخدمكم العادي:
sh "$HOME/codex-setup/install.sh"
export PATH="$HOME/.local/bin:$PATH"
codex --version
codex --help
يعتمد المثبّت الرسمي افتراضيًا المسار ~/.local/bin ويدير حزمته المستقلة ضمن مجلد مستخدم Codex لديكم. وقد يحدّث ملف بدء تشغيل الصدفة لديكم. أعيدوا فتح الطرفية عند الطلب؛ كما أن الأمر export أعلاه يتيح موقع التثبيت الافتراضي في الجلسة الحالية.
إذا فشل رابط التنزيل المختصر: مصدر المثبّت متاح أيضًا في مستودع OpenAI Codex الرسمي. نزّلوا ذلك المصدر وافحصوه، ثم استخدموا خطوات التثبيت نفسها:
curl -fsSL https://raw.githubusercontent.com/openai/codex/main/scripts/install/install.sh -o "$HOME/codex-setup/install.sh"
less "$HOME/codex-setup/install.sh"
sh "$HOME/codex-setup/install.sh"
لا تستبدلوا هذا بسكربت من مرآة مجهولة. وإذا فشل تنزيل الملف التنفيذي نفسه، فتوثّق OpenAI المتغير CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false لاختيار GitHub Releases:
CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false sh "$HOME/codex-setup/install.sh"
وإذا كنتم تديرون بالفعل تثبيتًا مدعومًا لـ Node.js/npm، فإن بديل npm الموثّق هو npm install -g @openai/codex. اختاروا طريقة تثبيت واحدة بدلًا من الخلط بين عدة طرق ثم التساؤل أي codex موجود في PATH.
3. سجّلوا الدخول من خادم بلا واجهة رسومية
لا يملك VPS لديكم عادةً متصفح سطح مكتب. توصي OpenAI بالمصادقة برمز الجهاز (device-code) في هذه الحالة:
codex login --device-auth
افتحوا الرابط الظاهر في الطرفية على حاسوبكم أو هاتفكم، وسجّلوا الدخول، وأدخلوا الرمز لمرة واحدة. قد تحتاجون أولًا إلى تفعيل تسجيل الدخول برمز الجهاز في إعدادات الأمان في ChatGPT، أو أن يسمح به مسؤول مساحة العمل لديكم. لا ترسلوا هذا الرمز إلى أي شخص آخر.
ثم تحقّقوا من طريقة المصادقة:
codex login status
وإذا لم يكن تسجيل الدخول برمز الجهاز متاحًا، فتوثّق OpenAI أيضًا نفق SSH لتدفق تسجيل الدخول العادي عبر المتصفح. ابدؤوا هذا الاتصال من حاسوبكم:
ssh -L 1455:localhost:1455 youruser@YOUR_VPS_IP
داخل جلسة SSH تلك، شغّلوا codex login وافتحوا رابط تسجيل الدخول في متصفحكم المحلي. يمرّر هذا نداء الرجوع (callback) على localhost دون كشف منفذ مصادقة للعموم. راجعوا تعليمات OpenAI لتسجيل الدخول على الأجهزة بلا واجهة إذا كانت بيئتكم تستخدم إعداد callback مختلفًا.
استخدام مفتاح API بدلًا من ذلك
إذا كنتم تفضّلون الوصول عبر API بالدفع حسب الاستخدام، فوفّروا مفتاح OpenAI API الخاص بكم بأمان كمتغير بيئة، ثم مرّروه عبر الدخل القياسي:
printenv OPENAI_API_KEY | codex login --with-api-key
لا تلصقوا مفتاح API حرفيًا في أمر محفوظ في سجل الصدفة. تُفوتر استخدامات API عبر حسابكم على OpenAI Platform، ولا تُخصم من فاتورة استضافة VPS. تعاملوا مع بيانات الاعتماد المخزَّنة لدى Codex كما تتعاملون مع كلمات المرور، وأبقوها خارج المستودعات ولقطات الشاشة وتذاكر الدعم. يشرح دليل المصادقة الرسمي الطريقتين.
4. ابدؤوا بمهمة للقراءة فقط
انتقلوا إلى مشروع تجريبي تفهمون ملفاته. وإن لم يكن لديكم، فيكفي مجلد فارغ لفتح CLI واستكشاف الواجهة:
mkdir -p "$HOME/codex-first-session"
cd "$HOME/codex-first-session"
codex --sandbox read-only --ask-for-approval on-request
في مستودع اختبار حقيقي، يكون الموجّه الأول المفيد:
Explain how this project starts. Read the relevant configuration and README files, identify the entry point, and list anything you cannot verify. Do not change files or install packages.
يقيّد read-only الأوامر التي يولّدها النموذج عبر الـ sandbox المضبوط. ويتيح on-request للنموذج طلب موافقة إضافية؛ وهذا لا يعني أن كل أمر يتطلب تأكيدًا تلقائيًا. اقرؤوا أي طلب لرفع الصلاحيات قبل أن تقرروا السماح به.
عبارة «لا تغيّر أي شيء» في الموجّه ليست حدًّا أمنيًا بمفردها. استخدموا حسابًا مخصّصًا وبيئة اختبار، وقيّدوا البيانات المتاحة، وافحصوا الصلاحيات التي يعرضها إصداركم المثبَّت. فالوصول للقراءة فقط قد يكشف محتويات الملفات القابلة للقراءة لخدمة النموذج.
راجعوا codex --help ومرجع أوامر CLI قبل نسخ علامات (flags) من درس أقدم. وتجنّبوا تجاوز الـ sandbox أو الموافقات للالتفاف على خطأ في التثبيت.
5. انتقلوا من الشرح إلى مهمة مفيدة على الخادم
خطوة تالية معقولة هي منح Codex نطاق تشخيص صغيرًا وصريحًا. جهّزوا نسخًا منقّاة من السجلات والإعدادات ذات الصلة داخل مجلد اختبار، ثم اطلبوا:
This demo site returns HTTP 502. Inspect only the supplied nginx configuration, application entry point and error log. Explain the cause and propose the smallest fix. Do not edit files, install packages or restart services.
راجعوا التغيير المقترح قبل تطبيقه بأنفسكم. وبالنسبة إلى خدمة حقيقية، خذوا نسخة احتياطية من الإعدادات، وتحققوا منها بأداة الفحص الخاصة بالخدمة نفسها، وجهّزوا خطة تراجع. شرح الذكاء الاصطناعي ليس دليلًا على أن التغيير آمن للإنتاج.
ما حدث في عرضنا التوضيحي
أعددنا عمدًا موقعًا تجريبيًا بشكل خاطئ على VPS مخصّص للتجارب. كان Nginx يمرّر الطلبات إلى المنفذ 3000، بينما كان التطبيق يستمع على 3001. وأرجع الموقع الخطأ HTTP 502.
فحص Codex الإعدادات والتطبيق وسجل الأخطاء المحددة في وضع القراءة فقط. وحدّد عدم التطابق واقترح تصحيحًا من سطر واحد في نحو 22 ثانية، دون تعديل الملفات المقدَّمة. طبّق مشغّل الإنتاج لدينا ذلك الاقتراح، وفحص إعدادات nginx، وأعاد تحميل الخدمة، وتحقق من استجابة HTTP 200.
كان هذا اختبارًا واحدًا منضبطًا بخلل معروف أُدخل عمدًا. وهو ليس معيارًا قياسيًا (benchmark)، ولا ضمانًا لزمن الإصلاح، ولا عرضًا لاستعادة الإنتاج دون إشراف.
إذا لم ينجح شيء
codex: command not found: أعيدوا فتح الطرفية، وافحصواcommand -v codex، وتأكدوا من وجود مجلد المثبّت في PATH.- رابط المثبّت أو التنزيل محجوب: استخدموا مصدر المستودع الرسمي واختيار GitHub Releases الموثّق أعلاه. لا تعطّلوا التحقق من TLS.
- تعذّر فتح متصفح لتسجيل الدخول: استخدموا تسجيل الدخول برمز الجهاز أو نفق SSH الموثّق. لا تنشروا منافذ مصادقة localhost.
- بلغتم حد الاستخدام: افحصوا الحساب وطريقة المصادقة المعروضة بالأمر
codex login status. فتثبيت CLI أو شراء VPS لا يزيل حدود استخدام OpenAI. - أخطاء الـ sandbox أو أدوات المساعدة: أبقوا حزمة التثبيت الرسمية كاملة معًا وتحققوا من دعم توزيعتكم لآليات العزل المطلوبة. وقد تفرض الحاوية أو VPS المقيَّد قيودًا إضافية. لا تحلّوا ذلك بتشغيل Codex بصفة root أو بتعطيل ضماناته.
شاهدوا العرض التوضيحي، ثم جرّبوه على VPS الخاص بكم
يتابع الفيديو المرافق لدينا مثال التشخيص من الموقع المعطَّل حتى الاستجابة المتحقَّق منها. وهو يوضح ما يمكن للوكيل المثبَّت أن يساعدكم في التحقيق فيه؛ أما أوامر التثبيت فموجودة في هذا الدليل.
عرض توضيحي منضبط على VPS تجريبي مخصّص للتجارب: يقترح Codex الإصلاح، ويطبّقه مشغّلنا ويتحقق منه. شاهدوا العرض التوضيحي على YouTube.
ابدؤوا بمشروع تجريبي، وأبقوا صلاحيات الوكيل ضيقة، وتحققوا من كل نتيجة. وإذا كنتم بحاجة إلى خادم لمساحة العمل تلك، فـاستكشفوا خطط VPS Linux من SharpHeberg. يبقى حساب OpenAI واستخدامه منفصلين عن خدمة الاستضافة.