SSD Nodes Learn Hosting plans →
الأدلة Matt Connorبقلم Matt Connor

كيفية استضافة Octop ذاتياً لعدة مستخدمين عبر Docker

شغّل Octop v0.9.19 على خادم VPS باستخدام Docker Compose مع تثبيت الوسم، ومستخدمين منفصلين، ونموذج متوافق مع OpenAI وTLS، وتجنّب مثبت curl.

ما هو Octop، ولماذا تستضيفه ذاتياً

Octop هو مساعد ذكاء اصطناعي تستضيفه بنفسك لمنزل أو فريق صغير. وسبب استضافة Octop ذاتياً بدلاً من استخدام واجهة دردشة عادية هو أنه يفصل المستخدمين عن بعضهم. يوفّر Open WebUI واجهة متصفح أمام نموذج، ويدعم أيضاً عدة مستخدمين وعناصر تحكم في الوصول. يجمع Octop بين الحسابات ودور المسؤول، ومساحة عمل خاصة ومجموعة بيانات اعتماد لكل مستخدم، ومكتبة من الوكلاء المتخصصين الذين يمكن لكل مستخدم التبديل بينهم حسب المهمة. وهذا هو الفرق الذي يتيح لخادم VPS واحد خدمة خمسة أشخاص بدلاً من شخص واحد.

يوجد المشروع في github.com/TencentCloud/Octop. وهو عملية واحدة توفّر لوحة ويب، وواجهة سطر أوامر، وقنوات دردشة (Feishu وDingTalk وQQ وDiscord وWeCom)، ومهام مجدولة، وكلها تعتمد على قاعدة بيانات SQLite واحدة ضمن ~/.octop/. كُتب كل ما يلي اعتماداً على الوسم v0.9.19، الذي صدر في 5 August 2026. إذا كنت لا تزال تقارن بين المنصات، فإن مقارنة بدائل Open WebUI التي يمكنك تشغيلها على خادم VPS تغطي الخيارات الأوسع.

هناك أمر يجب توضيحه قبل أن تقضي عليه أمسية كاملة. عندما كُتب هذا الدليل، كان Octop برنامجاً بإصدار سابق لـ1.0، منشوراً من مؤسسة GitHub تابعة لمورّد. ومنذ ذلك الحين، وسم المشروع الإصدار v1.0.0 في 14 September 2026. واعتباراً من 20 November 2026، أصبح أحدث وسم هو v1.0.3b7، وقد نُشر في 18 November 2026، بينما يضم المستودع نحو 12,300 نجمة. وما يزال أحدث إصدار مستقر هو v1.0.2، وقد نُشر في 18 October 2026. كُتبت الخطوات أدناه اعتماداً على v0.9.19، ولم يُعَد اختبارها على الإصدار 1.x. يتغير المشروع بسرعة، وتؤكد أرقام الإصدارات ذلك، ولا يوجد هنا ما يضمن مسار ترقية مستقراً. ثبّت وسم إصدار محدداً، واقرأ سجل التغييرات، واحتفظ بنسخ احتياطية.

ما تحتاج إليه قبل البدء

  • 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 في الإصدار v0.9.19 بأمر تثبيت من سطر واحد:

curl -fsSL https://finnie-1258344699.cos.ap-guangzhou.myqcloud.com/octop/install.sh | bash

لا نوصي بتمريره مباشرة إلى bash على خادم تهتم به. يحتوي المستودع فعلاً على scripts/install.sh، لذلك تتضمن تلك النسخة سجل Git، ويغطيها وسم. أما النسخة المقدمة من حاوية Tencent Cloud Object Storage فلا يثبّت الأمر أعلاه إصدارها. يمكن للحاوية تقديم محتوى مختلف غداً، وسيستمر الأمر في تشغيله. كما أن تمرير النتيجة مباشرة إلى bash يعني أن الجهاز يشغّل النص البرمجي قبل أن تقرأ منه سطراً واحداً.

يكتب المثبّت أيضاً في المضيف بدلاً من حاوية. ويستخدم uv لجلب Python 3.12 وإنشاء بيئة لا يعرف عنها مدير الحزم لديك شيئاً، لذلك تصبح إزالتها لاحقاً مهمة يدوية.

لديك خياران أفضل. اجلب النص البرمجي واقرأه ثم شغّله، وهذا يستغرق ثلاثين ثانية: curl -fsSL <url> -o install.sh، ثم less install.sh، ثم bash install.sh. أو استخدم Docker، وهو موضوع بقية هذا الدليل. حزمة PyPI (pip install octop) هي على الأقل مورداً يحمل إصداراً محدداً، ويمكنك تثبيته على إصدار معيّن.

نشر 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 تمرير رأسي الترقية واستخدام HTTP/1.1 مع الخادم الخلفي؛ ويجعل proxy_http_version 1.1 ذلك صريحاً، كما أنّه مطلوب في إصدارات nginx الأقدم من 1.29.7. من دون ترقية ناجحة، تُحمّل لوحة التحكم بشكل طبيعي، لكن يتعذر اتصال المحادثة؛ وينهي v0.9.19 حالة البث بعد فشل المصافحة بدلاً من ترك الرسالة معلّقة إلى الأبد. يهم proxy_buffering off لأن نقطة نهاية الاستئناف مع وجود الإنسان ضمن الحلقة تُرجع text/event-stream، ولأن SSE (الأحداث المرسلة من الخادم) إذا بقيت في ذاكرة التخزين المؤقت للـProxy تصل دفعة واحدة في النهاية بدلاً من بثها تدريجياً. يغطي proxy_read_timeout الفواصل الطويلة التي لا تصل خلالها بيانات من الخادم الخلفي: يمكن للإعداد الافتراضي البالغ 60 ثانية أن يفصل WebSocket ويسجّل upstream timed out (110: Connection timed out)، لكن v0.9.19 يُبقي مهمة الوكيل قيد التشغيل بعد انقطاع الاتصال. ويؤدي الإلغاء الصريح إلى إيقاف المهمة.

سلوك مصادقة JWT خلف الـProxy

تستخدم Octop مصادقة تعتمد على bearer token، وليس على cookie. يعيد POST /api/auth/login القيمة {access_token, token_type, expires_in, 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;

لا يؤدي تسجيل الخروج إلى إبطال الرمز في v0.9.19. تكون 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 مستضاف ذاتياً. وصل دعم OIDC المضمّن في v0.9.24 بتاريخ 15 August 2026.

أشر إلى خلفية نموذج من Octop

تُضبط موفّرات النماذج لكل وكيل من لوحة المعلومات، ويعرض لك octop provider list الإعدادات الحالية. يوفّر Octop إعدادات مسبقة لواجهات OpenAI المتوافقة، وDashScope (Qwen)، وOllama، وتُخزَّن بيانات الاعتماد في جدول providers ضمن قاعدة بيانات SQLite الخاصة بك. يغيّر هذا الاختيار ما تدفعه وما يغادر الخادم.

نموذج محلي باستخدام Ollama. لا يغادر أي شيء الخادم، وتدفع تكلفة الذاكرة RAM بدلاً من الرموز. توجد هنا تفصيلة اتصال قد تسبب مشكلات: لا يمكن لحاوية الوصول إلى Ollama على المضيف عبر 127.0.0.1:11434، لأن هذا العنوان يشير إلى loopback الخاص بالحاوية نفسها. أضف إدخال بوابة المضيف إلى الخدمة:

    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 لكنه ليس كذلك. تعمل الوكلاء عبر استدعاء الأدوات، وتشكّل مطالبة النظام وتعريفات الأدوات والسجل السابق مطالبة كبيرة. تعتمد نافذة السياق الافتراضية في Ollama الآن على VRAM: 4k لمن تقل VRAM لديهم عن 24 GiB، و32k من 24 GiB إلى أقل من 48 GiB، و256k عند 48 GiB أو أكثر. توصي إرشادات Ollama الحالية بما لا يقل عن 64,000 رمز للوكلاء وأدوات البرمجة. اضبط num_ctx بحيث يناسب عبء العمل هذا السياقَ الذي يدعمه النموذج والذاكرة المتاحة، واختر نموذجاً يجيد فعلياً استدعاء الدوال. توقّف الرد في منتصف الجملة هو المشكلة المعاكسة، ويرتبط بإعداد مختلف هو num_predict. لذلك، إذا عادت الإجابات مبتورة، فمن المفيد التحقق من موضع ضبط num_predict وما تعرضه done_reason قبل إلقاء اللوم على الوكيل. وإذا كنت تفضّل البدء بمرشح محدد بدلاً من قائمة مختصرة، فجرب 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 الخاص بك ومعرفة ما تفعله الوكلاء فعلياً بدلاً من التخمين من نافذة المحادثة.

المستخدمون والأدوار ومكتبة الوكلاء المشتركة

ينشئ حساب المسؤول من الإقلاع الأول الحسابات الأخرى ويديرها. يحصل كل مستخدم على وكلائه ومساحة عمله وبيانات اعتماده الخاصة، ويحمل المتصفح رمز الوصول الذي يفرض هذا العزل. وإلى جانب ذلك توجد قوالب الخبراء المضمّنة وحزم المهارات على مستوى المثيل. أُضيفت إمكانية مشاركة وكلائك مع مستخدمين آخرين في الإصدار v0.9.24، بعد الإصدار المحدد هنا.

استخدم الأدوات بحذر. يعلن Octop عن موافقة تشغيل الأدوات ووسائل حماية أوامر shell، وهذه الميزات موجودة فعلاً، لكن الوكيل الذي يشغّل أوامر shell يشغّلها داخل حاوية Octop مع تركيب وحدة بياناتك. تحدّ وسائل الحماية مما يمكن لموجّه غير حذر أن يفعله. لكنها لا تشكّل حدّاً عازلاً، لذلك اترك موافقة تشغيل الأدوات مفعّلة لأي شخص لا تمنحه وصولاً إلى shell. إذا كنت تقارن هذا بخيارات أخرى، تقارن المراجعة الشاملة لوكلاء الذكاء الاصطناعي المستضافين ذاتياً كيفية تعامل كل خيار مع ذلك.

ترقية مشروع يصدر الإصدارات بهذه السرعة

رسم بيانيDays between Octop releases, v0.9.16 to v0.9.19 (repository tags, 7 August 2026)
البيانات وراء هذا الرسم البياني
[
  {
    "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 November 2026، كان أحدث وسم هو v1.0.3b7، وقد نُشر في 18 November 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.

تُحمّل لوحة المعلومات، لكن لا يمكن للمحادثة الاتصال. يؤدي فشل مصافحة WebSocket إلى إنهاء حالة البث في v0.9.19. افتح وحدة تحكم المتصفح وابحث عن اتصال فاشل بـ wss://octop.example.com/api/agents/.../chat/ws. تحقّق من أن الـproxy يمرّر ترقية الاتصال. أضف الرأسين proxy_http_version 1.1 وUpgrade، والرأس Connection.

تظهر الإجابة كاملة دفعة واحدة بعد تأخير عدة ثوانٍ. يعمل البث، لكن التخزين المؤقت مفعّل. عيّن proxy_buffering off.

bind: address already in use. هناك برنامج آخر يستخدم 8088. يحدده sudo ss -tlnp | grep 8088. ويحدث ذلك أيضاً إذا أضفت إدخال ports ثانياً في ملف override بدلاً من تعديل الإدخال الأصلي.

يُرفض مرجع المرور الصحيح. تؤدي خمس محاولات خاطئة إلى قفل لمدة 900 ثانية. انتظر انتهاء المدة بدلاً من إعادة التثبيت.

لم تؤثر كلمة المرور الجديدة في .env. تُطبَّق بيانات الاعتماد هذه أثناء التهيئة الأولى فقط. غيّرها من لوحة المعلومات.

يجيب الوكيل، لكنه لا يشغّل أي أداة مطلقاً. تحقّق من تخصيص السياق للنموذج المحلي ومن دعمه لاستدعاء الدوال. توصي Ollama الآن بما لا يقل عن 64,000 رمز مميز لأحمال عمل الوكلاء؛ اختر نموذجاً وميزانية ذاكرة يدعمان ذلك.

FAQ

هل يُعد Octop بديلاً عن Open WebUI؟

فقط إذا كنت تحتاج إلى الميزات التي يضيفها. يدعم Open WebUI أيضاً عدة مستخدمين، والأدوار، وعناصر التحكم في الوصول. يجمع Octop بين الحسابات مع دور إداري، ومساحات عمل وبيانات اعتماد لكل مستخدم، ومكتبة قابلة للتبديل من الوكلاء المتخصصين. يتيح ذلك لعدة أشخاص مشاركة خادم واحد دون مشاركة سجل واحد. إذا كان الحساب الواحد مناسباً لك، فإن Open WebUI هو الخيار الأبسط والأكثر نضجاً بكثير.

لماذا ينبغي ألا أستخدم نص تثبيت Octop عبر curl؟

يجلب الأمر المكوّن من سطر واحد في v0.9.19 نصاً برمجياً من حاوية Tencent Cloud Object Storage، من دون تثبيت محتواه على وسم git أو commit محدد. يحتوي المستودع على نسخة ذات إصدار في scripts/install.sh، لكن تمرير النسخة البعيدة إلى 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، لأن API المحلي لـ Ollama لا يتطلب مصادقة. تحقق من نافذة السياق المخصّصة. تختلف الإعدادات الافتراضية لـ Ollama الآن وفق VRAM، وتوصي إرشاداته الحالية بما لا يقل عن 64,000 token لأحمال عمل الوكلاء، ضمن سياق النموذج المدعوم والذاكرة المتاحة.

هل أحتاج إلى reverse proxy، أم يمكنني فتح المنفذ 8088؟

تحتاج إلى proxy. ينشر ملف Compose المرفق مع Octop المنفذ 8088 على كل الواجهات من دون TLS. لذلك ستنتقل كلمات المرور وbearer tokens عبر الإنترنت بنص واضح. غيّر المنفذ المنشور إلى 127.0.0.1:8088:8088 وضع Caddy أو nginx أمامه مع شهادة. عند استخدام nginx، مرّر رؤوس ترقية WebSocket واضبط proxy_buffering off. تمنع ترقية فاشلة اتصال المحادثة، بينما يؤدي التخزين المؤقت إلى تأخير تدفق استئناف HITL. في v0.9.19، تنهي مصافحة فاشلة حالة البث، ولا يؤدي قطع الاتصال إلى إلغاء مهمة وكيل نشطة.

هل أصبح Octop جاهزاً للاستخدام في الإنتاج؟

كان البرنامج قبل الإصدار 1.0 ويصدر عدة إصدارات موسومة كل أسبوع حتى August 2026. وضع الوسم v1.0.0 في 14 September 2026، ثم أصدر سلسلة من وسوم 1.0.2 التجريبية قبل إصدار v1.0.2 المستقر في 18 October 2026. حتى 20 November 2026، كان أحدث وسم هو v1.0.3b7، وقد نُشر في 18 November 2026، بينما ظل v1.0.2 أحدث إصدار مستقر. لا تزال وتيرة الإصدارات سريعة، لذلك اعتبره واعداً لا مستقراً نهائياً. يمكن استخدامه لعائلة أو فريق داخلي صغير إذا ثبّتَّ وسمًا محدداً، وقرأت سجل commit قبل كل ترقية، وأنشأت نسخة احتياطية من وحدة تخزين البيانات قبل كل إعادة بناء. لا تشغّله على latest، ولا تضع فيه بيانات العملاء بعد.

هل كان هذا المقال مفيدًا؟