香港服务器部署OpenResty时,如何配置反向代理并验证上游服务?

发布人:A5数据发布时间:2026-11-10 11:44阅读量:55

本文以一台运行 Ubuntu 22.04、已分配公网 IP 的香港服务器为例,演示首次安装 OpenResty,并将 HTTP 请求转发到一台可访问的上游应用服务器。香港机房的位置不会改变反向代理的配置方式;实际需要确认的是系统版本、域名解析、防火墙规则,以及 OpenResty 到上游服务的网络连通性。

示例中,OpenResty 监听服务器的 80 端口,上游应用监听 10.0.1.20:8080。请将 IP、域名和端口替换为自己的环境值。文中命令和终端输出用于说明操作与判断方法,不代表在某台实际服务器上的执行记录。

一、准备条件

开始前确认以下条件:

  • 拥有服务器的 SSH 登录权限,并能使用 sudo。
  • 系统为 Ubuntu 22.04。其他发行版或版本的仓库地址、包名和服务配置路径可能不同,不要直接套用本文命令。
  • 域名的 A 记录已指向香港服务器公网 IP。若暂时没有域名,可先用服务器 IP 测试。
  • 上游应用已启动,并且服务器能访问其监听地址。若上游在同一台机器,可改用 127.0.0.1:8080;若在另一台内网机器,应使用该机器可路由的内网地址。
  • 入站规则允许客户端访问 TCP 80;上游主机的防火墙允许来自 OpenResty 服务器的 TCP 8080。不要为了测试而无差别开放所有端口。

先检查系统版本、服务器地址和上游连通性:

cat /etc/os-release
ip -brief address
curl -i --max-time 5 http://10.0.1.20:8080/

上游检查的预期结果是收到 HTTP 响应,例如 HTTP/1.1 200 OK。应用返回 401、404 等状态码,也说明网络连接和 HTTP 服务可能已建立,但还需根据应用的认证或路由要求判断是否符合预期。若出现连接超时或拒绝连接,先检查上游进程监听地址、端口及两端防火墙,不要先把问题归因于 OpenResty。

二、安装 OpenResty

以下操作使用 OpenResty 软件仓库。先安装下载、证书和密钥处理工具,再导入仓库签名密钥:

sudo apt-get update
sudo apt-get install -y ca-certificates curl gnupg

sudo install -d -m 0755 /usr/share/keyrings
curl -fsSL https://openresty.org/package/pubkey.gpg \
  | sudo gpg --dearmor -o /usr/share/keyrings/openresty.gpg

将 Ubuntu 代号写入软件源配置。该示例适用于 Ubuntu 22.04 的 jammy:

echo "deb [signed-by=/usr/share/keyrings/openresty.gpg] https://openresty.org/package/ubuntu jammy main" \
  | sudo tee /etc/apt/sources.list.d/openresty.list

更新包索引并安装:

sudo apt-get update
sudo apt-get install -y openresty

确认程序版本和 systemd 服务:

openresty -v
systemctl status openresty --no-pager

如果 apt-get update 提示仓库没有对应发行版,先核对 /etc/os-release 中的版本和代号,并确认 OpenResty 仓库支持该版本。不要把 jammy 机械替换成任意系统代号;不确定时,按 OpenResty 官方安装说明选择适配的软件源。若安装命令提示找不到 openresty 包,也应先检查软件源文件、密钥导入和包索引更新是否成功。

三、配置反向代理

先确认 OpenResty 使用的配置文件路径和主配置是否包含站点配置目录:

sudo openresty -V 2>&1 | grep -E 'conf-path|prefix'
sudo grep -nE 'include|listen|server_name' /etc/openresty/nginx.conf

Ubuntu 软件包安装通常使用 /etc/openresty/nginx.conf,但应以服务器上的命令输出为准。若主配置中已有类似 include /etc/openresty/conf.d/*.conf; 的配置,可以在该目录创建独立站点文件;若没有,不要直接假设目录会自动加载,需要先根据主配置确认正确的 include 位置。

以下示例假设主配置已包含 /etc/openresty/conf.d/*.conf,且域名为 app.example.com。用编辑器创建文件:

sudo install -d -m 0755 /etc/openresty/conf.d
sudo nano /etc/openresty/conf.d/app.conf

写入配置:

三、配置反向代理配图

upstream app_backend {
    server 10.0.1.20:8080;
    keepalive 16;
}

server {
    listen 80;
    server_name app.example.com;

    location / {
        proxy_pass http://app_backend;
        proxy_http_version 1.1;

        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        proxy_connect_timeout 5s;
        proxy_read_timeout 60s;
    }
}

这里的 upstream 定义后端服务地址;proxy_pass 将匹配到的请求转发给该组。Host、X-Real-IP 和 X-Forwarded-For 用于向应用传递请求域名及客户端地址信息。应用若使用这些转发头,应配置为只信任来自 OpenResty 的请求,不能无条件把客户端自行提交的转发头当作可信地址。

示例中的 proxy_pass http://app_backend; 不带 URI 部分,因此会按常见的反向代理方式保留原请求路径。例如客户端访问 /api/items,上游收到的路径通常仍为 /api/items。若配置成带 URI 的形式,路径替换规则可能不同;部署前应结合应用路由核对,避免请求路径被意外改写。

如果上游在本机,可将 server 行改为:

server 127.0.0.1:8080;

若上游通过域名访问,还需要考虑 DNS 解析与地址变化。不要把域名解析结果未核实地当作固定内网地址;先在服务器上用 getent hosts 上游域名 检查解析结果,并确认 OpenResty 能连接解析出的地址。

检查配置并启动服务

修改配置后,先运行语法检查,再启动或重载服务:

sudo openresty -t

成功时通常会看到类似以下提示:

syntax is ok
test is successful

如果检查失败,输出会指出配置文件和行号。修正问题后重新执行检查,不要在配置测试未通过时重载服务。

首次启动可执行:

sudo systemctl enable --now openresty
sudo systemctl status openresty --no-pager

若服务此前已经运行,配置检查通过后再重载:

sudo systemctl reload openresty
sudo systemctl status openresty --no-pager

检查监听端口:

sudo ss -lntp | grep ':80'

预期能看到 OpenResty 对应进程监听 TCP 80。若没有监听,查看服务日志:

OpenResty反向代理部署需要稳定的服务器资源承载入口服务与上游应用。A5idc数据提供香港物理服务器,涵盖Xeon Gold和AMD EPYC等平台,并有SSD或NVMe存储及CN2、国际带宽等不同配置方向,可用于企业网站、业务后台和接口服务部署。面向不同地区的业务,也提供美国、日本、韩国、中国台湾、新加坡及马来西亚等地的服务器资源,为多地区业务系统安排部署提供硬件与网络选择。

sudo journalctl -u openresty -n 50 --no-pager

四、逐层验证请求链路

建议按“上游本身、OpenResty 本机、外部客户端”的顺序验证。这样可以区分应用、代理配置和公网访问问题。

四、逐层验证请求链路配图

1. 再次检查上游响应

从 OpenResty 服务器直接请求上游:

curl -i --max-time 5 http://10.0.1.20:8080/

只有这一步能稳定建立连接,才适合继续验证代理。如果上游按路径提供服务,可改为测试实际路径,例如 /health。判断时记录响应状态码及应用返回内容;状态码正确与否取决于应用设计,不宜把所有非 200 响应都认定为网络故障。

2. 在服务器本机检查虚拟主机匹配

如果域名尚未完成公网解析,或 DNS 仍指向旧地址,可通过 Host 请求头直接验证本机配置:

curl -i -H 'Host: app.example.com' http://127.0.0.1/

此请求应进入 server_name app.example.com 对应的服务块,并由 OpenResty 转发到上游。若上游有专门的健康检查路径,可相应请求:

curl -i -H 'Host: app.example.com' http://127.0.0.1/health

成功标准不一定是固定状态码,而是与应用对该路径的预期一致,并且响应内容来自目标服务。若响应为 OpenResty 默认页面,通常要检查 server_name 是否匹配、站点文件是否被主配置加载,以及是否存在其他默认服务块抢先匹配。

3. 从外部验证域名和公网入口

确认域名解析指向这台服务器后,从外部网络访问:

curl -i --max-time 10 http://app.example.com/

若 DNS 尚未生效,可在客户端使用 curl --resolve 临时指定目标 IP,而不修改 DNS:

curl -i --resolve app.example.com:80:203.0.113.10 \
  http://app.example.com/

其中 203.0.113.10 是示例地址,需替换为服务器公网 IP。外部访问失败而本机访问成功时,优先检查云平台安全组、服务器防火墙、域名解析和公网路由;本机代理也失败时,则继续检查 OpenResty 配置与上游连接。

五、常见失败及判断方法

现象常见原因优先检查
openresty -t 报语法错误缺少分号、括号不匹配、指令位置不合法按报错文件和行号检查配置,再重新运行 openresty -t
本机请求返回 502 Bad GatewayOpenResty 无法连接上游,或上游未正常响应在服务器上执行上游 curl;核对 IP、端口、路由和防火墙
本机返回默认页面站点配置未加载、域名不匹配,或请求进入其他服务块检查主配置的 include、server_name 和监听配置
外部超时,本机正常公网入口未放通、DNS 指向错误或网络路径异常分别核对域名解析、云安全组和服务器防火墙
返回 404 或应用错误页请求已到达某个 HTTP 服务,但路径、域名或应用路由可能不匹配对比直连上游和经过代理的响应,并核对应用所需的 Host 与路径
修改后仍表现为旧配置重载未成功、改错配置文件,或请求命中了其他服务块检查配置测试、服务日志及主配置实际加载的文件

出现 502 时,可以查看 OpenResty 错误日志。日志位置应以主配置中的 error_log 指令为准;常见安装位置之一是 /usr/local/openresty/nginx/logs/error.log,不要在未经核实的情况下假设路径固定:

五、常见失败及判断方法配图

sudo grep -n 'error_log' /etc/openresty/nginx.conf

确定路径后读取近期记录。例如:

sudo tail -n 50 /实际日志路径/error.log

日志中的 connect() failed、connection refused 通常指向地址、端口或监听问题;timed out 则应检查网络路径、防火墙和上游负载。若上游应用需要较长时间处理请求,再根据业务时延评估 proxy_read_timeout,不要仅为消除报错而无限增大超时时间。

六、结果检查与回滚

验收时至少确认以下事项:

  • openresty -v 能输出版本信息,systemctl status openresty 显示服务正常。
  • openresty -t 检查通过,且端口 80 正由 OpenResty 监听。
  • 从服务器直连上游可以得到符合应用预期的响应。
  • 本机带 Host 的请求能进入目标站点配置;外部请求也能到达同一应用。
  • OpenResty 日志中没有持续出现连接上游失败或配置加载错误。

若新配置导致异常,先恢复配置文件,不需要删除软件包。可以将文件移出自动加载目录,再检查并重载:

sudo mv /etc/openresty/conf.d/app.conf /etc/openresty/conf.d/app.conf.disabled
sudo openresty -t
sudo systemctl reload openresty

执行前确认文件路径与主配置的 include 规则一致;若此前已备份旧配置,应优先恢复备份。重载成功后,用本机请求确认旧站点行为已恢复。若 openresty -t 仍失败,不要继续重载,先检查错误是否来自其他配置文件。

如果需要撤销本次安装,可先确认没有其他站点或业务依赖该服务,再停止并禁用服务;卸载软件包前备份站点配置和相关日志,并评估对现有业务的影响。单纯回滚反向代理配置时,保留已安装的软件包通常更便于恢复服务。

最终核对:上游地址和端口正确、站点配置已被加载、语法测试通过、本机与外部请求均符合预期;回滚时确认配置已移出加载范围、服务重载成功且旧业务不受影响。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/8597.html

相关推荐