MoxServer 应用核心中继节点

安全的多中继聊天控制面，内置长轮询事件同步。
负责私聊、群聊、资料存储，以及跨多个中继的增量事件投递。
在消息被推送到目的地后会被删除，仅用于中继数据不负责长期保存。

环境变量 .env

MoxServer 启动时默认读取当前目录或上级目录中的 .env；也可以在启动前通过 MOXSERVER_ENV_FILE 指定其他 env 文件。.env 中的值会覆盖代码内置默认值。

数值型配置只接受正整数。空值、非整数或小于等于 0 的值会回退到代码内置默认值。

参数	用途
`MOXSERVER_DB_DSN`	MoxServer 运行期 PostgreSQL 连接串，服务启动后用它连接聊天中继数据库并初始化表结构。
`MOXSERVER_DB_AUTO_INIT`	是否在启动时自动创建/确保数据库和账号。只有值为 `1` 时启用；启用后会使用下面的 super/user/name/password 配置先执行数据库初始化。
`MOXSERVER_DB_SUPER_DSN`	自动初始化数据库时使用的 PostgreSQL 管理员连接串，需要有创建数据库、创建/修改用户的权限。
`MOXSERVER_DB_NAME`	自动初始化时要创建或确保存在的业务数据库名。
`MOXSERVER_DB_USER`	自动初始化时要创建或确保存在的业务数据库用户名。
`MOXSERVER_DB_PASSWORD`	自动初始化时写入 `MOXSERVER_DB_USER` 的数据库密码。
`MOXSERVER_ADDR`	HTTP 监听地址，格式如 `:8980`、`:8080` 或 `127.0.0.1:8980`；不配置时使用 `:8980`。端口被占用时启动入口会尝试后续端口。
`MOXSERVER_DATA_RETENTION_DAYS`	中继数据保留天数。后台清理器会定期删除早于该时间的 DM、群消息、好友申请、回执、事件等数据；默认 `30` 天。
`MOXSERVER_CHALLENGE_TTL_SECONDS`	challenge-response 验证码有效期，单位秒；默认 `60` 秒。
`MOXSERVER_AUTH_FAIL_BAN_THRESHOLD`	同一来源 IP 在失败统计窗口内达到多少次认证失败后进入封禁；默认 `10` 次。
`MOXSERVER_AUTH_FAIL_BAN_MINUTES`	认证失败触发封禁后的封禁时长，单位分钟；默认 `30` 分钟。
`MOXSERVER_AUTH_FAIL_WINDOW_MINUTES`	认证失败次数统计窗口，单位分钟；默认 `30` 分钟。

MoxFile 文件中继服务

一次性文件中继，适合加密上传、清单分发与已读销毁式附件流程。
提供安全的文件会话控制面，以及带短时 token 的上传 / 下载端点，适合短生命周期的加密附件交付。

环境变量 .env

MoxFile 启动时默认读取当前目录或上级目录中的 .env；也可以在启动前通过 MOXFILE_ENV_FILE 指定其他 env 文件。.env 中的值会覆盖代码内置默认值。

数值型配置只接受正整数。空值、非整数、表达式或小于等于 0 的值会回退到代码内置默认值。

参数	用途
`MOXFILE_DB_DSN`	MoxFile 运行期 PostgreSQL 连接串，服务启动后用它连接文件中继数据库并初始化表结构。
`MOXFILE_ADDR`	HTTP 监听地址，格式如 `:8981`、`:8090` 或 `127.0.0.1:8981`；不配置时使用 `:8981`。端口被占用时启动入口会尝试后续端口。
`MOXFILE_DATA_RETENTION_DAYS`	文件对象和过期数据的最长保留天数。后台清理器会删除超出保留期或已过期的文件对象，并同步删除磁盘文件；默认 `30` 天。
`MOXFILE_CHALLENGE_TTL_SECONDS`	challenge-response 验证码有效期，单位秒；默认 `60` 秒。
`MOXFILE_AUTH_FAIL_BAN_THRESHOLD`	同一来源 IP 在失败统计窗口内达到多少次认证失败后进入封禁；默认 `10` 次。
`MOXFILE_AUTH_FAIL_BAN_MINUTES`	认证失败触发封禁后的封禁时长，单位分钟；默认 `30` 分钟。
`MOXFILE_AUTH_FAIL_WINDOW_MINUTES`	认证失败次数统计窗口，单位分钟；默认 `30` 分钟。
`MOXFILE_MAX_FILE_SIZE_BYTES`	单个文件对象允许的最大字节数。必须写成十进制整数字节数，例如 `107374182400` 表示 100 GiB；`10010241024*1024` 这类表达式不会被计算。

MoxSignal 实时通话信令服务

支持 ws-token 交接与服务端下发 ICE 配置。
将小型鉴权 HTTP 控制面与 WebSocket 信令通道结合起来，用于 offer / answer / ICE / hangup 等实时交互。
附带SFU服务扩展，除了P2P音视频通话以外，还支持大型多人视频会议和直播功能。

环境变量 .env

MoxSignal 启动时默认读取当前目录或上级目录中的 .env；也可以在启动前通过 MOXSIGNAL_ENV_FILE 指定其他 env 文件。.env 中的值会覆盖代码内置默认值。

数值型配置只接受正整数。空值、非整数或小于等于 0 的值会回退到代码内置默认值。

参数	用途
`MOXSIGNAL_DB_DSN`	MoxSignal 运行期 PostgreSQL 连接串，服务启动后用它连接信令数据库并初始化通话、参与者、信令事件等表结构。
`MOXSIGNAL_ADDR`	HTTP 与 WebSocket 监听地址，格式如 `:8982`、`:8077` 或 `127.0.0.1:8982`；不配置时使用 `:8982`。端口被占用时启动入口会尝试后续端口。
`MOXSIGNAL_CHALLENGE_TTL_SECONDS`	challenge-response 验证码有效期，单位秒；默认 `60` 秒。
`MOXSIGNAL_WS_TOKEN_TTL_SECONDS`	`POST /api/secure/ws-token` 返回的 WebSocket token 有效期，单位秒；默认 `900` 秒。
`MOXSIGNAL_EVENT_TTL_SECONDS`	未投递信令事件的保留时间，单位秒；超时后后台 GC 会删除 `signal_events` 中的过期事件，默认 `120` 秒。
`MOXSIGNAL_START_CALL_RATE_PER_MIN`	创建通话接口的限流阈值，表示每分钟最多允许的 start-call 请求数；默认 `30`。
`MOXSIGNAL_WS_MESSAGE_RATE_PER_SEC`	单个 WebSocket 连接的信令消息限流阈值，表示每秒最多允许的消息数；默认 `60`。
`MOXSIGNAL_PUBLIC_BASE_URL`	对外公开访问地址。创建 DM 通话时会写入邀请中的 `signalRelayURL`；不配置时根据请求的 scheme/host 推导。
`MOXSIGNAL_AUTH_FAIL_BAN_THRESHOLD`	同一来源 IP 在失败统计窗口内达到多少次认证失败后进入封禁；默认 `10` 次。
`MOXSIGNAL_AUTH_FAIL_BAN_MINUTES`	认证失败触发封禁后的封禁时长，单位分钟；默认 `30` 分钟。
`MOXSIGNAL_AUTH_FAIL_WINDOW_MINUTES`	认证失败次数统计窗口，单位分钟；默认 `30` 分钟。