指南概览

Lag 是一个自托管的语音与聊天服务器：语音房间、持久文字聊天、房间角色与管理控制台，打包为单个容器，背后是 Web UI、Fastify API、PostgreSQL 与 LiveKit。本文档描述该仓库中当前存在的代码，并明确区分“已实现行为”和“集成方案或未来工作”。

运行内容

用户通过一种已配置的 Prism/OIDC/OAuth 提供商认证（或使用可选昵称访客模式），使用带角色的房间、交换持久化文本消息并连接语音。改变部署拓扑前，请先阅读架构与上下文。

推荐阅读顺序

1. 部署教程：从空白主机到验证完成的分步操作。
2. 配置：运行时参数与安全默认值。
3. 对外开放前阅读认证和权限。
4. 运维：备份、健康检查、升级与故障排查。
5. 开发：源码构建与验证。

生产环境警告

Compose 默认值 devkey 和 secret 不安全，其中的身份提供商参数仅为开发示例。暴露到互联网前必须配置真实认证与密钥；仅在明确需要时启用昵称访客。