跳转至

反向代理与 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。

排查命令

# 查看站点实际生效的反代配置
cat /opt/1panel/www/conf.d/halo.localhost.conf

# 测试 nginx 配置是否正确(在容器内)
docker exec 1Panel-openresty-2ex7 nginx -t

# 重载配置
docker exec 1Panel-openresty-2ex7 nginx -s reload