快速开始
构建、安装并完成第一次只读验证。
内容经过人工双语校对
前置条件
- Linux 服务器，具备 systemd；涉及容器时需要 Docker。
- Rust stable 工具链，或已经构建好的 Debian 包。
- registry 目录与 state 目录；生产默认分别为
/srv/server-registry和/var/lib/opsctl。 - 执行备份时需要单独配置 Restic/rustic 仓库凭据。
不要复制生产凭据
文档中的环境变量只展示名称。真实值应保存在 root-only 文件或受控的 systemd credential 中，绝不能提交到源码。
从源码构建
cargo build --release
./target/release/opsctl --version安装到 Debian 系统：
sudo scripts/install-debian.sh ./target/release/opsctl安装脚本创建运行用户、registry/state 目录和 systemd unit 文件，但不会自动启用治理或备份定时器。
第一次验证
sudo opsctl \
--registry /srv/server-registry \
--state-dir /var/lib/opsctl \
install-check --json然后验证 registry：
sudo opsctl \
--registry /srv/server-registry \
--state-dir /var/lib/opsctl \
registry validate --json运行只读检查
opsctl status --json
opsctl doctor --json
opsctl scan --json
opsctl deploy-gates --json这些命令读取状态并输出结构化结果，不执行部署。