PuppyIP 资源中心
网络与连接排错 9 分钟 发布于 2026-11-17

Nginx 给 Nezha 域名返回默认证书:检查 SNI、虚拟主机与 OAuth 回调

域名访问落到 Nginx 默认 TLS 站点时先核对 SNI 与 server_name;证书正常后仍要单独验证 OAuth 回调地址。

Nginx Nezha SNI 默认 TLS 证书 GitHub OAuth HTTPS

服务对象与地域限制

PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。

代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。

本文要点

  • TLS 握手中的 SNI 帮助 Nginx 选择虚拟主机;匹配失败时可能返回默认 server 的证书。
  • 需核对 listen 443、server_name、证书链和代理到 Nezha 的位置,而不是只检查证书文件存在。
  • HTTPS 证书修复不自动修复 OAuth;应用回调、公共基础 URL 与 OAuth 应用登记必须一致。
  • 通过指定域名和 SNI 在目标 HTTPS 端口验证,再执行真实的登录回调测试。

证书不匹配通常先查 Nginx 选中了哪个虚拟主机

Nginx 为一个 IP 和端口承载多个 TLS 站点时,会根据握手中的 SNI 与配置的 server_name 选择虚拟主机。若请求的主机名没有匹配到预期块,连接可能落到 default_server 或配置顺序中的默认站点,返回另一域名的证书。证书文件存在并不意味着这个域名的请求实际使用了它。

先把错误分类为 DNS/连通失败、TLS 主机名或证书链错误、HTTP 代理路由错误,以及应用层登录回调错误。Nezha 的页面可能在 TLS 尚未匹配时就无法打开;在证书路径正确后,OAuth 仍可能因回调地址不同而失败,必须分别处理。

只读检查 Nginx 监听、server_name 和返回证书

先确认 Nginx 监听的地址与端口,再把解析到该入口的域名对应到 TLS server 块。nginx -T 只在本机阅读,不要复制完整配置。用实际目标主机名作为 SNI,并要求 TLS 客户端同时验证受信证书链和该主机名;输出证书 SAN、颁发者和有效期用于核对。只看 subject、issuer 或日期并不构成验证通过。

若服务位于 CDN、负载均衡或多台 Nginx 后端之后,应从用户实际访问路径和源站管理路径分别验证。连接 127.0.0.1 只检查本机入口,不能证明公网负载均衡已更新。命令应使用你获准检查的目标地址,并确认终端使用可信系统 CA;若站点使用内部 CA,应先在受信 CA 配置中提供该颁发链,再运行主机名校验。不要关闭证书验证。

检查 Nginx 配置语法和 TLS server 配置

sh
nginx -t
nginx -T 2>/dev/null | grep -E 'listen .*443|server_name|ssl_certificate'
在 Nginx 主机运行只读检查;仅查看相关行,不要公开完整 nginx -T 输出,其中可能包含内部主机名和路径。

用目标域名 SNI 查看服务端证书

sh
set -eu
TARGET_HOST='REPLACE_WITH_TARGET_TLS_HOSTNAME'
CONNECT_TO='REPLACE_WITH_AUTHORIZED_CONNECT_HOST:443'
OPENSSL_VERSION=$(openssl version) || exit 1
case "$OPENSSL_VERSION" in
  "OpenSSL 1.1.1"*|"OpenSSL 3."*) ;;
  *) printf 'OpenSSL version must support hostname verification: %s\n' "$OPENSSL_VERSION" >&2; exit 2;;
esac
openssl s_client -help 2>&1 | grep -q -- '-verify_hostname' || { printf 's_client lacks -verify_hostname\n' >&2; exit 2; }
WORK_DIR=$(mktemp -d) || exit 1
trap 'rm -rf "$WORK_DIR"' EXIT
trap 'exit 129' HUP
trap 'exit 130' INT
trap 'exit 143' TERM
if openssl s_client -connect "$CONNECT_TO" -servername "$TARGET_HOST" -verify 10 -verify_return_error -verify_hostname "$TARGET_HOST" -showcerts </dev/null >"$WORK_DIR/handshake.txt" 2>&1; then
  :
else
  TLS_STATUS=$?
  grep -E 'verify error|Verification error|Verify return code' "$WORK_DIR/handshake.txt" || true
  exit "$TLS_STATUS"
fi
awk '/-----BEGIN CERTIFICATE-----/ { if (!seen++) printing=1 } printing { print } /-----END CERTIFICATE-----/ && printing { exit }' "$WORK_DIR/handshake.txt" >"$WORK_DIR/leaf.pem"
test -s "$WORK_DIR/leaf.pem" || { printf 'No leaf certificate received\n' >&2; exit 1; }
openssl x509 -in "$WORK_DIR/leaf.pem" -noout -subject -issuer -dates -ext subjectAltName
grep -F 'Verify return code: 0 (ok)' "$WORK_DIR/handshake.txt"
将目标主机名与连接入口替换为你获准检查的值;127.0.0.1:443 仅代表本机入口。命令要求 OpenSSL 1.1.1/3 且支持主机名校验,并同时要求受信链与 hostname 验证成功;最后输出 SAN、颁发者和有效期。依赖系统 CA 信任库,内部 CA 需先正确加入信任配置。退出码非零或最后的 Verify return code 行缺失都不能视为通过。

在确认配置后修正虚拟主机与证书关联

只有确认 TLS 请求进入了错误 server 块,才在对应 Nginx 配置中修正 server_name、listen 和该站点证书路径。先备份被编辑的站点配置,并确认现有 HTTPS 站点及默认站点的职责;不要改写整份 nginx.conf 或删除默认块来碰运气。证书的完整链、私钥权限和续期部署路径也需要一起核对。

修改前运行 nginx -t 检查语法,再使用维护窗口 reload Nginx;若语法检查失败,不要 reload。保留配置备份和原服务入口作为回退。TLS 证书选择修正后,先对目标域名验证证书和 HTTP 页面,再进入 OAuth 排查;不要在同一轮混改应用基础 URL 与 Nginx 路由。

TLS 正常后独立核对 GitHub OAuth 回调

OAuth 回调失败与默认证书是不同层的问题。核对 Nezha 配置中的公共基础 URL、OAuth 提供方登记的 callback URL、实际请求的 scheme/host/path 是否逐字符一致,包括 HTTPS、主机名、子路径和尾部斜杠。反向代理还需正确传递应用需要的 Host 与 HTTPS 代理头;不要为了绕开回调校验改用 HTTP 或另一个未登记域名。

Nezha 版本和 OAuth 配置字段可能不同,应以当前运行版本的官方说明为准。更改 OAuth 应用登记或服务器配置前先备份并确认管理员登录仍可用。若 TLS 正常但登录被拒,记录脱敏后的回调错误路径和状态码,不要把 OAuth client secret、应用密钥或用户 token 发到日志/工单。

分别验证 TLS、页面代理和 OAuth 登录

对目标域名做三个独立检查:TLS 客户端成功验证证书链和 hostname,输出的 SAN 覆盖目标主机名且有效期合理;HTTPS 页面经 Nginx 能到达 Nezha;OAuth 能从应用跳转到授权方并返回完全匹配的 callback。浏览器锁形图标只说明某一访问路径完成了 TLS 检查,不证明代理上游、应用 URL 或 OAuth 授权都正确。

若 Nezha 版本页、静态资源和健康检查正常但 OAuth 回调失败,继续查 OAuth 配置而不是轮换 TLS 证书。若本机请求正常、公网请求仍拿到旧证书,检查 CDN/LB 后端、DNS 和缓存更新;不要把本机 openssl 结果推广到所有入口。

回滚和安全边界

出现 Nginx 配置校验失败、其他网站证书异常或代理上游无法访问时,恢复最近备份的站点配置并先运行 nginx -t,再 reload。证书文件、私钥和 OAuth secret 应保持在受限权限目录,不要将其加入配置 diff、截图或知识库正文。

本流程的版本参照范围为 Nezha v2.2.10;其他版本应按正在运行版本的 OAuth 文档核对字段,不要假定配置相同。证书返回正确仍需要 OAuth 完成真实回调;只有 TLS、应用页面和授权登录分别通过,才能关闭整条故障链的排查。

资料来源

常见问题

为什么 Nginx 返回另一个域名的证书?

目标 SNI 可能没有匹配到预期 server_name,从而落到默认 TLS server。检查实际监听端口、虚拟主机匹配和返回证书。

证书修复后 GitHub OAuth 仍失败,说明证书没更新吗?

不一定。TLS 与 OAuth 回调是不同层。核对应用基础 URL、OAuth 登记的 callback 和反向代理头是否一致。

nginx -T 输出可以发给别人排查吗?

不要公开完整输出。它可能包含内部域名、上游地址、文件路径或认证配置。只分享脱敏后的相关 server_name、listen 和错误行。

本机 openssl 看到正确证书是否证明公网也正确?

不证明。CDN、负载均衡、DNS 和缓存可能仍指向其他后端。使用实际用户访问路径和目标 SNI 再验证。