אתר מחזיר שגיאת 502. במקום להעתיק לוגים לצ'אטבוט, אתם מבקשים מסוכן AI בשרת לבדוק את הקבצים הרלוונטיים ולהסביר את הבעיה. זה שימוש מעשי אחד ב-Codex CLI על VPS של Linux.
המדריך הזה מכסה את ההתקנה, ההתחברות מתוך סשן SSH ומשימה ראשונה עם הרשאות מוגבלות. לאחר מכן נסביר את הבדיקה האמיתית שמאחורי הסרטון שלנו: Codex זיהה אי-התאמה בפורטים באתר הדגמה שהושבת במכוון.
מה רץ איפה: סוכן Codex וכלי שורת הפקודה שלו רצים על ה-VPS שלכם. עם ההגדרה של OpenAI המתוארת כאן, מודל ה-AI רץ בענן של OpenAI. אתם זקוקים לחשבון ChatGPT זכאי משלכם או לגישת API של OpenAI בחיוב נפרד. VPS של SharpHeberg אינו כולל גישה זו.
לפני שמתחילים
- VPS של Linux שאפשר לגשת אליו דרך SSH, עם גישת HTTPS יוצאת. פקודות החבילות שלהלן מיועדות ל-Debian ול-Ubuntu.
- משתמש Linux רגיל עם sudo זמין להתקנת חבילות מערכת. הריצו את Codex כמשתמש הזה, לא כ-root.
- חשבון OpenAI עם גישה ל-Codex. בדקו את הזמינות והמגבלות העדכניות של החבילה שלכם; חיוב ה-API נפרד ממנוי ChatGPT.
- פרויקט בדיקה או סביבת staging. השאירו פרטי גישה לפרודקשן וקבצי לקוחות שאינם קשורים מחוץ לחשבון ולסביבת העבודה הנגישים לסוכן.
אינכם צריכים לארח את משקולות המודל או להקים GPU עבור זרימת העבודה הזו המבוססת ענן. המשאבים שהפרויקטים, כלי ה-build והשירותים שלכם צורכים עדיין חשובים בבחירת VPS.
היקף האימות: הדגמת האבחון שלנו רצה על VPS זמני עם Debian 12 באמצעות Codex CLI 0.164.0. הניסוי המבודד הזה השתמש בחשבון אבחון בעל הרשאות מורחבות; זו אינה הגדרת החשבון שאנו ממליצים עליה לפרודקשן. בדקנו גם את מתקין ה-standalone הרשמי בתיקיית התקנה מבודדת של Linux x86-64 ואימתנו את גרסת ה-CLI ואת אפשרויות ההתחברות וה-sandbox. לא בדקנו כל גרסת Ubuntu או כל תצורת VPS.
1. התחברו ל-VPS שלכם
מהמחשב שלכם, התחברו עם חשבון ה-SSH הקיים שלכם שאינו root. החליפו את המשתמש והכתובת לדוגמה:
ssh youruser@YOUR_VPS_IP
אם בשרת שלכם יש רק חשבון root, צרו ואמתו תחילה חשבון נפרד לפי הוראות הניהול של מערכת ההפעלה שלכם. אסור לתת לסוכן AI shell של root רק כדי להתחיל.
ב-Debian או ב-Ubuntu, התקינו את כלי ההורדה והפרויקט המשמשים במדריך הזה:
sudo apt update
sudo apt install ca-certificates curl git less
הפקודות האלה מתקינות חבילות מערכת; הן אינן משדרגות את כל השרת ואינן משנות את חומת האש שלכם.
2. התקינו את Codex CLI
OpenAI מתעדת מתקין standalone ל-macOS ול-Linux, וכן חלופות npm ו-Homebrew. מסלול ה-standalone אינו מחייב אתכם להתקין תחילה 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 ומנהל את חבילת ה-standalone שלו תחת תיקיית המשתמש של Codex. הוא עשוי לעדכן את קובץ ההפעלה של ה-shell שלכם. פתחו מחדש את הטרמינל כשתתבקשו; גם ה-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. התחברו משרת headless
ל-VPS שלכם בדרך כלל אין דפדפן שולחני. OpenAI ממליצה במצב כזה על אימות באמצעות device-code:
codex login --device-auth
פתחו את הקישור שמופיע בטרמינל במחשב שלכם או בטלפון, התחברו והזינו את הקוד החד-פעמי. ייתכן שתצטרכו קודם להפעיל התחברות device-code בהגדרות האבטחה של ChatGPT, או לבקש ממנהל סביבת העבודה שלכם לאפשר זאת. לעולם אל תשלחו את הקוד הזה למישהו אחר.
לאחר מכן בדקו את שיטת האימות:
codex login status
אם התחברות device-code אינה זמינה, OpenAI מתעדת גם מנהרת SSH לתהליך ההתחברות הרגיל בדפדפן. התחילו את החיבור הזה מהמחשב שלכם:
ssh -L 1455:localhost:1455 youruser@YOUR_VPS_IP
בתוך סשן ה-SSH הזה, הריצו codex login ופתחו את קישור ההתחברות שלו בדפדפן המקומי שלכם. כך מועבר ה-callback של localhost בלי לחשוף פורט אימות באופן ציבורי. עיינו בהוראות ההתחברות ל-headless של OpenAI אם הסביבה שלכם משתמשת בתצורת callback אחרת.
שימוש במפתח API במקום זאת
אם אתם מעדיפים גישת API מבוססת שימוש, הקצו בצורה מאובטחת מפתח API משלכם של OpenAI כמשתנה סביבה, ואז העבירו אותו דרך קלט סטנדרטי:
printenv OPENAI_API_KEY | codex login --with-api-key
אל תדביקו מפתח API מילולי בפקודה שנשמרת בהיסטוריית ה-shell. השימוש ב-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 מאפשר למודל לבקש אישור נוסף; זה אינו אומר שכל פקודה דורשת אישור אוטומטית. קראו כל בקשת הסלמה לפני שתחליטו אם לאשר.
הנחיה שאומרת “do not change anything” אינה גבול אבטחה בפני עצמה. השתמשו בחשבון ייעודי ובסביבת בדיקה, הגבילו את הנתונים הנגישים ובדקו את ההרשאות שמציגה הגרסה המותקנת שלכם. גישת קריאה בלבד עדיין עשויה לחשוף את תוכן הקבצים הקריאים לשירות המודל.
בדקו את codex --help ואת מדריך הפקודות של ה-CLI לפני שתעתיקו דגלים ממדריך ישן. הימנעו מעקיפת ה-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.
עברו על השינוי המוצע לפני שתחילו אותו בעצמכם. בשירות אמיתי, גבו את ההגדרות, אמתו אותן באמצעות הבדיקה של השירות עצמו והכינו תוכנית שחזור. הסבר של AI אינו הוכחה לכך ששינוי בטוח לפרודקשן.
מה קרה בהדגמה שלנו
הגדרנו בכוונה בצורה שגויה אתר הדגמה על VPS זמני. Nginx העביר בקשות לפורט 3000, בעוד שהאפליקציה האזינה ל-3001. האתר החזיר HTTP 502.
Codex בדק את ההגדרות, האפליקציה ויומן השגיאות שנבחרו במצב קריאה בלבד. הוא זיהה את אי-ההתאמה והציע תיקון בשורה אחת תוך כ-22 שניות, בלי לערוך את הקבצים שסופקו. מפעיל הפרודקשן שלנו יישם את ההצעה, בדק את הגדרות nginx, טען מחדש את השירות ואימת תגובת HTTP 200.
זה היה מבחן מבוקר אחד עם תקלה ידועה שהוכנסה בכוונה. זה אינו benchmark, אינו הבטחה לזמן תיקון, ואינו הדגמה של התאוששות בפרודקשן ללא השגחה.
אם משהו לא עובד
codex: command not found: פתחו מחדש את הטרמינל, בדקו אתcommand -v codexוודאו שתיקיית המתקין נמצאת ב-PATH שלכם.- כתובת המתקין או ההורדה חסומה: השתמשו במקור המאגר הרשמי ובבחירת GitHub Releases המתועדת שלמעלה. אל תבטלו את אימות ה-TLS.
- ההתחברות לא יכולה לפתוח דפדפן: השתמשו בהתחברות device-code או במנהרת ה-SSH המתועדת. אל תפרסמו פורטי אימות של localhost.
- הגעתם למגבלת שימוש: בדקו את החשבון ואת שיטת האימות המוצגים על ידי
codex login status. התקנת ה-CLI או רכישת VPS אינן מסירות את מגבלות השימוש של OpenAI. - שגיאות sandbox או כלי עזר: שמרו על ההתקנה הרשמית המלאה יחד ובדקו את התמיכה של ההפצה שלכם במנגנוני הבידוד הנדרשים. קונטיינר או VPS מוגבל עשויים לכלול מגבלות נוספות. אל תפתרו זאת בהרצת Codex כ-root או בביטול אמצעי ההגנה שלו.
צפו בהדגמה, ואז נסו זאת על ה-VPS שלכם
הסרטון הנלווה שלנו עוקב אחר דוגמת האבחון מהאתר השבור ועד לתגובה המאומתת. הוא מדגים במה הסוכן המותקן יכול לעזור לכם לחקור; פקודות ההתקנה נמצאות במדריך הזה.
הדגמה מבוקרת על VPS בדיקה זמני: Codex מציע את התיקון; המפעיל שלנו מחיל ומאמת אותו. צפו בהדגמה ב-YouTube.
התחילו בפרויקט בדיקה, שמרו על הרשאות הסוכן צרות ואמתו כל תוצאה. אם אתם זקוקים לשרת עבור סביבת העבודה הזו, עיינו בחבילות ה-VPS של Linux של SharpHeberg. חשבון OpenAI והשימוש שלכם נשארים נפרדים משירות האחסון.