环境变量与配置
了解自托管实例中最常用的环境变量：访问地址、数据库与 Redis 连接、邮件、存储、注册策略与功能开关。
配置方式
自托管实例通过 .env 文件和容器环境变量进行配置。修改配置后通常需要重建或重启相关容器才能生效。建议把 .env 文件纳入受控管理，避免在服务器上手工改动后无法追溯。
核心配置项
- 公网访问地址：实例对外的完整域名与协议，影响邮件链接与回调
- 数据库连接：PostgreSQL 的主机、端口、库名、账号与口令
- Redis 连接：用于缓存与实时协作会话
- 邮件 SMTP：服务器、端口、账号、发件人地址与加密方式
- 资源存储：默认本地卷，也可对接对象存储
- 密钥配置：会话、加密等用途的 SECRET 类变量
- 注册策略：开放注册、邀请制或关闭注册
- 功能开关：控制部分实验特性与遥测上报
修改配置的标准流程
- 备份当前 .env 文件
- 编辑需要调整的变量并保存
- 执行 docker compose up -d 让变更应用到对应服务
- 查看容器日志确认服务正常启动
- 用一个普通账号验证受影响的功能（如邀请邮件）
关于邮件
关于邮件
邀请成员、找回密码等流程依赖邮件发送。内网环境如果无法使用公共 SMTP，可以对接内部邮件网关；邮件不可用时也可以由管理员在后台直接创建账号。
实用提示
- 所有 SECRET 类变量在首次上线时就应替换为强随机值，之后不要轻易变更。
- 不同大版本之间配置项可能增减，升级时请对照官方变更说明核对 .env。