ainigost/acme.sh

acme.sh Docker镜像

镜像概述

基于Alpine Linux的轻量级acme.sh Docker镜像，支持amd64和arm64架构（包括斐讯N1设备），镜像体积仅5MB。acme.sh是一个用于从Let's Encrypt等证书颁发机构获取和自动续期SSL/TLS证书的Shell脚本工具，本镜像将其容器化，避免在主机直接安装依赖，提供更便捷的证书管理方式。

核心功能与特性

• 轻量级：基于Alpine构建，镜像体积仅5MB，资源占用低
• 多架构支持：兼容amd64和arm64架构，适用于斐讯N1等设备
• 灵活运行模式：支持两种运行模式
  • 作为可执行程序：直接运行acme.sh命令
  • 作为守护进程：后台运行并自动处理证书续期的cron任务
• 完整命令支持：支持acme.sh的所有命令行参数，包括证书申请、吊销、续期等操作

使用场景与适用范围

• 需要为网站或服务申请Let's Encrypt SSL证书的场景
• 希望自动管理证书续期，避免手动操作的场景
• 运行在amd64或arm64架构设备（如斐讯N1）上的Docker环境
• 希望避免在主机系统直接安装acme.sh依赖的场景

使用方法与配置说明

1. 快速测试（Hello World）

运行以下命令验证镜像基本功能：

sh
docker run --rm docker.xuanyuan.run/ainigost/acme.sh

2. 作为可执行程序使用

通过挂载目录持久化证书，并执行acme.sh命令。以下是常见操作示例：

申请证书（独立模式）

sh
docker run --rm -it \
  -v "$(pwd)/out":/acme.sh \
  --net=host \
  docker.xuanyuan.run/ainigost/acme.sh --issue -d example.com --standalone

吊销证书

sh
docker run --rm -it \
  -v "$(pwd)/out":/acme.sh \
  --net=host \
  docker.xuanyuan.run/ainigost/acme.sh --revoke -d example.com

DNS模式申请证书

sh
docker run --rm -it \
  -v "$(pwd)/out":/acme.sh \
  docker.xuanyuan.run/ainigost/acme.sh --issue --dns -d example.com

执行cron续期任务

sh
docker run --rm -it \
  -v "$(pwd)/out":/acme.sh \
  --net=host \
  docker.xuanyuan.run/ainigost/acme.sh --cron

3. 作为守护进程运行

以守护进程模式运行，自动处理证书续期的cron任务：

启动守护进程

sh
docker run --rm -itd \
  -v "$(pwd)/out":/acme.sh \
  --net=host \
  --name=acme.sh \
  docker.xuanyuan.run/ainigost/acme.sh daemon

通过docker exec执行命令

启动守护进程后，可通过docker exec执行任意acme.sh命令：

sh
# 查看帮助
docker exec acme.sh --help

# 申请证书
docker exec acme.sh --issue -d example.com --standalone

注意事项

• 挂载目录/acme.sh用于持久化证书和配置，建议使用绝对路径或命名卷
• --net=host模式适用于需要绑定主机端口的场景（如独立模式），非必要时可移除
• 更多内容请访问：御宅说 [***]
• 相关自动化nginx反向代理配置：https://github.com/Neilpang/nginx-proxy
• 容器部署详细说明：https://github.com/Neilpang/acme.sh/wiki/deploy-to-docker-containers