一、需求与选型

需求:

  • 泛域名证书申请、自动续期
  • 更新后同步到多台服务器
  • 个人管理,尽量轻量,不想装 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.1
  • dnsPropagationWait 设置为 30
  • dnsPropagationTimeout 设置为 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=1

docker-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.1

docker-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