امنسازی Ollama API: بستن پورت 11434
سرویس Ollama بهصورت پیشفرض فاقد احراز هویت است و هر کسی با دسترسی به پورت 11434 میتواند مدلهای شما را کنترل کند. در این مطلب 3 راهکار عملی برای ایمنسازی سرور بررسی شده است.
رابط برنامهنویسی Ollama فاقد رمز عبور است
رابط برنامهنویسی (API) Ollama هیچگونه احراز هویتی ندارد. هیچ کاربر، رمز عبور یا بررسی کلید API برای کلاینتهای ورودی وجود ندارد. هر چیزی که بتواند یک اتصال TCP به پورت 11434 برقرار کند، میتواند مدلهای شما را لیست کند، آنها را اجرا نماید، مدلهای جدید دانلود کند و مدلهای موجود را حذف نماید.
مستندات رسمی این موضوع را بهصراحت بیان کردهاند: "رابط برنامهنویسی محلی در http://localhost:11434 نیازی به احراز هویت ندارد." کلمه محلی (local) تمام مدل امنیتی را در بر میگیرد. Ollama بهصورت پیشفرض روی 127.0.0.1 گوش میدهد، بنابراین در یک لپتاپ، رابط loopback نقش کنترل دسترسی را ایفا میکند. اگر این شنونده را به یک آدرس عمومی منتقل کنید، کنترل دسترسی از بین میرود، زیرا هیچ جایگزینی برای آن در نظر گرفته نشده است.
به همین دلیل است که این موضوع در یک VPS (سرور مجازی خصوصی) اهمیت پیدا میکند. حالت پیشفرض امن است. اولین تغییری که اکثر افراد ایجاد میکنند، یعنی باز کردن شنونده برای اینکه ماشین دومی بتواند از مدل استفاده کند، همان تغییری است که تمام محافظتها را بهیکباره حذف میکند.
اطلاعاتی که باز بودن پورت 11434 فاش میکند
تمام endpointها. هیچ حالت read-only یا پورت مدیریتی جداگانهای وجود ندارد. اینها درخواستهای واقعی هستند که به جای 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) شما برای شخص دیگری عملیات inference انجام میدهد. در پلنهایی که محدودیت مصرف CPU دارند، بار کاری مداوم به معنای هدر رفتن سهمیه شما توسط یک غریبه است و کنترل هزینههای بار کاری هوش مصنوعی روی VPS زمانی که شما تنها کاربر نباشید، بسیار دشوارتر میشود.
/api/pullروی دیسک شما مینویسد. حجم مدلها متفاوت است؛ حتیllama3.2:1bنیز 1.3 گیگابایت است. یک حلقه از دستورات pull باعث پر شدن حجم دیسک میشود و پر شدن دیسک، نه تنها Ollama، بلکه تمام سرویسهای دیگر روی سرور را از کار میاندازد.- درخواستها وارد پردازش شما شده و ثبت (log) میشوند. در سطح لاگ پیشفرض، Ollama فقط متادیتا را ذخیره میکند؛ بنابراین شما endpoint، وضعیت، تأخیر (latency) و آدرس کلاینت را دریافت میکنید، نه متن prompt را. با این حال، این همچنان سندی از این است که چه کسی و برای چه کاری از سرور شما استفاده کرده است که در journal شما باقی میماند، در حالی که شما تمایلی به جمعآوری آن نداشتهاید.
/api/deleteمدلها را حذف میکند. بازگرداندن آنها به معنای دانلود مجددشان با استفاده از پهنای باند خودتان است.
هیچکدام از این موارد نیازی به exploit ندارند. این رفتار دقیقاً مطابق با طراحی مستندات API است.
کلید Ed25519 یک ابزار کنترل دسترسی نیست
اگر عبارت "Ollama API key" را جستجو کنید، با دو مفهوم متفاوت مواجه میشوید. هیچکدام از این دو، رمز عبور سرور شما نیستند و تفکیک آنها بخش بزرگی از سردرگمیها را برطرف میکند.
مورد اول، جفتکلید هویت است. Ollama در اولین اجرا یک جفتکلید Ed25519 تولید میکند. در لینوکس، اسکریپت نصب یک کاربر سیستمی به نام ollama ایجاد میکند که دایرکتوری خانگی آن در /usr/share/ollama قرار دارد، بنابراین این جفتکلید در اینجا ذخیره میشود:
/usr/share/ollama/.ollama/id_ed25519
/usr/share/ollama/.ollama/id_ed25519.pubاین کلید به سمت بیرون اشاره دارد. ollama signin نیمه عمومی کلید را در حساب کاربری ollama.com شما ثبت میکند و این همان چیزی است که به شما اجازه میدهد مدلی را به registry ارسال (push) کنید یا یک مدل خصوصی را دریافت (pull) کنید. این کلید هویت دستگاه شما را برای ollama.com اثبات میکند. این کلید هیچ درخواستی از کلاینتهایی که به دستگاه شما متصل میشوند، ندارد. حذف کردن، تغییر دادن (rotate) یا هرگز ایجاد نکردن آن، هیچ تغییری در اینکه چه کسی میتواند API شما را فراخوانی کند، ایجاد نمیکند.
مورد دوم OLLAMA_API_KEY است. این متغیر کلیدی را نگه میدارد که شما در https://ollama.com/settings/keys ایجاد میکنید و کلاینت شما هنگام فراخوانی API میزبانیشده در https://ollama.com/api، آن را به عنوان Authorization: Bearer $OLLAMA_API_KEY ارسال میکند. این یک اعتبارنامه برای سرویس آنهاست که توسط شما به عنوان کلاینت استفاده میشود. 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 شنوندههای wildcard روی تمام آدرسهای IPv6 هستند. اینکه آیا این موارد اتصالات IPv4 را نیز میپذیرند یا خیر، به گزینهٔ IPV6_V6ONLY سوکت بستگی دارد که لینوکس بهصورت پیشفرض آن را غیرفعال نگه میدارد (net.ipv6.bindv6only=0)؛ بنابراین هر سه مورد را در معرض دسترسی عمومی در نظر بگیرید.
اکنون از خارج از شبکه بررسی کنید. این دستور را روی لپتاپ خود اجرا کنید، نه روی سرور:
curl -m 5 http://YOUR_SERVER_IP:11434/api/versioncurl: (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 و استفاده از تونل
این اولین راهکار پیشنهادی است. این روش به هیچ نرمافزار جدیدی نیاز ندارد و هیچ اعتبارنامهای ایجاد نمیکند که احتمال نشت داشته باشد. پورت هرگز روی رابط عمومی (public interface) ایجاد نمیشود، بنابراین اسکن کردن شبکه نمیتواند آن را پیدا کند.
آدرس bind را بهجای تکیه بر مقدار پیشفرض، بهصورت صریح تنظیم کنید:
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 11434ss اکنون باید 127.0.0.1:11434 را نشان دهد. اگر همچنان 0.0.0.0 را نشان میدهد، یک فایل drop-in دیگر اولویت دارد. دستور systemctl cat ollama.service را اجرا کنید تا unit و تمام فایلهای 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 به آدرس آن شبکه متصل (bind) کنید:
[Service]
Environment="OLLAMA_HOST=10.8.0.1:11434"در این حالت، پورت فقط روی رابطی وجود دارد که برای پیوستن به آن به یک کلید نیاز دارید. این روش در برابر اشتباهات فایروال نیز مقاوم است، زیرا قانونی که بهطور تصادفی دسترسی عمومی را باز میگذارد، همچنان نمیتواند سرویسی را که روی رابط عمومی گوش نمیدهد، در معرض دید قرار دهد.
دفاع 2: یک reverse proxy که bearer token را بررسی میکند
هنگامی که سرویسی در اینترنت عمومی باید مدل را فراخوانی کند، Ollama را روی loopback نگه دارید و یک پروکسی در مقابل آن قرار دهید. پروکسی، TLS (امنیت لایه انتقال) را خاتمه میدهد و درخواستهای فاقد هدر صحیح را رد میکند. Ollama همچنان فقط اتصالات از 127.0.0.1 را میپذیرد، بنابراین پروکسی تنها مسیر ورودی است.
ابتدا یک توکن واقعی تولید کنید. آن را بهصورت دستی ابداع نکنید:
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 ایده بدی است، اما بدنه دقیقاً return یکی از دو شکلی است که رفتار قابل پیشبینی دارد، بنابراین این استفاده ایمن است.
location = /api/pull یک تطابق دقیق است و nginx تطابقهای دقیق را بالاتر از پیشوند location / رتبهبندی میکند، بنابراین آن سه endpoint قبل از اینکه حتی توکن بررسی شود، رد میشوند. یک توکن معتبر همچنان دسترسی به سایر endpointهای مدیریت مدل، از جمله /api/create و /api/blobs/:digest را فراهم میکند، بنابراین این سه بلوک از تمام عملیات نوشتن روی دیسک جلوگیری نمیکنند.
proxy_set_header Host 127.0.0.1:11434; اهمیت دارد زیرا Ollama هدرهای ورودی Host و Origin را بررسی میکند. عبور مستقیم نام میزبان عمومی پروکسی میتواند منجر به تولید یک 403 Forbidden شود که از سمت Ollama آمده است نه از سمت nginx، که اشکالزدایی آن گیجکننده است. OLLAMA_ORIGINS اهرم دیگر است، برای کلاینت مرورگری که نیاز دارد یک origin خاص مجاز باشد.
proxy_buffering off; اهمیت دارد زیرا Ollama پاسخ خود را توکن به توکن استریم میکند. با فعال بودن buffering، nginx پاسخ را قبل از ارسال به جلو بافر میکند که باعث تأخیر در تحویل توکنهای استریمشده میشود.
proxy_read_timeout 600s; اهمیت دارد زیرا مقدار پیشفرض nginx برابر با 60 ثانیه است و این تایمر بین دو خواندن متوالی از Ollama اجرا میشود، نه در کل پاسخ. یک پاسخ استریم که مدام توکن تولید میکند، آن را هر بار ریست میکند. درخواستی که در آن Ollama به مدت 60 ثانیه چیزی ارسال نمیکند، باعث فعال شدن آن میشود؛ مانند درخواستی که با "stream": false ارسال شده و کل پاسخ را در پایان به صورت یکجا برمیگرداند، یا سکوت طولانی قبل از رسیدن اولین توکن. کلاینت 504 Gateway Time-out را دریافت میکند و /var/log/nginx/error.log مقدار upstream timed out (110: Connection timed out) while reading response header from upstream را ثبت میکند. درخواست همچنان در حال کار بوده است، اما nginx از آن قطع امید کرده است.
پیکربندی را reload کرده و هر دو مسیر را تست کنید:
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 درخواست را مدیریت کرده و آیا reload موفقیتآمیز بوده است یا خیر. یک بلوک map در scope اشتباه، پیکربندی را نامعتبر میکند. این بلوک متعلق به سطح 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 مورد انتظار آن تولید شود. یک نکته در مورد نامگذاری: این دستور قبل از Caddy v2.8 به صورت basicauth بود و اکنون basic_auth است. Caddy همچنان املای قدیمی را به عنوان یک alias منسوخ میپذیرد، بنابراین پیکربندی کپیشده از یک راهنمای قدیمی بارگذاری میشود، اما Caddy هشدار میدهد که basicauth منسوخ شده و از شما میخواهد که از basic_auth استفاده کنید. هنگامی که آن هشدار را دیدید، آن را تغییر نام دهید.
هر پروکسی که انتخاب کنید، این یک راز مشترک برای همه است. هر کلاینتی که آن را در اختیار دارد دسترسی یکسانی دارد و ابطال آن به معنای ویرایش پیکربندی و بهروزرسانی همزمان تمام فراخوانکنندهها است.
دفاع 3: دروازهای که برای هر کلاینت کلید صادر میکند
هنگامی که بیش از یک شخص یا برنامه مدل را فراخوانی میکنند، یک توکن مشترک دیگر پاسخگو نخواهد بود. در این حالت نمیتوان تشخیص داد کدام کلاینت باعث ایجاد بار شده است و نمیتوان دسترسی یکی از آنها را بدون قطع دسترسی همه مسدود کرد. یک دروازه (gateway) در همان جایگاهی قرار میگیرد که پروکسی قرار داشت، از همان API سازگار با OpenAI استفاده میکند، برای هر کلاینت یک کلید مجزا صادر کرده و میزان مصرف هر کلید را ثبت میکند. یک دروازه LiteLLM خود-میزبانیشده راهکار معمول برای این مسئله است که علاوه بر کنترل دسترسی، امکان تعیین بودجه برای هر کلید و ثبت لاگ درخواستها را نیز فراهم میکند.
قانون ذکر شده در دفاع 1 تغییر نمیکند. Ollama باید به 127.0.0.1 متصل شود، دروازه تنها فرآیندی باشد که با آن ارتباط برقرار میکند و دروازه تنها سرویسی باشد که دارای شنونده (listener) عمومی است. وجود دروازه روی سیستمی که پورت 11434 آن همچنان برای عموم باز است، صرفاً جنبه تزئینی دارد؛ زیرا فراخوانکنندهها میتوانند بهسادگی آن را دور بزنند.
تلهٔ فایروال: پورتهای منتشرشدهٔ کانتینر، UFW را دور میزنند
به همین دلیل است که نمونههای سرویسهای در معرض دید، روی سرورهایی وجود دارند که مالکان آنها فایروال را بهدرستی پیکربندی کردهاند.
ابزار UFW (فایروال ساده) قوانین خود را در زنجیرهٔ INPUT از جدول filter هسته مینویسد و INPUT بستههایی را که مقصدشان خودِ میزبان است، مدیریت میکند. فلگ -p در Docker، یک قانون NAT (ترجمه آدرس شبکه) مقصد را در زنجیرهٔ PREROUTING از جدول nat مینویسد که هسته پیش از تصمیمگیری دربارهٔ مسیر بسته، آن را ارزیابی میکند. تا زمانی که تصمیم مسیریابی اتخاذ شود، مقصد قبلاً به آدرس کانتینر بازنویسی شده است؛ بنابراین بسته بهجای تحویل محلی، فوروارد میشود و بهجای عبور از INPUT، از FORWARD میگذرد. قوانین 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 همچنان گزارش میدهد که فایروال فعال است و سیاست پیشفرض آن deny است. هر دو گزارش همزمان درست هستند و دقیقاً به همین دلیل است که کاربران به گزارش اشتباه اعتماد میکنند. میتوانید قانونی که این کار را انجام داده است مشاهده کنید:
sudo iptables -t nat -L DOCKER -nراه حل، افزودن یک آدرس در فلگ publish است:
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 دسترسی داشته باشند، بنابراین پیش از تکیه بر این محافظت، سیستم را ارتقا دهید. بازسازی کانتینر در اینجا ایمن است، زیرا مدلها در volume نامگذاریشدهٔ ollama قرار دارند، نه داخل کانتینر.
تأیید کنید که هر دو دیدگاه با هم توافق دارند:
docker port ollama
sudo ss -tlnp | grep 11434docker port ollama باید 11434/tcp -> 127.0.0.1:11434 را چاپ کند. اگر 0.0.0.0:11434 یا [::]:11434 را چاپ کرد، شما همچنان در معرض خطر هستید. این مکانیزم را یکبار بیاموزید تا برای هر کانتینری که منتشر میکنید کاربرد داشته باشد: چرا پورتهای منتشرشده توسط Docker، فایروال UFW را دور میزنند زنجیرهٔ DOCKER-USER و قوانینی که پس از راهاندازی مجدد Docker باقی میمانند را پوشش میدهد. اگر هنوز در حال ساخت سیاست اصلی میزبان هستید، قوانین UFW مورد نیاز برای یک VPS جدید پایه و اساسی که این تنظیمات روی آن قرار میگیرد را توضیح میدهد. در Rocky یا AlmaLinux ابزار UFW برای پیکربندی وجود ندارد، بنابراین همان سیاست پایه نوشتهشده در firewalld نقطه شروع مناسبی است.
این پردازش با چه کاربری اجرا میشود
اسکریپت نصب لینوکس یک حساب کاربری اختصاصی ایجاد میکند و سرویس را تحت آن اجرا مینماید:
useradd -r -s /bin/false -U -m -d /usr/share/ollama ollamaفایل unit در مسیر /etc/systemd/system/ollama.service سپس مقادیر User=ollama و Group=ollama را تنظیم میکند. این تنظیمات را تغییر ندهید. اجرای سریع ollama serve بهصورت دستی در ترمینال، با کاربری که با آن لاگین کردهاید اجرا میشود؛ اگر آن کاربر root باشد، یک API بدون احراز هویت، فایلها را با دسترسی root مینویسد. بررسی کنید وضعیت چگونه است:
ps -o user= -C ollamaپاسخ باید ollama باشد. هر چیز دیگری به این معنی است که یک پردازشِ دستی در کنار یا بهجای unit در حال اجراست. همین منطق برای هر daemon دیگری که بعداً اضافه میکنید نیز صادق است و اجرای سرویسها با کاربران دارای حداقل دسترسی این موضوع را بهدرستی بررسی میکند.
نحوه بررسی امنیت endpoint مربوط به Ollama API
صرفنظر از روش انتخابی شما، یک تست وضعیت را مشخص میکند و باید از ماشینی دیگر اجرا شود:
curl -m 5 http://YOUR_SERVER_IP:11434/api/version
curl -m 5 http://YOUR_SERVER_IP:11434/api/tagsهر دو دستور باید با خطای timeout یا connection refused مواجه شوند. اگر یک proxy راهاندازی کردهاید، همان دو مسیر روی نام میزبان (hostname) مربوط به proxy باید بدون اعتبارنامه، کد 401 و با اعتبارنامه، JSON واقعی را بازگردانند.
سپس لاگ دسترسی را برای درخواستهایی که در زمان باز بودن پورت ثبت شدهاند، بررسی کنید:
journalctl -u ollama --since "-30 days" | grep GINOllama برای هر درخواست یک خط مینویسد و آدرس کلاینت را نیز شامل میشود:
[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 را از proxyهای مورد اعتماد نیز بررسی میکند. بنابراین، یک درخواست از طریق reverse proxy در loopback میتواند آدرس کلاینت عمومی را نشان دهد، در حالی که Ollama بهدرستی روی 127.0.0.1 bind شده است. وجود یک آدرس عمومی در آن ستون، لزوماً به معنای دسترسی مستقیم به پورت 11434 نیست و نبود خطوط لاگ منطبق نیز ثابت نمیکند که کسی به آن دسترسی پیدا نکرده است. زمانها (timestamps) را با لاگها و پیکربندی proxy خود مقایسه کنید و از تست اتصال از راه دور برای بررسی وضعیت فعلی exposure استفاده کنید. اگر مباحث مربوط به مدل برای شما جدید است، اجرای Ollama روی VPS شامل نصب، تعیین اندازه مدل و محدودیتهای حافظه است که مشخص میکند چه چیزی واقعاً بارگذاری خواهد شد.
FAQ
آیا Ollama دارای API key یا رمز عبور است؟
خیر. سروری که اجرا میکنید فاقد هرگونه احراز هویت است و مستندات رسمی تأیید میکنند که API محلی نیازی به احراز هویت ندارد. هر دو موردی که با نام "Ollama API key" شناخته میشوند، کاربرد متفاوتی دارند. جفتکلید Ed25519 در /usr/share/ollama/.ollama/ دستگاه شما را برای ollama.com احراز هویت میکند تا بتوانید مدلها را push یا مدلهای خصوصی را pull کنید. OLLAMA_API_KEY یک اعتبارنامه است که کلاینت شما به API میزبانیشده در https://ollama.com/api ارسال میکند. ollama serve شخصی شما از هیچکدام برای احراز هویت کلاینتهای ورودی استفاده نمیکند، بنابراین کنترل دسترسی باید از طریق شبکه یا یک پروکسی در لایهٔ جلویی اعمال شود.
آیا OLLAMA_HOST=0.0.0.0 در صورت داشتن فایروال امن است؟
تنها در صورتی که فایروال دسترسی به آن listener را بهدرستی مسدود کند. 0.0.0.0 به این معنی است که listener واقعاً روی اینترفیس عمومی وجود دارد و شما صرفاً به فایروال اعتماد کردهاید تا آن را غیرقابلدسترس نگه دارد. پورت Ollama که توسط Docker منتشر شده است نیاز به توجه ویژهای دارد، زیرا قانون DNAT که Docker به جدول nat اضافه میکند، پیش از رسیدن بسته به زنجیرهٔ INPUT (جایی که UFW در آن قرار دارد) ارزیابی میشود؛ بنابراین بسته فوروارد شده و قوانین INPUT در UFW هرگز آن را نمیبینند. Bind کردن روی 127.0.0.1 یا یک آدرس تونل خصوصی، listener را از اینترفیس عمومی حذف میکند تا در صورت بروز خطا در فایروال، چیزی برای افشا شدن باقی نماند.
چگونه بررسی کنم که آیا پورت Ollama من برای اینترنت باز است؟
دستور sudo ss -tlnp | grep 11434 را روی سرور و curl -m 5 http://YOUR_SERVER_IP:11434/api/version را از یک ماشین دیگر اجرا کنید. مشاهده ss به همراه 127.0.0.1:11434 و timeout شدن دستور curl از راه دور، همان نتیجهای است که انتظار دارید. مشاهده ss به همراه 0.0.0.0:11434 یا *:11434 در حالی که curl از راه دور پاسخ JSON برمیگرداند، به این معنی است که کل API در دسترس است. تست کردن با curl روی خودِ سرور، مشخص نمیکند که آیا ماشین دیگری میتواند به آن دسترسی داشته باشد یا خیر.
آیا میتوانم پورت را از 11434 به یک پورت تصادفی تغییر دهم؟
خیر، و دلیل آن قابلتأمل است. تغییر پورت هیچچیز را کند نمیکند، مگر اسکنِ یک پورت واحد را. اسکنرها کل محدوده را بررسی میکنند و یک درخواست به /api/tags، نوع سرویس را فارغ از پورتی که روی آن ارسال شده، شناسایی میکند. تغییر پورت همچنین تنظیمات پیشفرض تمام کلاینتها را مختل کرده و درک پیکربندی شما را در آینده دشوارتر میکند. بهجای جابهجایی، آن را روی loopback bind کنید که باعث حذف listener میشود، نه جابهجایی آن.
شخصی به Ollama بازِ من دسترسی پیدا کرده است. چه چیزی را باید بررسی کنم؟
ابتدا آن را روی 127.0.0.1 bind کرده و سرویس را restart کنید تا دسترسی پیش از شروع بررسی متوقف شود. سپس journalctl -u ollama --since "-30 days" | grep GIN را اجرا کنید تا آدرسهای کلاینت، endpointها و زمانبندیها را مرور کنید. Gin همچنین هدرهای آدرس کلاینتِ فوروارد شده را میخواند، بنابراین پیش از آنکه یک آدرس را به عنوان مدرک دسترسی مستقیم در نظر بگیرید، آن ورودیها را با لاگهای پروکسی خود مقایسه کنید. ollama list را با مدلهایی که قصد داشتید داشته باشید مقایسه کنید، زیرا /api/pull فاقد احراز هویت است و مدلی که شما pull نکردهاید، هم نشاندهنده مصرف دیسک و هم مدرکی از نفوذ است. فضای آزاد را با df -h بررسی کنید. لاگ دسترسی پیشفرض، متادیتای درخواست را ثبت میکند، نه نام مدل، متن prompt یا پاسخ تولیدشده را.