LobeHub with RustFS

LobeHub 是一个开源、可扩展的高性能 AI 聊天框架。本模板遵循官方 Docker Compose 架构，使用 RustFS 作为 S3 兼容存储（Apache 2.0 许可证）、Redis 作为缓存。

架构（5 个服务）

• PostgreSQL（ParadeDB pg17，含 pgvector + pg_search）
• Redis（会话缓存与性能优化）
• RustFS（S3 兼容对象存储）
• RustFS-Init（初始化 bucket 并设置公开读取策略）
• LobeHub（主应用）

部署后必需配置

JWKS 密钥（必需）

模板已包含 JWKS_KEY 环境变量（默认为空）。图片生成、桌面客户端认证、异步任务等功能需要它。

访问官方文档一键生成： https://lobehub.com/zh/docs/self-hosting/environment-variables/auth#jwks-key

生成后，在 LobeHub 服务的环境变量中填写 JWKS_KEY 的值。

可选功能（在 LobeHub 服务环境变量中填写 API 密钥）

网络搜索（Tavily）— 已预配置，需填密钥

TAVILY_API_KEY 默认为空。在 https://www.tavily.com/ 获取密钥后填入。 搜索和爬虫均已预设为 Tavily，深度为 advanced。

知识库向量嵌入（AiHubMix）— 已预配置，需填密钥

AIHUBMIX_API_KEY 默认为空。在 https://aihubmix.com/ 获取密钥后填入。 嵌入模型已预设为 aihubmix/jina-embeddings-v4。

AI 模型提供商

在 LobeHub 设置界面或环境变量中配置模型提供商 API 密钥（OpenAI、Claude、Gemini、DeepSeek 等）。

说明

• 认证默认使用 Better Auth 邮箱 + 密码登录（无需 SSO）。
• S3_ENDPOINT 使用公开的 RustFS 域名，确保浏览器和 LLM 服务商能访问上传的文件。
• RustFS 使用 bucket 策略（而非逐对象 ACL）实现公开读取，因此 S3_SET_ACL=0。