目录
宝塔面板反向代理配置指南：隐藏子域名路径，保持主域名显示
宝塔面板反向代理配置指南：隐藏子域名路径，保持主域名显示
——如何实现 http://juece.jilian.co/docs 访问但显示 docs.juece.jilian.co 内容，且地址栏不变
摘要
在网站开发中，有时需要将内容托管在子域名（如 docs.juece.jilian.co），但希望用户通过主域名的路径（如 http://juece.jilian.co/docs）访问，且浏览器地址栏始终显示主域名路径。本文将介绍如何通过 宝塔面板的反向代理功能 实现这一需求，并解决常见问题（如 502 错误、路径重写等）。
一、需求场景
目标：访问 http://juece.jilian.co/docs 时，实际展示 docs.juece.jilian.co 的内容。
要求：浏览器地址栏 不跳转，始终显示 http://juece.jilian.co/docs。
适用场景：
隐藏子域名，统一品牌入口。
将不同服务（如文档、API）聚合到主域名下。
避免搜索引擎将子域名和主域名内容视为重复。
二、配置步骤
- 域名解析准备
确保主域名 juece.jilian.co 和子域名 docs.juece.jilian.co 已正确解析到服务器 IP：
bash
验证解析（在本地命令行执行）
ping juece.jilian.co
ping docs.juece.jilian.co
如果 docs.juece.jilian.co 和主域名在同一服务器，可跳过子域名解析（直接通过路径代理）。
- 在宝塔面板中添加主域名网站
登录宝塔面板，进入 网站 > 添加站点。
填写以下信息：
域名：juece.jilian.co
根目录：可选（反向代理无需本地文件）
PHP 版本：选择 “纯静态” 或 “不启用”
点击 提交 完成创建。 - 配置反向代理规则
进入 juece.jilian.co 的 设置 > 反向代理。
点击 添加反向代理，填写以下关键配置：
目标 URL：
如果 docs.juece.jilian.co 是独立服务：
http://docs.juece.jilian.co
如果与主域名同服务器：
http://127.0.0.1/docs # 或实际路径
代理路径：/docs（匹配用户访问路径）
发送域名：勾选（确保请求头 Host 为 docs.juece.jilian.co）
高级设置（可选）：
重写路径：解决路径嵌套问题（见下文示例）。
关键配置：路径重写
如果目标服务器的根路径就是 /docs 内容（如 docs.juece.jilian.co 直接对应 /docs），需添加重写规则：
正则表达式：^/docs/(.*)
替换为：/$1
作用：将 http://juece.jilian.co/docs/api 代理为 http://docs.juece.jilian.co/api。
保存配置并重启网站服务。 - 验证配置
访问 http://juece.jilian.co/docs，检查内容是否来自 docs.juece.jilian.co。
按 F12 打开开发者工具，确认：
请求的 Host 头为 docs.juece.jilian.co。
地址栏未跳转，始终显示 http://juece.jilian.co/docs。
三、常见问题解决 - 502 Bad Gateway 错误
原因：目标服务器不可达或响应超时。
解决：
检查 docs.juece.jilian.co 是否正常运行（如 curl http://docs.juece.jilian.co）。
在宝塔面板中调整反向代理的 超时时间（如改为 30s）。 - 内容未更新（缓存问题）
解决：
清除浏览器缓存或使用无痕模式访问。
在宝塔面板中禁用反向代理缓存（将缓存时间设为 0）。 - 路径错误（如 404）
原因：重写路径规则不匹配。
解决：
检查正则表达式是否正确（如 ^/docs/(.) → /$1）。
如果目标路径不同，调整替换规则（如 ^/docs/(.) → /target-path/$1）。
四、SEO 优化建议
如果两个域名内容完全相同，建议通过以下方式避免搜索引擎惩罚：
在 docs.juece.jilian.co 的页面头部添加：
html
在宝塔面板中配置 HTTPS（强制跳转 https://），提升安全性。
五、总结
通过宝塔面板的反向代理功能，可以轻松实现：
✅ 主域名路径访问子域名内容（如 http://juece.jilian.co/docs → docs.juece.jilian.co）。
✅ 保持地址栏路径不变，提升用户体验。
✅ 灵活处理路径重写，适配不同服务结构。
适用场景：
隐藏技术细节（如子域名托管）。
统一多服务入口（如文档、API、博客聚合）。
避免重复内容影响 SEO。
文章结束
