# conf/tls/ —— TLS 入口 `conf/nginx.cache.conf` 的 `http` 块里有: ```nginx include /usr/local/nginx/conf/tls/*.conf; ``` 目录为空时 include 无匹配,nginx 照常启动。往里放任意 `*.conf`(每个文件是 一个完整的 `server { ... }` 块)即启用该域名的 HTTPS。 | 文件 | 作用 | | --- | --- | | `cache.conf.example` | TLS 入口模板。`cp` 成 `cache.conf` 后改域名/证书路径即生效 | ## 为什么制品缓存必须有 TLS 入口 * **Docker**:`registry-mirrors` 只接受 https。明文地址会被 daemon 拒绝 (除非把主机加进 `insecure-registries`,那等于放弃传输安全)。 * **`pip` / `npm` / `cargo`**:都支持 `https://user:pass@host/` 或 token 形式, 但明文 http 会让凭据裸奔——网关的下行 `sk_` 是长期凭据,不该走明文。 ## 证书放哪 按域名建目录(可以带字面 `*`,ipass 生产就是这么存无级别泛域名证书的): ``` conf/tls/cache.example.com/ ├── fullchain.cer ├── cache.example.com.key └── ca.cer ``` ## 注意 * `*.example` 后缀不会被 `include *.conf;` 匹配到,所以模板文件放在这里**不会** 被误加载。 * 本项目的 nginx 必须带 `--with-http_ssl_module`(`build/build-nginx-ssl.sh` 已包含)。用早前那个 `--without-http_rewrite_module` 的裁剪版会直接 报 `unknown directive "ssl_certificate"`。 * `conf/tls/*.conf` 与 `server.cache.conf` 里的明文入口**共用**同一份 `cache-routes.conf`,因此路由、鉴权、探针、管理台只维护一份。