香港服务器部署OpenResty时,如何配置反向代理并验证上游服务?
本文以一台运行 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 Gateway | OpenResty 无法连接上游,或上游未正常响应 | 在服务器上执行上游 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



