Как установить LibreChat через Docker Compose и подключить TokenMaster
LibreChat — это бесплатный self-hosted интерфейс для общения с моделями ИИ, который поддерживает множество провайдеров, включая любой OpenAI-совместимый API. Внешне он напоминает ChatGPT, но вы полностью контролируете, к каким моделям он обращается, и храните данные у себя. Благодаря этому вы не привязаны к одному сервису: к нему можно подключить DeepSeek, GLM (Zhipu) и Qwen через шлюз TokenMaster. Если хочется интерфейс попроще, есть TypingMind — self-hosted альтернатива с похожими возможностями.
Что понадобится
- Компьютер с Windows, macOS или Linux.
- Docker: Docker Desktop (Windows/macOS) или Docker Engine с плагином Compose (Linux).
- API-ключ TokenMaster (создаётся в разделе «Ключи» после регистрации).
Установка через Docker Compose
Основной способ установки LibreChat — Docker Compose: он работает одинаково на всех трёх системах и не требует настраивать окружение вручную. Установите Docker, затем выполните в терминале:
git clone https://github.com/danny-avila/LibreChat.git
cd LibreChat
cp .env.example .env
Теперь откройте файл .env в текстовом редакторе и заполните обязательные секреты случайными значениями: CREDS_KEY, CREDS_IV, JWT_SECRET и JWT_REFRESH_SECRET. Это нужно для безопасного хранения ваших ключей. После этого запустите контейнеры:
docker compose up -d
LibreChat поднимется на http://localhost:3080. При первом входе он предложит создать учётную запись — это локальный аккаунт, который хранится только у вас.
Полезные команды для управления:
docker compose down # остановить
docker compose up -d # запустить снова
docker compose logs # посмотреть логи, если что-то пошло не так
TypingMind — ещё один self-hosted интерфейс, который тоже работает с OpenAI-совместимым API. Если LibreChat покажется избыточным, его можно развернуть аналогично через Docker и подключить TokenMaster тем же способом: достаточно указать Base URL и ключ в настройках OpenAI-провайдера, и модели сразу появятся в чате.
Подключение TokenMaster
LibreChat умеет работать с любым OpenAI-совместимым API, поэтому TokenMaster подключается как обычный OpenAI-провайдер. Настройка занимает минуту:
- Зарегистрируйтесь на tokenmaster.ru и создайте API-ключ в разделе «Ключи».
- В LibreChat откройте настройки провайдеров: в интерфейсе выберите Settings → Providers (или панель администратора), затем провайдер OpenAI.
- Заполните поля:
- Base URL:
https://tokenmaster.ru/v1 - API Key: ваш ключ вида
sk-…
- Base URL:
- Сохраните настройки и выберите модель в чате.
Почему TokenMaster? Это OpenAI-совместимый API: один ключ
sk-…и один баланс для моделей DeepSeek, GLM (Zhipu) и Qwen, оплата из России без привязки к зарубежной карте. Base URL единый —https://tokenmaster.ru/v1.
Проверка работы
Чтобы убедиться, что всё настроено верно, задайте модели простой вопрос в чате. Если ответ пришёл — подключение работает. Если появилась ошибка:
- 401 / invalid api key — проверьте, что ключ скопирован целиком и начинается с
sk-. - connection error — проверьте, что Base URL указан ровно как
https://tokenmaster.ru/v1, без лишнего/chat/completionsв конце. - insufficient quota — на балансе недостаточно средств, пополните его в личном кабинете.
Частые вопросы
Можно ли установить LibreChat без Docker? Да, LibreChat можно запустить и без Docker, но это заметно сложнее: придётся вручную настроить Node.js, MongoDB и переменные окружения. Docker Compose — самый простой и надёжный способ.
Какие модели доступны через TokenMaster? Модели DeepSeek, GLM / Zhipu и Qwen. Каталог регулярно пополняется — актуальный список смотрите на tokenmaster.ru/pricing.
Чем LibreChat отличается от TypingMind? Оба — self-hosted интерфейсы для OpenAI-совместимых API. LibreChat — открытый и бесплатный, с гибкой настройкой провайдеров; TypingMind — более лёгкий и ориентирован на простоту. Оба подключаются к TokenMaster одинаково.
Итог
LibreChat даёт удобный self-hosted интерфейс для любых OpenAI-совместимых моделей, а TokenMaster закрывает вопрос с самими моделями и оплатой. Укажите Base URL https://tokenmaster.ru/v1 и ключ — и можно работать.