AI-агенты и AgentOps

LobeHub

Self-hosted портал поверх LLM: команда AI-агентов, чат с любой моделью, база знаний с RAG и встроенный веб-поиск - на своем сервере, ключ к модели свой. Развернули полный стек 2.0, вывели egress через не-РФ прокси и подтвердили живой диалог.

Июль 2026 ~10 минут чтения Fatmetal Team
AI-агенты и AgentOps Лицензия: LobeHub Community License (Apache-2.0-based) Статус: запущен у нас, LobeChat 2.0

Вердикт

Подходит
  • кому нужен приватный AI-портал у себя: чат, агенты, база знаний с RAG и веб-поиск в одном интерфейсе
  • у кого есть ключ хотя бы к одному провайдеру - модель считает провайдер на своих GPU, локальный GPU не нужен
  • кто хочет держать историю переписок, файлы и агентов на своем сервере, а не в чужом облаке
Не подходит
  • кому нужен локальный инференс без внешнего API - это фронт к чужой модели, а не своя модель на своем железе
  • кто ждет «просто чат в один контейнер» - в 2.0 это стек из шести сервисов
  • у кого нет ключа ни к одному LLM-провайдеру - без него чат мертв
Мин. тариф: CPU4-RAM8-DISK100 Рекомендуем: CPU4-RAM8-DISK100 Сложность: hard RAM в простое: ~804 MiB Контейнеров: 6 Главный риск: геоблок провайдера с РФ-IP Прод-готовность: с оговорками (egress-прокси + TLS + Better Auth)
Что это

Что это и какую задачу решает

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 видеокарта не нужна: в отличие от связки, где модель поднимают локально, тут вся тяжелая математика уезжает к провайдеру.

TypeScriptNext.jsBetter AuthPostgres (paradedb/pg_search)RedisRustFS (S3)SearXNGDocker Compose
Сравнение

Чем отличается от платных порталов

Сравнение по тому, что влияет на выбор self-hosted-портала против готового SaaS.

ПараметрLobeHubChatGPT / 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-стек из шести сервисов.

КонтейнерОбразРоль
lobelobehub/lobehub:latestприложение, порт 3210
postgresqlparadedb/paradedb:latest-pg17БД + pg_search для RAG и поиска по базе знаний
redisredis:7-alpineкэш и очереди
rustfsrustfs/rustfs:latestS3-совместимое хранилище файлов и картинок, порты 9000/9001
rustfs-initminio/mcодноразовая инициализация бакета
searxngsearxng/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
i

Важно: сам стек в простое ест всего ~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.

  1. Взять 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.

  2. Взять официальный 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)
  3. Поднять стек

    docker compose pull
    docker compose up -d
    docker compose ps   # rustfs-init должен выйти с кодом 0

    Если rustfs-init падает с exit 1 - смотрите раздел «Где может сломаться» (баг с полем в bucket.config.json). Пока он не отработает, приложение не поднимется.

  4. Реверс-прокси и TLS

    45-15-159-3.fatmetal.net {
        reverse_proxy 127.0.0.1:3210
    }

    Caddy выпускает сертификат Let's Encrypt сам при первом внешнем запросе - magic-DNS-домен резолвится, HTTP-01 проходит без ручных ходов.

  5. Настроить провайдера модели и egress-прокси

    В .env указываете провайдера и ключ (для OpenRouter - OPENAI_PROXY_URL=https://openrouter.ai/api/v1 плюс OPENAI_MODEL_LIST). С РФ-IP этого мало: без исходящего прокси провайдер отдаст 403. Подробности - в следующем разделе.

https://45-15-159-3.fatmetal.net
Главный интерфейс LobeHub Chief Agent Operator: Задачи, Страницы, Память, шаблоны агент-задач, модель GPT-4o mini
Главный экран Chief Agent Operator на нашем инстансе: разделы Задачи/Страницы/Память, шаблоны агент-задач, выбранная модель GPT-4o mini. LobeChat 2.0, тариф CPU4-RAM8-DISK100.
Замеры

Что измерили после запуска

Цифры со свежей установки на нашем сервере. Только реальные замеры.

Живых контейнеров5 (из 6, rustfs-init одноразовый)
RAM всего стека в простое~804 MiB
Образ приложения255 MB
Все образы на диске~6.3 GB
TTFB главной за Caddy/TLS0.21 c
Проверенный провайдерOpenRouter, модель openai/gpt-4o-mini
i

Главное: живой диалог подтвержден. GPT-4o mini через OpenRouter вернул связный русский ответ и в CLI (43 токена, 0.0000136 доллара за вызов), и в самом UI продукта. То есть стек не просто поднялся - через него реально идет переписка с моделью.

https://45-15-159-3.fatmetal.net
Живой диалог в LobeHub: вопрос про self-hosting и ответ Lobe AI
Живой диалог в UI: вопрос про self-hosting и ответ модели про контроль над данными и конфиденциальность. Ответ пришел через OpenRouter (GPT-4o mini) сквозь исходящий не-РФ прокси.

Проверено на LobeChat 2.0 (образ lobehub/lobehub:latest), июль 2026. На новых версиях результаты могут отличаться.

Подводные камни

Где может сломаться

Реальные грабли, на которые наткнулись при запуске на РФ-IP.

{"provider":"openai","message":"403 Access denied"}

Причина. С российского 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=https://openrouter.ai/api/v1

Причина. Частая путаница: OPENAI_PROXY_URL у LobeHub - это адрес OpenAI-совместимого API-ЭНДПОИНТА (например, OpenRouter), а НЕ сетевой прокси. Люди прописывают сюда адрес своего прокси и ждут обхода геоблока - обхода не будет.

Решение. Разводить два разных параметра. Адрес API - в OPENAI_PROXY_URL. Сетевой обход геоблока - отдельным HTTPS_PROXY плюс NODE_USE_ENV_PROXY=1.

rustfs-init exited with code 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 чат не заработает - портал поднимется, но говорить будет нечем.

FAQ

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

Нужен ли серверу 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 ₽/мес.

Запустить LobeHub →
Анонсы новых разборов в Telegram-канале Новые гайды и карточки в маркетплейсе первыми @fatmetal_channel →

Этот стек у нас запущен на тарифе CPU4-RAM8-DISK100. Нашли баг в гайде - напишите, поправим в течение дня.