LobeHub
Self-hosted портал поверх LLM: команда AI-агентов, чат с любой моделью, база знаний с RAG и встроенный веб-поиск - на своем сервере, ключ к модели свой. Развернули полный стек 2.0, вывели egress через не-РФ прокси и подтвердили живой диалог.
Вердикт
- кому нужен приватный AI-портал у себя: чат, агенты, база знаний с RAG и веб-поиск в одном интерфейсе
- у кого есть ключ хотя бы к одному провайдеру - модель считает провайдер на своих GPU, локальный GPU не нужен
- кто хочет держать историю переписок, файлы и агентов на своем сервере, а не в чужом облаке
- кому нужен локальный инференс без внешнего API - это фронт к чужой модели, а не своя модель на своем железе
- кто ждет «просто чат в один контейнер» - в 2.0 это стек из шести сервисов
- у кого нет ключа ни к одному LLM-провайдеру - без него чат мертв
Что это и какую задачу решает
LobeHub - это бывший LobeChat в ветке 2.0 с самопозиционированием «Chief Agent Operator». Не чат-обертка над одной моделью, а связка: чат с любой моделью, команда AI-агентов (сборка ассистентов, задачи по расписанию, память), база знаний с RAG на Postgres pg_search и встроенный веб-поиск через SearXNG. Все это - под собственным доменом, на собственном сервере, с историей и файлами, которые не уходят в чужое облако.
Ключевой момент: LobeHub - это фронт к внешнему LLM-API, а не локальный инференс. Модель считает провайдер (OpenAI, Anthropic, Gemini, DeepSeek, OpenRouter или любой OpenAI-совместимый эндпоинт) на своих GPU. Ключ - ваш, по схеме BYO-key. Поэтому серверу с одним CPU видеокарта не нужна: в отличие от связки, где модель поднимают локально, тут вся тяжелая математика уезжает к провайдеру.
Чем отличается от платных порталов
Сравнение по тому, что влияет на выбор self-hosted-портала против готового SaaS.
| Параметр | LobeHub | ChatGPT / Poe / TypingMind (SaaS) |
|---|---|---|
| Где данные | на своем сервере (Postgres + S3) | в облаке вендора |
| Ключ к модели | свой, BYO-key к любому провайдеру | внутри подписки или свой |
| Выбор модели | OpenAI, Anthropic, Gemini, DeepSeek, OpenRouter, любой OpenAI-совместимый | ограничен набором вендора |
| Агенты и задачи по расписанию | встроено | частично / платный тариф |
| База знаний с RAG | встроена (pg_search) | частично / платно |
| Веб-поиск для агентов | встроен (SearXNG) | зависит от вендора |
| Модель цены | только плата провайдеру за токены | подписка + токены |
Тех-стек и архитектура
Приложение написано на TypeScript (Next.js), образ lobehub/lobehub:latest - около 255 MB. В 2.0 простой одно-контейнерный режим с ACCESS_CODE убран: контейнер прямо отказывается стартовать со ссылкой на Better Auth. Обязателен server-database-стек из шести сервисов.
| Контейнер | Образ | Роль |
|---|---|---|
| lobe | lobehub/lobehub:latest | приложение, порт 3210 |
| postgresql | paradedb/paradedb:latest-pg17 | БД + pg_search для RAG и поиска по базе знаний |
| redis | redis:7-alpine | кэш и очереди |
| rustfs | rustfs/rustfs:latest | S3-совместимое хранилище файлов и картинок, порты 9000/9001 |
| rustfs-init | minio/mc | одноразовая инициализация бакета |
| searxng | searxng/searxng | встроенный веб-поиск для агентов |
Аутентификация - Better Auth (email/пароль плюс SSO). При старте генерируются секреты: KEY_VAULTS_SECRET, AUTH_SECRET, JWKS_KEY, POSTGRES_PASSWORD, RUSTFS_SECRET_KEY. Переменная APP_URL обязана быть внешним https-доменом - иначе Better Auth не выставит cookie.
Минимальная конфигурация
Реальные требования против того, что кажется по слову «чат».
| Контейнеров в стеке | 6 определено, 5 живых (rustfs-init одноразовый) |
| RAM всего стека в простое | ~804 MiB |
| Образ приложения | 255 MB |
| Все образы на диске | ~6.3 GB |
| Локальный GPU | не нужен (инференс у провайдера) |
| Рекомендуем тариф | CPU4-RAM8-DISK100 |
Важно: сам стек в простое ест всего ~804 MiB, но шесть контейнеров плюс Postgres под нагрузкой и первой сборкой держат в тонусе - тариф CPU4-RAM8-DISK100 тут не рабочий вариант. CPU4/RAM8 берем как минимум с запасом, а не впритык.
В маркетплейсе Fatmetal
Не хотите ставить руками?
Этот стек есть в маркетплейсе Fatmetal - можно не повторять установку из этого разбора вручную. Заказываете сервер, за пару минут получаете рабочий домен, валидный TLS и портал, готовый к регистрации первого пользователя.
Рекомендуемая конфигурация:
4 vCPU · 8 ГБ RAM · 100 ГБ NVMe от 990 ₽/мес
Развертывание на Fatmetal
Fatmetal Cloud Server (CPU4-RAM8) + Ubuntu 24.04 + Docker из маркетплейса, наружу через Caddy с авто-TLS.
Взять VM с предустановленным Docker
Marketplace-приложение Docker кладет Docker 29.6.2 и Compose v5.3.1 на Ubuntu 24.04 LTS. Домен по magic-DNS вида 45-15-159-X.fatmetal.net резолвится сразу - его и подставляем в APP_URL.
Взять официальный deploy-compose и сгенерировать секреты
mkdir -p /opt/lobehub && cd /opt/lobehub # официальный docker-compose (server-database режим) + .env # сгенерировать секреты: for k in KEY_VAULTS_SECRET AUTH_SECRET POSTGRES_PASSWORD RUSTFS_SECRET_KEY; do echo "$k=$(openssl rand -hex 32)" done # APP_URL - внешний https-домен (нужен Better Auth для cookie)Поднять стек
docker compose pull docker compose up -d docker compose ps # rustfs-init должен выйти с кодом 0Если rustfs-init падает с exit 1 - смотрите раздел «Где может сломаться» (баг с полем в bucket.config.json). Пока он не отработает, приложение не поднимется.
Реверс-прокси и TLS
45-15-159-3.fatmetal.net { reverse_proxy 127.0.0.1:3210 }Caddy выпускает сертификат Let's Encrypt сам при первом внешнем запросе - magic-DNS-домен резолвится, HTTP-01 проходит без ручных ходов.
Настроить провайдера модели и egress-прокси
В .env указываете провайдера и ключ (для OpenRouter -
OPENAI_PROXY_URL=https://openrouter.ai/api/v1плюсOPENAI_MODEL_LIST). С РФ-IP этого мало: без исходящего прокси провайдер отдаст 403. Подробности - в следующем разделе.
Что измерили после запуска
Цифры со свежей установки на нашем сервере. Только реальные замеры.
| Живых контейнеров | 5 (из 6, rustfs-init одноразовый) |
| RAM всего стека в простое | ~804 MiB |
| Образ приложения | 255 MB |
| Все образы на диске | ~6.3 GB |
| TTFB главной за Caddy/TLS | 0.21 c |
| Проверенный провайдер | OpenRouter, модель openai/gpt-4o-mini |
Главное: живой диалог подтвержден. GPT-4o mini через OpenRouter вернул связный русский ответ и в CLI (43 токена, 0.0000136 доллара за вызов), и в самом UI продукта. То есть стек не просто поднялся - через него реально идет переписка с моделью.
Проверено на LobeChat 2.0 (образ lobehub/lobehub:latest), июль 2026. На новых версиях результаты могут отличаться.
Где может сломаться
Реальные грабли, на которые наткнулись при запуске на РФ-IP.
Причина. С российского IP openrouter.ai и openai отдают HTTP 403 за ~0.10 c - это геоблок провайдера. Стек при этом поднимается, UI живой, но любой диалог мертв: запрос к модели не проходит.
Решение. Вывести исходящий трафик приложения через не-РФ выход и включить флаг NODE_USE_ENV_PROXY=1 (Node 24+). Нативный fetch приложения (undici) сам HTTP_PROXY/HTTPS_PROXY НЕ читает и лезет напрямую в 403 - флаг заставляет глобальный fetch уважать прокси-env. На стенде выход - tinyproxy на не-РФ интерфейсе, после этого диалог пошел.
Причина. Частая путаница: OPENAI_PROXY_URL у LobeHub - это адрес OpenAI-совместимого API-ЭНДПОИНТА (например, OpenRouter), а НЕ сетевой прокси. Люди прописывают сюда адрес своего прокси и ждут обхода геоблока - обхода не будет.
Решение. Разводить два разных параметра. Адрес API - в OPENAI_PROXY_URL. Сетевой обход геоблока - отдельным HTTPS_PROXY плюс NODE_USE_ENV_PROXY=1.
Причина. Баг deploy-ассетов: файл bucket.config.json содержит поле "ID" вместо "Id". Из-за этого одноразовый контейнер rustfs-init падает с exit 1, бакет не инициализируется, и приложение не стартует.
Решение. Поправить регистр поля перед запуском: sed -i 's/"ID":/"Id":/' bucket.config.json, затем перезапустить стек.
Безопасность и обновления
Аутентификация - Better Auth (email/пароль плюс SSO); анонимного режима, как в старом ACCESS_CODE, больше нет, так что портал не окажется открытым по недосмотру. Перед продом закройте по чек-листу: внешним оставляете только 443 через Caddy (порты 3210, 9000/9001, Postgres и Redis держим на loopback), секреты (KEY_VAULTS_SECRET, AUTH_SECRET, JWKS_KEY, POSTGRES_PASSWORD, RUSTFS_SECRET_KEY) генерируем свои и не из примера, свежий JWKS_KEY обязателен - дефолтный из .env.example только для отладки.
Обновление стека:
docker compose pull && docker compose up -d
Бэкап базы (в ней истории, агенты, база знаний) и объектного хранилища:
docker exec lobehub-postgresql-1 pg_dump -U postgres lobe > lobe.sql
# плюс бэкап бакета RustFS (файлы и картинки), напр. через mc mirror
Связь с другими стеками
- Paperclip - соседний ai-ops-стек про управление командой агентов. Разница в слое: Paperclip оркеструет агент-раннеры (OpenClaw/Hermes/Codex), а LobeHub - единый портал-фронт к моделям с агентами внутри самого интерфейса.
- Hermes - тоже требует исходящий прокси из-за геоблока провайдера, рецепт вывода egress через не-РФ выход общий.
- Обратный прокси - Caddy с авто-TLS перед портом 3210 (в разборе используется он же).
Когда это НЕ ваш выбор
Нужен локальный инференс без внешнего API
LobeHub - фронт к чужой модели: считает провайдер на своих GPU. Если задача в том, чтобы модель крутилась на вашем железе и никуда не ходила, это не сюда - там нужен локальный GPU и другой стек.
Хочется «просто чат в один контейнер»
В 2.0 легкого одно-контейнерного режима с ACCESS_CODE больше нет. Минимум - шесть сервисов (app, Postgres, Redis, RustFS, rustfs-init, SearXNG) плюс Better Auth. Для одноразового простого чата это тяжело.
Нет ключа ни к одному провайдеру
Модель считает внешний провайдер по вашему ключу. Без ключа хотя бы к одному из OpenAI/Anthropic/Gemini/DeepSeek/OpenRouter чат не заработает - портал поднимется, но говорить будет нечем.
Частые вопросы
Нужен ли серверу GPU?
Нет. Это фронт к внешнему LLM-API - модель считает провайдер на своих GPU. Нашему CPU-серверу видеокарта не нужна.
Можно ли поднять в один контейнер, как раньше?
Нет. В 2.0 простой режим с ACCESS_CODE убран, обязателен стек из шести сервисов и Better Auth.
Сколько памяти ест стек?
В простое весь стек - около 804 MiB. Но под нагрузкой и первой сборкой берем CPU4/RAM8 с запасом.
Почему чат отдает 403 с российского IP?
Геоблок провайдера: openrouter.ai/openai отдают 403. Лечится исходящим прокси на не-РФ выходе плюс NODE_USE_ENV_PROXY=1.
OPENAI_PROXY_URL - это сетевой прокси для обхода?
Нет. Это адрес API-эндпоинта провайдера. Сетевой обход - отдельным HTTPS_PROXY и флагом NODE_USE_ENV_PROXY=1.
Как делать бэкап?
pg_dump базы Postgres (истории, агенты, база знаний) плюс копия бакета RustFS с файлами и картинками.
Какие ограничения лицензии?
LobeHub Community License на базе Apache-2.0: single-tenant self-host для своих нужд разрешен, ограничения - на коммерческую перепродажу, мульти-тенант-хостинг под своим брендом и снятие брендинга.
Итог
LobeHub 2.0 - это приватный AI-портал у себя: чат с любой моделью, команда агентов, база знаний с RAG и веб-поиск в одном интерфейсе. Стек из шести сервисов в простое держится в ~804 MiB, TTFB главной за Caddy/TLS - 0.21 c, все образы - около 6.3 GB, а живой диалог через OpenRouter (GPT-4o mini) подтвержден и в CLI, и в UI. GPU не нужен - модель считает провайдер. Главная засада на РФ-IP - геоблок провайдера (403), который снимается исходящим не-РФ прокси и флагом NODE_USE_ENV_PROXY=1. Берем как минимум CPU4-RAM8-DISK100.
Рекомендуемая конфигурация для установки:
4 vCPU · 8 ГБ RAM · 100 ГБ NVMe
Не хотите устанавливать вручную?
Запустите LobeHub на этой конфигурации автоматически - от 990 ₽/мес.
Этот стек у нас запущен на тарифе CPU4-RAM8-DISK100. Нашли баг в гайде - напишите, поправим в течение дня.