宝塔面板安装后无法识别二级域名_检查DNS解析与绑定设置-php教程-PHP中文网

二级域名不生效主因是dns未正确解析至服务器ip，需用dig或dnschecker验证；宝塔中域名与根目录须准确绑定；ssl需手动扩展二级域名；伪静态和反向代理配置不当会导致404/502；务必检查nginx错误日志定位问题。

宝塔面板安装后无法识别二级域名_检查dns解析与绑定设置

很多情况根本不是宝塔的问题，而是 DNS 解析没到位。哪怕你已经在宝塔里加了 sub.example.com，如果 DNS 还没把这条记录指向你的服务器 IP，请求压根到不了宝塔。

实操建议：

用 dig sub.example.com +short 或在线工具（如 dnschecker.org）查全球各节点解析结果，确认返回的是你服务器的公网 IP
检查 DNS 记录类型：二级域名必须用 A 记录（不能是 CNAME 指向主域名，除非你明确配置了泛解析且主域名本身也指向该 IP）
TTL 值较高时，修改后可能需要几小时才全网生效；临时调试可把 TTL 改成 60 秒再等 5 分钟
注意 CDN 干扰：如果套了 Cloudflare 等，确保状态是 DNS only（灰色云），否则流量不会进宝塔

宝塔的「网站」→「添加站点」流程里，域名 和 根目录 是强关联项，填反或漏填会导致 404 或访问到默认页。

实操建议：

添加站点时，域名 栏必须填完整二级域名，比如 api.example.com，不能只填 api
如果想让多个二级域名共用一个站点，得在已建站点的「域名管理」里额外添加，而不是新建站点
根目录 路径必须真实存在且有读取权限；常见错误是写成 /www/wwwroot/api.example.com 但实际目录名是 /www/wwwroot/api，导致 Nginx 找不到 index 文件
若使用 SSL，务必勾选「强制 HTTPS」前先确认证书已成功申请——否则会因重定向失败导致无限刷新或 ERR_TOO_MANY_REDIRECTS

宝塔自动申请的 Let's Encrypt 证书默认只包含主域名和 www 子域，api.example.com 这类二级域名不会被自动包含，必须手动扩展。

实操建议：

进入站点设置 → 「SSL」→ 「申请证书」，在「其他域名」栏补上你要的二级域名，例如：api.example.com、admin.example.com
不要重复点击「申请」按钮：多次申请可能触发 Let's Encrypt 的速率限制（每 3 小时最多 5 次），导致后续申请失败并显示 too many failed authorizations
证书申请成功后，检查 Nginx 配置文件中 ssl_certificate 和 ssl_certificate_key 路径是否指向最新生成的 PEM 文件（路径类似 /www/server/panel/vhost/cert/api.example.com/fullchain.pem）
改完配置记得点「重载配置」，否则 Nginx 不会加载新证书

二级域名看起来通了，但 JS/CSS 加载失败，或者 API 请求返回 502，通常不是 DNS 或证书问题，而是请求没正确落到后端服务上。

实操建议：

检查「网站」→「设置」→ 「伪静态」：如果是 Laravel、ThinkPHP 等框架，必须选择对应规则，否则 /api/user 这类路径会被 Nginx 当作静态文件找，自然 404
如果后端跑在本地端口（如 127.0.0.1:3000），需在「反向代理」里新增规则，目标 URL 填 http://127.0.0.1:3000，且确保代理配置里没有漏掉 proxy_set_header Host $host;
查看 Nginx 错误日志：/www/wwwlogs/api.example.com.error.log，里面常有具体线索，比如 connect() failed (111: Connection refused) 表示后端没起来，no resolver defined 则是反向代理用了域名但没配 resolver
别忽略跨域问题：前端调用 https://api.example.com 接口时，后端响应头没带 Access-Control-Allow-Origin，浏览器控制台会静默失败，但 Nginx 日志里查不到痕迹