knrdl/acme-ca-server

ACME CA Server 镜像文档

镜像概述和主要用途

ACME CA Server 是一个自托管的ACME（自动化证书管理环境）证书颁发机构服务器，提供类似Let's Encrypt的功能。该镜像允许用户在私有环境中搭建自己的证书颁发机构，实现TLS证书的自动化申请、签名、吊销及生命周期管理，适用于企业内部网络、私有云或开发测试环境中对证书管理有自主控制需求的场景。

核心功能和特性

• ACME Server实现：支持http-01挑战类型，符合ACME协议标准，可与ACME客户端（如Certbot）配合使用。
• 内置CA功能：提供内置的证书颁发机构，支持证书签名、吊销操作；支持替换为外部CA，并支持CA轮换机制。
• 通知邮件系统：可发送账户创建、证书即将过期、证书已过期等事件通知，邮件模板支持自定义。
• Web UI界面：提供证书日志查看功能，界面模板可定制，便于直观管理证书状态。

使用场景和适用范围

• 企业内部网络：为内部服务（如私有API、内部网站）颁发可信证书，避免使用公共CA的限制。
• 私有云环境：在私有云平台中管理服务证书，确保通信安全。
• 开发/测试环境：为开发或测试环境快速生成证书，模拟生产环境的TLS配置。
• 对证书管理有严格控制需求的场景：需要完全掌控证书颁发流程、避免依赖第三方CA的场景。

使用方法和配置说明

基本部署

详细部署和配置说明请参考官方GitHub仓库：https://github.com/knrdl/acme-ca-server

主要配置项

（注：具体配置参数、环境变量及使用示例请以GitHub仓库最新文档为准）

• CA配置：可配置内置CA的根证书、密钥，或指定外部CA的连接参数。
• 邮件通知：需配置SMTP服务器信息（如SMTP地址、端口、认证信息）及通知模板路径。
• Web UI：可通过自定义模板文件调整界面样式和显示内容。
• 挑战配置：支持http-01挑战的相关参数设置，如挑战验证超时时间等。

Docker部署示例

（以下为通用示例，具体参数需根据实际需求调整）

Docker Run命令

bash
docker run -d \
  --name acme-ca-server \
  -p 80:80 -p 443:443 \
  -v /path/to/ca-data:/app/data \
  -v /path/to/templates:/app/templates \
  -e SMTP_HOST=smtp.example.com \
  -e SMTP_PORT=587 \
  -e SMTP_USER=user@example.com \
  -e SMTP_PASSWORD=password \
  knrdl/acme-ca-server

Docker Compose配置

yaml
version: '3'
services:
  acme-ca-server:
    image: knrdl/acme-ca-server
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./ca-data:/app/data
      - ./templates:/app/templates
    environment:
      - SMTP_HOST=smtp.example.com
      - SMTP_PORT=587
      - SMTP_USER=user@example.com
      - SMTP_PASSWORD=password
    restart: always

注意事项

• 首次部署需初始化CA根证书，具体步骤请参考官方文档。
• 生产环境中建议使用持久化卷（volume）存储CA数据，避免数据丢失。
• 邮件通知功能需确保SMTP服务器配置正确，建议测试通知发送功能。
• 如需替换为外部CA，需提前准备外部CA的接口信息及认证凭证。