Как да инсталирате LobeHub с Docker стъпка по стъпка

Ако сте уморени да разчитате на една-единствена компания за изкуствен интелект и искате да контролирате къде се съхраняват вашите разговори, LobeHub е една от най-всеобхватните платформи, които можете да инсталирате на собствената си инфраструктура. Това не е просто чат интерфейс, а... работно пространство за създаване и организиране на агентиСвържете различни модели и работете с файлове, инструменти и бази знания.

Освен това, можете да използвате търговски доставчици като OpenAI, Anthropic, Google или OpenRouter и да ги комбинирате с модели, работещи локално с помощта на Ollama. Това улеснява... предотвратяване на достъпа на изкуствен интелект до лична информациястига правилно да конфигурирате моделите, хранилището и външните интеграции.

LobeHub е самостоятелно хостван проект с публично достъпен код. Официалното му внедряване чрез Docker Compose ви позволява да инсталирате приложението, базата данни, хранилището за файлове и други спомагателни услуги. без да е необходимо да конфигурирате всеки компонент от нулата.

Инсталирането на платформата на вашия сървър обаче не гарантира, че цялата информация ще остане там. Ако свържете модел, хостван в облак, съобщенията, необходими за генериране на отговора, ще бъдат изпратени до избрания доставчик. Това запазва цялата обработка в рамките на вашата инфраструктура. Ще трябва да използвате и локални модели, вграждания и инструменти..

Какво ви е необходимо, за да инсталирате LobeHub с Docker

Преди да започнете, ви е необходим компютър или сървър със съвместима операционна система и достъп до терминал. Официалната процедура използва интерактивен скрипт, който изтегля необходимите файлове и настройва променливите на средата.

Това са основните изисквания:

• Докер двигател: Той е отговорен за управлението на контейнерите.
• Docker Compose v2: Това ви позволява да стартирате и управлявате всички услуги като едно приложение.
• къдрене и OpenSSL: Скриптът ги използва, за да изтегли конфигурацията и да генерира секрети.
• Постоянно пространство: необходимо за запазване на базата данни и качените файлове.
• Домейн: Незадължително за тестване, но силно препоръчително, ако ще публикувате приложението в интернет.
• Моделен ключ или сървър: LobeHub предоставя платформата, но тя трябва да се свърже с доставчик на изкуствен интелект или локален модел.

За лека лична употреба, документацията препоръчва поне 2 процесорни ядра, 4 GB RAM и 20 GB място за съхранениеЗа конфигурация, използвана от няколко души, препоръчителната начална точка се увеличава до 4 ядра, 8 GB RAM и 50 GB място за съхранение или повече.

Тези изисквания се отнасят за платформата и нейните услуги. Ако искате да стартирате и локални модели на същия сървър, ще трябва да добавите RAM, VRAM и място за съхранение, необходими за всеки модел.

Услуги, включени в официалното внедряване

LobeHub не функционира като единичен, изолиран контейнер. Въпреки че основните компоненти са приложението, съвместима с PostgreSQL база данни и S3 хранилище, официалният Compose файл разполага с няколко координирани услуги:

• ЛобеХъб: Той управлява уеб приложението, агентите, разговорите и администрирането.
• PostgreSQL използва ParadeDB: Той съхранява потребители, разговори, настройки и данните, необходими за търсения.
• Редис: Осигурява бързо съхранение и запазване чрез AOF за определени вътрешни операции.
• RustFS: Той действа като устройство за съхранение на обекти, съвместимо с протокола S3.
• rustfs-init: Подгответе кофата, използвана от LobeHub по време на първото зареждане.
• ТърсенеXNG: Това позволява включването на уеб търсения в агентите, когато тази функция е активирана.

Docker Compose създава частна мрежа, така че тези услуги да могат да се намират взаимно, използвайки вътрешните си имена. Той също така конфигурира постоянни томове, за да предотврати загуба на данни при рестартиране или подмяна на контейнери.

Опции за внедряване на Docker

Официалният скрипт предлага три режима. Изборът определя откъде можете да получите достъп до LobeHub и кои адреси ще бъдат запазени в конфигурационния файл.

Локален режим

Това е идеалният начин да тествате LobeHub на същия компютър, на който работи Docker. Приложението обикновено е достъпно на адрес като:

http://localhost:3210

Този режим не е предназначен за присъединяване на други устройства към мрежата или за публикуване на платформата в интернет.

Режим на порт

Това позволява достъп чрез IP адрес и порт на сървъраНапример:

http://192.168.1.50:3210

Полезно е в локална мрежа, въпреки че ще трябва да проверите защитната стена на сървъра. Ако възнамерявате да го използвате от интернет, за предпочитане е да превключите в режим на домейн и да активирате HTTPS.

Режим на доминиране

Това е подходящата опция за постоянна инсталация или използване от екип. Тя изисква конфигуриране на обратен прокси, HTTPS сертификати и обикновено два домейна или поддомейна:

• Един за приложението, като например ia.ejemplo.com.
• Още един за S3 съхранение, като например s3.ejemplo.com.

Вторият домейн е важен, защото браузърът трябва да може да достъпва определени файлове, съхранявани в RustFS. Използването на вътрешното име на контейнера не е достатъчно.

Как да инсталирате LobeHub с помощта на Docker Compose

Първо, създайте папка за инсталацията и въведете в нея:

mkdir lobehub-db
cd lobehub-db

След това изпълнете официалния конфигурационен скрипт:

bash <(curl -fsSL https://lobe.li/setup.sh)

Съветникът ще поиска режима на внедряване и адресите, които ще се използват. Той също така ще изтегли файлове, като например docker-compose.yml, .env, конфигурацията на контейнера RustFS и настройките на SearXNG.

По време на процеса се генерират пароли и тайни, за да се защитят базата данни, хранилището, сесиите и запазените идентификационни данни. Не публикувайте съдържанието на файла. .env Не го качвайте в хранилище.

След като конфигурацията е завършена, стартирайте всички услуги:

docker compose up -d

Първоначалната настройка може да отнеме известно време, защото Docker трябва да изтегли изображенията, да създаде базата данни, да стартира RustFS и да изпълни миграциите.

Как да проверя дали LobeHub е стартирал правилно

Проверете състоянието на контейнерите, като използвате:

docker compose ps

Основните услуги трябва да изглеждат стартирани или в работно състояние. За да наблюдавате лог файловете в реално време, използвайте:

docker compose logs -f

Можете също да видите само лог файловете на приложението:

docker logs -f lobehub

По време на успешно стартиране би трябвало да видите, че миграцията на базата данни е завършена успешно и че сървърът е готов да приема връзки.

В локален режим отворете в браузъра си:

http://localhost:3210

В режими на порт или домейн ще трябва да използвате адреса, показан от съветника за настройка.

Критични конфигурации за работа

Скриптът автоматично подготвя по-голямата част от инсталацията, но е препоръчително да знаете променливите, които причиняват най-много проблеми при промяна на домейна, порта или мрежовата архитектура.

URL_адрес на приложението

APP_URL Това е публичният адрес, от който потребителите имат достъп до LobeHub. Използва се и в OAuth връщания, уеб куки и други генерирани от приложения връзки.

В инсталация, контролирана от домейн, може да има тази стойност:

APP_URL=https://ia.ejemplo.com

Протоколът, домейнът и портът трябва да съответстват на действителния адрес, използван в браузъра. Ако поставите LobeHub зад обратен прокси, той трябва правилно да изпраща заглавките на протокола и хоста.

ВЪТРЕШЕН_УРЛ_НА_ПРИПАЗКА

INTERNAL_APP_URL Използва се за вътрешни заявки, които LobeHub отправя към собственото си приложение. Някои асинхронни функции, като например генериране на изображения, може да се провалят, ако контейнерът се опита да осъществи достъп до публичен адрес, който не е достъпен от неговата мрежа.

Официалният Compose обикновено използва:

INTERNAL_APP_URL=http://localhost:3210

Като алтернатива може да се използва вътрешен адрес, достъпен от мрежата на Docker. Целта му е да предотврати преминаването на тези повиквания през прокси, CDN или външната мрежа на хоста.

S3_ENDPOINT

S3_ENDPOINT Идентифицира адреса, от който се обслужват обекти, съхранявани в RustFS. В домейн-базирано внедряване може да бъде конфигуриран както следва:

S3_ENDPOINT=https://s3.ejemplo.com

Не бива просто да влизате http://rustfs:9000 като публичен адрес. Това име се разрешава само в мрежата на Docker и браузърът няма да може да го използва, за да отваря изображенията или файловете.

URL адрес на базата_данни и пароли

Веригата DATABASE_URL Свържете LobeHub към PostgreSQL. Паролата трябва да съвпада POSTGRES_PASSWORD и името на базата данни с това, дефинирано в LOBE_DB_NAME.

Избягвайте да променяте тези променливи след създаване на базата данни, освен ако не актуализирате и идентификационните данни за съответната услуга.

Как да защитим достъпа и регистрацията на потребителите

LobeHub 2.0 използва По-добра автентикация като система за удостоверяване. По-старите ръководства, базирани на Clerk или NextAuth, вече не са приложими за текущите версии.

Разгръщането поддържа вход чрез имейл и парола, OAuth доставчици и съвместими SSO системи. В инстанция с интернет връзка, проверете опциите за регистрация, преди да споделите адреса.

За частна инсталация можете да използвате AUTH_ALLOWED_EMAILS и ограничаване на достъпа до определени адреси:

AUTH_ALLOWED_EMAILS=usuario@ejemplo.com,otro@ejemplo.com

Когато използвате изключително един доставчик на SSO, можете също да деактивирате достъпа чрез имейл и парола:

AUTH_DISABLE_EMAIL_PASSWORD=1

След промяна на файла .env, пресъздайте контейнера на приложението, за да приложите промените:

docker compose up -d --force-recreate lobe

Не предоставяйте директно достъп до интернет на PostgreSQL, Redis или административната конзола на RustFS. В инсталация, хоствана от домейн, публикувайте само основни услуги чрез HTTPS и ограничете достъпа до останалите, използвайки защитната стена или вътрешната мрежа на Docker.

Как да се свържат моделите с изкуствен интелект

LobeHub е независим от доставчикаМожете да го свържете с търговски услуги или със сървъри за извод, контролирани от вас.

Сред наличните алтернативи са OpenAI, Anthropic, Google, OpenRouter и различни доставчици, съвместими с OpenAI API. Можете също да използвате местни модели чрез Ollama или други съвместими сървъри.

Ключовете могат да бъдат конфигурирани с помощта на променливи на сървъра или, в зависимост от конфигурацията на доставчика и екземпляра, от настройките на LobeHub. В споделена инсталация обикновено е за предпочитане администраторът да управлява идентификационните данни и да решава кои модели ще бъдат налични.

Ако доставчикът работи в различен контейнер, не го използвайте localhost да се обърнете към него. В Docker този адрес сочи към самия контейнер LobeHub. Ще трябва да използвате името на услугата, вътрешен мрежов адрес или URL адрес, достъпен от контейнера.

Отвъд чата: Разширените функции на LobeHub

Една от най-интересните характеристики на LobeHub е неговата съвместимост с Протокол за контекст на моделаПлатформата действа като MCP клиент, открива инструментите, предлагани от съвместими сървъри, управлява връзките и изпраща заявки от агенти към съответната услуга.

Сървърите, налични в Marketplace, ви позволяват да разширите възможностите на вашите агенти. Можете също така ръчно да добавите съвместим MCP сървър, ако необходимата ви интеграция не е посочена в каталога.

Трябва внимателно да прегледате разрешенията за всяка връзка. MCP сървърът може да позволи на агента да отправя заявки към външни услуги, да чете файлове или да извършва действия. Инсталирането на LobeHub на вашия сървър не елиминира рисковете от предоставяне на прекомерен достъп до даден инструмент.

Друга силна страна е управлението на знанията. Можете да качвате документи, електронни таблици, изображения, аудио и видео, за да създадете библиотека с ресурси. Това позволява конвертиране на PDF файлове с изкуствен интелектКонсултирайте се с вътрешна информация и свържете бази знания с агенти или работни пространства.

Платформата обработва съвместимо съдържание и използва техники за извличане, за да избере информация, свързана с въпроса. След това моделът генерира отговора, използвайки тези фрагменти като контекст. Точността ще зависи от документа, модела на вграждане, търсенето и използвания генеративен модел.

LobeHub предлага и мултимодални функции за работа с изображения, аудио и файлове, въпреки че тяхната наличност зависи от избрания модел. Чисто текстов модел няма да може да анализира изображение, дори ако интерфейсът позволява качването му.

Как да актуализирате LobeHub

Преди да надстроите инсталация, използвана в производствена среда, архивирайте базата данни, файловете и конфигурацията.

След това можете да изтеглите текущите изображения и да пресъздадете контейнерите:

docker compose pull
docker compose up -d

Проверете стартирането и миграциите, като използвате:

docker compose logs -f

Не е препоръчително да се автоматизират големи актуализации без възстановимо резервно копие. Нова версия може да включва миграции на базата данни или допълнителни променливи, които изискват редакции на конфигурацията.

Как да направите резервно копие

Пълното архивиране трябва да включва базата данни, обектите, съхранени в RustFS, и конфигурационните файлове. Запазването само на PostgreSQL няма да ви позволи да възстановите качените изображения и документи.

Копие на PostgreSQL

Ако запазите името на базата данни по подразбиране, можете да я експортирате, като използвате:

docker compose exec postgresql pg_dump -U postgres lobechat > backup.sql

За да го възстановите:

docker compose exec -T postgresql psql -U postgres lobechat < backup.sql

Ако сте се променили LOBE_DB_NAME, замества lobechat с истинското име.

Копие на RustFS

За да пакетирате данните за съхранение:

docker compose exec rustfs tar czf /tmp/backup.tar.gz /data
docker cp lobe-rustfs:/tmp/backup.tar.gz ./rustfs-backup.tar.gz

Също така запазете файла .env, docker-compose.yml и конфигурационните файлове на RustFS и SearXNG. Файлът .env Съдържа чувствителна информация и трябва да се съхранява криптирана или на защитено място.

Поддръжка и отстраняване на неизправности

Някоя услуга не стартира

Първо, проверете състоянието му:

docker compose ps
docker compose logs NOMBRE_DEL_SERVICIO

Най-честите причини са зает порт, малко дисково пространство, неправилна парола или услуга, от която LobeHub зависи и която все още не е в изправност.

Порт 3210 е зает

Промяна LOBE_PORT във файла .env и пресъздайте контейнерите. Не забравяйте да актуализирате и публичния адрес, ако осъществявате достъп чрез IP адрес и порт.

LobeHub не може да се свърже с PostgreSQL

Проверете състоянието на базата данни:

docker compose exec postgresql pg_isready -U postgres

След това проверете записите си:

docker compose logs postgresql
docker compose logs lobe

Проверете това POSTGRES_PASSWORD, LOBE_DB_NAME y DATABASE_URL бъдете последователни.

Изображенията или документите не се отварят

Проверете лог файловете на RustFS:

docker compose logs rustfs
docker compose logs rustfs-init

Проверете и това S3_ENDPOINT да бъде достъпен от браузъра. При отдалечено внедряване не може да сочи към localhost нито към вътрешното име на контейнера.

Домейнът се отваря, но някои функции не работят.

Проверете това APP_URL използвайте правилния публичен адрес и това INTERNAL_APP_URL Разрешете на контейнера вътрешен достъп до приложението. Също така проверете дали обратният прокси изпраща заглавките. Host, X-Forwarded-For y X-Forwarded-Proto.

Не се появява модел

Проверете дали ключът на доставчика е валиден, дали неговият API URL адрес е достъпен от контейнера и дали моделът не е скрит от конфигурацията на списъка. Ако използвате локален сървър, тествайте неговия API от същата мрежа, където работи LobeHub.

Мястото на сървъра свършва.

Вижте използването на Docker и файловата система:

docker system df
df -h

Старите изображения, лог файлове, PostgreSQL и RustFS файлове могат да се разрастват с времето. Не изтривайте томове или данни, без първо да проверите съдържанието им и да създадете резервно копие.

Инсталирането на LobeHub с Docker ви позволява да създадете хъб с агенти, различни модели, MCP инструменти и собствени знания в рамките на контролирана инфраструктура. Официалната процедура значително опростява внедряването, но остава важно правилно да конфигурирате публичните адреси, S3 съхранението, удостоверяването и архивирането.

За лично тестване е достатъчен локалният режим. Ако други ще използват платформата, използвайте домейн с HTTPS, ограничете регистрацията, защитете вътрешните услуги и се уверете, че никоя интеграция не изпраща информация извън инфраструктурата без знанието на потребителя.