كيف تستضيف Octop ذاتياً لعدة مستخدمين؟
ثبّت Octop على VPS باستخدام Docker Compose والوسم v0.9.19، مع عزل المستخدمين وTLS ونموذج متوافق مع OpenAI، وتعرّف لماذا تتجنب مثبت curl.
ما هو Octop، ولماذا تستضيفه ذاتياً
Octop هو مساعد AI تستضيفه ذاتياً للاستخدام المنزلي أو لفريق صغير. وسبب استضافة Octop ذاتياً بدلاً من استخدام واجهة محادثة بسيطة هو أنّه يفصل المستخدمين عن بعضهم. يوفّر Open WebUI واجهة متصفح أمام نموذج. ويضيف Octop حسابات تتضمن دور admin، ومساحة عمل خاصة ومجموعة بيانات اعتماد مستقلة لكل مستخدم، ومكتبة من الوكلاء المتخصصين الذين يمكن لكل مستخدم التبديل بينهم حسب المهمة. وهذا ما يتيح لخادم VPS واحد خدمة خمسة أشخاص بدلاً من شخص واحد.
يوجد المشروع في github.com/TencentCloud/Octop. وهو عملية واحدة توفّر لوحة تحكم ويب، وواجهة سطر أوامر، وقنوات محادثة (Feishu وDingTalk وQQ وDiscord وWeCom)، ومهام مجدولة، وكلها تعتمد على قاعدة بيانات SQLite واحدة ضمن ~/.octop/. كُتب كل ما يلي استناداً إلى tag v0.9.19، الذي صدر في 5 August 2026. إذا كنت لا تزال تختار بين المنصات، فإن مقارنة بدائل Open WebUI التي يمكنك تشغيلها على خادم VPS تغطي الخيارات الأوسع.
هناك نقطة يجب توضيحها قبل أن تقضي مساءً كاملاً في إعداد البرنامج. عند كتابة هذا الدليل، كان Octop برنامجاً قبل الإصدار 1.0 منشوراً من مؤسسة vendor على GitHub، وكان لديه نحو 900 نجمة حتى August 2026. وقد أضاف المشروع منذ ذلك الحين tag v1.0.0 في 14 September 2026. وحتى 20 October 2026، أصبح أحدث tag هو v1.0.2، وهو إصدار مستقر نُشر في 18 October 2026 بعد سلسلة من tags الإصدار التجريبي 1.0.2، بينما بلغ عدد نجوم المستودع نحو 10,400. كُتبت الخطوات أدناه استناداً إلى v0.9.19، ولم تُختبر مجدداً على الإصدار 1.x. يتغير البرنامج بسرعة، وتوضح أرقام الإصدارات ذلك. ولا يضمن هذا الدليل مسار ترقية مستقراً. ثبّت tag محدداً، واقرأ سجل التغييرات، واحتفظ بنسخ احتياطية.
ما تحتاج إليه قبل البدء
- VPS يعمل بنظام Ubuntu 24.04، مع Docker Engine وإضافة Compose. هل هذه أول مرة تستخدم فيها Compose؟ ابدأ بدرس أساسيات Docker Compose على VPS.
git، لأنك ستسحب release tag بدلاً من سحب image.- اسم نطاق يشير إلى VPS، لأنك تريد وضع TLS (أمان طبقة النقل) أمام هذه الخدمة.
- backend لنموذج يدعم OpenAI API: نسخة Ollama محلية، أو gateway مستضاف ذاتياً، أو مفتاح مدفوع.
Octop نفسه خفيف. فهو عبارة عن عملية Python وملف SQLite. أما العبء الأساسي فيأتي من backend النموذج. لذلك، إذا كنت تخطط لتشغيل النموذج على الخادم نفسه، فاختر مواصفات الخادم بما يناسب النموذج.
لماذا لا نوصي بمثبّت curl
يبدأ ملف README بأمر تثبيت في سطر واحد:
curl -fsSL https://finnie-1258344699.cos.ap-guangzhou.myqcloud.com/octop/install.sh | bashلا نوصي باستخدامه على خادم مهم بالنسبة إليك لسبب واضح: هذا البرنامج النصي ليس موجوداً في المستودع. بل يُقدَّم من حاوية Tencent Cloud Object Storage. لا يغطيه أي git tag أو commit، لذلك لا يمكنك مقارنة البرنامج النصي الحالي ببرنامج الأسبوع الماضي، ولا يوجد سجل يفسّر أي تغيير. ويمكن للحاوية تقديم محتوى مختلف غداً، من دون أن يسجّل المشروع ذلك. كما أن تمرير النتيجة مباشرة إلى bash يعني أن الجهاز يشغّل البرنامج النصي قبل أن تقرأ منه سطراً واحداً.
يكتب المثبّت أيضاً إلى المضيف بدلاً من حاوية. ويستخدم uv لجلب Python 3.12 وإنشاء بيئة لا يعرف عنها مدير الحزم لديك شيئاً، لذلك تصبح إزالتها لاحقاً مهمة يدوية.
هناك خياران أفضل. اجلب البرنامج النصي واقرأه ثم شغّله، وهذا يستغرق ثلاثين ثانية: curl -fsSL <url> -o install.sh، ثم less install.sh، ثم bash install.sh. أو استخدم Docker، وهو موضوع بقية هذا الدليل. أما حزمة PyPI (pip install octop)، فهي على الأقل artifact بإصدار محدد يمكنك تثبيته على إصدار معيّن.
نشر Octop باستخدام Docker Compose مع تثبيت الإصدار v0.9.19
ملف Compose المتوفر في الإصدار v0.9.19 ينشئ الصورة من المستودع، لذلك يعني تثبيت الإصدار في هذا الدليل سحب وسم git محدداً. توجد صور منشورة أيضاً. تتضمن شجرة v0.9.19 بالفعل سير عمل docker-publish.yml، أُضيف في v0.9.8 بتاريخ 15 July 2026، وينشئ صورة ويدفعها إلى Docker Hub لكل وسم v*. واعتباراً من 20 October 2026، ينشر المشروع أيضاً إلى سجل الحاويات في GitHub (docker pull ghcr.io/tencentcloud/octop:1.0.2). يظل الإنشاء من الوسم الذي سحبته أكثر إحكاماً في تثبيت الإصدار، لأنك تترجم الشفرة التي قرأتها بالضبط بدلاً من الوثوق بوسم في سجل الصور. هذه خطوة إضافية مقارنة بما تطلبه معظم المشاريع ذاتية الاستضافة، إذ إن شيئاً مثل مساحة عمل AFFiNE ذاتية الاستضافة يثبت وسم صورة منشورة ولا ينشئ أي شيء على VPS لديك. روتين الاستنساخ وسحب الوسم والإنشاء أدناه هو نفسه الذي يشرحه دليل نشر openGym، لذلك إذا أعددته مرة واحدة فأنت تعرف بنيته بالفعل.
git clone https://github.com/TencentCloud/Octop.git
cd Octop
git checkout v0.9.19هذه هي الخدمة التي يعرّفها الملف، بعد اختصارها إلى الأجزاء المهمة:
services:
octop:
build:
context: ..
dockerfile: docker/Dockerfile
image: octop:latest
container_name: octop
restart: unless-stopped
ports:
- "${OCTOP_PORT:-8088}:${OCTOP_PORT:-8088}"
volumes:
- ${OCTOP_DATA:-~/.octop}:/data/.octop
environment:
- HOME=/data
- OCTOP_BIND_HOST=0.0.0.0
- OCTOP_PORT=${OCTOP_PORT:-8088}
- OCTOP_DEFAULT_PASSWORD=${OCTOP_DEFAULT_PASSWORD:-octop}
- OCTOP_ADMIN_USERNAME=${OCTOP_ADMIN_USERNAME:-admin}
- OPENAI_API_KEY=${OPENAI_API_KEY:-}انتبه إلى كتلة build:. يشير image: octop:latest إلى اسم الإنشاء الذي تنشئه أنت، وليس إلى مرجع في سجل الصور، لذلك يعني latest هنا آخر إصدار ترجمته، أياً كان. عيّن مسار البيانات إلى موقع واضح بدلاً من تركه للإعداد الافتراضي، وضع كلمة مرور حقيقية لحساب الإدارة قبل التشغيل الأول. ضع ما يلي في docker/.env:
OCTOP_PORT=8088
OCTOP_ADMIN_USERNAME=admin
OCTOP_DEFAULT_PASSWORD=<a long random password>
OCTOP_DATA=/srv/octop-dataهناك نقطة مهمة هنا تتفوق على بقية الملف. يقرأ Compose docker/.env فقط لاستبدال العناصر النائبة ${...} في YAML. ولا تصل أي قيمة مفتاح تضيفها إلى ذلك الملف إلى الحاوية إلا إذا أدرجتها أيضاً تحت environment: في ملف Compose. إضافة OCTOP_ACCESS_TOKEN_TTL إلى .env وحده لا تفعل شيئاً إطلاقاً، من دون ظهور خطأ. البديل هو كتابة المفاتيح نفسها في ~/.octop/env داخل دليل البيانات المركّب، حيث يحمّلها Octop عند بدء التشغيل. يشرح دليل ملفات البيئة والأسرار في Docker Compose سبب اختلاف هاتين الآليتين.
أنشئ الخدمة وشغّلها:
docker compose -f docker/docker-compose.yml up -d --build
docker compose -f docker/docker-compose.yml ps
curl http://127.0.0.1:8088/api/healthتستجيب النسخة السليمة لفحص الصحة بكائن JSON من الشكل {"ok":true,"started_at":...,"db":...,"users_loaded":0,"agents_running":0} تقريباً. إذا كانت النتيجة مختلفة، اقرأ docker compose -f docker/docker-compose.yml logs -f octop قبل استخدام المتصفح.
امنح الآن الصورة التي أنشأتها اسماً واضحاً، لأن --build التالي سيستبدل octop:latest ولن تتمكن من معرفة الفرق بين الصورتين:
docker image tag octop:latest octop:0.9.19يشغّل التشغيل الأول octop init ويكتب بيانات الاعتماد الأولية في وحدة تخزين البيانات:
docker exec -it octop cat /data/.octop/credential.txtالقيم الافتراضية هي admin / octop، ولا تُطبَّق إلا عند التهيئة الأولى. وهذا يفسر سؤالاً يتكرر كثيراً: تغيير OCTOP_DEFAULT_PASSWORD بعد بدء الحاوية مرة واحدة لا يغيّر شيئاً، لأن الحساب موجود مسبقاً. غيّر كلمة المرور من لوحة التحكم بدلاً من ذلك.
لا تنشر المنفذ 8088
يربط السطر ports: أعلاه كل واجهات VPS. وبمجرد بدء الحاوية، تصبح لوحة المعلومات متاحة على الإنترنت العام بنص واضح، مع كلمة مرور افتراضية. الإعداد الافتراضي OCTOP_BIND_HOST الخاص بـOctop هو 127.0.0.1؛ ويتجاوزه ملف Compose إلى 0.0.0.0 لأن العملية يجب أن تقبل حركة الشبكة من خارج مساحة أسماء الشبكة الخاصة بها. هذا التجاوز صحيح. أما الجزء الذي يعرّضك للخطر فهو نشر المنفذ.
حرّر السطر ports: في docker/docker-compose.yml بحيث يستمع الربط على loopback فقط:
ports:
- "127.0.0.1:${OCTOP_PORT:-8088}:${OCTOP_PORT:-8088}"لا تحاول معالجة ذلك باستخدام ملف override عادي. إذ يضم Compose قوائم ports من ملفات متعددة بدلاً من استبدالها، فتنتتهي إلى نشر الربطين معاً، ويفشل الربط الثاني. إذا أردت إبقاء ملف upstream دون تعديل، فاستخدم الوسم !override على التسلسل، فهذه هي الطريقة الموثقة للاستبدال بدلاً من الإضافة. يشرح شرح كيفية دمج Compose لملفات متعددة بقية قواعد الدمج هذه.
يحل الربط على loopback أيضاً مشكلة ستواجهها بخلاف ذلك مع الجدار الناري. يكتب Docker قواعد المنافذ المنشورة في جدول nat قبل السلاسل التي يديرها ufw، لذلك لا يمنع ufw deny 8088 منفذاً منشوراً لحاوية. في Docker Engine 28.0.0 أو أحدث، لا يمكن الوصول إلى منفذ مربوط بـ127.0.0.1 من خارج الخادم، بصرف النظر عما يعتقده ufw. لذلك فهذا هو الإصلاح الصحيح، وليس حلاً ثانوياً. تسمح إصدارات Engine الأقدم للمضيفين الموجودين في مقطع L2 نفسه، مثل الأجهزة الأخرى على محوّل مزود الخدمة، بالوصول إلى المنافذ المنشورة على localhost. لذلك شغّل docker version وقم بالترقية إذا أبلغ الخادم عن إصدار أقل من 28.
ضع TLS أمام التطبيق باستخدام reverse proxy
يُعد Caddy أقصر مسار، لأنه يطلب الشهادة تلقائياً عبر ACME (بيئة إدارة الشهادات التلقائية) ويتولى توجيه WebSockets دون إعداد إضافي:
octop.example.com {
reverse_proxy 127.0.0.1:8088
}يتطلب nginx عناية أكبر، لأن Octop يمرر المحادثة عبر WebSocket:
server {
listen 443 ssl;
server_name octop.example.com;
ssl_certificate /etc/letsencrypt/live/octop.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/octop.example.com/privkey.pem;
location / {
proxy_pass http://127.0.0.1:8088;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_buffering off;
proxy_read_timeout 3600s;
}
}كل سطر هنا يؤدي وظيفة محددة. تعمل المحادثة عبر WS /api/agents/{id}/chat/ws، لذلك يرد nginx على محاولة الترقية بالخطأ 400 Bad Request عند غياب proxy_http_version 1.1 ورأسي الترقية. في هذه الحالة تُحمَّل لوحة التحكم بشكل طبيعي، لكن كل رسالة ترسلها تتوقف إلى الأبد دون ظهور خطأ في الصفحة. يهم proxy_buffering off لأن نقطة نهاية الاستئناف human-in-the-loop تعيد text/event-stream، ولأن أحداث SSE (الأحداث المرسلة من الخادم) إذا بقيت في ذاكرة proxy المؤقتة تصل دفعة واحدة في النهاية بدلاً من تدفقها تدريجياً. يغطي proxy_read_timeout عمليات تشغيل الأدوات الطويلة، لأن المهلة الافتراضية البالغة 60 ثانية توقف الوكيل أثناء تنفيذ المهمة وتُسجّل upstream timed out (110: Connection timed out).
سلوك مصادقة JWT خلف الـproxy
يصادق Octop باستخدام bearer token، وليس باستخدام cookie. يعيد POST /api/auth/login القيمة {access_token, role, user, ...}، وتحمل الطلبات اللاحقة Authorization: Bearer <access_token>. وهذا خبر جيد عند استخدام reverse proxy: فلا يوجد نطاق cookie، ولا راية Secure، ولا قاعدة SameSite يمكن ضبطها بشكل خاطئ. لذلك تتصرف الجلسة التي عملت على http://127.0.0.1:8088 بالطريقة نفسها على https://octop.example.com.
هناك نتيجتان تجدر معرفتهما قبل إتاحة الخدمة للمستخدمين الفعليين.
تحمل WebSocket الرمز المميز في عنوان URL. نقطة النهاية هي WS /api/agents/{id}/chat/ws?token=<jwt>، لأن JavaScript في المتصفح لا يستطيع تعيين ترويسة Authorization أثناء مصافحة WebSocket. يحمي TLS هذا الرمز أثناء النقل. لكنه لا يحميه من سجلاتك: يكتب nginx سطر الطلب الكامل، بما في ذلك سلسلة الاستعلام، في access_log افتراضياً. وهذا يعني أن رمزاً صالحاً لمستخدم فعلي ينتهي به الأمر في ملف نصي عادي على الخادم. سجّل المسار من دون الوسائط. يمثّل $uri المسار الموحّد بعد إزالة سلسلة الاستعلام، لذا ضع هذا الإعداد في كتلة http وأشر إليه من الخادم:
log_format octop_noargs '$remote_addr [$time_local] '
'"$request_method $uri $server_protocol" '
'$status $body_bytes_sent';
access_log /var/log/nginx/octop.log octop_noargs;لا توجد آلية لتسجيل الخروج لكل جلسة. تكون قيمة OCTOP_ACCESS_TOKEN_TTL الافتراضية 86400، لذلك يظل الرمز صالحاً لمدة 24 ساعة بعد تسجيل الدخول. والطريقة الموثقة الوحيدة لإبطال رمز واحد هي octop admin rotate-jwt-secret، التي تدوّر مفتاح التوقيع المخزّن في ~/.octop/secrets/jwt_secret وتبطل جميع الرموز الحالية فوراً ولدى الجميع. لذلك، عندما يغادر أحد أعضاء الفريق، يكون الترتيب كالتالي: احذف المستخدم، ثم دوّر السر، ثم اطلب من المستخدمين الباقين تسجيل الدخول مرة أخرى. إذا بدا ذلك مرهقاً، فقصّر مدة الصلاحية، وتذكّر إضافة المتغير إلى قائمة environment: وكذلك .env:
OCTOP_ACCESS_TOKEN_TTL=28800تُعالَج محاولات القوة الغاشمة: تكون القيمة الافتراضية لـOCTOP_LOGIN_MAX_ATTEMPTS هي 5 حالات فشل، ولـOCTOP_LOGIN_LOCKOUT_SECONDS هي 900. لذلك ينتظر المستخدم المقفل 15 دقيقة ببساطة، بدلاً من اعتقاده أن التثبيت معطّل. لدى Octop مخزن مستخدمين خاص به، ولا يوفّر دعماً موثقاً لـOIDC في الإصدار v0.9.19. لذلك، إذا كنت تحتاج إلى تسجيل دخول موحّد فعلي، فضع proxy للمصادقة أمامه. وهذا هو الغرض من خادم Authentik مستضاف ذاتياً.
إعداد Octop للاتصال بخلفية نموذج
تُضبط موفّرات النماذج لكل agent من لوحة التحكم، ويعرض لك octop provider list الإعدادات الحالية. يوفّر Octop إعدادات مسبقة لواجهات OpenAI المتوافقة، وDashScope (Qwen)، وOllama، وتُخزَّن بيانات الاعتماد في جدول providers داخل قاعدة SQLite الخاصة بك. يغيّر هذا الاختيار ما تدفعه وما يغادر الخادم.
نموذج محلي باستخدام Ollama. لا يغادر أي شيء الخادم، وتدفع مقابل استهلاك RAM بدلاً من الرموز. توجد نقطة إعداد تسبب الالتباس: لا يستطيع container الوصول إلى Ollama على المضيف عبر 127.0.0.1:11434، لأن هذا العنوان يشير إلى loopback الخاص بالـcontainer نفسه. أضف إدخال host gateway إلى الخدمة:
extra_hosts:
- "host.docker.internal:host-gateway"بعد ذلك، اضبط عنوان URL الأساسي للموفّر على http://host.docker.internal:11434/v1، وهو المسار المتوافق مع OpenAI في Ollama، وضع أي سلسلة غير فارغة في حقل مفتاح API، لأن Ollama يتجاهله، بينما ترفض عملاء OpenAI إرسال مفتاح فارغ. يجب أيضاً أن يستمع Ollama خارج loopback حتى يعمل ذلك، وهذا يعني ضبط OLLAMA_HOST=0.0.0.0:11434 في وحدة systemd الخاصة به. هذا هو الجزء الخطِر: لا يوفّر Ollama مصادقة، لذلك فإن فتح المنفذ 11434 على عنوان IP عام يحوّل الخادم إلى خادم نماذج مجاني لأي شخص يفحصه أولاً. اسمح فقط بالنطاق الخاص بـDocker، sudo ufw allow from 172.16.0.0/12 to any port 11434 proto tcp، وارفض بقية المصادر. يشرح تشغيل Ollama على VPS تحديد حجم النموذج، بينما تشرح مقارنة Ollama وvLLM الحالات التي يتوقف فيها Ollama عن كونه الخادم المناسب.
يوجد تحذير آخر بشأن النماذج المحلية، لأن المشكلة تبدو كأنها خطأ في Octop لكنها ليست كذلك. تعمل agents عبر استدعاء الأدوات، ويكون system prompt وتعريفات الأدوات وسجل المحادثة prompt كبيراً. يقدّم Ollama النماذج ضمن نافذة سياق افتراضية محدودة، لذلك يخرج الجزء الأول من prompt، حيث توجد تعريفات الأدوات، من النافذة. يتوقف النموذج عندها عن استدعاء الأدوات أو يخترع أدوات غير موجودة. ارفع num_ctx إلى 16k أو 32k، واختر نموذجاً يجيد فعلياً استدعاء الدوال. أما الرد الذي يتوقف في منتصف الجملة فهو شكوى معاكسة وإعداد مختلف، هو num_predict. لذلك، إذا عادت الإجابات مبتورة، فمن المفيد التحقق من مكان ضبط num_predict وما يعرضه done_reason قبل إلقاء اللوم على agent. إذا كنت تفضّل البدء من مرشح محدد بدلاً من قائمة مختصرة، فجرّب Nemotron 3.5 Lightning. يذكر ذلك الدليل الوسم الدقيق المطلوب سحبه، وكمية RAM التي يحتاج إليها، وما إذا كان التشغيل باستخدام CPU فقط يواكب المطلوب.
بوابة مستضافة ذاتياً. ضع بوابة LiteLLM مستضافة ذاتياً بين Octop وكل ما عداه، لتحصل على عنوان URL أساسي واحد، ومفتاح منفصل لكل مستخدم، وحدود للإنفاق، وسجل موحّد. ويمكنك أيضاً تبديل النموذج خلف البوابة من دون تعديل أي شيء في Octop.
واجهة API مدفوعة. تحصل على أفضل جودة، مع مقايضة واضحة: يغادر محتوى المحادثة خادمك ويصل إلى الموفّر، وهذا يناقض جزءاً كبيراً من هدف الاستضافة الذاتية. يوضع المفتاح في docker/.env بصيغة OPENAI_API_KEY، ويمرّره ملف Compose مسبقاً.
أيّاً كان اختيارك، يحمل ملف Compose أيضاً OCTOP_LANGFUSE_ENABLED وLANGFUSE_PUBLIC_KEY وLANGFUSE_SECRET_KEY وLANGFUSE_BASE_URL، بحيث يمكنك إرسال آثار التشغيل إلى مثيل Langfuse الخاص بك ومعرفة ما تفعله agents فعلياً بدلاً من التخمين من نافذة المحادثة.
المستخدمون والأدوار ومكتبة الوكلاء المشتركة
ينشئ حساب المسؤول من الإقلاع الأول الحسابات الأخرى ويديرها. يحصل كل مستخدم على وكلائه ومساحة العمل وبيانات الاعتماد الخاصة به، ويضمن العزل بينها الرمز المميز الذي يحتفظ به المتصفح. وإلى جانب ذلك، توجد مجموعة مشتركة من المهارات والوكلاء الفرعيين يمكن لأي شخص استخدامها. وهذه هي الميزة التي تجعل تشغيل النظام مفيداً للعائلة: ينشئ أحد الأشخاص وكيل بحث جيداً مرة واحدة، ولا يضطر الآخرون إلى إعادة إنشائه.
انتبه عند استخدام الأدوات. يوفّر Octop موافقات على استخدام الأدوات ووسائل حماية لأوامر shell، وكلتاهما فعليتان. لكن الوكيل الذي يشغّل أوامر shell يشغّلها داخل حاوية Octop مع تركيب وحدة البيانات الخاصة بك. تحد وسائل الحماية من الأفعال التي يمكن أن ينفذها prompt غير حذر. لكنها لا تشكل حدود sandbox، لذلك اترك موافقة الأدوات مفعّلة لأي شخص لا تمنحه وصولاً إلى shell. إذا كنت تقارن هذا الخيار بخيارات أخرى، تقارن المراجعة الشاملة لوكلاء الذكاء الاصطناعي المستضافين ذاتياً كيفية تعامل كل خيار معها.
ترقية مشروع تُصدر إصدارات بهذه السرعة
البيانات وراء هذا الرسم البياني
[
{
"version": "v0.9.16",
"days_since_previous_release": 2
},
{
"version": "v0.9.17",
"days_since_previous_release": 3
},
{
"version": "v0.9.18",
"days_since_previous_release": 1
},
{
"version": "v0.9.19",
"days_since_previous_release": 3
}
]هذه تواريخ الوسوم في المستودع، محسوبة حتى 7 August 2026. أُصدرت 4 إصدارات موسومة خلال تسعة أيام، وكان أقصر فاصل بينها 1 يوم، بينما وصل الإصدار v0.9.19 بعد 3 يوماً من الوسم السابق. هذا المعدل مؤشر جيد على المشروع، لكنه سبب سيئ لتشغيل latest. اقرأ التغييرات قبل تطبيقها:
cd Octop
git fetch --tags
git tag --sort=-creatordate | head
NEW_TAG=$(git tag --sort=-creatordate | head -1)
git log --oneline "v0.9.19..$NEW_TAG"تحقق مما يحتويه $NEW_TAG فعلياً قبل تسجيل الخروج إليه، لأن المشروع يضع وسوم الإصدارات التجريبية، مثل v1.0.2b9، إلى جانب الإصدارات المستقرة. حتى 20 October 2026، أحدث وسم هو الإصدار المستقر v1.0.2، الذي نُشر في 18 October 2026. كما أن الانتقال من v0.9.19 يتجاوز الإصدار v1.0.0 الصادر في 14 September 2026، ولذلك يكون سجل التغييرات طويلاً ويستحق القراءة الدقيقة.
أنشئ نسخة احتياطية أولاً في كل مرة، لأن عمليات ترحيل قاعدة البيانات تُنفَّذ عند بدء التشغيل، وفشل عملية ترحيل في مشروع يُصدر إصدارات بهذه السرعة يصبح مشكلة عليك حلها:
docker compose -f docker/docker-compose.yml stop
sudo tar czf octop-backup-$(date +%F).tgz -C /srv octop-data
docker compose -f docker/docker-compose.yml startبعد ذلك، سجّل الخروج إلى الوسم الجديد وأعد البناء باستخدام docker compose -f docker/docker-compose.yml up -d --build. إذا حدث خطأ، فإن تسجيل الخروج إلى الوسم القديم وإعادة البناء يعيدان الشيفرة، لكن ملف tarball وحده يعيد قاعدة البيانات.
يحتوي ملف tarball على octop.db وconfig.json وJWT signing secret وcredential.txt، ولذلك يجب التعامل معه على أنه حساس بقدر حساسية الخادم نفسه. اضبط صلاحياته على mode 600 واحتفظ بنسخة منه خارج الخادم. بالنسبة إلى التثبيتات الأكبر، يوفّر المشروع أيضاً docker/docker-compose.postgres.yml، الذي يشغّل PostgreSQL مع pgvector بدلاً من SQLite.
أوضاع الفشل، مع السلاسل النصية التي ستراها
لا يستجيب فحص الصحة مطلقاً. يتعطل curl http://127.0.0.1:8088/api/health أو يرفض الاتصال. اقرأ docker compose -f docker/docker-compose.yml logs -f octop. الحاوية التي تخرج أثناء التهيئة الأولى لا تستطيع عادةً الكتابة إلى دليل البيانات، لذلك تحقّق من مالك المسار الذي ضبطت OCTOP_DATA عليه.
تُحمّل لوحة المعلومات، لكن المحادثة تتعطل. لا يظهر أي خطأ في الصفحة، ولا يصل أي رد. افتح وحدة تحكم المتصفح وابحث عن فشل اتصال بـ wss://octop.example.com/api/agents/.../chat/ws. الوكيل الوسيط لا يمرّر الترقية. أضف الرؤوس proxy_http_version 1.1 وUpgrade وConnection.
يظهر الرد كاملاً دفعة واحدة بعد تأخير عدة ثوانٍ. يعمل البث، لكن التخزين المؤقت مفعّل. اضبط proxy_buffering off.
bind: address already in use. هناك شيء يستخدم 8088 مسبقاً. يحدده sudo ss -tlnp | grep 8088. ويحدث هذا أيضاً إذا أضفت إدخال ports ثانياً في ملف override بدلاً من تعديل الإدخال الأصلي.
يُرفض أمر المرور الصحيح. تؤدي 5 محاولات فاشلة إلى قفل لمدة 900 ثانية. انتظر انتهاء المدة بدلاً من إعادة التثبيت.
لم تؤثر كلمة المرور الجديدة في .env. تُطبّق بيانات الاعتماد هذه أثناء التهيئة الأولى فقط. غيّرها من لوحة المعلومات.
يرد الوكيل، لكنه لا يشغّل أي أداة مطلقاً. تكون المشكلة في النموذج المحلي في معظم الحالات: نافذة السياق صغيرة جداً بالنسبة إلى تعريفات الأدوات، أو أن النموذج ضعيف في استدعاء الدوال. ارفع num_ctx وجرّب نموذجاً مصمماً لاستخدام الأدوات.
FAQ
هل يُعدّ Octop بديلاً عن Open WebUI؟
فقط إذا كنت تحتاج إلى الوظائف التي يضيفها. Open WebUI عبارة عن واجهة محادثة أمام نموذج، وهو يؤدي هذه المهمة جيداً لشخص واحد أو لأسرة موثوقة. يضيف Octop حسابات تتضمن دور المسؤول، ومساحات عمل وبيانات اعتماد لكل مستخدم، ومكتبة قابلة للتبديل من الوكلاء المتخصصين. يتيح ذلك لعدة أشخاص مشاركة خادم واحد دون مشاركة سجل واحد. إذا كان الحساب الواحد مناسباً لك، فإن Open WebUI هو الخيار الأبسط والأكثر نضجاً بكثير.
لماذا ينبغي ألا تستخدم برنامج تثبيت Octop عبر curl؟
يُقدَّم البرنامج من حاوية Tencent Cloud Object Storage بدلاً من المستودع، ولذلك لا يغطيه أي وسم أو commit في git. لا يمكنك مقارنة ما يفعله اليوم بما كان يفعله الأسبوع الماضي، كما أن تمريره إلى bash يشغّله قبل أن تقرأه. كذلك يثبّت البرنامج نفسه على المضيف مع بيئة Python 3.12 مستقلة، خارج مدير الحزم لديك. نزّله واقرأه أولاً، أو انشره باستخدام Docker Compose من وسم تم سحبه إلى نسخة محلية من المستودع.
هل يستطيع Octop استخدام نموذج محلي بدلاً من API مدفوع؟
نعم. يتعامل Octop مع واجهات API المتوافقة مع OpenAI، ويتضمن إعداداً مسبقاً لـOllama. لذلك يعمل توجيهه إلى http://host.docker.internal:11434/v1 بعد إضافة extra_hosts: ["host.docker.internal:host-gateway"] إلى الحاوية وضبط OLLAMA_HOST=0.0.0.0:11434 على المضيف. قيّد المنفذ 11434 في جدار الحماية على نطاق عناوين Docker، لأن Ollama لا يوفّر مصادقة خاصة به. توقّع زيادة قيمة num_ctx في Ollama إلى 16k أو أكثر، لأن مطالبات الوكلاء التي تتضمن تعريفات الأدوات تتجاوز نافذة السياق الافتراضية، وعندها يتوقف النموذج عن استدعاء الأدوات.
هل أحتاج إلى reverse proxy، أم يمكنني فتح المنفذ 8088؟
تحتاج إلى reverse proxy. ينشر ملف Compose المرفق مع Octop المنفذ 8088 على كل الواجهات دون TLS، لذلك ستنتقل كلمات المرور والرموز الحاملة عبر الإنترنت بنص واضح. غيّر المنفذ المنشور إلى 127.0.0.1:8088:8088، وضع Caddy أو nginx أمامه مع شهادة. عند استخدام nginx، مرّر رؤوس ترقية WebSocket واضبط proxy_buffering off، وإلا فستُحمّل الصفحة بينما لا تستجيب المحادثة مطلقاً دون إظهار خطأ واضح.
هل أصبح Octop جاهزاً للاستخدام في الإنتاج؟
كان Octop قبل الإصدار 1.0 ويصدر عدة إصدارات موسومة أسبوعياً حتى August 2026. وقد وضع الوسم v1.0.0 في 14 September 2026، ثم أصدر سلسلة من وسوم الإصدار التجريبي 1.0.2 قبل الإصدار المستقر v1.0.2 في 18 October 2026. لا تزال وتيرة التطوير سريعة، لذلك اعتبره واعداً لا مستقراً تماماً. يمكن استخدامه لأسرة أو لفريق داخلي صغير إذا ثبّتَّ وسمًا محدداً، وقرأت سجل commits قبل كل ترقية، وأخذت نسخة احتياطية من وحدة البيانات قبل كل إعادة إنشاء. لا تشغّله على latest، ولا تضع فيه بيانات العملاء بعد.