لماذا لا تتطلب واجهة Ollama API كلمة مرور؟
تعمل Ollama بلا مصادقة، لذا يستطيع أي من يصل إلى المنفذ 11434 تشغيل نماذجك وتنزيلها وحذفها. تعرّف على الإصلاحات الثلاثة بالترتيب.
واجهة Ollama API بلا كلمة مرور
لا تستخدم Ollama API أي مصادقة. لا يوجد مستخدم أو كلمة مرور أو تحقق من مفتاح API للعملاء الواردين. يستطيع أي طرف يمكنه فتح اتصال TCP بالمنفذ 11434 عرض نماذجك وتشغيلها وتنزيل نماذج جديدة وحذف النماذج الموجودة لديك.
تذكر الوثائق الرسمية ذلك بوضوح: "لا تتطلب واجهة API المحلية على http://localhost:11434 مصادقة." وتحمل كلمة المحلية نموذج الأمان بأكمله. يرتبط Ollama افتراضياً بالعنوان 127.0.0.1، لذلك تكون واجهة loopback على الحاسوب المحمول هي آلية التحكم في الوصول. عند نقل المستمع إلى عنوان عام، تختفي آلية التحكم في الوصول لأن شيئاً لم يحل محلها.
لهذا الأمر أهمية على VPS (خادم خاص افتراضي). الإعداد الافتراضي آمن. أما التغيير الأول الذي يجريه معظم المستخدمين، وهو فتح المستمع كي يتمكن جهاز ثانٍ من استخدام النموذج، فيزيل كل وسائل الحماية دفعة واحدة.
ما الذي يكشفه فتح المنفذ 11434
كل نقاط النهاية. لا يوجد وضع للقراءة فقط ولا منفذ إدارة منفصل. هذه هي الطلبات الفعلية، وهي موجّهة إلى عنوان خادم بدلاً من localhost:
# List every model on the box
curl http://SERVER_IP:11434/api/tags
# See what is loaded into memory right now
curl http://SERVER_IP:11434/api/ps
# Run a prompt on your hardware
curl http://SERVER_IP:11434/api/generate -d '{"model":"llama3.2","prompt":"Why is the sky blue?"}'
# Write several gigabytes to your disk
curl http://SERVER_IP:11434/api/pull -d '{"model":"llama3.2"}'
# Remove a model
curl -X DELETE http://SERVER_IP:11434/api/delete -d '{"model":"llama3.2"}'من منظور المشغّل، تحدث أربع مشكلات:
- تنفّذ وحدة CPU أو GPU لديك عمليات استدلال لصالح شخص آخر. في خطة تتضمن حصة استخدام عادل لوحدة CPU، يعني الحمل المستمر أن شخصاً غريباً يستهلك حصتك، ويصبح ضبط تكاليف أحمال الذكاء الاصطناعي على VPS أصعب بكثير عندما لا تعود المتصل الوحيد.
- يكتب
/api/pullإلى القرص لديك. تختلف أحجام النماذج؛ حتىllama3.2:1bحجمه 1.3 GB. يؤدي تكرار عمليات السحب إلى امتلاء وحدة التخزين، ويؤدي القرص الممتلئ إلى تعطيل كل خدمة أخرى على الخادم، وليس Ollama فقط. - تصل الطلبات إلى داخل عمليتك وتُسجَّل. في مستوى السجل الافتراضي، يسجّل Ollama البيانات الوصفية فقط، لذلك تحصل على نقطة النهاية، والحالة، وزمن الاستجابة، وعنوان العميل، وليس نص المطالبة. يظل هذا سجلاً لمن استخدم خادمك والغرض من استخدامه، وهو موجود في journal، مع أنك لم تختر جمعه.
- يزيل
/api/deleteالنماذج. واستعادتها تعني تنزيلها مجدداً باستخدام عرض النطاق الترددي الخاص بك.
لا يتطلب أي من ذلك استغلالاً لثغرة. إنّها واجهة API موثّقة تعمل تماماً وفق التصميم.
مفتاح Ed25519 ليس وسيلة للتحكم في الوصول
ابحث عن "Ollama API key"، وستجد شيئين مختلفين. لا يُعد أيٌّ منهما كلمة مرور لخادمك، والتمييز بينهما يزيل معظم الالتباس.
الأول هو زوج مفاتيح الهوية. ينشئ Ollama زوج مفاتيح Ed25519 عند التشغيل للمرة الأولى. في Linux، ينشئ برنامج التثبيت مستخدماً نظامياً باسم ollama، ويضع دليله الرئيسي في /usr/share/ollama، لذلك يوجد الزوج هنا:
/usr/share/ollama/.ollama/id_ed25519
/usr/share/ollama/.ollama/id_ed25519.pubيُستخدم هذا المفتاح للاتصال بالخارج. يسجّل ollama signin الجزء العام لدى حسابك في ollama.com، وهو ما يصرّح لك بدفع نموذج إلى السجل أو سحب نموذج خاص. وهو يثبت هوية جهازك لدى ollama.com. لكنه لا يطلب أي شيء من العملاء الذين يتصلون بجهازك. لا يؤدي حذفه أو تدويره أو عدم إنشائه مطلقاً إلى تغيير من يمكنه استدعاء واجهة API الخاصة بك.
الثاني هو OLLAMA_API_KEY. يحتوي هذا المتغير على مفتاح تنشئه في https://ollama.com/settings/keys، ويرسله عميلك في Authorization: Bearer $OLLAMA_API_KEY عند استدعاء واجهة API المستضافة في https://ollama.com/api. وهو بيانات اعتماد لخدمتهم، وتستخدمها أنت بصفتك العميل. لا يستخدم ollama serve الخاص بك هذا المفتاح لمصادقة الطلبات الواردة. لا يؤدي ضبط OLLAMA_API_KEY على VPS الخاص بك إلى وضع كلمة مرور على VPS.
لذلك لا يوجد إعداد يجب تفعيله. تعمل وسائل الحماية الثلاثة أدناه بالطريقة نفسها: أبقِ المنفذ غير قابل للوصول، وضع أمامه شيئاً يتحقق من الطلبات.
تحقّق مما يستمع إليه خادمك الآن
sudo ss -tlnp | grep 11434تُظهر النتيجة الآمنة عنوان loopback:
LISTEN 0 4096 127.0.0.1:11434 0.0.0.0:* users:(("ollama",pid=812,fd=3))تُظهر النتيجة المكشوفة كل واجهة:
LISTEN 0 4096 0.0.0.0:11434 0.0.0.0:* users:(("ollama",pid=812,fd=3))يشير 0.0.0.0 إلى جميع عناوين IPv4 على الخادم، بما في ذلك العنوان العام. ويشير *:11434 و[::]:11434 إلى مستمعين عامّين على كل عنوان IPv6. يعتمد قبول الاتصالات عبر IPv4 أيضاً على خيار المقبس IPV6_V6ONLY، الذي يتركه Linux معطّلاً افتراضياً (net.ipv6.bindv6only=0)، لذلك اعتبر أيّاً من القيم الثلاث مكشوفاً.
تحقّق الآن من خارج الخادم. نفّذ هذا الأمر على حاسوبك المحمول، وليس على الخادم:
curl -m 5 http://YOUR_SERVER_IP:11434/api/versionإن curl: (28) Connection timed out after 5001 milliseconds هي الإجابة المطلوبة، وكذلك curl: (7) Failed to connect ... Connection refused. يعني كائن JSON يحتوي على الحقل version أن واجهة API بأكملها يمكن لأي شخص طلبها. لا يثبت اختبار الخادم باستخدام curl أن جهازاً آخر يستطيع الوصول إليه. إذا كان للخادم عنوان IPv6، فأعد الاختبار باستخدام curl -6 -m 5 http://[YOUR_SERVER_IPV6]:11434/api/version، لأن إغلاق منفذ IPv4 لا يثبت شيئاً بشأن مستمع IPv6.
يحدث التعريض عادةً بإحدى طريقتين. الأولى تعديل متعمّد، لأن شخصاً احتاج إلى وصول جهاز ثانٍ إلى النموذج:
sudo systemctl edit ollama.service[Service]
Environment="OLLAMA_HOST=0.0.0.0:11434"يمثّل هذا السطر الواحد كامل عملية التعريض. والطريقة الثانية هي Docker، ولا تتطلب منك تعديل أي شيء على الإطلاق. وسنشرحها في قسم مستقل أدناه.
الدفاع 1: أبقِ الخدمة على localhost وأنشئ نفقاً للوصول إليها
ابدأ بهذا الخيار. لا يحتاج إلى برامج جديدة، ولا ينشئ بيانات اعتماد يمكن تسرّبها. لا يظهر المنفذ على أي واجهة عامة، لذلك لا تستطيع عمليات الفحص العثور عليه.
حدّد عنوان الربط صراحةً بدلاً من الاعتماد على القيمة الافتراضية:
sudo systemctl edit ollama.service[Service]
Environment="OLLAMA_HOST=127.0.0.1:11434"يكتب ذلك /etc/systemd/system/ollama.service.d/override.conf. طبّق التغيير وتحقق منه:
sudo systemctl daemon-reload
sudo systemctl restart ollama
sudo ss -tlnp | grep 11434يجب أن يعرض ss الآن 127.0.0.1:11434. إذا كان لا يزال يعرض 0.0.0.0، فهذا يعني أن ملف drop-in ثانياً له الأولوية. شغّل systemctl cat ollama.service لسرد الوحدة وجميع ملفات drop-in مع مساراتها، ثم احذف الملف القديم.
لاستخدام النموذج من حاسوبك المحمول، أعد توجيه المنفذ عبر SSH:
ssh -N -L 11434:127.0.0.1:11434 you@your-serverيفتح -L 11434:127.0.0.1:11434 المنفذ 11434 على حاسوبك المحمول، ويرسل كل ما يصل إليه إلى 127.0.0.1:11434 كما يراه الخادم. يخبر -N SSH بعدم تشغيل أمر بعيد، لذلك تظل العملية محتفظة بالنفق مفتوحاً. أثناء تشغيله، يعمل الأمر التالي على حاسوبك المحمول:
curl -s http://localhost:11434/api/tagsستواجه فشلين شائعين. يعني bind [127.0.0.1]:11434: Address already in use أن العنوان والمنفذ المحليين مستخدمان بالفعل، سواء بواسطة Ollama أو نفق SSH آخر أو برنامج آخر. اختر منفذاً محلياً مختلفاً باستخدام -L 11500:127.0.0.1:11434، ووجّه عميلك إلى 11500. إذا أعاد طلب يمر عبر النفق استجابة فارغة، فتحقق من ss على الخادم ومن مخرجات أخطاء SSH قبل تحديد الخدمة التي فشلت.
إذا كان لديك عدة أجهزة عميلة، فالشبكة الخاصة أفضل من إنشاء نفق لكل مستخدم. صِل الأجهزة عبر WireGuard أو Tailscale، ثم اربط Ollama بعنوانه على هذه الشبكة بدلاً من 0.0.0.0:
[Service]
Environment="OLLAMA_HOST=10.8.0.1:11434"سيظهر المنفذ عندئذ على واجهة تحتاج إلى مفتاح للانضمام إليها فقط. يحميك ذلك أيضاً من أخطاء إعداد الجدار الناري، لأن القاعدة التي تسمح للعالم بالوصول عن طريق الخطأ لا تستطيع كشف مستمع لا توجد عليه الواجهة العامة.
الدفاع 2: Reverse Proxy يتحقق من bearer token
عندما يجب على شيء على الإنترنت العام استدعاء النموذج، اترك Ollama على loopback وضع Proxy أمامه. ينهي الـProxy اتصال TLS (أمان طبقة النقل) ويرفض الطلبات التي لا تحتوي على الرأس الصحيح. يظل Ollama يقبل الاتصالات من 127.0.0.1 فقط، لذلك يكون الـProxy هو المسار الوحيد للدخول.
أنشئ token حقيقياً أولاً. لا تنشئه يدوياً:
openssl rand -base64 36ملف موقع nginx يتحقق منه:
map $http_authorization $ollama_ok {
default 0;
"Bearer PASTE_YOUR_GENERATED_TOKEN_HERE" 1;
}
server {
listen 443 ssl;
server_name llm.example.com;
ssl_certificate /etc/letsencrypt/live/llm.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/llm.example.com/privkey.pem;
location = /api/pull { return 403; }
location = /api/delete { return 403; }
location = /api/push { return 403; }
location / {
if ($ollama_ok = 0) { return 401; }
proxy_pass http://127.0.0.1:11434;
proxy_set_header Host 127.0.0.1:11434;
proxy_buffering off;
proxy_read_timeout 600s;
}
}تؤدي خمسة أسطر فيه وظيفة فعلية، ويمنع كل سطر منها عطلاً قد تواجهه لولا ذلك.
يُعد if داخل كتلة location فكرة سيئة عادةً في nginx، لكن body بطول return بالضبط هو أحد الشكلين اللذين يعملان بطريقة يمكن التنبؤ بها، لذلك فإن هذا الاستخدام آمن.
يطابق location = /api/pull تطابقاً تاماً، ويضع nginx التطابقات التامة قبل السابقة location /، لذلك تُرفض نقاط النهاية الثلاث هذه قبل التحقق من token. يتيح token صالح الوصول إلى نقاط نهاية أخرى لإدارة النموذج، بما في ذلك /api/create و/api/blobs/:digest، لذلك لا تمنع هذه الكتل الثلاث كل عمليات الكتابة على القرص.
يهم proxy_set_header Host 127.0.0.1:11434; لأن Ollama يفحص رأسي Host وOrigin الواردين. قد يؤدي تمرير اسم المضيف العام للـProxy مباشرةً إلى إنشاء 403 Forbidden مصدره Ollama بدلاً من nginx، مما يصعّب تصحيح المشكلة. ويمثل OLLAMA_ORIGINS وسيلة التحكم الأخرى، عند استخدام عميل متصفح يحتاج إلى السماح بأصل محدد.
يهم proxy_buffering off; لأن Ollama يرسل استجابته token تلو الآخر. عند تفعيل التخزين المؤقت، يخزن nginx الاستجابة مؤقتاً قبل إرسالها، مما يؤخر تسليم الـtokens المتدفقة.
يهم proxy_read_timeout 600s; لأن القيمة الافتراضية في nginx هي 60 ثانية، ويعمل المؤقت بين عمليتي قراءة متتاليتين من Ollama، لا على كامل الاستجابة. تعيد استجابة streaming التي تواصل إنتاج tokens ضبط المؤقت في كل مرة. أما الطلب الذي لا يرسل فيه Ollama شيئاً لمدة 60 ثانية فيؤدي إلى انتهاء المهلة، مثل طلب يُرسل مع "stream": false، والذي يعيد الإجابة كاملة في النهاية دفعة واحدة، أو طلب يسبق وصول أول token فيه صمت طويل. يحصل العميل على 504 Gateway Time-out، ويسجل /var/log/nginx/error.log القيمة upstream timed out (110: Connection timed out) while reading response header from upstream. كان الطلب لا يزال قيد التنفيذ. لكن nginx أوقفه.
أعد التحميل واختبر المسارين:
sudo nginx -t && sudo systemctl reload nginx
curl -s -o /dev/null -w '%{http_code}\n' https://llm.example.com/api/tags
curl -s -H "Authorization: Bearer YOUR_TOKEN" https://llm.example.com/api/tagsيجب أن يطبع الأول 401. ويجب أن يطبع الثاني قائمة النماذج. إذا أعاد الأول أيضاً قائمة النماذج، فتحقق من الخادم وlocation اللذين عالجا الطلب، ومن نجاح إعادة التحميل. تجعل كتلة map الموجودة في النطاق الخطأ الإعداد غير صالح. يجب أن تكون على مستوى http، لذلك ضعها في ملف ضمن /etc/nginx/conf.d/ أو فوق كتلة server، ولا تضعها داخل server.
ينفذ Caddy المهمة نفسها باستخدام basic authentication في أربعة أسطر، وهو أنسب لعميل متصفح من bearer token:
llm.example.com {
basic_auth {
apiuser PASTE_BCRYPT_HASH_HERE
}
reverse_proxy 127.0.0.1:11434
}شغّل caddy hash-password لإنشاء bcrypt hash الذي يتوقعه. ملاحظة حول التسمية: كان التوجيه يُسمى basicauth قبل Caddy v2.8، وأصبح يسمى basic_auth الآن. لا يزال Caddy يقبل التسمية القديمة كاسم بديل deprecated، لذلك يُحمّل الإعداد المنسوخ من دليل أقدم، لكن Caddy يحذّر من أن basicauth deprecated ويطلب استخدام basic_auth بدلاً منه. أعد تسميته عند ظهور هذا التحذير.
أيّاً كان الـProxy الذي تختاره، فهذا secret مشترك واحد للجميع. يملك كل عميل يحوزه الصلاحيات نفسها، ويعني إبطاله تعديل الإعداد وتحديث كل مستدعٍ في الوقت نفسه.
الدفاع 3: بوابة تُصدر مفاتيح لكل عميل
عندما يستدعي أكثر من شخص أو تطبيق النموذج، ينفد هامش استخدام الرمز المشترك. لا يمكنك معرفة العميل الذي تسبب في الحمل، ولا إيقاف أحدهم دون إيقاف الجميع. تعمل البوابة في الموضع الذي كان يشغله الـproxy، وتستخدم واجهة API نفسها المتوافقة مع OpenAI، وتُصدر مفتاحاً منفصلاً لكل عميل، وتسجل ما استخدمه كل مفتاح. بوابة LiteLLM مستضافة ذاتياً هي الخيار المعتاد، وتضيف ميزانيات لكل مفتاح وسجلات للطلبات إلى جانب التحكم في الوصول.
لا تتغير القاعدة الواردة في الدفاع 1. يرتبط Ollama بالعنوان 127.0.0.1، وتكون البوابة هي العملية الوحيدة التي تتصل به، كما تكون البوابة هي الخدمة الوحيدة التي تستمع على منفذ عام. وجود بوابة على خادم ما يزال المنفذ 11434 فيه مفتوحاً للعالم لا يحقق حماية فعلية، لأن المتصلين يستطيعون ببساطة تجاوزها.
فخ الجدار الناري: يتجاوز منفذ الحاوية المنشور UFW
لهذا تظهر مثيلات مكشوفة على خوادم ضبط مالكوها جداراً نارياً بصورة صحيحة.
يكتب UFW (الجدار الناري غير المعقد) قواعده في سلسلة INPUT ضمن جدول filter الخاص بـkernel، بينما تتعامل INPUT مع الحزم الموجّهة إلى المضيف نفسه. يضيف خيار -p في Docker قاعدة NAT للوجهة (ترجمة عنوان الشبكة) إلى سلسلة PREROUTING ضمن جدول nat، الذي يقيّمه kernel قبل أن يحدد وجهة الحزمة. وعند اتخاذ قرار التوجيه، تكون الوجهة قد أُعيدت كتابتها إلى عنوان الحاوية، لذلك تُمرَّر الحزمة بدلاً من تسليمها محلياً، وتعبر FORWARD بدلاً من INPUT. ولا تُفحَص قواعد INPUT في UFW مطلقاً، فتتجاوز الحزمة الجدار الناري بدلاً من المرور عبره.
لهذا يترك التسلسل التالي المنفذ 11434 مفتوحاً على الإنترنت:
sudo ufw default deny incoming
sudo ufw enable
docker run -d -v ollama:/root/.ollama -p 11434:11434 --name ollama ollama/ollamaومع ذلك، يظل sudo ufw status يعرض الجدار الناري على أنه نشط مع سياسة رفض افتراضية. القراءتان صحيحتان في الوقت نفسه، وهذا تحديداً ما يجعل الناس يثقون بالقراءة الخاطئة. يمكنك رؤية القاعدة التي سببت ذلك:
sudo iptables -t nat -L DOCKER -nالإصلاح هو إضافة عنوان واحد إلى خيار النشر:
docker rm -f ollama
docker run -d -v ollama:/root/.ollama -p 127.0.0.1:11434:11434 --name ollama ollama/ollamaلا يحدد -p 11434:11434 أي عنوان للمضيف، لذلك ينشر Docker المنفذ على كل عناوين المضيف، سواء IPv4 (0.0.0.0) أو IPv6 ([::]). أما تحديد 127.0.0.1 فيربط طرف المضيف من التعيين بواجهة loopback، ولذلك يظل نفق SSH وreverse proxy قادرين على الوصول إليه، بينما لا يستطيع الإنترنت ذلك. إصدارات Docker الأقدم من 28.0.0 لها استثناء: يمكن للأجهزة الموجودة في مقطع الشبكة نفسه الوصول إلى المنافذ المنشورة إلى localhost، لذا قم بالترقية قبل الاعتماد على هذه الحماية. إعادة إنشاء الحاوية آمنة هنا لأن النماذج موجودة في وحدة التخزين المسماة ollama، وليس داخل الحاوية.
تأكد من توافق العرضين:
docker port ollama
sudo ss -tlnp | grep 11434ينبغي أن يطبع docker port ollama القيمة 11434/tcp -> 127.0.0.1:11434. إذا طبع 0.0.0.0:11434 أو [::]:11434، فما زلت مكشوفاً. تعلّم الآلية مرة واحدة، وستنطبق على كل حاوية تنشرها مستقبلاً: يشرح سبب تجاوز المنافذ المنشورة في Docker لـUFW سلسلة DOCKER-USER والقواعد التي تبقى بعد إعادة تشغيل Docker. إذا كنت لا تزال تبني سياسة المضيف نفسها، فيشرح قواعد UFW التي يحتاج إليها VPS جديد الأساس الذي تعتمد عليه هذه الإعدادات. لا يوجد UFW لتكوينه على Rocky أو AlmaLinux، لذا ابدأ من السياسة الأساسية نفسها مكتوبة باستخدام firewalld بدلاً من ذلك.
باسم أي حساب تعمل العملية
ينشئ برنامج التثبيت في Linux حساباً مخصصاً، ويشغّل الخدمة تحته:
useradd -r -s /bin/false -U -m -d /usr/share/ollama ollamaتضبط الوحدة الموجودة في /etc/systemd/system/ollama.service بعد ذلك كلاً من User=ollama وGroup=ollama. اترك هذا الإعداد كما هو. إن تشغيل ollama serve يدوياً بسرعة في الطرفية يتم باسم الحساب الذي سجلت الدخول به. وإذا كان ذلك الحساب هو root، فستكتب واجهة API غير موثّقة الملفات باسم root. تحقّق من الحساب المستخدم:
ps -o user= -C ollamaيجب أن تكون النتيجة ollama. وتشير أي نتيجة أخرى إلى أن عملية بدأت يدوياً تعمل إلى جانب الوحدة أو بدلاً منها. ينطبق المنطق نفسه على كل daemon تضيفه لاحقاً، ويساعدك تشغيل الخدمات بحسابات ذات أقل صلاحيات على تطبيق ذلك بشكل صحيح.
كيفية التحقق من أمان نقطة نهاية Ollama API
أياً كان اختيارك، فهناك اختبار واحد يحسم الأمر، ويجب تشغيله من جهاز آخر:
curl -m 5 http://YOUR_SERVER_IP:11434/api/version
curl -m 5 http://YOUR_SERVER_IP:11434/api/tagsيجب أن تنتهي محاولتا الاتصال بمهلة أو أن يرفضهما الخادم. إذا أنشأت proxy، فيجب أن يعيد المساران نفسهما على اسم مضيف الـproxy الرمز 401 من دون بيانات اعتماد، وJSON فعلياً عند تقديمها.
ثم اقرأ access log مرة واحدة بحثاً عن الطلبات التي أُجريت أثناء فتح المنفذ:
journalctl -u ollama --since "-30 days" | grep GINيكتب Ollama سطراً واحداً لكل طلب، ويتضمن عنوان العميل:
[GIN] 2026/08/12 - 14:01:10 | 200 | 103.965898ms | 127.0.0.1 | POST "/api/generate"يأتي هذا العنوان من ClientIP() في Gin، الذي يتحقق أيضاً من رأسي X-Forwarded-For وX-Real-IP الواردين من proxies موثوقة. لذلك قد يعرض الطلب المار عبر reverse proxy يعمل على loopback عنوان عميل عاماً، مع أن Ollama مرتبط بشكل صحيح بالعنوان 127.0.0.1. لا يثبت ظهور عنوان عام في هذا العمود أن الوصول إلى المنفذ 11434 كان مباشراً، كما أن عدم وجود أسطر مطابقة في السجل لا يثبت أن أحداً لم يصل إليه. قارِن الطوابع الزمنية مع سجلات proxy وإعداداته، واستخدم اختبار الاتصال الخارجي للتحقق من مستوى التعرض الحالي. إذا كان جانب النماذج جديداً عليك، فراجع تشغيل Ollama على VPS لمعرفة خطوات التثبيت، وتحديد حجم النموذج، وحدود الذاكرة التي تحدد ما سيتم تحميله فعلياً.
FAQ
هل لدى Ollama مفتاح API أو كلمة مرور؟
لا. لا يوفّر الخادم الذي تشغّله أي نوع من المصادقة، وتوضح الوثائق الرسمية أن واجهة API المحلية لا تتطلب المصادقة. والشيئان اللذان يُسمّيان «مفتاح Ollama API» يشيران إلى الجهة الأخرى. يثبت زوج Ed25519 في /usr/share/ollama/.ollama/ أن جهازك لدى ollama.com، لكي تتمكن من دفع النماذج وسحب النماذج الخاصة. أما OLLAMA_API_KEY فهو بيانات اعتماد يرسلها عميلك إلى واجهة API المستضافة على https://ollama.com/api. ولا يستخدم ollama serve الخاص بك أياً منهما لمصادقة العملاء الواردين، لذلك يجب أن تأتي سياسة التحكم في الوصول من الشبكة أو من proxy أمامه.
هل يُعد OLLAMA_HOST=0.0.0.0 آمناً إذا كان لدي جدار ناري؟
فقط إذا كان الجدار الناري يحظر الوصول إلى نقطة الاستماع هذه بشكل صحيح. يعني 0.0.0.0 أن نقطة الاستماع موجودة فعلاً على الواجهة العامة، وأنك تعتمد على الجدار الناري وحده لمنع الوصول إليها. يحتاج منفذ Ollama المنشور عبر Docker إلى عناية منفصلة، لأن قاعدة DNAT التي يضيفها Docker إلى جدول nat تُقيَّم قبل وصول الحزمة إلى سلسلة INPUT التي يعمل فيها UFW، ولذلك تُمرَّر الحزمة ولا ترى قواعد INPUT في UFW هذه الحزمة. يؤدي الربط مع 127.0.0.1 أو مع عنوان نفق خاص إلى إزالة نقطة الاستماع من الواجهة العامة، ولذلك لا يبقى ما يمكن لخطأ في إعداد الجدار الناري أن يكشفه.
كيف أتحقق من أن منفذ Ollama مفتوح على الإنترنت؟
شغّل sudo ss -tlnp | grep 11434 على الخادم، وشغّل curl -m 5 http://YOUR_SERVER_IP:11434/api/version من جهاز مختلف. إن أظهر ss القيمة 127.0.0.1:11434 وانتهت مهلة curl البعيد، فهذه هي النتيجة المطلوبة. أما إذا أظهر ss القيمة 0.0.0.0:11434 أو *:11434، وأعاد curl البعيد JSON، فهذا يعني أن واجهة API كاملة يمكن الوصول إليها. لا يثبت اختبار curl على الخادم نفسه قدرة جهاز آخر على الوصول إليه.
هل يمكنني نقل المنفذ من 11434 إلى منفذ عشوائي؟
لا، ويجب توضيح السبب. لا يؤدي تغيير المنفذ إلى إبطاء أي شيء سوى فحص منفذ واحد. تفحص أدوات المسح النطاق بالكامل، ويحدد طلب واحد إلى /api/tags الخدمة، أياً كان المنفذ الذي وصل إليه الطلب. كما يؤدي نقل المنفذ إلى كسر الإعداد الافتراضي لكل عميل، ويجعل فهم إعدادك الخاص أصعب لاحقاً. اربط الخدمة بعنوان loopback بدلاً من ذلك، فهذا يزيل نقطة الاستماع بدلاً من نقلها.
وصل أحدهم إلى Ollama المفتوح لدي. ما الذي يجب أن أتحقق منه؟
اربطه مع 127.0.0.1 وأعد تشغيل الخدمة أولاً، لكي يتوقف التعرض قبل بدء التحقيق. ثم شغّل journalctl -u ollama --since "-30 days" | grep GIN لمراجعة عناوين العملاء ونقاط النهاية والطوابع الزمنية. يقرأ Gin أيضاً رؤوس عناوين العملاء المُعاد توجيهها، لذلك قارن هذه الإدخالات بسجلات proxy قبل اعتبار عنوان ما دليلاً على وصول مباشر. قارن ollama list بالنماذج التي قصدت امتلاكها، لأن /api/pull لا يتطلب المصادقة، وأي نموذج لم تسحبه يمثل استخداماً لمساحة القرص ودليلاً في الوقت نفسه. تحقق من المساحة الحرة باستخدام df -h. يسجل سجل الوصول الافتراضي بيانات وصفية للطلب، لكنه لا يسجل اسم النموذج أو نص prompt أو الإجابة المُولَّدة.