VPN环境下Matrix-Synapse的Nginx反向代理配置异常排查

API 探路者

2026-6-14

问题排查与解决

核心原因

你的Nginx配置仅对/_matrix和/_synapse/client开头的请求做反向代理转发，而/health路径不在匹配规则内，因此Nginx找不到对应的处理逻辑，返回404错误；访问根路径/时，由于没有配置对应的location规则，Nginx会返回默认的欢迎页面。

解决步骤

修改Nginx的location匹配规则
在现有location块中加入/health路径的匹配，修改后的规则如下：

location ~ ^(/health|/_matrix|/_synapse/client) {
    proxy_pass http://10.8.0.3:8008;
    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;

    client_max_body_size 50M;
    proxy_http_version 1.1;
}

验证配置并重启Nginx
先检查配置合法性：
```
sudo nginx -t
```
若配置无报错，重启Nginx生效：
```
sudo systemctl restart nginx
```
网络连通性验证（可选）
在EC2服务器上执行curl http://10.8.0.3:8008/health，若返回OK则说明VPN内网连通正常；若不通，需检查OpenVPN路由配置或树莓派防火墙规则。