Configuration

配置说明

Wiki 不复制完整环境变量表。配置真源是仓库的 .env.example、config/*.config 和 配置参考。

配置来源

场景	来源
生产部署	deploy/.env.example
本地运行	config/sys.local.config.example + IMBOYENV=local
后端默认配置	config/sys.config、config/debug.config、config/cron.config
客户端构建	imboyapp/example.env、--dart-define
管理后台构建	imboyadmin 的 Vite 环境变量

生产必看

• 所有生产密钥必须显式配置，不能沿用开发默认值。
• JWT、数据库字段加密、管理后台 Cookie、客户端初始化加密和 API 签名相关配置必须按部署手册生成。
• .env、私钥、数据库密码和真实域名不应提交到任何仓库。
• 修改配置后重新执行前置检查，并查看后端启动日志。

定时任务（ecron）

周期作业统一在 config/sys.config.example 的 {ecron, [...]} 段定义（附件孤儿/待确认清理、B-06 支付对账、ops 周报、教学域 AI Worker/回收器等）。

键名约束（易错）：当前 pin 的 ecron v1.1.0 只消费 local_jobs（每节点各跑）或 global_jobs（集群单实例，依赖 global 注册与 quorum）两个键；写成 {jobs, [...]} 不报错但整段静默不生效。2026-09-09 之前入仓的作业块曾因此从未被调度过，已修正为 local_jobs（仓内全部作业均幂等/带守卫，双节点重复执行安全）。

两点运维须知：

1. 作业在节点重启后才真正激活。从旧版本升级后首次重启时，各作业会第一次实际运行：支付对账首跑会回看约 25 小时，清理类按各自阈值扫描——属预期行为，不必告警。
2. 验活方法：节点启动后执行 ecron:statistic().，应返回各作业且 status => activate、ok 计数随周期增长；返回 [] 即配置键名有误或 ecron 未启动。

详细参考

• Day-1 部署
• 完整生产部署
• 配置工程笔记
• 系统要求