新手必看:宝塔面板网站二级域名绑定完整教程
建站过程中,经常需要给主站挂上二级域名,比如 blog.example.com 或 shop.example.com。
对于刚接触宝塔面板的新手来说,绑定二级域名并不复杂,但有几个关键点容易踩坑。
这篇教程从零开始,讲清楚每一步怎么做,并附上常见问题的解决办法。
绑定二级域名前要先准备好什么?
在进入宝塔面板之前,有两件事必须确认:
- 域名解析已经做好:登录你的域名管理后台(阿里云、腾讯云、DNSPod 等),为主域名添加一条 A 记录,主机记录写你想用的二级域名前缀(比如
blog),记录值填你服务器的公网 IP。如果你不确定 IP,可以在宝塔面板首页右侧看到。 - 宝塔面板已正常安装:确保面板可以访问,并且已经建好了网站。如果还没有建任何站点,建议先新建一个站点再操作二级域名。
在宝塔面板里添加二级域名站点
有两种常见方式:一是新建一个独立站点,二是将二级域名绑定到主站点的子目录。
这里先说第一种,也是推荐的做法。
- 登录宝塔面板,点击左侧菜单 网站。
- 点击页面右上角的 添加站点。
- 在弹出框中,域名 栏输入你的二级域名全称,比如
blog.example.com。根目录 可以自动生成或手动指定一个文件夹,建议按规范创建,比如/www/wwwroot/blog.example.com。 - 其他选项按默认即可,点击 提交。
- 创建成功后,你会看到新站点已经在列表里。
将二级域名绑定到现有站点的子目录
如果你不想新建独立站点,希望二级域名直接访问主站下的某个文件夹(例如 /www/wwwroot/main/sub),可以这样操作:
- 在 网站 列表中找到主站点,点击右侧的 设置。
- 进入 子目录绑定 选项卡。
- 点击 添加子目录绑定。
- 域名 填二级域名全称,路径 选择对应的子目录。
- 保存即可。注意:这种方式下,二级域名会继承主站点的 PHP 版本和伪静态规则,如果子目录需要独立设置,用第一种方式更灵活。
第二步:配置 DNS 解析生效
宝塔面板添加完站点后,必须确保域名解析已经指向服务器 IP。
如果你之前已在域名管理后台设置了 A 记录,通常几分钟到一小时内生效。
可以用 ping 命令验证:在本地电脑打开终端(Win 下用 CMD,Mac/Linux 用 Terminal),输入 ping blog.example.com,看返回的 IP 是否与你服务器 IP 一致。
如果超时或返回错误,说明解析没生效或记录值写错了。
高频问题与避坑说明
- 添加站点后访问显示 502 Bad Gateway:最常见原因是 PHP 版本与站点程序不兼容或 PHP 服务未启动。可以在宝塔面板 软件商店 → 已安装 中重启对应 PHP 版本,或者改为其他 PHP 版本再试。
- 添加站点后访问显示 404 或 403:检查站点根目录下是否有默认首页文件(如 index.php、index.html)。如果目录为空,上传一个测试文件即可。另外检查站点设置里的 默认文档 是否包含这些文件名。
- SSL 证书怎么办?:如果主站已经部署了 SSL,且二级域名与主域名在同一级(都属于
*.example.com),可以申请通配符证书。在宝塔面板的 SSL 功能里,选择 Let's Encrypt,勾选通配符域名,输入*.example.com,按提示完成验证即可。如果 SSL 证书绑定的站点不同,需要单独部署。 - 子目录绑定方式下二级域名无法访问:确认子目录路径是否正确,并且该目录下有可访问的入口文件。同时检查主站点的 Nginx 或 Apache 配置中是否有冲突的规则,必要时可以清空伪静态再试。
效果验证
完成上述步骤后,在浏览器输入 http://blog.example.com(或你绑定的二级域名),如果能正常显示网页内容(或你上传的测试文件),说明绑定成功。
如果显示的是其他站点的内容,请检查是否有其他站点占用了该域名。
另外建议清理浏览器缓存或使用无痕模式重新测试,避免本地缓存干扰。
如果你正在处理宝塔面板网站二级域名绑定,建议先按本文步骤完整执行,再根据自己的环境做微调;
遇到异常时优先回看避坑和高频问题部分。
按照这个流程操作,一般几分钟内就能顺利上线你的二级域名站点。