Как установить Open WebUI на Windows, macOS и Linux и подключить TokenMaster

· open-webui установка чат ai

Open WebUI — это бесплатный веб-интерфейс для работы с большими языковыми моделями с открытым исходным кодом. Внешне он похож на ChatGPT, но при этом вы полностью контролируете, к каким моделям он обращается. Это значит, что вместо одной закрытой подписки вы можете подключить к нему любые модели через OpenAI-совместимый API — например, шлюз TokenMaster.

В этой инструкции разберём два надёжных способа установки Open WebUI (Docker и pip), которые работают на Windows, macOS и Linux, и покажем, как за пару минут подключить модели TokenMaster.

Что понадобится

  • Компьютер с Windows, macOS или Linux.
  • Docker (рекомендуется) или Python 3.11+ с pip.
  • API-ключ TokenMaster (создаётся в разделе «Ключи» после регистрации).

Установка через Docker (рекомендуется)

Docker — самый простой способ, потому что работает одинаково на всех трёх системах и не требует настраивать окружение Python. Установите Docker Desktop (Windows/macOS) или Docker Engine (Linux), затем выполните команду:

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

После запуска откройте в браузере http://localhost:3000. При первом входе Open WebUI предложит создать аккаунт администратора — это локальная учётная запись, она хранится только у вас.

Полезные команды для управления контейнером:

docker stop open-webui    # остановить
docker start open-webui   # запустить снова
docker logs open-webui    # посмотреть логи, если что-то пошло не так

Установка через pip (если Docker не хочется)

Если Docker недоступен, Open WebUI ставится как обычный Python-пакет. Подойдёт Python 3.11 или новее.

python -m venv venv
source venv/bin/activate        # Windows: venv\Scripts\activate
pip install open-webui
open-webui serve

Сервер запустится на http://localhost:8080. Чтобы обновить Open WebUI позже, достаточно выполнить pip install --upgrade open-webui.

Подключение TokenMaster

Open WebUI работает с любым OpenAI-совместимым API, а TokenMaster предоставляет именно такой интерфейс. Подключение займёт минуту:

  1. Зарегистрируйтесь на tokenmaster.ru и создайте API-ключ в разделе «Ключи».
  2. В Open WebUI откройте Настройки → Подключения → OpenAI API (шестерёнка внизу слева, затем вкладка «Админ»).
  3. Заполните поля:
    • Base URL: https://tokenmaster.ru/v1
    • API Key: ваш ключ вида sk-…
  4. Нажмите «Сохранить» и выберите модель в чате.

После этого в списке моделей появятся доступные модели TokenMaster — DeepSeek, GLM (Zhipu) и Qwen — и можно писать запросы сразу в веб-интерфейсе.

Почему TokenMaster? Один ключ sk-… и один баланс для всех моделей, оплата из России, без привязки к зарубежной карте. Base URL единый — https://tokenmaster.ru/v1.

Проверка работы

Чтобы убедиться, что всё настроено верно, задайте модели простой вопрос в чате. Если ответ пришёл — подключение работает. Если появилась ошибка:

  • 401 / invalid api key — проверьте, что ключ скопирован целиком (начинается с sk-).
  • connection error — проверьте, что Base URL указан ровно как https://tokenmaster.ru/v1, без лишнего /chat/completions в конце.
  • insufficient quota — на балансе недостаточно средств, пополните его в разделе «Кошелёк».

Частые вопросы

Можно ли использовать Open WebUI без Docker и Python? Да — у Open WebUI есть десктопные приложения для Windows, macOS и Linux. Они работают так же, а подключение TokenMaster настраивается в тех же настройках «Подключения».

Какие модели доступны через TokenMaster? Модели DeepSeek (deepseek-flash, deepseek-v4-pro), GLM / Zhipu (glm-4.5, glm-5 и другие) и Qwen. Каталог регулярно пополняется — актуальный список смотрите в «Model Square» на tokenmaster.ru/pricing.

Open WebUI может работать с несколькими провайдерами одновременно? Да, в «Подключения» можно добавить несколько OpenAI API-эндпоинтов и переключаться между ними.

Итог

Open WebUI — быстрый способ получить удобный интерфейс для моделей ИИ на любом компьютере, а TokenMaster закрывает вопрос с самими моделями и оплатой. Настройка занимает несколько минут: установите Open WebUI, укажите Base URL https://tokenmaster.ru/v1 и ключ — и можно работать.

Подключите модели через TokenMaster

Один ключ sk-… и base URL https://tokenmaster.ru/v1 — доступ к DeepSeek, GLM, Qwen и другим моделям. Зарегистрироваться →