使用指南

把证书部署变成可重复的流程。

从安装开始，逐步完成上游连接、证书发现、自动更新、最小权限和日常维护。

开始使用

完成下载、安装、初始化和第一次证书更新。

快速开始按顺序完成 clmbot 的最小可用部署：下载、校验、初始化、发现证书并执行第一次自动更新。安装在 macOS、Linux 与 Windows 上下载、解压、赋权并验证 clmbot v0.6.6 安装包。

配置与更新

配置上游、发现证书，并安全执行更新。

配置clmbot 的通用配置模型（config.yaml、上游、脚本）与 CaaS 上游的 login 接入示例。证书发现使用 discover-certificate 自动扫描服务器上已有证书并生成 config.yaml 配置文件。自动更新与服务重载update-certificate 的更新流程：脚本审核、.bak 证书备份、服务重载与成功/失败/回滚日志检查。

运行模式

在定时拉取和远程推送之间做出合适选择。

运行模式定时拉取与远程推送两种运行模式的对比与选择建议：连接方向、入站端口、认证、更新延迟与适用场景。定时拉取使用 Linux crontab 或 Windows 计划任务定期执行 update-certificate，实现无入站端口的证书自动更新。远程推送以 Server 模式常驻运行 clmbot，由上游通过双向 TLS 主动推送证书；含 8862/TCP 端口与防火墙建议。

安全部署

收窄系统权限、网络入口和凭证暴露面。

最小权限以专用 clmbot 账号运行、sudoers 精确授权与证书目录 ACL；Nginx、Apache、Tomcat、IIS 分场景最小权限配置。安全clmbot 的安全模型与信任边界：mTLS、凭证保存、私钥权限、日志脱敏、下载校验、8862 端口防火墙与漏洞报告流程。

维护与参考

查询配置字段、排查问题并维护生产运行。

故障排查按安装、登录与凭证、证书发现、更新、服务重载和日志位置分类的常见问题检查项。配置参考clmbot 当前公开命令、核心配置字段、端口、日志与备份行为速查。