آموزش نصب Open WebUI کنار Ollama روی VPS؛ ساخت ChatGPT شخصی تحت وب

در آموزش قبلی Ollama را روی سرور مجازی لینوکس نصب کردیم، یک مدل هوش مصنوعی روی VPS اجرا کردیم و API اختصاصی آن را ساختیم. اما کار کردن دائمی با Terminal و دستورهای curl برای استفاده روزمره چندان جذاب نیست. اینجا Open WebUI وارد ماجرا می‌شود.

با نصب Open WebUI کنار Ollama می‌توانیم یک رابط چت هوش مصنوعی تحت وب و Self-hosted داشته باشیم؛ یعنی مرورگر را باز کنیم، وارد پنل خودمان شویم، مدل مورد نظر را انتخاب کنیم و تقریباً مانند سرویس‌های آنلاین هوش مصنوعی با مدل‌های اجراشده روی سرور خودمان گفتگو کنیم.

Open WebUI چیست؟

Open WebUI یک پلتفرم Self-hosted برای کار با مدل‌های هوش مصنوعی است. این پروژه می‌تواند به Ollama و سرویس‌های سازگار دیگر متصل شود و یک رابط تحت وب برای گفتگو و مدیریت AI در اختیار شما قرار دهد.

در ترکیبی که ما می‌سازیم، Ollama مسئول اجرای مدل است و Open WebUI رابط کاربری را در اختیارمان قرار می‌دهد.

Browser
   |
   v
Open WebUI
   |
   v
Ollama API
   |
   v
Local AI Model
   |
   v
CPU / GPU / RAM

این تفکیک مهم است. Open WebUI خودش جای مدل را نمی‌گیرد. مدل همچنان توسط Ollama اجرا می‌شود و منابع CPU، RAM یا GPU سرور را مصرف می‌کند.

با Open WebUI چه چیزی به Ollama اضافه می‌شود؟

Ollama به‌تنهایی برای CLI و API بسیار مناسب است. Open WebUI زمانی ارزش بیشتری پیدا می‌کند که بخواهید یک محیط گرافیکی و قابل استفاده از مرورگر داشته باشید.

تفاوت Ollama و Open WebUI چیست؟

پس بهتر است این دو را رقیب یکدیگر نبینیم. در این معماری، Open WebUI روی Ollama سوار می‌شود و تجربه استفاده از مدل را کامل‌تر می‌کند.

معماری نهایی سرور هوش مصنوعی ما

پس از تکمیل آموزش، VPS ما تقریباً چنین ساختاری خواهد داشت:

User Browser
     |
     v
Open WebUI :3000
     |
     v
Ollama :11434
     |
     v
AI Model
     |
     v
Server CPU / GPU / RAM

در مرحله آزمایشی Open WebUI را روی پورت ۳۰۰۰ باز می‌کنیم. برای استفاده واقعی و عمومی بهتر است بعداً دامنه، HTTPS و Reverse Proxy را به معماری اضافه کنیم.

پیش‌نیازهای نصب Open WebUI روی VPS

مرحله اول: مطمئن شوید Ollama فعال است

قبل از نصب Open WebUI ابتدا وضعیت Ollama را بررسی کنید:

sudo systemctl status ollama

سپس مدل‌های نصب‌شده را ببینید:

ollama list

برای اطمینان از پاسخ‌گویی API نیز می‌توانید دستور زیر را اجرا کنید:

curl http://127.0.0.1:11434/api/tags

اگر اطلاعات مدل‌ها برگردانده شد، Ollama آماده است.

مرحله دوم: نصب Docker روی Ubuntu

روش پیشنهادی Open WebUI برای اکثر کاربران استفاده از Docker است. ابتدا اگر Docker روی VPS نصب نیست، Repository رسمی Docker را برای Ubuntu اضافه کنید.

بسته‌های مورد نیاز را نصب کنید:

sudo apt update
sudo apt install ca-certificates curl -y
sudo install -m 0755 -d /etc/apt/keyrings

کلید رسمی Docker را اضافه کنید:

sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

سپس Repository را اضافه کنید:

echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

حالا Docker Engine و Compose Plugin را نصب کنید:

sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y

و نسخه Docker را بررسی کنید:

sudo docker --version
sudo docker compose version

مرحله سوم: ساخت WEBUI_SECRET_KEY

قبل از اجرای Open WebUI یک Secret Key ثابت بسازید. این مقدار باید محرمانه بماند و بهتر است بعداً بدون دلیل تغییر نکند.

openssl rand -hex 32

خروجی یک رشته تصادفی خواهد بود. آن را در محل امن نگه دارید و در دستور مرحله بعد به‌جای YOUR_SECRET_KEY قرار دهید.

مرحله چهارم: نصب Open WebUI با Docker

حالا Open WebUI را اجرا می‌کنیم. در این سناریو Ollama مستقیماً روی Ubuntu Host نصب شده و Open WebUI داخل Docker اجرا می‌شود.

دستور پیشنهادی:

sudo docker run -d \
  -p 3000:8080 \
  --add-host=host.docker.internal:host-gateway \
  -v open-webui:/app/backend/data \
  -e WEBUI_SECRET_KEY="YOUR_SECRET_KEY" \
  --name open-webui \
  --restart always \
  ghcr.io/open-webui/open-webui:main

به‌جای YOUR_SECRET_KEY همان مقدار تولیدشده در مرحله قبل را قرار دهید.

هر قسمت این دستور چه کاری انجام می‌دهد؟

مرحله پنجم: بررسی وضعیت Open WebUI

وضعیت کانتینر را ببینید:

sudo docker ps

اگر کانتینر در لیست بود، Logها را هم می‌توانید با دستور زیر مشاهده کنید:

sudo docker logs -f open-webui

برای خروج از حالت نمایش زنده Logها از ترکیب Ctrl+C استفاده کنید.

مرحله ششم: باز کردن Open WebUI در مرورگر

اگر پورت ۳۰۰۰ در Firewall سرور اجازه دسترسی داشته باشد، برای آزمایش اولیه آدرس زیر را در مرورگر وارد کنید:

http://SERVER_IP:3000

SERVER_IP را با IP واقعی VPS جایگزین کنید.

در اولین ورود، حساب مدیریتی اولیه را مطابق رابط Open WebUI ایجاد کنید. اطلاعات ورود را با رمز قوی نگه دارید؛ چون این پنل در صورت Public بودن می‌تواند به مدل‌ها، گفتگوها و قابلیت‌های مدیریتی شما دسترسی داشته باشد.

مرحله هفتم: اتصال Open WebUI به Ollama

اگر دستور Docker بالا را استفاده کرده باشید، Open WebUI باید بتواند از طریق Host Gateway به Ollama دسترسی پیدا کند. آدرس متداول برای Ollama نصب‌شده روی Host از داخل کانتینر چنین است:

http://host.docker.internal:11434

در Open WebUI می‌توانید از بخش مدیریت Connections وضعیت اتصال Ollama را بررسی کنید. مسیر رابط ممکن است با نسخه‌های مختلف کمی تغییر کند، اما در مستندات فعلی از بخش Settings → Admin → Connections برای مدیریت اتصال Ollama استفاده می‌شود.

اگر Open WebUI به Ollama وصل نشد چه کنیم؟

این یکی از مهم‌ترین خطاهایی است که ممکن است در این معماری ببینید. دلیلش تفاوت شبکه Host و Docker Container است.

ابتدا Ollama را روی خود Host بررسی کنید:

curl http://127.0.0.1:11434/api/tags

اگر این دستور کار می‌کند ولی Open WebUI مدل‌ها را نمی‌بیند، ارتباط Container → Host را بررسی کنید.

در سناریویی که Ollama روی Host و Open WebUI در Docker است، ممکن است لازم باشد Ollama روی Interface قابل دسترسی برای شبکه Docker Listen کند. برای ویرایش سرویس:

sudo systemctl edit ollama.service

سپس:

[Service]
Environment="OLLAMA_HOST=0.0.0.0:11434"

بعد سرویس را Reload و Restart کنید:

sudo systemctl daemon-reload
sudo systemctl restart ollama

چطور مطمئن شویم پورت 11434 عمومی نشده است؟

اگر UFW استفاده می‌کنید، وضعیت Ruleها را بررسی کنید:

sudo ufw status

برای سناریوی این مقاله نیازی نیست Rule عمومی زیر را ایجاد کنید:

11434/tcp ALLOW Anywhere

اگر قبلاً چنین دسترسی عمومی ایجاد کرده‌اید و به آن احتیاج ندارید، Ruleهای Firewall را بازبینی کنید. روش دقیق حذف Rule به تنظیمات فعلی UFW شما بستگی دارد؛ قبل از حذف، شماره Rule را با دستور زیر ببینید:

sudo ufw status numbered

مرحله هشتم: انتخاب مدل و شروع اولین گفتگو

اگر اتصال موفق باشد، مدل‌های نصب‌شده Ollama باید در Model Selector قابل مشاهده باشند. مدلی را که در آموزش قبلی Pull کرده‌اید انتخاب کنید و یک پیام آزمایشی ارسال کنید.

مثلاً:

اگر پاسخ دریافت شد، زنجیره زیر به‌درستی کار می‌کند:

Browser
  -> Open WebUI
  -> Ollama
  -> Model
  -> Response

آیا می‌توان مدل جدید را از داخل Open WebUI دانلود کرد؟

بله. اتصال Native به Ollama امکان مدیریت مدل‌های Ollama را از رابط مدیریتی Open WebUI فراهم می‌کند. بنابراین برای هر مدل الزاماً مجبور نیستید به SSH برگردید.

البته قبل از Pull کردن مدل جدید حتماً فضای دیسک و RAM سرور را بررسی کنید. مدل جدید ممکن است چند گیگابایت فضا بگیرد و هنگام اجرا نیز RAM قابل توجهی مصرف کند.

برای بررسی منابع:

free -h
df -h
ollama ps

Context در Open WebUI؛ یک تنظیم کوچک با تأثیر بزرگ

یکی از تنظیماتی که باید با دقت تغییر دهید num_ctx یا Context مدل است. Context تعیین می‌کند چه مقدار از گفتگو، دستورها و اطلاعات همراه Prompt در اختیار مدل قرار گیرد.

Context بسیار کوچک می‌تواند باعث قطع شدن بخش‌هایی از Prompt شود. از طرف دیگر، Context بزرگ‌تر RAM یا VRAM بیشتری مصرف می‌کند.

داده‌های Open WebUI کجا ذخیره می‌شوند؟

در دستور نصب ما از Volume زیر استفاده شد:

open-webui:/app/backend/data

این Volume بسیار مهم است، چون داده‌های Open WebUI باید خارج از عمر خود Container نگهداری شوند. اگر کانتینر را Update یا Recreate کنید، Volume باعث می‌شود داده‌های Persistent به خود کانتینر وابسته نباشند.

برای مشاهده Volume:

sudo docker volume inspect open-webui

از این Volume بکاپ بگیرید، مخصوصاً اگر کاربران، گفتگوها، تنظیمات یا Knowledge مهمی در Open WebUI دارید.

چطور Open WebUI را Restart کنیم؟

sudo docker restart open-webui

برای Stop:

sudo docker stop open-webui

و برای Start مجدد:

sudo docker start open-webui

چطور Open WebUI را آپدیت کنیم؟

اگر از Docker Run و Tag مورد نظر استفاده کرده‌اید، قبل از Update ابتدا از داده‌های مهم بکاپ داشته باشید. سپس Image جدید را Pull کنید و Container را با همان Volume و Secret قبلی Recreate کنید.

برای محیط Production بهتر است نسخه مشخصی را Pin کنید تا Update ناخواسته باعث تغییر رفتار سیستم نشود.

اگر از Docker Compose استفاده کنید، مدیریت Update ساده‌تر می‌شود:

sudo docker compose pull
sudo docker compose up -d

نصب Open WebUI با Docker Compose

اگر قرار است این سرویس را طولانی‌مدت مدیریت کنید، Docker Compose ساختار تمیزتری در اختیار شما قرار می‌دهد. یک پوشه بسازید:

mkdir -p ~/open-webui
cd ~/open-webui

سپس فایل docker-compose.yml ایجاد کنید:

services:
  open-webui:
    image: ghcr.io/open-webui/open-webui:main
    container_name: open-webui
    ports:
      - "3000:8080"
    volumes:
      - open-webui:/app/backend/data
    extra_hosts:
      - "host.docker.internal:host-gateway"
    environment:
      - WEBUI_SECRET_KEY=YOUR_SECRET_KEY
    restart: unless-stopped

volumes:
  open-webui:

YOUR_SECRET_KEY را با Secret واقعی خود جایگزین کنید و سپس:

sudo docker compose up -d

در Compose جدید از دستور docker compose با فاصله استفاده می‌شود؛ آموزش‌های قدیمی ممکن است هنوز از docker-compose استفاده کنند.

آیا می‌توان Ollama و Open WebUI را در یک Container اجرا کرد؟

Open WebUI Imageهایی برای سناریوی Bundled با Ollama هم ارائه می‌کند؛ اما در این آموزش عمداً آن‌ها را جدا نگه داشتیم.

دلیلش این است که شما Ollama را در آموزش قبلی روی Host نصب کرده‌اید و جدا بودن دو سرویس، درک معماری، مدیریت مدل‌ها و عیب‌یابی را ساده‌تر می‌کند.

در یک نصب جدید که هنوز Ollama وجود ندارد، روش Bundled می‌تواند گزینه دیگری باشد؛ اما نباید بدون دلیل دو Ollama جداگانه روی یک سرور ایجاد کنید و مدل‌ها را دوباره دانلود کنید.

چرا باید HTTPS را برای Open WebUI فعال کنیم؟

اگر فقط برای چند دقیقه روی شبکه کنترل‌شده آزمایش می‌کنید، IP و پورت ۳۰۰۰ کار را راه می‌اندازد. اما برای استفاده واقعی، ارسال نام کاربری، گفتگوها و فایل‌ها روی HTTP عمومی انتخاب مناسبی نیست.

معماری Production بهتر است شبیه این باشد:

https://ai.example.com
        |
        v
Nginx / HTTPS
        |
        v
Open WebUI :3000
        |
        v
Ollama :11434
        |
        v
AI Model

Open WebUI در مستندات رسمی خود برای HTTPS و Reverse Proxy راهنما دارد و استفاده از Nginx، Caddy و گزینه‌های دیگر را پوشش می‌دهد.

نکته مهم درباره Nginx و Streaming پاسخ AI

Reverse Proxy برای LLM دقیقاً مانند Proxy کردن یک صفحه ساده نیست. پاسخ مدل ممکن است Stream شود و تولید پاسخ طول بکشد.

طبق مستندات Open WebUI، هنگام استفاده از Reverse Proxy باید مواردی مثل WebSocket، Proxy Buffering و Timeoutهای طولانی‌تر را درست تنظیم کنید. در غیر این صورت ممکن است رابط باز شود اما Streaming یا بعضی قابلیت‌های Real-time درست کار نکنند.

این بخش ارزش یک آموزش مستقل دارد؛ بنابراین بهتر است کانفیگ Nginx و SSL را در مقاله جداگانه با تنظیمات کامل انجام دهیم، نه اینکه چند خط ناقص و ناامن در این مقاله قرار دهیم.

Open WebUI برای چند کاربر مناسب است؟

Open WebUI قابلیت‌های چندکاربره دارد، اما توان واقعی سیستم به منابع Backend مدل وابسته است. داشتن ۲۰ حساب کاربری به معنی توان پاسخ‌گویی هم‌زمان به ۲۰ درخواست سنگین نیست.

اگر چند کاربر هم‌زمان از مدل استفاده کنند، مصرف CPU، RAM یا GPU و Queue درخواست‌ها اهمیت بیشتری پیدا می‌کند. بنابراین برای استفاده تیمی باید Benchmark واقعی روی مدل و VPS خودتان انجام دهید.

آیا این سیستم واقعاً خصوصی است؟

اگر Open WebUI به Ollama محلی متصل باشد و مدل انتخابی نیز Local باشد، Inference مدل روی زیرساخت خودتان انجام می‌شود. این معماری کنترل بیشتری روی محل پردازش داده می‌دهد.

اما Open WebUI امکان اتصال Providerهای Cloud را نیز دارد. اگر یک مدل Cloud را انتخاب کنید، درخواست به Provider همان مدل ارسال می‌شود. بنابراین صرف نصب Open WebUI روی VPS به این معنی نیست که هر Provider و هر Tool متصل‌شده به آن Local است.

خطاهای رایج Open WebUI و Ollama

Open WebUI باز نمی‌شود

ابتدا docker ps را بررسی کنید. اگر Container اجرا نیست، docker logs را ببینید. سپس بررسی کنید پورت ۳۰۰۰ توسط Firewall یا سرویس دیگری مسدود نشده باشد.

صفحه باز می‌شود اما هیچ مدلی نمایش داده نمی‌شود

ابتدا ollama list را روی Host بررسی کنید. سپس Connection مربوط به Ollama در Open WebUI و دسترسی Container به host.docker.internal:11434 را بررسی کنید.

Connection Error هنگام اتصال به Ollama

معمولاً Ollama فقط روی 127.0.0.1 Listen می‌کند یا Host Gateway درست تنظیم نشده است. بخش رفع مشکل اتصال همین مقاله را بررسی کنید.

مدل بسیار کند پاسخ می‌دهد

Open WebUI معمولاً دلیل اصلی کندی Inference نیست. CPU، GPU، RAM، اندازه مدل، Quantization و Context را بررسی کنید.

بعد از Restart سرور Open WebUI بالا نمی‌آید

اگر Container با –restart always یا restart policy مناسب ساخته شده باشد باید دوباره اجرا شود. وضعیت Docker و Container را بررسی کنید.

بعد از Recreate کردن Container از حساب خارج شدم

مطمئن شوید WEBUI_SECRET_KEY ثابت است و هنگام Recreate کردن Container همان مقدار قبلی استفاده شده است.

Ollama تنها یا Ollama + Open WebUI؟

بعد از نصب Open WebUI چه پروژه‌هایی می‌توان ساخت؟

حالا دیگر فقط یک مدل در Terminal نداریم. یک پلتفرم AI تحت وب روی VPS ساخته‌ایم و می‌توانیم مرحله‌به‌مرحله قابلیت‌های حرفه‌ای‌تری به آن اضافه کنیم.

سؤالات متداول نصب Open WebUI کنار Ollama

Open WebUI چیست؟

Open WebUI یک پلتفرم Self-hosted برای تعامل با مدل‌های هوش مصنوعی است که می‌تواند به Ollama و Providerهای دیگر متصل شود و رابط تحت وب در اختیار کاربران قرار دهد.

آیا برای Open WebUI به Ollama نیاز داریم؟

الزاماً خیر؛ Open WebUI می‌تواند به Providerهای مختلف متصل شود. اما در این آموزش از Ollama به‌عنوان Backend مدل Local استفاده می‌کنیم.

آیا Open WebUI رایگان و متن‌باز است؟

کد Open WebUI در مخزن عمومی پروژه در دسترس است؛ برای جزئیات دقیق مجوز و شرایط استفاده تجاری، نسخه فعلی License پروژه را پیش از استقرار تجاری بررسی کنید.

Open WebUI روی چه پورتی اجرا می‌شود؟

در دستور Docker این آموزش، پورت ۸۰۸۰ کانتینر به پورت ۳۰۰۰ Host متصل شده است؛ بنابراین برای تست از SERVER_IP:3000 استفاده می‌کنیم.

چرا Open WebUI مدل‌های Ollama را نمایش نمی‌دهد؟

یکی از دلایل رایج این است که Container به Ollama روی Host دسترسی ندارد. آدرس host.docker.internal:11434، Host Gateway و تنظیم OLLAMA_HOST را بررسی کنید.

آیا می‌توان Open WebUI را با دامنه باز کرد؟

بله. برای محیط واقعی می‌توانید دامنه را به VPS متصل و Open WebUI را پشت Reverse Proxy مانند Nginx یا Caddy همراه HTTPS قرار دهید.

آیا گفتگوها بعد از Restart از بین می‌روند؟

اگر Volume دائمی به /app/backend/data متصل شده باشد، داده‌ها مستقل از عمر Container نگهداری می‌شوند. با این حال برای اطلاعات مهم باید Backup منظم داشته باشید.

آیا می‌توان Open WebUI را روی VPS بدون GPU اجرا کرد؟

بله. خود رابط Open WebUI الزاماً به GPU نیاز ندارد. توان اجرای مدل به Ollama و مدل انتخابی بستگی دارد و مدل‌های سبک می‌توانند روی CPU اجرا شوند.