netreconlab/ca-server

ca-server

https://dockeri.co/image/netreconlab/ca-server](https://hub.docker.com/r/netreconlab/ca-server) https://github.com/netreconlab/ca-server/actions/workflows/build.yml/badge.svg](https://github.com/netreconlab/ca-server/actions/workflows/build.yml) https://github.com/netreconlab/ca-server/actions/workflows/release.yml/badge.svg](https://github.com/netreconlab/ca-server/actions/workflows/release.yml) !https://img.shields.io/badge/license-Apache%202.0-blue.svg

镜像概述

ca-server是一款用于快速构建应用证书颁发机构（CA）的工具，支持证书签名请求（CSR）处理、证书生成与管理，可与Parse-Swift生态系统集成，帮助开发者搭建安全的应用通信体系。

核心功能

• 快速创建和管理自定义证书颁发机构（CA）
• 接收并处理客户端发送的证书签名请求（CSR），生成有效证书
• 支持与Parse-Swift相关工具链集成，提供端到端的证书处理能力
• 可配置的路由前缀与存储路径，适配不同部署场景的需求

使用场景

• 为内部应用服务生成自签名证书，保障服务间加密通信安全
• 构建基于Parse-Swift的应用生态，实现客户端与服务器的身份认证
• 快速部署证书管理服务，满足开发与测试环境的安全需求

配置说明

环境变量

需配置以下环境变量，并挂载包含私钥、根证书、数据库文件的目录以确保数据持久化：

bash
CA_SERVER_PRIVATE_KEY_FILE=./server/ca/private/cakey.pem # （必填）私钥文件路径
CA_SERVER_ROOT_CA_CERT=./server/ca/private/cacert.der # （必填）根证书文件路径
CA_SERVER_DATABASE_NAME=./server/dbs/appdb.sqlite # （必填）数据库文件路径
CA_SERVER_CA_DIRECTORY=./server/ca # CA相关文件存储目录
CA_SERVER_ROUTE_ROOT_CERTIFICATE_PREFIX=/ca_certificate # 根证书路由前缀
CA_SERVER_ROUTE_USER_PREFIX=/appusers # 用户路由前缀
CA_SERVER_ROUTE_CERTIFICATE_PREFIX=/certificates # 证书路由前缀
CA_SERVER_ROUNDS=5 # 加密轮数

部署示例

本地Docker部署

1. Fork本仓库
2. 执行以下命令启动服务：

bash
docker-compose up

3. 访问http://localhost:3000/docs查看API文档并使用

代理后部署配置

若需在代理后运行，修改docker-compose.yml的启动命令添加--root-path（假设代理端点为/ca）：

bash
command: [ "./start-poetry.sh", "poetry", "run", "uvicorn", "server.main:app", "--host", "0.0.0.0", "--port", "3000", "--root-path", "/ca" ]

同时在Nginx配置中添加：

bash
location /ca/docs {
    proxy_pass [***]
}
location /ca/ {
    proxy_pass [***]
}