Личный кабинет
На сайт
← База знаний

Open WebUI и Ollama на VPS: собственный ИИ-чат

Open WebUI предоставляет браузерный интерфейс для общения с моделями. В этом примере есть приватный Ollama и небольшая модель: можно проверить всю цепочку чата, не открывая сервер моделей в интернет. У Open WebUI собственная лицензия с условиями по брендингу; самостоятельное размещение не означает неограниченные права на переименование.

Среда: Ubuntu Server 24.04 LTS, x86-64, SSH и учётная запись с sudo. Проверено по документации 15 ноября 2026 года. Команды не проходили сквозное испытание на Ubuntu.

Что подготовить

Для теста интерфейса вместе с небольшой моделью ориентируйтесь на 4 vCPU, 8 ГБ RAM и 20 ГБ свободного диска. Интерфейс и модель потребляют память отдельно. Внешний API снижает требования к вычислениям на VPS, но может передавать запросы за его пределы и тарифицироваться отдельно.

Приведённые ресурсы — ориентир для небольшого теста, а не гарантия производительности или описание тарифов. VPS/VDS не означает наличие GPU. Проверьте память, диск и доступные ресурсы перед заказом.

На чистой Ubuntu установите пакеты ниже. Если Docker уже установлен из другого репозитория, сохраните текущую установку и сначала проверьте совместимость: не смешивайте пакеты Docker CE и docker.io. Нужен Compose v2; при отсутствии пакета проверьте включение репозитория Ubuntu Universe.

sudo apt update
sudo apt install -y docker.io docker-compose-v2 curl openssl
sudo systemctl enable --now docker
sudo docker compose version

Все примеры публикуют порты только на 127.0.0.1 сервера. Для доступа с компьютера используйте SSH-туннель; домен для этого не нужен. Не открывайте эти порты в интернете. Внутренний адрес 0.0.0.0 в контейнере не отменяет привязку опубликованного порта к loopback хоста.

Каждый проект ниже — новая установка. Не повторяйте генерацию секретов поверх уже работающего экземпляра.

1. Сохраните конфигурацию приватного чата

Создайте постоянный секретный ключ. Сохраните YAML в compose.yaml: публикуется только интерфейс и только на loopback. Имя ollama — DNS-имя сервиса Docker, а не localhost вашего ноутбука.

umask 077
mkdir -p ~/ai-webui
cd ~/ai-webui
printf 'WEBUI_SECRET_KEY=%s\n' "$(openssl rand -hex 32)" > .env
services:
  ollama:
    image: ollama/ollama:latest
    restart: unless-stopped
    environment:
      OLLAMA_NUM_PARALLEL: "1"
      OLLAMA_CONTEXT_LENGTH: "2048"
    volumes:
      - models:/root/.ollama
  webui:
    image: ghcr.io/open-webui/open-webui:main
    restart: unless-stopped
    ports:
      - "127.0.0.1:3000:8080"
    environment:
      OLLAMA_BASE_URL: http://ollama:11434
      WEBUI_SECRET_KEY: ${WEBUI_SECRET_KEY:?set WEBUI_SECRET_KEY in .env}
    volumes:
      - webui:/app/backend/data
    depends_on:
      - ollama
volumes:
  models:
  webui:

2. Запустите сервисы и создайте администратора

Первый блок выполните на VPS, SSH-команду — на своём компьютере. Откройте http://127.0.0.1:3000 и создайте первого администратора до предоставления кому-либо доступа. В панели администратора проверьте, что после настройки регистрация закрыта. Не отключайте авторизацию ради решения проблем со входом.

sudo docker compose up -d
sudo docker compose exec ollama ollama pull qwen2.5:0.5b
curl --fail-with-body http://127.0.0.1:3000/health
ssh -N -L 127.0.0.1:3000:127.0.0.1:3000 YOUR_USER@YOUR_SERVER_IP

3. Проверьте чат и защитите рабочее пространство

Выберите загруженную модель и задайте короткий вопрос без конфиденциальных данных. Если список пуст, проверьте адрес Ollama и журналы: 127.0.0.1:11434 внутри контейнера интерфейса указывает не на тот контейнер. Не включайте непроверенные инструменты и функции. Копируйте том webui и .env вместе: от секретного ключа могут зависеть сохранённые данные авторизации. Том моделей может быть большим; если планируете загрузить веса заново, сохраните их точные идентификаторы.

Обновления и восстановление

Перед обновлением остановите приложение на время согласованного резервного копирования, сохраните данные и секреты за пределами VPS и проверьте восстановление на отдельном экземпляре. Изменяемые теги образов в примерах нужны для первоначальной оценки; перед постоянной эксплуатацией зафиксируйте проверенный тег выпуска или digest. Запишите текущий digest командой sudo docker image inspect ИМЯ_ОБРАЗА --format '{{json .RepoDigests}}'. Не запускайте автоматические обновления без проверки совместимости и не удаляйте тома командой down -v.

Если приложение не запускается, проверьте sudo docker compose ps, последние журналы, свободное место и память. Не публикуйте журналы с ключами, содержимым запросов или персональными данными. При ошибке доступа к каталогу проверьте UID/GID и владельца, а не назначайте права 777. Для совместного доступа сначала настройте HTTPS, аутентификацию и ограничения запросов.

Другие сценарии