一个轻量级、自动化的容器化测试工具,由 Alpine Linux 和 OpenSSL s_server 驱动,用于以小整数作为椭圆曲线私钥进行测试。
它会生成两级椭圆曲线(EC)证书链(CA + 服务器),使用自定义 SAN 扩展(IP 和域名)为服务器证书签名,捕获并回显所有执行的 OpenSSL 命令,并在以 -WWW 或 -www 模式运行时提供一个实时 HTML 报告,说明证书和密钥是如何创建的。
fullchain.pem 中。CHAIN_MODE=c1)或所有可用路径的组合(CHAIN_MODE=all)。s 字节输入:直接接受 EC 私钥标量 $s$ 作为十六进制字符串(例如 0xdeadbeef1337 或 deadbeef...)或小整数(例如 42),将精确的十六进制标量嵌入生成的 EC 私钥中,使 openssl ec -text 在 priv: 下显示你的精确字节。S_BYTES、SERVER_S_BYTES、CA_S_BYTES。CA_CURVE、SERVER_CURVE,或回退到 CURVE(例如 prime256v1、secp384r1、secp521r1)。CA_SUBJECT 和 SERVER_SUBJECT。DOMAINS 和 IPS(以逗号或空格分隔)。WWW_MODE(WWW、www、HTTP)。PORT(默认 4433)。fullchain.pem、tls.crt)和私钥挂载到 /certs,若存在则改为提供这些内容。openssl x509 -text -noout 和 openssl ec -text -noout)。在 -WWW 模式下,访问 https://<host>:<port>/index.html 会渲染此完整报告,并支持一键下载 PEM 文件。chart/)和 ArgoCD Application(argocd/),与 Gitea CI/CD 流水线相匹配。s 字节(十六进制)运行docker run -p 4433:4433 \
-e S_BYTES="0xdeadbeef1337" \
ghcr.io/blackthornyugen/tiny-key-s-server:latest
运行 openssl ec -in server.key.pem -text -noout 时,私钥标量显示为:
priv:
00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:
00:00:00:00:00:00:00:00:00:00:00:de:ad:be:ef:
13:37
s 运行docker run -p 4433:4433 \
-e S_BYTES="42" \
-e DOMAINS="localhost,test.internal" \
-e IPS="127.0.0.1,192.168.1.100" \
ghcr.io/blackthornyugen/tiny-key-s-server:latest
docker run -p 4433:4433 \
-e SERVER_S_BYTES="0xdeadbeef" \
-e CA_S_BYTES="0x1337c0de" \
-e CA_CURVE="prime256v1" \
-e SERVER_CURVE="prime256v1" \
ghcr.io/blackthornyugen/tiny-key-s-server:latest
如果你已有预生成的证书(例如 Let's Encrypt 或 Vault 证书):
docker run -p 4433:4433 \
-v /path/to/my/certs:/certs:ro \
ghcr.io/blackthornyugen/tiny-key-s-server:latest
当 fullchain.pem(或 tls.crt)与 privkey.pem(或 tls.key / server.key)存在于 /certs 中时,容器会直接检查并提供它们,而不会生成新证书。
由于密钥 $a$(服务器,标量 $s$)和 $b$(CA,标量 $s+1$ 或 CA_S_BYTES)是确定性的,中间密钥 $b$ 可以提前由外部根 CA($c_1, c_2, \dots$)预签名,或者可以挂载根证书以便在启动时自动签名。
将交叉签名链 PEM 放入 /certs/chains/:
/certs/chains/c1.pem(包含由 $c_1$ 签名的 $b$,以及可选的 $c_1$)/certs/chains/c2.pem(包含由 $c_2$ 签名的 $b$,以及可选的 $c_2$)# Serve specific cross-signed path (a -> b_c1 -> c1)
docker run -p 4433:4433 \
-e S_BYTES="0x01" \
-e CA_S_BYTES="0x02" \
-e CHAIN_MODE="c1" \
-v /path/to/chains:/certs/chains:ro \
ghcr.io/blackthornyugen/tiny-key-s-server:latest
# Serve all paths concatenated in fullchain.pem (a -> b_c1 + b_c2)
docker run -p 4433:4433 \
-e S_BYTES="0x01" \
-e CA_S_BYTES="0x02" \
-e CHAIN_MODE="all" \
-v /path/to/chains:/certs/chains:ro \
ghcr.io/blackthornyugen/tiny-key-s-server:latest
适用于 CI/CD 或无需挂载卷的轻量级执行场景:
docker run -p 4433:4433 \
-e S_BYTES="0x01" \
-e CHAIN_MODE="all" \
-e EXTRA_CHAIN_PEM="$(cat extra_chain.pem)" \
ghcr.io/blackthornyugen/tiny-key-s-server:latest
将外部根 CA 证书和私钥挂载到 /certs/roots/:
/certs/roots/c1.crt 和 /certs/roots/c1.key在启动时,容器会自动为密钥 $b$ 生成由根证书 $c_1$ 签名的中间证书,并将其置于 CHAIN_MODE="c1" 或 CHAIN_MODE="all" 下。
在 -WWW 模式下,获取 HTML 报告:
# Insecure (skip CA verification)
curl -k https://localhost:4433/index.html
# Download the generated CA certificate
curl -k -O https://localhost:4433/ca.crt.pem
# Secure request using the downloaded CA
curl --cacert ca.crt.pem https://localhost:4433/index.html
s_client在终端中连接并检查证书链:
openssl s_client -connect localhost:4433 -showcerts
| 变量 | 默认值 | 描述 |
|---|---|---|
S_BYTES / SERVER_S_BYTES | chart 中的 0x01 | 服务器 EC 私钥的精确整数(例如 1、42)或十六进制标量(0xdeadbeef...)。 |
CA_S_BYTES | 派生值($s+1$) | CA EC 私钥的精确整数或十六进制标量。 |
ROOTS / CHAINS | c1,c2 (在 chart 中) | 以逗号分隔的根 CA / 链名称列表。自动派生 2 到 10 个 ingress 及配套端口(单链时省略 all)。 |
ROOT_S_BYTES | 0x10,0x20 (在 chart 中) | 以逗号分隔的根 CA 精确标量。 |
CHAIN_MODE | default | 主链组装模式:default($a \rightarrow b$)、<name> 或 all。 |
CHAINS_DIR | /certs/chains | 包含预签名中间证书或交叉链 PEM 文件的目录。 |
ROOTS_DIR | /certs/roots | 包含根 CA .crt 和 .key 密钥对(用于自动中间证书签名)的目录。 |
EXTRA_CHAIN_PEM | 空 | 要包含在中间链组装中的原始 PEM 证书字符串。 |
CHAIN_FILE | 空 | 要包含的特定中间链 PEM 文件的路径。 |
WWW_MODE | WWW | openssl s_server 的模式(WWW 提供文件,www 提供内置状态页,HTTP 包含响应头)。 |
PORT | 4433 | s_server 监听的 TCP 端口。 |
CA_CURVE | prime256v1 | CA 密钥使用的椭圆曲线。 |
SERVER_CURVE | prime256v1 | 服务器密钥使用的椭圆曲线。 |
CURVE | prime256v1 | 当 CA 和服务器未单独设置时使用的回退曲线。 |
CA_SUBJECT | /CN=Test OpenSSL CA/O=Test Lab/C=CA | CA 的 X.509 主题。 |
SERVER_SUBJECT | /CN=localhost/O=Test Lab/C=CA | 服务器证书的 X.509 主题。 |
DOMAINS | tiny-key-s-server.jskw.dev,localhost | 以逗号或空格分隔的 DNS SAN 列表。 |
IPS | 127.0.0.1 | 以逗号或空格分隔的 IP SAN 列表。 |
CA_DAYS | 3650 | CA 证书的有效期(以天为单位)。 |
SERVER_DAYS | 365 | 服务器证书的有效期(以天为单位)。 |
CERTS_DIR | /certs | 用于检查挂载的证书和密钥的目录。 |
EXTRA_S_SERVER_ARGS | 空 | 直接传递给 openssl s_server 的额外 CLI 标志。 |
所有测试均设计为在临时 Docker 容器中干净运行,不会修改宿主机系统:
tests/test_scalar_s_bytes.sh:测试标量生成,并验证 openssl ec -text 是否显示确切的用户十六进制值。tests/test_chain_generation.sh:测试 CA 创建、服务器 CSR 签名、SAN 注入以及 openssl verify。tests/test_s_server_behavior.sh:使用 curl 测试 -WWW 和 -www 的响应语义。tests/test_volume_override.sh:测试挂载包含预先存在证书的外部卷。tests/test_full_docker_app.sh:对构建的镜像进行完整的端到端集成测试。tests/test_cross_signed_chains.sh:测试中间交叉签名($a \rightarrow b \rightarrow c_1 / c_2$)以及多信任锚客户端验证。tests/test_chain_modes.sh:测试运行时 CHAIN_MODE 路径解析(default、命名路径 c1 以及 all)。tests/test_multi_port_server.sh:测试动态多根派生(ROOTS=c1,c2)、配套的 s_server 监听器,以及单链与多链端口分配。tests/run_all_tests.sh:编排所有测试脚本。运行所有测试:
./tests/run_all_tests.sh
Helm chart 位于 chart/:
helm upgrade --install tiny-key-s-server ./chart \
--set env.DOMAINS="tiny-key-s-server.jskw.dev,localhost" \
--set ingress.enabled=true \
--set ingress.hosts[0]=tiny-key-s-server.jskw.dev
持续部署由 argocd/ 中的 ArgoCD 清单文件处理:
argocd/main-application.yaml:跟踪 main 分支 / 版本标签的生产发布应用。argocd/pr-applicationset.yaml:为 Gitea PR 动态配置的拉取请求预览环境。一个可选的 mitmproxy 容器可以与 tiny-key-s-server 一起运行,使用你的自定义中间 CA 和交叉签名链来检查、记录或操纵 TLS 流量。