長春網(wǎng)站建設(shè)xgsite,html5新增標(biāo)簽,哈爾濱網(wǎng)站建設(shè)策劃方案,物業(yè)管理軟件LobeChat數(shù)據(jù)庫版部署指南#xff08;2025最新#xff09; 2025/04/05 更新內(nèi)容 在 .env 文件中補(bǔ)充了對 Ollama 嵌入模型#xff08;Embedding Model#xff09; 的支持配置#xff0c;用于啟用 LobeChat 內(nèi)建知識庫的向量檢索能力。同時更新了 MinIO 桶策略模板以增強(qiáng)安…LobeChat數(shù)據(jù)庫版部署指南2025最新2025/04/05 更新內(nèi)容在.env文件中補(bǔ)充了對Ollama 嵌入模型Embedding Model的支持配置用于啟用 LobeChat 內(nèi)建知識庫的向量檢索能力。同時更新了 MinIO 桶策略模板以增強(qiáng)安全性并明確標(biāo)注所有敏感字段必須替換。你有沒有遇到過這種情況在手機(jī)上和AI聊了一半換到電腦就得從頭開始或者想上傳一份文檔讓AI分析卻發(fā)現(xiàn)本地版本根本不支持這正是LobeChat社區(qū)版的痛點——功能受限、無法同步、數(shù)據(jù)孤島。而今天我們要搭建的LobeChat 數(shù)據(jù)庫版本Database Edition, DB 版就是為了解決這些問題而生。它不再依賴瀏覽器存儲而是通過一套完整的后端服務(wù)架構(gòu)實現(xiàn)了多端同步、文件上傳、知識庫RAG、插件擴(kuò)展等企業(yè)級功能。更重要的是它是開源的完全可控適合個人開發(fā)者、團(tuán)隊協(xié)作甚至企業(yè)客服系統(tǒng)。本文將帶你從零開始完成一次生產(chǎn)級部署。最終成果是一個可以通過https://chat.yourdomain.com安全訪問的完整實例包含身份認(rèn)證、對象存儲、數(shù)據(jù)庫持久化等全套組件。? 部署模式域名 HTTPS Docker-Compose 反向代理 目標(biāo)成果可通過https://chat.yourdomain.com安全訪問的 LobeChat 實例前提條件請確保以下環(huán)境已準(zhǔn)備就緒一臺擁有固定公網(wǎng) IP 的 Linux 服務(wù)器推薦 Ubuntu 22.04 LTS已安裝Docker和Docker Compose v2已部署1Panel或其他可視化運(yùn)維面板可選但推薦已配置OpenResty或 Nginx 作為反向代理擁有一個可解析的合法域名如example.com至少注冊一個第三方大模型 API Key如 OpenAI、DeepSeek、SiliconFlow 等域名規(guī)劃與 DNS 解析要實現(xiàn)前后端分離和安全隔離我們需要多個子域名來分別承載不同服務(wù)。這是現(xiàn)代微服務(wù)架構(gòu)的標(biāo)準(zhǔn)做法也能有效避免跨域問題。設(shè)置 DNS A 記錄進(jìn)入你的域名服務(wù)商控制臺如阿里云、Cloudflare添加如下五條 A 類記錄子域名記錄值服務(wù)器公網(wǎng)IPchat.example.comYOUR_SERVER_IPauth-api.example.comYOUR_SERVER_IPauth-ui.example.comYOUR_SERVER_IPs3-api.example.comYOUR_SERVER_IPs3-ui.example.comYOUR_SERVER_IP 替換說明將example.com替換為你的真實一級域名。這些子域?qū)⒎謩e用于-chat.*LobeChat 主服務(wù)-auth-*Logto 提供的身份認(rèn)證服務(wù)OAuth/OIDC-s3-*MinIO 對象存儲服務(wù)文件上傳/下載如果你使用的是內(nèi)網(wǎng)服務(wù)器并通過 NPS 進(jìn)行穿透請登錄 NPS 控制臺在“域名管理”中設(shè)置如下代理規(guī)則chat.example.com → 內(nèi)網(wǎng)OpenResty:443 auth-api.example.com → 內(nèi)網(wǎng)OpenResty:443 auth-ui.example.com → 內(nèi)網(wǎng)OpenResty:443 s3-api.example.com → 內(nèi)網(wǎng)OpenResty:443 s3-ui.example.com → 內(nèi)網(wǎng)OpenResty:443確保所有流量均被正確轉(zhuǎn)發(fā)至內(nèi)網(wǎng) OpenResty 的 HTTPS 端口。編排文件與環(huán)境變量配置我們采用docker-compose.yml來統(tǒng)一編排 PostgreSQL、MinIO、Logto 和 LobeChat 四個核心組件。這種聲明式配置方式不僅便于維護(hù)也利于后期遷移到 Kubernetes。創(chuàng)建項目目錄mkdir ~/lobechat-db cd ~/lobechat-db編寫docker-compose.yml執(zhí)行命令創(chuàng)建文件vim docker-compose.yml粘貼以下內(nèi)容請務(wù)必按注釋修改敏感信息name: lobe-chat-database services: postgresql: image: pgvector/pgvector:pg16 container_name: lobe-postgres ports: - 5432:5432 volumes: - ./data:/var/lib/postgresql/data environment: POSTGRES_DB: lobe POSTGRES_PASSWORD: CHANGEME_POSTGRES_PASS healthcheck: test: [CMD-SHELL, pg_isready -U postgres] interval: 5s timeout: 5s retries: 5 restart: always minio: image: minio/minio container_name: lobe-minio ports: - 9000:9000 - 9001:9001 volumes: - ./s3_data:/data environment: MINIO_ROOT_USER: CHANGEME_MINIO_USER MINIO_ROOT_PASSWORD: CHANGEME_MINIO_PASS MINIO_DOMAIN: s3-api.example.com MINIO_API_CORS_ALLOW_ORIGIN: https://chat.example.com command: server /data --address :9000 --console-address :9001 restart: always logto: image: svhd/logto container_name: lobe-logto ports: - 3001:3001 - 3002:3002 depends_on: postgresql: condition: service_healthy environment: TRUST_PROXY_HEADER: 1 DB_URL: postgresql://postgres:CHANGEME_POSTGRES_PASSpostgresql:5432/logto ENDPOINT: https://auth-api.example.com ADMIN_ENDPOINT: https://auth-ui.example.com entrypoint: [sh, -c, npm run cli db seed -- --swe npm start] restart: always lobe: image: lobehub/lobe-chat-database container_name: lobe-chat ports: - 3210:3210 depends_on: - postgresql - minio - logto env_file: - .env restart: always volumes: data: driver: local s3_data: driver: local重點注意事項所有CHANGEME_*字段必須替換為強(qiáng)密碼POSTGRES_PASSWORD必須與.env中的DATABASE_URL密碼一致所有example.com需替換為你的實際域名??????切勿將此配置直接用于生產(chǎn)環(huán)境否則可能導(dǎo)致數(shù)據(jù)泄露或未授權(quán)訪問??????配置.env環(huán)境變量文件創(chuàng)建環(huán)境變量文件vim .env填入以下內(nèi)容根據(jù)實際情況修改# —————————— 基礎(chǔ)配置 —————————— # APP_URLhttps://chat.example.com # —————————— 數(shù)據(jù)庫加密密鑰 —————————— # KEY_VAULTS_SECRETYOUR_SECURE_BASE64_32BYTE_KEY # 生成方式openssl rand -base64 32 # —————————— PostgreSQL 連接 —————————— # DATABASE_URLpostgresql://postgres:CHANGEME_POSTGRES_PASSpostgresql:5432/lobe # —————————— NextAuth 鑒權(quán)配置 —————————— # NEXT_AUTH_SECRETANOTHER_SECURE_RANDOM_STRING NEXT_AUTH_SSO_PROVIDERSlogto NEXTAUTH_URLhttps://chat.example.com/api/auth # —————————— Logto 應(yīng)用憑證 —————————— # AUTH_LOGTO_IDyour-logto-app-id AUTH_LOGTO_SECRETyour-logto-app-secret AUTH_LOGTO_ISSUERhttps://auth-api.example.com/oidc # —————————— MinIO/S3 存儲配置 —————————— # S3_ACCESS_KEY_IDgenerated-access-key S3_SECRET_ACCESS_KEYgenerated-secret-key S3_ENDPOINThttps://s3-api.example.com S3_BUCKETlobe S3_PUBLIC_DOMAINhttps://s3-api.example.com S3_ENABLE_PATH_STYLE1 # —————————— 可選模型接入配置 —————————— # # OPENAI_API_KEYsk-xxxxxx # OPENAI_PROXY_URLhttps://api.openai.com/v1 # —————————— Ollama Embedding 支持知識庫必需 —————————— # OLLAMA_PROXY_URLhttp://host.docker.internal:11434 DEFAULT_FILES_CONFIGembedding_modelollama/bge-m3:latest關(guān)鍵參數(shù)解釋參數(shù)說明KEY_VAULTS_SECRET用于加密數(shù)據(jù)庫中存儲的敏感信息如 API KeyNEXT_AUTH_SECRETNextAuth 會話簽名密鑰必須高強(qiáng)度隨機(jī)生成S3_ENABLE_PATH_STYLE1自建 MinIO 必須開啟路徑風(fēng)格訪問DEFAULT_FILES_CONFIG啟用 Ollama 的 bge-m3 模型進(jìn)行文檔嵌入 提示host.docker.internal在 Linux 上可能不可用建議改為宿主機(jī)真實 IP 或額外配置網(wǎng)絡(luò)別名。啟動容器并驗證運(yùn)行狀態(tài)拉取鏡像并啟動服務(wù)docker compose up -d該命令將自動拉取所需鏡像并后臺運(yùn)行所有服務(wù)。查看日志確認(rèn)啟動情況docker logs -f lobe-chat等待輸出出現(xiàn)類似以下內(nèi)容即表示啟動成功[Next.js] Server ready on http://localhost:3210此時可通過內(nèi)網(wǎng)地址http://server-ip:3210訪問測試頁面。? 注意首次啟動時 Logto 和 PostgreSQL 初始化可能需要 1~2 分鐘請耐心等待。OpenResty 1Panel 配置 HTTPS使用 1Panel 添加反向代理網(wǎng)站登錄 1Panel 控制臺進(jìn)入「網(wǎng)站」→「創(chuàng)建網(wǎng)站」依次為以下五個域名創(chuàng)建反向代理站點域名代理目標(biāo)chat.example.comhttp://127.0.0.1:3210auth-api.example.comhttp://127.0.0.1:3001auth-ui.example.comhttp://127.0.0.1:3002s3-api.example.comhttp://127.0.0.1:9000s3-ui.example.comhttp://127.0.0.1:9001? 建議為每個站點添加備注便于后期維護(hù)。申請 SSL 證書進(jìn)入「證書」→「申請證書」選擇 ACME 協(xié)議主域名填寫chat.example.com添加其余四個子域到“其他域名”列表選擇 DNS 驗證方式推薦 Cloudflare 或阿里云 API開啟“自動續(xù)簽”。等待證書狀態(tài)變?yōu)椤罢！蓖ǔ：臅r 1~5 分鐘。綁定 HTTPS 并啟用加密訪問返回「網(wǎng)站」列表逐個點擊各站點的「配置」→「HTTPS」? 啟用 HTTPS選擇剛申請的通配符證書強(qiáng)制 HTTP 跳轉(zhuǎn)至 HTTPS建議開啟保存后即可通過https://安全訪問各服務(wù)。初始化身份認(rèn)證服務(wù)Logto訪問 https://auth-ui.example.com 進(jìn)入 Logto 管理界面。注冊首個管理員賬戶首次訪問需注冊新用戶該用戶將自動成為超級管理員。?? 注意此賬戶僅用于管理不能直接用于 LobeChat 登錄創(chuàng)建 OAuth 應(yīng)用進(jìn)入左側(cè)菜單「應(yīng)用」→「創(chuàng)建應(yīng)用」類型選擇Next.js (App Router)名稱可設(shè)為LobeChat-Frontend填寫以下回調(diào)地址字段值Redirect URIshttps://chat.example.com/api/auth/callback/logtoPost sign-out redirect URIshttps://chat.example.com/CORS allowed originshttps://chat.example.com點擊「保存」。獲取 App Credentials在應(yīng)用詳情頁復(fù)制以下兩項App ID→ 填入.env中的AUTH_LOGTO_IDApp Secret→ 填入.env中的AUTH_LOGTO_SECRET 敏感信息一旦關(guān)閉頁面將不再顯示請立即記錄可選關(guān)閉公開注冊如需限制用戶注冊進(jìn)入「登錄體驗」→「注冊與登錄」關(guān)閉「允許用戶注冊」此后只能由管理員在「用戶管理」中手動添加成員。??????再次強(qiáng)調(diào)管理員賬戶 ≠ 登錄賬戶必須創(chuàng)建普通用戶才能登錄 LobeChat??????配置 MinIO 對象存儲訪問 https://s3-ui.example.com使用之前設(shè)置的MINIO_ROOT_USER和MINIO_ROOT_PASSWORD登錄。創(chuàng)建 Bucket左側(cè)導(dǎo)航進(jìn)入「Buckets」→「Create Bucket」名稱輸入lobe與.env中一致創(chuàng)建完成。設(shè)置公共訪問策略點擊剛創(chuàng)建的lobe桶 →「Access Policy」→「Custom」粘貼以下 JSON 策略{ Version: 2012-10-17, Statement: [ { Effect: Allow, Principal: { AWS: [*] }, Action: [s3:GetBucketLocation], Resource: arn:aws:s3:::lobe }, { Effect: Allow, Principal: { AWS: [*] }, Action: [s3:ListBucket], Resource: arn:aws:s3:::lobe, Condition: { StringEquals: { s3:prefix: [files/*] } } }, { Effect: Allow, Principal: { AWS: [*] }, Action: [s3:PutObject, s3:DeleteObject, s3:GetObject], Resource: arn:aws:s3:::lobe/** } ] }此策略允許客戶端上傳、讀取和刪除文件同時限制目錄遍歷。創(chuàng)建 Access Key進(jìn)入「Access Keys」→「Create access key」輸入用戶名如lobe-s3-client生成后復(fù)制Access Key和Secret Key替換.env文件中的S3_ACCESS_KEY_IDXXXXXXXXXXXXXX S3_SECRET_ACCESS_KEYYYYYYYYYYYYYYYYY重啟服務(wù)并正式啟用由于我們修改了.env文件中的憑據(jù)需重新加載容器。docker compose down docker compose up -d等待所有服務(wù)重啟完畢后訪問 https://chat.example.com你應(yīng)該能看到 LobeChat 的登錄界面。點擊「Continue with Logto」使用你在 Logto 中創(chuàng)建的普通用戶賬號登錄。 成功登錄后你已擁有一個功能完整的 LobeChat 數(shù)據(jù)庫版實例功能驗證與后續(xù)優(yōu)化推薦驗證項功能驗證方法多端同步在不同設(shè)備登錄檢查會話是否同步文件上傳嘗試上傳 PDF/Word 文檔并發(fā)送給 AI知識庫啟用插件后導(dǎo)入文檔提問相關(guān)內(nèi)容測試召回模型切換在設(shè)置中添加 OpenAI、Ollama 等模型測試響應(yīng)后續(xù)建議備份數(shù)據(jù)庫定期導(dǎo)出./data目錄中的 PostgreSQL 數(shù)據(jù)啟用監(jiān)控結(jié)合 Prometheus Grafana 監(jiān)控容器狀態(tài)升級策略關(guān)注 LobeHub GitHub 發(fā)布動態(tài)及時更新鏡像安全加固禁用不必要的調(diào)試接口設(shè)置防火墻規(guī)則。LobeChat DB 版本是目前最適合作為團(tuán)隊級 AI 助手門戶的開源解決方案之一。它不僅提供了優(yōu)雅的 UI 和強(qiáng)大的插件生態(tài)更通過標(biāo)準(zhǔn)化的服務(wù)架構(gòu)實現(xiàn)了真正的可維護(hù)性與可擴(kuò)展性。這套部署方案已經(jīng)在多個實際項目中穩(wěn)定運(yùn)行無論是個人知識管理、團(tuán)隊內(nèi)部助手還是輕量級客服系統(tǒng)都能輕松應(yīng)對。其模塊化設(shè)計也讓未來擴(kuò)展變得非常自然——比如加入 Redis 緩存提升性能或是集成 LDAP 實現(xiàn)企業(yè)級統(tǒng)一認(rèn)證。如果你希望獲得自動化部署腳本、Kubernetes Helm Chart 或 CI/CD 流水線配置模板歡迎加入技術(shù)交流群獲取資源。 若你希望獲得自動化部署腳本、Kubernetes Helm Chart 或 CI/CD 流水線配置模板歡迎加入交流群獲取資源。本文首發(fā)于我的技術(shù)博客 https://blog.zxilly.org/posts/lobechat-db-deploy-2025同步發(fā)布于 CSDN、掘金、知乎專欄。 技術(shù)交流群827193325LobeChat 部署與定制 入群口令Lobe2025歡迎分享、點贊、收藏也歡迎 PR 補(bǔ)充更多部署模式創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考