#!/bin/bash # ============================================================================ # 生产配置语法校验:把 conf/ 下的生产配置渲染到沙箱,跑 `nginx -t`。 # # 验证点(不做真实回源): # * load_module 能加载 ipass 模块(含 plugin-cache) # * ipass_state / ipass_data_dir / ipass_audit_dir / ipass_cache / ipass_api 指令被接受 # * 变量式 `proxy_pass $cache_target` 被接受,且 `resolver` 已声明 # (变量上游没 resolver 会在运行期 500,配置期看不出,所以这里也断言 resolver 在) # * **SSL 在本构建里真的可用**:conf/server.cache.conf / cache-routes.conf / # cache-common.conf 都用了 `proxy_ssl_server_name`(上游 https 必需), # 若拿无 SSL 的 nginx 来校验会报 unknown directive —— 这正是要拦的情况 # * 六生态 proxy_cache_path 目录可创建 # * include conf/server.cache.conf / cache-routes.conf / cache-common.conf # 与 tls/*.conf 空匹配都解析正确 # # ⚠️ 与旧版(静态上游版)的区别:上游地址与凭据**已不在 conf 里**,全在 # plugin-cache 的上游表(data/cache-upstreams.json → 写穿共享内存)。 # 所以这里**不再需要**把 https:// 降级成 http:// —— 配置里根本没有字面量上游。 # 同理也不再剔除 proxy_ssl_*:那会让「SSL 构建可用」这个验证点凭空消失。 # ============================================================================ set -uo pipefail HERE=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd) REPO=$(cd "$HERE/../.." && pwd) RUN="$HERE/.run-prod" NGINX_BIN=${NGINX_BIN:-$REPO/build/nginx-1.30.4/objs/nginx} MODULE=${MODULE:-$REPO/rust/target/debug/libipass_gateway.dylib} [ -x "$NGINX_BIN" ] || { echo "错误:nginx 不存在 $NGINX_BIN" >&2; exit 1; } [ -f "$MODULE" ] || { echo "错误:模块不存在 ${MODULE}(先 cargo build)" >&2; exit 1; } # 前置闸门:本校验依赖 SSL 模块在编(conf 里有 proxy_ssl_server_name)。 # 先自检,避免用错二进制时得到一串难懂的 unknown directive。 if ! "$NGINX_BIN" -V 2>&1 | grep -q -- '--with-http_ssl_module'; then echo "❌ 该 nginx 未编译 http_ssl_module,无法校验生产配置:" >&2 echo " $NGINX_BIN" >&2 echo " 生产 conf 用了 proxy_ssl_server_name(上游 https 必需)。" >&2 echo " 请先:bash build/build-nginx-ssl.sh(产物 build/nginx-1.30.4/objs/nginx)" >&2 exit 1 fi # 清掉上一次的 conf 副本(其余子树不必清:渲染会覆盖同名文件)。 # ⚠️ 不要写 `rm -rf "$RUN"`:本机批量删除护栏超过阈值会**拒绝整个删除且不报错**, # 于是上一轮残留的 conf 会被当成"本次校验通过"(静默假绿)。实测见 .run-prod。 mkdir -p "$RUN/conf/tls" "$RUN/logs" "$RUN/data" "$RUN/audit" \ "$RUN/cache/go" "$RUN/cache/cargo" "$RUN/cache/pypi" \ "$RUN/cache/npm" "$RUN/cache/maven" "$RUN/cache/docker" find "$RUN/conf" -maxdepth 1 -type f -delete >/dev/null 2>&1 # 渲染:**借 e2e/Tier2 同一套** lib-render.sh,别在这里自己再写一份 sed 替换。 # 自己写的那份会漏掉 renderer 后续新增的项(端口、worker、tls include…), # 结果就是"校验的 conf" 与 "实跑的 conf" 悄悄分叉 —— 正是 Tier2 挂掉的那类根因。 # 端口用 18086(`-t` 不绑定端口,取个不与 run.sh 其它实例重的值只为可读)。 CACHE_PY="${PY:-python3}"; export CACHE_PY # shellcheck source=tests/cache/lib-render.sh source "$HERE/lib-render.sh" cache_render_prod_conf "$RUN" 18086 "$MODULE" echo " (沙箱校验:借 lib-render.sh 渲染,未做任何指令降级——SSL 在编,如实校验)" export ADMIN_INIT_PASSWORD="validate_only_pw" echo "── nginx -t(生产配置:conf/nginx.cache.conf)──" if "$NGINX_BIN" -p "$RUN" -c conf/nginx.cache.conf -t 2>"$RUN/logs/error.log"; then # 反向断言:变量式 proxy_pass 必须配 resolver,否则运行期一律 500 if grep -qE '^[[:space:]]*resolver[[:space:]]' "$RUN/conf/nginx.cache.conf"; then echo "✅ resolver 已声明(变量上游运行期解析的必需项)" else echo "❌ 缺 resolver:变量式 proxy_pass 会在运行期报 no resolver defined" >&2 exit 1 fi echo "✅ 生产配置语法与模块加载校验通过" rc=0 else echo "❌ 生产配置校验失败:" >&2 cat "$RUN/logs/error.log" >&2 rc=1 fi echo echo " 渲染后的配置:$RUN/conf/nginx.cache.conf" exit $rc