反向代理与 1Panel¶
本文记录在本服务器(1Panel 管理的 openresty + Halo)上如何新增一个与既有服务共存的子站点反代。
服务器架构现状¶
本机为 1Panel 面板管理,核心服务跑在 Docker:
| 容器 | 作用 | 端口 |
|---|---|---|
| 1Panel-openresty | 反向代理/Web 入口 | 80 |
| 1Panel-halo-lGUB | Halo 博客 | 127.0.0.1:8080 |
| 1Panel-mysql | MySQL 8.2 | 127.0.0.1:3306 |
入口 openresty 通过 conf 反代到各后端:80 端口默认 server_name 把所有流量指向 Halo(proxy_pass http://127.0.0.1:8080)。
关键文件位置¶
- 站点 nginx 配置(1Panel 生成):
/opt/1panel/www/sites/halo.localhost/ - 反代 conf:
/opt/1panel/www/conf.d/halo.localhost.conf - openresty 容器把宿主
/opt/1panel/www/conf.d挂载到容器/usr/local/openresty/nginx/conf/conf.d
如何新增一个子站点(与 Halo 共存)¶
方案 A:子路径(如 /wiki)¶
在主站 conf 的 location / 之前新增 location,让 /wiki 与 /wiki/api 分别指向不同后端:
location ^~ /wiki/ {
alias /www/sites/halo.localhost/index/wiki-site/;
index index.html;
try_files $uri $uri/ /wiki-site/index.html;
}
location ^~ /wiki/api/ {
proxy_pass http://127.0.0.1:8001/;
proxy_set_header Host $host;
}
方案 B:独立子域名(如 wiki.xiaoanger.com)¶
在 1Panel 中新建一个"网站",反向代理到 127.0.0.1:8001,配好 DNS 解析即可。此方案更清爽,推荐长期使用。
注意¶
- openresty 容器通过宿主目录挂载读 conf,改完宿主文件需 reload openresty 使配置生效(1Panel 内重启 openresty 容器或执行 nginx -s reload)。
- 修改前先备份原 conf,避免破坏 Halo 访问。
- 静态资源(文档站 site 目录)直接由 nginx 提供;动态 API(RAG)才走 proxy_pass。