安装之前
- 准备一台 Linux 服务器、管理员访问权限、一个域名和 DNS。
- 确定运营者和支持联系方式；制定注册和数据处理的规则。
- 准备 SMTP 或经过授权的 Sibrel 邮件网关。注册验证需要可用的邮件。
- 选择兼容 S3 的存储：本地 MinIO 或外部存储桶。
- 为通话选择本地或独立的 LiveKit。
- 在服务器和提供商的防火墙上放行所需端口。
安装与就绪检查
请在兼容的应用或面板版本中使用主机管理向导。它会询问 SSH 访问、邮件、存储和媒体设置。请只允许它修改专用于 Sibrel 的机器。
安装后请测试 GET /api/host/readiness、使用邮箱注册、文件上传与下载、两个外部网络之间的通话以及机器人连接。仅凭 HTTP 响应成功无法验证通话质量。
反向代理与网关
反向代理必须转发 /api/bots/gateway 和客户端 socket 的 WebSocket Upgrade 请求。不要把令牌查询参数写入访问日志。请自动续期证书并监控有效期。
根据你的配置选择 LiveKit 和 TURN 端口。独立的 S3 与媒体节点必须能从相关服务器和客户端网络访问。
备份与更新
- 把 PostgreSQL、对象存储、配置和联邦密钥备份到受保护的位置。
- 设定保留策略和备份计划，并定期在另一台机器上测试恢复。
- 更新前检查迁移和客户端兼容性，并先做一次备份。
- 更新由向导安装的主机可能会中断应用，请提前通知用户。
- 更新过程中的数据库备份并不意味着任何失败都会自动回滚数据库。
- 保护 SSH、服务密钥和备份，避免未授权访问。
迁移服务与增加节点
额外的 S3 节点会分散新上传，但不会复制旧文件。房间会分配给媒体节点；从配置中移除节点不会迁移已有房间。
更改地址和存储桶时，请保留对旧对象的访问。文件迁移、DNS 变更和旧机器下线是彼此独立的任务。一张架构图并不能证明迁移已经成功。
联邦与规则
只与密钥已验证的已知主机建立连接。监控版本兼容性、网络路由和重放处理。中继不是可靠的队列，也不会自动改善媒体质量。
运营者对其主机以及在其管理范围内的用户负责。请阅读主机创建与使用规则，并公布你自己的数据处理说明。
注册与访问管理
主机管理员可以在管理面板中关闭公开注册并手动创建账号。该设置仅适用于相应主机。更新服务器前请应用数据库迁移、保留备份并确认现有用户可以登录。