acme.sh证书迁移与多设备同步指南

证书管理机制解析

acme.sh作为自动化证书管理工具，其核心数据存储在用户目录下的.acme.sh文件夹中。该目录采用结构化存储设计，包含以下关键组件：

1. 证书存储区：每个域名独立文件夹（如domain.com），内含：

   • 证书文件（fullchain.cer）
   • 私钥文件（domain.com.key）
   • 签发元数据（domain.com.conf）

2. 账户配置：

   • CA机构账户密钥（如acme.zerossl.com账户）
   • 签发策略配置
   • 续期任务记录

跨设备同步方案

完整目录迁移（推荐方案）

1. 源设备定位.acme.sh目录（通常位于~/.acme.sh）
2. 使用rsync或压缩包方式完整复制到目标设备相同路径
3. 保持600权限：chmod -R 600 ~/.acme.sh
4. 验证同步效果：acme.sh --list

选择性迁移注意事项

当仅需迁移特定证书时：

1. 复制目标域名文件夹（如demo.example.com）
2. 同步对应CA账户配置（ca/acme.zerossl.com）
3. 更新cron任务：acme.sh --install-cronjob

与Web面板证书的隔离性

需特别注意：

• ZeroSSL等CA的网页控制台签发证书与acme.sh本地签发证书属于独立体系
• 即使使用相同邮箱注册，两套系统无自动同步机制
• Web面板证书需通过手动下载后使用acme.sh --install-cert命令导入

生产环境最佳实践

1. 统一签发渠道：避免混合使用网页版和命令行工具管理同一域名
2. 版本控制：将.acme.sh目录纳入配置管理系统（如Git）
3. 安全备份：
   • 加密存储私钥文件
   • 分离备份证书与私钥
4. 多节点同步：
   • 设计主从同步机制
   • 使用inotify-tools监控目录变更

故障排查要点

当出现"domain is not issued"报错时：

1. 检查目标设备是否存在完整证书目录结构
2. 验证账户配置文件完整性
3. 确认CA机构路径一致性（特别是ZeroSSL的DV90端点）

通过理解acme.sh的存储架构和迁移机制，用户可以构建稳定的证书管理流水线，实现多环境间的无缝协同工作。