一、需求与选型
需求:
- 泛域名证书申请、自动续期
- 更新后同步到多台服务器
- 个人管理,尽量轻量,不想装 MySQL
- 已知彩虹聚合 DNS 但觉得太重
结论: 选择 Certimate,原因:
- 单一 Go 二进制,零外部依赖,内嵌 SQLite
- 资源占用低,支持泛域名证书
- 支持多目标部署,包括 1Panel、SSH、CDN 等
先说结论,使用1panel即可部署,部署配置要改下:
networks:
1panel-network:
external: true
services:
certimate:
container_name: ${CONTAINER_NAME}
deploy:
resources:
limits:
cpus: ${CPUS}
memory: ${MEMORY_LIMIT}
# 改动1
dns:
- 8.8.8.8
- 1.1.1.1
environment:
- http_proxy=${PANEL_HTTP_PROXY}
- https_proxy=${PANEL_HTTPS_PROXY}
- NO_PROXY=${PANEL_NO_PROXY}
# 改动3 image镜像换国内代理
image: gh-proxy.org/docker/certimate/certimate:latest
labels:
createdBy: Apps
networks:
- 1panel-network
ports:
- ${HOST_IP}:${PANEL_APP_PORT_HTTP}:8090
restart: unless-stopped
# 改动2
sysctls:
- net.ipv6.conf.all.disable_ipv6=1
- net.ipv6.conf.default.disable_ipv6=1
volumes:
- /etc/localtime:/etc/localtime:ro
- /etc/timezone:/etc/timezone:ro
- ./data:/app/pb_data
二、Certimate 申请证书阶段的问题
问题 1:DNS-01 验证超时,直连 Cloudflare 权威 NS 失败
现象:
dns01: time limit exceeded: last error: authoritative nameservers:
DNS call error: dial udp: lookup jermaine.ns.cloudflare.com.: i/o timeout原因:
Certimate 底层 lego 在验证 TXT 记录时,直接连接 Cloudflare 的权威名称服务器,网络不通或超时。
解决: 在 Certimate “申请”节点中调整配置:
nameservers设置为8.8.8.8、1.1.1.1dnsPropagationWait设置为30dnsPropagationTimeout设置为600
即让验证走公共递归 DNS,并给 DNS 传播留出足够时间。
问题 2:Cloudflare API 请求走 IPv6,但服务器无 IPv6 出口
现象:
dial tcp [2606:4700:300a::xxxx:c0b0]:443: connect: network is unreachable原因: 容器/主机解析 Cloudflare API 时优先拿到了 IPv6 地址,但运行环境没有可用 IPv6 路由,导致连接失败。
解决: 在 Certimate 运行环境中禁用 IPv6,让它强制走 IPv4。
Docker 部署时可加:
--sysctl net.ipv6.conf.all.disable_ipv6=1 \
--sysctl net.ipv6.conf.default.disable_ipv6=1docker-compose 中:
sysctls:
- net.ipv6.conf.all.disable_ipv6=1
- net.ipv6.conf.default.disable_ipv6=1同时建议清理 Cloudflare 中残留的 _acme-challenge TXT 记录,避免新旧记录冲突。
问题 3:Docker 内置 DNS 127.0.0.11:53 解析超时
现象:
dial tcp: lookup acme-v02.api.letsencrypt.org on 127.0.0.11:53:
read udp 127.0.0.1:40954->127.0.0.11:53: i/o timeout原因:
Docker 容器默认使用内置 DNS 解析器 127.0.0.11,它向上游转发 DNS 查询时超时,导致连 Let’s Encrypt API 域名都解析不了。注意这和工作流里配置的 nameservers 不是一回事。
解决: 给 Certimate 容器显式指定公共 DNS。
docker run:
--dns 8.8.8.8 \
--dns 1.1.1.1docker-compose.yml:
dns:
- 8.8.8.8
- 1.1.1.1也可在 /etc/docker/daemon.json 中全局配置:
{
"dns": ["8.8.8.8", "8.8.4.4"]
}然后重启 Docker。
三、证书部署到 1Panel 阶段的问题
问题 4:1Panel API 返回 401,IP 不在白名单
现象:
failed to execute sdk request 'SettingsSSLUpdate':
sdkerr: api error: code='401', message='调用 API 接口 IP 不在白名单'原因: 你之前在 1Panel 白名单里配的是宿主机局域网网段:
192.168.100.0/24但 Certimate 运行在 Docker 容器中,1Panel 看到的请求来源 IP 是容器内部 IP,不是宿主机 IP。
通过命令查到 Certimate 容器 IP:
docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' 1Panel-certimate-hJ2J返回:
172.18.0.3解决: 在 1Panel API 接口 IP 白名单中新增 Docker 网段:
172.18.0.0/16