一、问题背景:FRP 已连接,为什么 Halo 博客还是无法通过域名访问?
之前通过 FRP 内网穿透,将部署在内网服务器上的 Halo 博客映射到海外 Vultr VPS,实现了通过公网域名访问个人博客。
原有架构运行正常,但在一次服务器更新之后,突然发现 Halo 博客无法通过域名正常访问。
最初怀疑是 FRP 服务异常,或者 Halo 更新之后导致服务出现问题。
但是经过逐步排查,发现了一个容易被忽略的问题:
FRP 内网穿透虽然已经正常建立,但 VPS 缺少 Nginx 反向代理服务,公网 HTTP/HTTPS 请求没有正确转发到 Halo。
也就是说,FRP TCP 转发正常,并不代表通过域名就一定能够访问博客。
本文以实际部署环境为例,完整记录从故障排查、问题定位到 Nginx 配置、HTTPS 证书申请的全过程。
如果你也遇到了以下问题,这篇文章可以作为排查参考:
FRP 服务端 frps 显示运行正常。
FRP 客户端 frpc 已经成功连接。
域名可以解析到 VPS 公网 IP,但浏览器无法打开。
DNSPod 提示 80、443 端口无法连通。
VPS 上 7007、8091 等端口正常,但 80、443 没有服务监听。
Halo 后端可以通过 IP 和端口访问,但无法通过域名访问。
本文最终采用的解决方案是:
DNSPod + Vultr VPS + Nginx + FRP + Halo。
保留原有 FRP TCP 转发配置,在 VPS 上安装 Nginx,通过反向代理将公网 HTTP/HTTPS 请求转发到内网 Halo 服务。
二、部署环境及原有网络架构
在开始排查之前,先介绍本次实际使用的服务器环境。
2.1 服务器环境
2.2 原有 FRP 客户端配置
内网服务器上的 FRP 客户端负责将本地 Halo 服务映射到公网 VPS。
原有配置如下:
[blog_tcp]
type = "tcp"
local_ip = "127.0.0.1"
local_port = 8091
remote_port = 8091其中:
type = "tcp":使用 TCP 类型代理。local_ip = "127.0.0.1":内网 Halo 服务地址。local_port = 8091:Halo 本地服务端口。remote_port = 8091:VPS 上映射出来的远程端口。
2.3 FRP 服务端配置
Vultr VPS 上的 FRP 服务端配置如下:
[common]
bind_port = 7007
vhost_http_port = 8087其中:
需要特别注意:
这里使用的是 FRP TCP 类型代理,而不是 FRP 原生 HTTP 域名代理。
因此,FRP 不会自动将公网 80、443 端口转发到 Halo。
2.4 原有网络架构
原来的访问链路如下:
公网浏览器
|
| 访问 xyzrpy.com
|
v
Vultr VPS
|
| TCP 8091
|
v
frps
|
| FRP TCP 转发
|
v
frpc
|
| 127.0.0.1:8091
|
v
Halo 博客从架构上看,FRP 已经建立了内网服务器与公网 VPS 之间的 TCP 转发通道。
但是,公网浏览器通常通过以下标准端口访问网站:
HTTP:80
HTTPS:443
原有架构没有配置 Nginx 或其他 Web 服务器来接收这些标准 HTTP/HTTPS 请求。
这就是后续需要解决的核心问题。
三、故障排查:FRP 正常,为什么域名依然无法访问?
排查网络问题时,不建议一开始就修改 FRP 配置。
更合理的方法是按照以下顺序逐层检查:
检查 FRP 服务端。
检查端口监听状态。
检查域名 DNS 解析。
检查服务器防火墙。
检查 FRP 到 Halo 的 TCP 转发。
检查 Nginx 是否存在。
通过这种方式,可以逐步缩小故障范围。
3.1 检查 FRP 服务端 frps
首先登录 Vultr VPS,检查 FRP 服务端运行状态:
systemctl status frps正常情况下,可以看到:
● frps.service - FRP Server Service
Loaded: loaded (/etc/systemd/system/frps.service; enabled)
Active: active (running)其中:
Active: active (running)表示 FRP 服务端正在运行。
接下来查看 FRP 启动日志:
journalctl -u frps -n 100 --no-pager正常情况下,可以看到类似信息:
frps tcp listen on 0.0.0.0:7007
http service listen on 0.0.0.0:8087
frps started successfully说明:
FRP TCP 通信端口已经启动。
FRP HTTP 虚拟主机端口已经启动。
FRP 服务端没有明显的启动异常。
排查结论:FRP 服务端运行正常,暂时不需要修改 frps 配置。
3.2 检查 VPS 端口监听状态
服务正常运行,不代表所有需要使用的端口都已经正确监听。
执行:
ss -lntp | grep frps也可以一次性检查所有相关端口:
ss -lntp | grep -E ':7007|:8087|:8091|:80|:443'本次排查发现:
这个结果非常关键。
FRP 使用的端口已经正常启动,但是公网 Web 服务所需要的 80 和 443 端口没有任何服务监听。
说明问题可能不在 FRP,而在 VPS 的 Web 服务入口。
3.3 检查域名 DNS 解析
接下来检查域名是否正确解析到了 Vultr VPS。
首先安装 DNS 查询工具:
apt update
apt install -y dnsutils执行:
dig +short xyzrpy.com本次查询结果:
167.179.99.196与 Vultr VPS 公网 IP 一致。
说明 DNS A 记录正常。
如果查询结果不正确,需要检查 DNSPod 中的解析记录。
建议配置:
如果没有使用 IPv6,还应检查是否存在错误或过期的 AAAA 记录。
注意:
如果域名使用了 CDN 或 DNS 代理,查询到的 IP 可能不是 VPS 的真实公网 IP,需要根据实际网络架构判断。
排查结论:本次故障不是 DNS A 记录解析错误导致的。
3.4 检查 Ubuntu 防火墙
接下来检查 VPS 防火墙状态:
ufw status numbered如果需要开放对应端口,可以执行:
ufw allow 7007/tcp
ufw allow 80/tcp
ufw allow 443/tcp根据实际 FRP 配置和访问需求,再决定是否开放 8091、8087 端口。
如果通过 SSH 远程管理 VPS,启用 UFW 前应先确认 SSH 端口已经放行,例如:
ufw allow 22/tcp重新加载防火墙:
ufw reload此外,如果 Vultr 控制台启用了 Cloud Firewall,也需要检查相应的入站规则。
这里有一个容易混淆的地方:
防火墙放行端口,不代表端口上已经有程序监听。
例如,即使已经执行:
ufw allow 80/tcp如果 VPS 没有安装 Nginx,80 端口仍然不会自动提供 HTTP 服务。
因此,必须结合下面的命令一起检查:
ss -lntp3.5 检查 FRP 到 Halo 的 TCP 转发
这是本次故障排查中非常重要的一步。
首先在 Vultr VPS 上执行:
curl -I http://127.0.0.1:8091本次返回:
HTTP/1.1 404 Not Found
Content-Type: application/problem+json随后,在内网服务器上执行相同测试。
由于内网机器配置了 HTTP 代理环境变量,第一次测试实际上经过了本地代理端口 1095,而不是直接访问 Halo。
因此,需要明确绕过 HTTP 代理:
curl --noproxy '*' -I http://127.0.0.1:8091/内网和 VPS 均返回:
HTTP/1.1 404 Not Found
Content-Type: application/problem+json两边返回结果一致,说明 VPS 的 8091 端口能够通过 FRP 到达内网服务。
这里需要说明:
curl -I 使用的是 HEAD 请求,返回 404 并不能单独证明 Halo 首页不可用。
建议进一步使用 GET 请求检查:
curl --noproxy '*' -v http://127.0.0.1:8091/也可以查看响应内容:
curl --noproxy '*' -sS http://127.0.0.1:8091/ | head排查结论:FRP TCP 转发链路已经能够到达内网 Halo 服务,问题需要继续向公网 Web 入口方向排查。
3.6 检查 VPS 是否安装 Nginx
接下来检查 Nginx 服务。
执行:
systemctl status nginx --no-pager本次返回:
Unit nginx.service could not be found.说明系统中不存在 Nginx 服务。
进一步检查 Nginx 配置目录:
ls -l /etc/nginx/sites-enabled/返回:
No such file or directory至此,故障原因已经基本明确。
VPS 没有安装 Nginx,也没有配置公网 HTTP 反向代理,因此公网 80、443 端口没有正确的 Web 服务入口。
原来的 FRP TCP 转发虽然正常,但公网浏览器无法通过标准 HTTP/HTTPS 入口访问 Halo。
四、解决方案:VPS 安装 Nginx 并配置 Halo 反向代理
明确故障原因之后,解决方案就比较简单了。
不需要修改原有 FRP TCP 转发架构,只需要在 Vultr VPS 上安装 Nginx,并将公网 HTTP 请求转发到 FRP 映射的 8091 端口。
4.1 修复后的网络架构
公网浏览器
|
| http://xyzrpy.com
|
v
Vultr VPS
|
| TCP 80
|
v
Nginx 反向代理
|
| http://127.0.0.1:8091
|
v
frps
|
| FRP TCP 8091
|
v
frpc
|
| 127.0.0.1:8091
|
v
Halo 博客这里需要理解两个关键点:
FRP 负责将内网 Halo 服务映射到 VPS。
Nginx 负责接收公网 HTTP/HTTPS 请求,并将请求转发到 FRP 映射端口。
两者配合,才能完成从公网域名到内网博客的完整访问链路。
4.2 安装 Nginx
登录 Vultr VPS,执行:
apt update
apt install -y nginx检查安装版本:
nginx -v查看服务运行状态:
systemctl status nginx设置开机自启动:
systemctl enable nginx启动 Nginx:
systemctl start nginx安装完成后,在浏览器中访问:
http://167.179.99.196如果出现:
Welcome to nginx!说明 Nginx 已经成功安装并运行。
4.3 创建 Halo 反向代理配置文件
接下来创建 Halo 专用的 Nginx 配置文件:
nano /etc/nginx/sites-available/halo写入以下配置:
server {
listen 80;
listen [::]:80;
server_name xyzrpy.com www.xyzrpy.com;
location / {
proxy_pass http://127.0.0.1:8091;
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_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_read_timeout 300s;
proxy_send_timeout 300s;
}
}保存退出。
4.4 Nginx 反向代理配置详解
上面的配置是整个修复过程最核心的部分。
下面逐项解释。
其中最重要的是:
proxy_pass http://127.0.0.1:8091;这行配置决定了 Nginx 将请求转发到哪里。
这里的 8091 对应原来 FRP TCP 代理的 remote_port。
也就是说:
公网浏览器
|
v
Nginx:80
|
v
127.0.0.1:8091
|
v
FRP TCP 转发
|
v
内网 Halo:8091因此,不需要修改原有 frpc 和 frps 的 TCP 转发配置。
4.5 启用 Halo 站点配置
创建配置文件之后,需要将其链接到 Nginx 已启用的站点目录。
执行:
ln -s /etc/nginx/sites-available/halo /etc/nginx/sites-enabled/halo如果当前 VPS 没有运行其他网站,可以禁用 Nginx 默认欢迎页:
rm /etc/nginx/sites-enabled/default注意:
如果 VPS 上还有其他网站,不要删除其他站点配置,只需要确保 Halo 域名能够正确匹配对应的 server 配置。
查看当前启用的站点:
ls -l /etc/nginx/sites-enabled/4.6 检查 Nginx 配置是否正确
在正式重启之前,先检查配置语法:
nginx -t正常情况下会显示:
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful如果没有错误,执行:
systemctl enable nginx
systemctl restart nginx检查运行状态:
systemctl status nginx至此,Nginx 反向代理已经基本配置完成。
4.7 测试 HTTP 反向代理是否生效
首先检查 Nginx 是否监听 80 端口:
ss -lntp | grep ':80'然后在 VPS 本机执行:
curl -I -H "Host: www.xyzrpy.com" http://127.0.0.1/也可以查看完整请求和响应:
curl -v -H "Host: www.xyzrpy.com" http://127.0.0.1/这里通过 Host 请求头模拟浏览器访问指定域名。
如果能够返回 Halo 对应的 HTTP 响应,而不是 Nginx 默认欢迎页,说明反向代理已经生效。
最后在浏览器中访问:
http://xyzrpy.com或者:
http://www.xyzrpy.com如果博客能够正常打开,说明 HTTP 访问已经恢复。
五、配置 HTTPS:使用 Let's Encrypt 免费 SSL 证书
完成 HTTP 访问之后,建议进一步配置 HTTPS。
HTTPS 不仅可以加密浏览器与服务器之间的通信,还可以避免浏览器出现不安全提示。
这里使用 Let's Encrypt 免费 SSL 证书,通过 Certbot 自动完成证书申请和 Nginx 配置。
5.1 安装 Certbot
在 Vultr VPS 上执行:
apt update
apt install -y certbot python3-certbot-nginxCertbot 是 Let's Encrypt 官方生态中常用的证书申请和管理工具。
其中:
certbot:负责申请和管理 SSL 证书。python3-certbot-nginx:提供 Nginx 配置集成能力。
5.2 申请 HTTPS 证书
执行:
certbot --nginx -d xyzrpy.com -d www.xyzrpy.com根据提示完成邮箱、服务协议等设置。
Certbot 会自动申请证书,并尝试修改 Nginx 配置,增加 HTTPS 监听。
申请证书之前,需要确认以下条件:
域名 A 记录已经正确解析到 VPS。
VPS 公网 80 端口能够正常访问。
VPS 防火墙已经放行 80 和 443。
Vultr Cloud Firewall 已经放行 80 和 443。
域名没有被错误的 CDN 或代理规则拦截。
域名验证方式符合证书申请要求。
5.3 检查 HTTPS 配置
证书申请完成之后,先检查 Nginx 配置:
nginx -t然后重启 Nginx:
systemctl restart nginx检查监听端口:
ss -lntp | grep -E ':80|:443'正常情况下,应该能够看到 Nginx 同时监听 HTTP 和 HTTPS 端口。
测试 HTTPS:
curl -I https://www.xyzrpy.com如果能够正常返回 HTTP 响应,并且浏览器可以正常显示证书信息,说明 HTTPS 配置成功。
5.4 检查 SSL 证书自动续期
Let's Encrypt 证书具有有效期限,因此需要定期续期。
查看 Certbot 定时任务:
systemctl list-timers | grep certbot测试证书续期:
certbot renew --dry-run如果测试成功,说明自动续期机制基本正常。
建议定期检查续期任务,避免证书过期导致博客 HTTPS 访问异常。
六、Halo 站点地址配置:解决 HTTPS 跳转和主题资源异常
Nginx 反向代理和 HTTPS 配置完成之后,还有一个容易被忽略的地方:
Halo 自身的站点地址必须与实际使用的公网域名保持一致。
如果 Halo 后台仍然配置了旧域名或者 HTTP 地址,可能出现以下问题:
页面跳转到旧域名。
网站图片无法正常加载。
CSS 和 JavaScript 资源加载异常。
HTTP 和 HTTPS 地址混用。
博客首页正常,但文章页面或主题资源异常。
6.1 检查 Halo 站点地址
进入 Halo 后台:
系统设置 → 常规设置 → 站点地址建议设置为实际使用的 HTTPS 域名:
https://www.xyzrpy.com保存后重新访问博客,检查页面跳转是否正常。
6.2 检查主题资源地址
如果使用了 Joe3 等博客主题,还需要检查主题中的资源基础地址、图片地址和跳转地址。
本次排查过程中,发现页面源码中存在两个不同的地址:
blog_url: "http://www.xyzrpy.com"
BASE_URL: "https://bbchin.com"这类地址不一致,可能造成主题资源加载异常或页面跳转错误。
因此,需要根据实际使用的域名统一检查:
Halo 站点地址。
主题资源基础地址。
图片资源地址。
页面跳转地址。
HTTPS 协议设置。
不要只检查 Nginx 配置,还需要检查 Halo 和主题自身的地址设置。
七、完整故障排查命令汇总
为了方便后续维护,将本次使用的主要排查命令整理如下。
7.1 检查 Nginx
查看运行状态:
systemctl status nginx查看错误日志:
tail -f /var/log/nginx/error.log查看访问日志:
tail -f /var/log/nginx/access.log检查配置:
nginx -t7.2 检查 FRP
查看服务状态:
systemctl status frps查看实时日志:
journalctl -u frps -f查看最近日志:
journalctl -u frps -n 100 --no-pager7.3 检查网络端口
查看全部监听端口:
ss -lntp查看指定端口:
ss -lntp | grep -E ':7007|:8087|:8091|:80|:443'7.4 检查 Ubuntu 防火墙
ufw status numbered7.5 检查 DNS 解析
dig +short xyzrpy.com7.6 测试 Halo 后端
curl --noproxy '*' -v http://127.0.0.1:8091/7.7 测试 Nginx 域名转发
curl -I -H "Host: www.xyzrpy.com" http://127.0.0.1/7.8 测试 HTTPS
curl -I https://www.xyzrpy.com八、FRP + Nginx + Halo 常见故障及解决方法
在实际部署和维护过程中,可能遇到以下问题。
8.1 遇到 502 Bad Gateway 怎么办?
502 通常表示 Nginx 无法正常从后端获取响应。
重点检查:
curl -v http://127.0.0.1:8091/如果无法连接,需要检查:
Halo 是否正常运行。
frpc 是否正常连接。
frps 是否正常运行。
FRP TCP 映射端口是否正确。
Nginx proxy_pass 是否配置正确。
同时查看 Nginx 错误日志:
tail -n 100 /var/log/nginx/error.log8.2 遇到 404 Not Found 怎么办?
404 不一定意味着服务器故障。
可能是:
Halo 返回了正常的应用路由错误。
请求路径不存在。
Host 请求头不匹配。
后端服务没有正确处理请求。
建议同时使用 GET 请求、检查响应内容和后端日志,不要仅凭 curl -I 的结果判断服务是否正常。
8.3 遇到 HTTPS 证书错误怎么办?
首先检查证书:
certbot certificates检查 Nginx:
nginx -t检查 HTTPS 端口:
ss -lntp | grep ':443'最后检查浏览器访问的域名是否与证书中的域名一致。
九、最终网络架构及各组件职责
经过本次故障修复,最终网络架构如下:
公网浏览器
|
|
xyzrpy.com 域名
|
v
Vultr VPS 公网服务器
167.179.99.196
|
+--------+--------+
| |
v v
HTTP 80 HTTPS 443
| |
+--------+--------+
|
v
Nginx 反向代理
|
|
http://127.0.0.1:8091
|
v
frps
|
TCP 8091
|
v
frpc
|
127.0.0.1:8091
|
v
Halo 博客各组件的职责:
整个架构中,每个组件负责不同的任务:
DNSPod 解决域名指向问题。
Vultr VPS 提供公网入口。
Nginx 负责 HTTP/HTTPS 请求处理。
FRP 负责内网穿透和 TCP 数据转发。
Halo 负责实际的博客业务。
这也是为什么 FRP 连接正常,并不意味着公网域名一定能够访问。
十、安全优化建议
完成网站访问恢复之后,还建议对 VPS 和 FRP 端口进行适当的安全检查。
10.1 不要无条件开放所有端口
本次排查涉及 7007、8087、8091、80 和 443 等端口。
但是,排查时需要使用的端口,不一定都需要长期对公网开放。
如果 Nginx 和 frps 在同一台 VPS 上运行,Nginx 可以通过本机地址访问 8091。
因此,建议根据实际需求配置防火墙:
注意:具体规则应结合 FRP 监听地址、云防火墙和实际部署方式设置,避免误封正常业务。
10.2 定期检查 FRP 和 Nginx 服务
建议定期检查以下服务:
systemctl status frps
systemctl status nginx查看端口:
ss -lntp查看 Nginx 日志:
tail -f /var/log/nginx/error.log查看 FRP 日志:
journalctl -u frps -f10.3 定期检查 HTTPS 证书
执行:
certbot renew --dry-run确认自动续期机制能够正常工作。
十一、总结:FRP 内网穿透成功后,为什么还需要 Nginx?
本次 Halo 博客无法通过域名访问,最初容易误判为 FRP 服务异常或者 Halo 更新导致的问题。
经过逐步排查,最终确认:
DNS A 记录正常,域名已经解析到 Vultr VPS。
frps 服务正常运行。
frpc 已成功连接 frps。
Halo 的 TCP 8091 转发链路有响应。
VPS 缺少 Nginx 服务,公网 80/443 没有正确的 Web 入口。
安装 Nginx 并配置反向代理后,恢复了域名访问。
进一步配置 Let's Encrypt SSL 证书,实现 HTTPS 访问。
本次故障的核心解决方案:保留原有 FRP TCP 转发配置,在 VPS 上安装 Nginx,将公网 80/443 请求反向代理到 127.0.0.1:8091。
这套方案有几个优点:
不需要改变内网 Halo 的部署方式。
不需要修改原有 FRP TCP 转发架构。
可以通过 Nginx 统一处理公网 HTTP/HTTPS 请求。
可以通过 Let's Encrypt 配置免费 SSL 证书。
可以在同一台 VPS 上通过不同域名部署多个内网 Web 服务。
不会影响其他已经正常运行的 FRP TCP 代理服务。
对于使用 FRP 将内网博客映射到海外 VPS 的场景,推荐采用:
DNSPod + Vultr VPS + Nginx + FRP + Halo。
需要记住一个关键原则:
FRP 解决的是内网穿透和端口转发问题,Nginx 解决的是公网 HTTP/HTTPS 请求入口和反向代理问题。两者配合,才能构建完整的内网博客公网访问架构。
十二、参考资料
文章关键词: FRP 内网穿透、Nginx 反向代理、Halo 博客部署、Halo 外网访问、FRP TCP 转发、Vultr VPS、Ubuntu Nginx 配置、Let's Encrypt SSL 证书。
评论区