# ============================================================================ # cache.conf.example —— 制品缓存网关的 TLS 入口(模板) # # 用法: # 1. 复制成 conf/tls/cache.conf(http 块里 include 的是 *.conf,*.example 不生效) # 2. 改 server_name / 三处证书路径 / listen 端口 # 3. nginx -t && nginx -s reload # # 为什么必须有这个入口:Docker 的 `registry-mirrors` **只接受 https**。 # 给 daemon 配一个明文 http 地址会直接被拒(除非改 insecure-registries, # 那等于放弃了这一层的传输安全)。所以 /v2/ 想真正被 docker 用起来, # 就必然要一个带证书的 server。 # # 与明文入口的关系:两者 include 同一份 cache-routes.conf(路由、鉴权、 # 探针、管理台),**只差 TLS 与监听**。改路由不用改两处。 # # ⚠️ 本机构建(build/build-nginx-ssl.sh)已带 --with-http_ssl_module, # 所以 ssl_certificate 能被真正校验;不带 ssl 的裁剪版会直接报 # `unknown directive "ssl_certificate"`。 # ============================================================================ server { # 18098 沿用 ipass 的约定(路由器再把它映射到 88/443)。 # docker daemon 允许在 registry-mirrors 里写端口:https://cache.example.com:18098 listen 18098 ssl; server_name cache.example.com; # —— 证书:三个文件都是**绝对路径**,随部署环境而异 —— ssl_certificate /usr/local/nginx/conf/tls/cache.example.com/fullchain.cer; ssl_certificate_key /usr/local/nginx/conf/tls/cache.example.com/cache.example.com.key; ssl_trusted_certificate /usr/local/nginx/conf/tls/cache.example.com/ca.cer; ssl_protocols TLSv1.2 TLSv1.3; absolute_redirect off; port_in_redirect off; # registry 大 blob 直通,不设体积上限 client_max_body_size 0; client_body_buffer_size 1m; include cache-routes.conf; }