CertHub
Home首页 · Docs文档 · Install安装部署

Install安装部署

Clone, prepare config, mount SSH keys, compose up.克隆、准备配置、挂载 SSH、启动 Compose。

docker compose · acme-ssl-manager · :8080

1. Clone1. 克隆仓库

clone
$ git clone https://github.com/huiyonghkw/CertHub.git
$ cd CertHub

2. Prepare config from examples2. 从示例复制配置

config
$ cp config/domains.yml.example config/domains.yml
$ cp config/servers.yml.example config/servers.yml
$ cp config/notify.yml.example config/notify.yml
# dns-providers.yml: create from your own keys (do not commit)
$ mkdir -p data/certs data/logs data/backups

Edit the YAML next — see Configure. You can start the stack first and fill keys before the first generate.YAML 怎么填见配置说明。也可以先把容器拉起来,真正跑 generate 之前再填密钥。

3. Mount SSH keys3. 挂载 SSH 密钥

docker-compose.yml mounts ~/.ssh read-only into the manager container. Make sure the key that can log into your nginx hosts is in that directory, and the public key is already on the servers.docker-compose.yml 会把本机 ~/.ssh 只读挂进管理容器。请确认能登录目标 nginx 机器的私钥在这个目录里,且对应公钥已装到服务器上。

ssh check
$ ssh -i ~/.ssh/id_rsa root@你的服务器IP hostname
 should print without password prompt应免密打出主机名

4. Start services4. 启动服务

compose
$ docker compose up -d
$ docker compose ps
 acme-ssl-manager
 acme-health   # http://localhost:8080/health
  • acme-manager — certificate engine + cron.acme-manager:证书引擎和定时任务。
  • acme-health — Community read-only health endpoint on port 8080.acme-health:Community 只读健康检查,端口 8080
  • Optional Prometheus is in the same compose file.同一份 compose 里还可选开 Prometheus。
edition boundary版本边界The public Community repository contains CLI + YAML and /health only. The Web console and full REST API are delivered separately with Pro.公开 Community 仓库只包含 CLI + YAML 和 /health;Web 控制台与完整 REST API 随 Pro 独立交付。

5. Health check5. 健康检查

health
$ docker exec acme-ssl-manager /scripts/cert-manager-simple.sh health-check
$ curl -s http://127.0.0.1:8080/health
security安全提醒 Community exposes only read-only /health. Do not add certificate inventory, configuration or log data to this endpoint. Community 只暴露只读 /health,不要向该接口加入证书库存、配置或日志数据。