跳转到内容
AsterDrive
安全更新：Docker 镜像从 v0.4.0-rc.1 起已修复 FFmpeg MagicYUV 解码器漏洞 CVE-2026-8461（高危），使用旧镜像的实例请立即升级。查看 CVE 公告
安全更新：v0.4.0-beta.3 已修复 WebDAV 请求可导致服务进程终止的问题，旧版本实例请尽快升级。查看安全公告

日志

[logging]
level = "info"
format = "text"
file = ""
enable_rotation = true
max_backups = 5

先决定日志写到哪里

Section titled “先决定日志写到哪里”
部署方式推荐做法
Docker不写文件，直接输出到 stdout，让容器日志系统接
systemd不写文件，交给 journald
裸机单进程写入单独文件 + 开启轮转

选项一览

Section titled “选项一览”
选项默认值作用
level"info"trace / debug / info / warn / error
format"text"text 或 json
file""日志文件路径；留空 = 输出到 stdout
enable_rotationtrue是否按天轮转，仅 file 非空时生效
max_backups5保留的历史日志文件数

格式怎么选

Section titled “格式怎么选”
  • 本机排障 —— text，肉眼好读
  • 对接集中式日志系统（Loki / ELK / 自建采集） —— json，字段直接结构化

RUST_LOG 和配置文件谁优先

Section titled “RUST_LOG 和配置文件谁优先”

日志初始化时优先读 RUST_LOG，没有再回退到 logging.level。

临时调日志级别用 RUST_LOG 最方便：

Terminal window
RUST_LOG=debug

也能用 ASTER__ 环境变量覆盖：

Terminal window
ASTER__LOGGING__LEVEL=debug

生产环境示例

Section titled “生产环境示例”
[logging]
level = "info"
format = "json"
file = "/var/log/asterdrive.log"
enable_rotation = true
max_backups = 7