certifytheweb/management-hub

Certify Management Hub 镜像文档

镜像概述

Certify Management Hub 目前处于测试和评估阶段（beta版）。更多详情请参见：[***]

该镜像集成了Certify Certificate Manager应用的所有核心功能，提供基于Web的管理界面（UI）和API接口，支持自托管部署及跨平台运行。

核心功能与特性

• 自托管与跨平台：支持Linux、macOS及Windows系统，可在企业内部环境独立部署。
• 集中化多实例管理：可选管理数百个现有Certify Certificate Manager实例（含Certify Agent）的数千个证书，通过"单一管理界面"实现集中续期。
• 多用户权限控制：基于角色的访问控制（RBAC），支持应用/服务安全原则及个人范围的API访问权限管理。
• 灵活证书分发：通过可选安装的代理、部署任务分发证书，或使用API自行集成以拉取最新证书。
• 集中化DNS挑战：兼容主流ACME客户端，无需在各客户端存储特权DNS凭据，降低安全风险。
• 第三方ACME客户端监控：可通过Certify Management Agent集中监控其他第三方ACME客户端的续期状态（参见：https://hub.docker.com/repository/docker/certifytheweb/certify-agent%EF%BC%89%E3%80%82
• 实验性ACME API：提供代理订单至实际CA的ACME API，支持标准ACME客户端通过EAB认证自动完成DNS挑战，最小化客户端配置。

!Hub管理界面截图

使用场景

• 企业级证书集中管理：适用于需要统一管控多业务线、多环境证书生命周期的企业。
• 多团队协作场景：支持不同团队基于角色权限管理和使用证书，满足协作与安全隔离需求。
• DNS挑战集中化管理：解决分布式ACME客户端分散存储DNS凭据的安全隐患，通过中心节点统一处理DNS验证。
• 第三方ACME客户端监控：需集中跟踪非Certify体系ACME客户端证书续期状态的场景。

使用方法与配置说明

基础部署提示

• 数据持久化：建议挂载卷至/usr/share/certify以持久化存储配置，或通过环境变量CERTIFY_APPDATA_PATH自定义存储路径。
• 网络端口：默认通过8080端口暴露UI和API服务。
• 安全运行：镜像以非root用户身份运行，降低权限风险。

Docker Compose快速启动

1. 创建配置文件

保存以下内容为docker-compose.yaml：

yaml
name: certify-management-hub
services:
  certify-hubservice:
    image: docker.io/certifytheweb/management-hub:latest
    ports:
      - "8080:8080"
    volumes:
      - certifydata:/usr/share/certify/
    restart: unless-stopped
volumes:
  certifydata:

2. 启动服务

在配置文件所在目录执行以下命令启动容器：

bash
docker compose up -d

初始登录与安全配置

• 默认凭据：初始管理员账号为admin，密码为changeme!。首次登录后必须立即修改密码，避免安全风险。
• 部署警告：当前版本部分API端点未完全防护，请勿部署在公共网络服务器，仅限内部测试与评估使用。

登录故障处理

若登录时提示"Failed to fetch"错误：

1. 点击登录界面的设置图标
2. 手动设置API URL为http://localhost:8080（本地部署）或远程实例的IP/主机名（如http://192.168.1.100:8080）

参考文档

完整使用文档请参见：[***]