تخطَّ إلى المحتوى
وثائق V1
البدء

الويب

يمكن تشغيل OpenCode كتطبيق ويب داخل متصفحك، ليمنحك تجربة البرمجة القوية بالذكاء الاصطناعي نفسها دون الحاجة إلى terminal.

OpenCode Web - جلسة جديدة

ابدأ تشغيل واجهة الويب عبر تنفيذ:

الطرفية
opencode web

يؤدي ذلك إلى تشغيل خادم محلي على 127.0.0.1 بمنفذ عشوائي متاح، ويفتح OpenCode تلقائيا في المتصفح الافتراضي لديك.


يمكنك ضبط خادم الويب باستخدام خيارات CLI أو عبر ملف الإعدادات.

افتراضيا، يختار OpenCode منفذا متاحا. يمكنك تحديد منفذ:

الطرفية
opencode web --port 4096

افتراضيا، يرتبط الخادم بـ 127.0.0.1 (للاستخدام المحلي فقط). لجعل OpenCode متاحا على شبكتك:

الطرفية
opencode web --hostname 0.0.0.0

عند استخدام 0.0.0.0 سيعرض OpenCode كلا من عناوين الوصول المحلي وعناوين الشبكة:

  Local access:       http://localhost:4096
  Network access:     http://192.168.1.100:4096

فعّل mDNS لجعل خادمك قابلا للاكتشاف على الشبكة المحلية:

الطرفية
opencode web --mdns

يضبط ذلك تلقائيا اسم المضيف إلى 0.0.0.0 ويعلن عن الخادم باسم opencode.local.

يمكنك تخصيص اسم نطاق mDNS لتشغيل عدة نسخ على الشبكة نفسها:

الطرفية
opencode web --mdns --mdns-domain myproject.local

للسماح بنطاقات إضافية عبر CORS (مفيد للواجهات الأمامية المخصصة):

الطرفية
opencode web --cors https://example.com

لحماية الوصول، عيّن كلمة مرور عبر متغير البيئة OPENCODE_SERVER_PASSWORD:

الطرفية
OPENCODE_SERVER_PASSWORD=secret opencode web

اسم المستخدم الافتراضي هو opencode، ويمكن تغييره عبر OPENCODE_SERVER_USERNAME.


بعد التشغيل، تتيح لك واجهة الويب الوصول إلى جلسات OpenCode الخاصة بك.

اعرض جلساتك وأدرها من الصفحة الرئيسية. يمكنك رؤية الجلسات النشطة وبدء جلسات جديدة.

OpenCode Web - جلسة نشطة

انقر على “See Servers” لعرض الخوادم المتصلة وحالتها.

OpenCode Web - See Servers (عرض الخوادم)


يمكنك إرفاق واجهة terminal (TUI) بخادم ويب قيد التشغيل:

الطرفية
# ابدأ خادم الويب
opencode web --port 4096

# في محطة طرفية أخرى، اربط TUI
opencode attach http://localhost:4096

يتيح لك ذلك استخدام واجهة الويب وterminal في الوقت نفسه، مع مشاركة الجلسات والحالة نفسها.


يمكنك أيضا ضبط إعدادات الخادم داخل ملف الإعدادات opencode.json:

JSON
{
  "server": {
    "port": 4096,
    "hostname": "0.0.0.0",
    "mdns": true,
    "cors": ["https://example.com"]
  }
}

تكون خيارات CLI ذات أولوية أعلى من إعدادات ملف الإعدادات.