自托管 Litefuse

当你需要把可观测性数据保留在自己的基础设施中、连接私有模型网关，或由内部团队控制运行依赖时，可以选择自托管 Litefuse。

Litefuse 可以作为紧凑的 Docker Compose 部署运行，用于评估和小规模安装；也可以作为生产环境部署，只运行 Litefuse Web 和 Worker 容器，并连接托管 Postgres、Redis、对象存储和 Doris/SelectDB。

部署方式

如果你需要最快启动一个单机 Litefuse 实例，请使用 Docker Compose。这个部署包会一起启动应用、Postgres、Redis、MinIO 和 Doris。

如果你的生产环境已经提供托管 Postgres、Redis、S3 兼容对象存储和 Doris/SelectDB，请使用 生产环境部署。这种模式下，Compose 只运行 Litefuse Web 和 Worker 容器。

架构

自托管 Litefuse 由一组明确的服务组成：

Postgres 保存元数据，Redis 提供队列和缓存，对象存储保存 ingestion payload，Doris/SelectDB 保存分析事件数据。Web 服务处理 UI 和 API 流量，Worker 处理后台任务和队列中的 ingestion 工作。

生产注意事项

• 所有容器都应使用 TZ=UTC。Litefuse 使用 UTC 存储和处理时间戳，修改容器时区可能导致基于时间的查询结果不一致。
• 生产环境的 NEXTAUTH_URL 应使用 HTTPS。
• 密钥应放在版本控制之外的 .env 中，或由密钥管理系统注入。
• 生产环境建议使用托管 Postgres、Redis、对象存储和 Doris/SelectDB。
• 如果使用出站代理，请把私有服务 endpoint 放进 NO_PROXY。
• 按照基础设施恢复目标备份 Postgres 和对象存储。

可靠性检查清单

• 为 Web 和 Worker 容器配置健康检查。
• Litefuse Web 和 Worker 镜像应使用相同的 TAG。
• 分别监控 Postgres、Redis、对象存储和 Doris/SelectDB，不只监控应用容器。
• 生产升级前先在 staging 环境验证。
• 每次部署后检查 /api/public/health。

下一步

先用 Docker Compose 做本地验证；当托管基础设施准备好后，再切换到生产环境部署模式。