配置参考
全部配置项集中列出：名称、用途、默认值、是否必填、环境变量。各子项目 .env 独立维护。
通用（全部 services / workers）
| 名称 |
用途 |
默认值 |
必填 |
环境变量 |
| NATS 连接 |
服务间通信 |
- |
是 |
NATS_URL |
| 数据库连接 |
本服务数据库 |
- |
是 |
DATABASE_URL |
identity_service
| 名称 |
用途 |
默认值 |
必填 |
环境变量 |
| 会话有效期 |
会话最长存活 |
2592000（30 天，秒） |
否 |
SESSION_TTL_SECONDS |
| 会话刷新阈值 |
剩余寿命低于该值时允许刷新 |
86400（秒） |
否 |
SESSION_REFRESH_THRESHOLD |
otp_service
| 名称 |
用途 |
默认值 |
必填 |
环境变量 |
| 验证码有效期 |
OTP TTL |
300（秒） |
否 |
OTP_TTL_SECONDS |
| 单码最大校验次数 |
超限作废 |
5 |
否 |
OTP_MAX_ATTEMPTS |
| 单目标发送频控 |
同一手机/邮箱窗口内最大发送数 |
3/10min |
否 |
OTP_SEND_RATE_LIMIT |
| TOTP 签发方 |
MFA 因素展示名 |
Xeegam Passport |
否 |
MFA_TOTP_ISSUER |
captcha_service
| 名称 |
用途 |
默认值 |
必填 |
环境变量 |
| 挑战有效期 |
挑战 TTL |
300（秒） |
否 |
CAPTCHA_TTL_SECONDS |
| 单挑战最大尝试 |
超限作废 |
3 |
否 |
CAPTCHA_MAX_ATTEMPTS |
| 清理保留天数 |
过期记录保留期 |
7 |
否 |
CAPTCHA_RETENTION_DAYS |
attempt_service
| 名称 |
用途 |
默认值 |
必填 |
环境变量 |
| 通过阈值 |
累加分数达到即允许签发会话 |
60 |
否 |
ATTEMPT_SCORE_THRESHOLD |
| 密码因素分值 |
密码校验通过得分 |
40 |
否 |
ATTEMPT_SCORE_PASSWORD |
| OTP 因素分值 |
OTP 校验通过得分 |
60 |
否 |
ATTEMPT_SCORE_OTP |
| MFA 因素分值 |
MFA 校验通过得分 |
60 |
否 |
ATTEMPT_SCORE_MFA |
| 验证码因素分值 |
验证码校验通过得分 |
20 |
否 |
ATTEMPT_SCORE_CAPTCHA |
| 尝试工单有效期 |
工单 TTL |
600（秒） |
否 |
ATTEMPT_TICKET_TTL_SECONDS |
| 尝试记录保留 |
历史留档期 |
180（天） |
否 |
ATTEMPT_RETENTION_DAYS |
organization_service
| 名称 |
用途 |
默认值 |
必填 |
环境变量 |
| 邀请有效期 |
邀请令牌 TTL |
72（小时） |
否 |
INVITATION_TTL_HOURS |
oauth_service
| 名称 |
用途 |
默认值 |
必填 |
环境变量 |
| 授权码有效期 |
code TTL |
600（秒） |
否 |
OAUTH_CODE_TTL_SECONDS |
| 访问令牌有效期 |
access token TTL |
7200（秒） |
否 |
ACCESS_TOKEN_TTL_SECONDS |
| 刷新令牌有效期 |
refresh token TTL |
2592000（秒） |
否 |
REFRESH_TOKEN_TTL_SECONDS |
| 密钥轮换周期 |
JWKS 签名密钥轮换 |
30（天） |
否 |
JWKS_ROTATE_DAYS |
payment_service
| 名称 |
用途 |
默认值 |
必填 |
环境变量 |
| 结算币种 |
订单默认币种 |
USD |
否 |
PAYMENT_DEFAULT_CURRENCY |
| 续订重试上限 |
续订失败重试次数 |
3 |
否 |
SUBSCRIPTION_RETRY_MAX |
payment_worker
| 名称 |
用途 |
默认值 |
必填 |
环境变量 |
| 续订扫描周期 |
cron 表达式 |
0 0 * * *（每小时） |
否 |
RENEWAL_SCAN_CRON |
| 对账扫描周期 |
cron 表达式 |
0 3 * * *（每日 03:00） |
否 |
RECONCILE_CRON |
apps
| 子项目 |
名称 |
用途 |
默认值 |
必填 |
环境变量 |
| passport_web |
api_service 地址 |
SSR 服务端调用 |
- |
是 |
API_SERVICE_URL |
| admin_web |
api_service 地址 |
SPA 请求目标 |
- |
是 |
API_SERVICE_URL |
| openapi |
NATS 连接 |
服务端调业务服务 |
- |
是 |
NATS_URL |