tuxmonteiro/boulder

tuxmonteiro/boulder镜像说明

镜像概述

Boulder是Let's Encrypt使用的ACME（自动证书管理环境）服务器实现，该镜像提供了Boulder的完整运行环境，可帮助用户在本地快速搭建ACME CA服务，用于证书相关的开发、测试和学习。

核心功能

• 支持ACME协议的证书签发流程
• 提供OCSP（在线证书状态协议）响应服务
• 集成MariaDB数据库存储证书数据
• 集成RabbitMQ消息队列处理异步任务
• 包含DNS、邮件测试服务及调试端口

使用场景

• ACME客户端开发时的本地测试环境
• 验证证书颁发、吊销流程的正确性
• 学习ACME协议和CA服务的工作原理
• 内部测试环境的证书自动化管理

配置说明

环境变量

• FAKE_DNS: 伪造DNS地址（默认127.0.0.1）
• PKCS11_PROXY_SOCKET: PKCS11代理 socket地址（默认tcp://boulder-hsm:5657）

卷挂载

• $GOPATH:/go/: 挂载本地GOPATH目录
• /tmp:/tmp: 挂载临时目录

端口映射

• 4000: ACME服务端口
• 4002/4003: OCSP服务端口
• 4500: CT测试服务端口
• 8000-8004: 调试端口
• 8055: DNS测试服务更新端口
• 9380/9381: 邮件测试服务端口

依赖服务

• bhsm: PKCS11守护进程服务
• bmysql: MariaDB数据库服务
• brabbitmq: RabbitMQ消息队列服务

部署示例（docker-compose）

yaml
boulder:
    image: tuxmonteiro/boulder
    environment:
        FAKE_DNS: 127.0.0.1
        PKCS11_PROXY_SOCKET: tcp://boulder-hsm:5657
    volumes:
      - $GOPATH:/go/
      - /tmp:/tmp
    net: bridge
    extra_hosts:
      - le.wtf:127.0.0.1
      - boulder:127.0.0.1
    ports:
      - 4000:4000 # ACME
      - 4002:4002 # OCSP
      - 4003:4003 # OCSP
      - 4500:4500 # ct-test-srv
      - 8000:8000 # debug ports
      - 8001:8001
      - 8002:8002
      - 8003:8003
      - 8004:8004
      - 8055:8055 # dns-test-srv updates
      - 9380:9380 # mail-test-srv
      - 9381:9381 # mail-test-srv
    links:
      - bhsm:boulder-hsm
      - bmysql:boulder-mysql
      - brabbitmq:boulder-rabbitmq
bhsm:
    image: letsencrypt/boulder-tools:2016-11-02
    environment:
        PKCS11_DAEMON_SOCKET: tcp://0.0.0.0:5657
    command: /usr/local/bin/pkcs11-daemon /usr/lib/softhsm/libsofthsm.so
    expose:
      - 5657
bmysql:
    image: mariadb:10.1
    net: bridge
    environment:
        MYSQL_ALLOW_EMPTY_PASSWORD: "yes"
    command: mysqld --bind-address=0.0.0.0
    log_driver: none
brabbitmq:
    image: rabbitmq:3
    net: bridge
    environment:
        RABBITMQ_NODE_IP_ADDRESS: "0.0.0.0"
    log_driver: none

通过上述docker-compose配置，可快速启动包含所有依赖的Boulder ACME服务环境。 ===END===