系统与运维

系统与运维负责让服务稳定运行、可配置、可观察、可恢复。它横跨启动配置、数据库运行时配置、后台任务、健康检查、日志、邮件、审计和 CLI。

能力边界

能力	说明	相关文档
启动配置	监听地址、数据库、日志、WebDAV 前缀、节点模式、限流和缓存	配置总览、服务器、数据库
运行时系统设置	管理后台热更新的站点、注册、邮件、WOPI、回收站、任务保留等配置	系统设置
多实例配置同步	API 或 config CLI 写入数据库后，通过 Redis 通知其他实例从权威数据库全量 reload	配置同步
后台任务	缩略图、归档、迁移、离线下载、清理、周期任务和重试	系统设置、运维 CLI
邮件	SMTP、模版、发件队列和测试邮件	邮件
监控	健康检查、ready 检查、Prometheus metrics 和 Grafana dashboard	监控与 Grafana
审计	管理操作、团队审计和可筛选的审计日志	管理后台
CLI	doctor、离线配置、节点 enroll、跨数据库迁移	运维 CLI
备份升级	数据库、配置、本地上传目录、版本升级和回滚	备份与恢复、升级与版本迁移

后端模块

模块	负责内容
config::loader、ops::config	静态配置加载、运行时系统设置和跨实例 reload 回调
runtime::startup、runtime::tasks	primary/follower 启动、config sync 订阅生命周期和周期后台任务
task	用户可见后台任务、调度、重试和清理
mail::sender、mail::outbox、mail::template	邮件投递和模版
ops::health、api::routes::health、metrics	健康检查、ready 和指标
ops::audit	审计日志记录、查询和展示
cli::*	离线运维命令

配置边界

• 启动前必须知道的东西放 config.toml 或 ASTER__... 环境变量。
• 管理员运行时能调整的东西放数据库 system_config。
• 多实例通过 [config_sync] 传递 reload 通知；Redis 不保存配置值，所有实例必须共享权威数据库。
• 系统默认配置定义集中在 src/config/definitions.rs。
• 新增用户可见后台任务要走 task::create_task_record() 并唤醒 dispatcher。

排障方向

• 服务起不来：先看配置路径、数据库连接、端口占用、目录权限。
• ready 不通过：看迁移、默认策略、运行模式和 follower 绑定状态。
• 后台任务堆积：看任务 dispatcher、任务保留、失败原因和重试次数。
• 系统设置只在一个实例生效：检查所有实例的数据库、Redis endpoint、config sync topic 和订阅错误，见 配置同步。
• 管理后台进不去但要改配置：用 运维 CLI 的 config 子命令。