跳转至

与 Go 版的差异

本项目最初基于 Go 版 acme-dns 的对外契约重写。当前版本与 Go 版的对应关系 如下;后续随本项目自有功能演进,差异可能逐步扩大,以本文档为准。

完全一致

  • REST API:/register、/update、/health 的路径、请求/响应结构、 状态码与错误体。
  • DNS 应答语义:TTL、SOA serial、NXDOMAIN + SOA authority、EDNS BADVERS、 双 TXT 滚动更新。
  • 配置文件字段:[general] / [database] / [api] / [log] 四段, 字段名与 Go 版 config.cfg 相同(仅文件扩展名改为 .toml)。
  • 数据库 schema:records / txt / acmedns 表结构兼容,可直接打开 Go 版创建的 acme-dns.db(含 bcrypt 口令哈希,格式跨语言通用)。
  • 运维行为:SQLite 单连接串行化、DNS 热路径 5s 读超时 / 一般 20s 超时、 恒定时间口令校验。

行为差异

项 Go 版 Rust 版
tls = "letsencrypt" / "letsencryptstaging" certmagic 自动签发与续期 暂未内置 ACME 客户端:配置字段被接受,但启动时报错。需自动签发时用外部工具(acme.sh / certbot)签发后走 tls = "cert"
日志输出 logtype = "file" 支持写文件 当前支持 stdout(文件输出规划中)
PostgreSQL rowid SQLite/PG 均用 rowid PG 用显式 SERIAL 列等价实现,滚动更新选行语义一致
二进制/进程名 acme-dns(Go) acme-dns(Rust,Cargo 包名 acme-dns)

部署差异

  • 构建产物为单个 Rust 二进制,无 Go 运行时;静态链接 musl 镜像基于 distroless static(非 root)。
  • acme-dns.service 语义与 Go 版一致,ExecStart 指向 Rust 二进制。
  • .goreleaser.yml / .golangci.yaml 不再适用;对应能力由 .github/workflows/release.yml(多平台二进制发布)与 clippy(-D warnings)承担。