# 2026-11-19 更新：上游 TLS 策略审计

此前的检查只识别显式的 `proxy_ssl_verify off`，即使所在配置没有实际启用 HTTPS 上游。
0.5.0 从实际的 `proxy_pass`、`grpc_pass` 和 `uwsgi_pass` 指令入手，按对应模块分别追踪
`http`、`server`、`location` 中的继承和覆盖。判断依据保留实际使用处的源文件、行号、
include 链及相关设置来源。没有显式启用证书验证的加密上游会报出其默认配置；
仅在某个 location 覆盖时，同级其他上游沿用父级配置。

同时检查显式启用的旧 TLS 协议，给出 DNS 名称存在但未启用 SNI、明文上游显式验证配置
不生效的提示。若运行时变量才决定传输协议，扫描返回不完整诊断。该功能检查配置策略，
不验证服务器证书、信任链、DNS、后端握手或全部 Nginx 模块的运行行为。
源码使用新格式化器的 `#derive` 写法，构建需要 `moonc` 0.10.21 或更新版本。
配置语义参考 Nginx 官方的 [HTTP 代理配置](https://nginx.org/en/docs/http/ngx_http_proxy_module.html)、
[gRPC 配置](https://nginx.org/en/docs/http/ngx_http_grpc_module.html)和
[uWSGI 配置](https://nginx.org/en/docs/http/ngx_http_uwsgi_module.html)。

从仓库目录使用 CMD 对照两份配置。第一条命令列出 4 个警告和 1 个提示，退出码为 1；
第二条输出 0 个发现，退出码为 0。

```bat
node tools\moonnginx-access-audit.mjs security review.conf --root examples/upstream-tls --strict
node tools\moonnginx-access-audit.mjs security protected.conf --root examples/upstream-tls --strict
```

两份配置均由真实 Nginx 执行 `nginx -t`。验证脚本生成临时测试 CA，校验两次语法检查、
文件扫描的规则、定位和退出码，并对照新编译的 CLI 与分发的 CLI。不会启动这两份配置，
也不会连接示例中的上游服务。

```bat
python tools\verify_upstream_tls.py --nginx C:/tools/nginx/nginx.exe --openssl C:/tools/openssl.exe
```

验收对应：MoonBit 实现和源代码组织见 `nginx/upstream_tls.mbt`；单元测试覆盖默认值、
继承、include、传输协议和误报边界；[README](../README.md)提供安装、使用和例子；
GitHub CI 继续运行检查、构建、测试和真实配置验证；Apache-2.0 及
[第三方许可记录](../THIRD_PARTY.md)保留。第 8 项以
[Mooncakes 模块](https://mooncakes.io/docs/BeiLaDuo/moonnginx-access-audit)实际可安装为准。
