怎么在Nginx Proxy Manager中反代phpMyAdmin_可视化网关配置-phpMyAdmin-PHP中文网

根本原因是phpMyAdmin用$_SERVER['HTTP_HOST']构造URL，而NPM未透传Host头或未改写响应头，导致跳转至localhost；需配置proxy_set_header、PMA_ABSOLUTE_URI、PmaAbsoluteUri、proxy_cookie_path及WebSocket头。

为什么 phpMyAdmin 反代后总跳转到 localhost？

根本原因是 phpmyadmin 默认用 $_server['http_host'] 构造跳转 url，而 nginx proxy manager（npm）转发时没透传 host 或没改写响应头，导致它生成的登录链接、数据库列表页链接全指向 localhost:8080 这类内网地址。

实操建议：

在 NPM 的「Advanced」配置里加三行，强制重写 Host 并注入可信代理头：

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

phpMyAdmin 容器必须设置 PMA_ABSOLUTE_URI 环境变量，比如 https://db.example.com/（结尾带斜杠），否则它仍会自己拼接错误路径
别只改 NPM 的「SSL」开关——即使启用了 HTTPS，phpMyAdmin 本身若没收到 X-Forwarded-Proto: https，仍可能生成 http 链接；在 Advanced 里补上：
```
proxy_set_header X-Forwarded-Proto $scheme;
```

路径带前缀（如 /phpmyadmin/）时怎么避免 404？

phpMyAdmin 不是为子路径设计的，默认静态资源和 API 路由都从根开始，直接挂 /phpmyadmin/ 会导致 CSS 加载失败、AJAX 请求 404。

实操建议：

NPM 的「Domain Names」里填完整路径，例如 db.example.com/phpmyadmin（注意：不能只写域名再单独配路径前缀）
phpMyAdmin 容器启动时必须指定 PMA_ARBITRARY=1 和 PMA_HOST=your-mysql-host，否则子路径下登录页会报“未定义服务器”
关键一步：在 phpMyAdmin 的 config.inc.php 中显式设置：
```
$cfg['PmaAbsoluteUri'] = 'https://db.example.com/phpmyadmin/';
$cfg['ForceSSL'] = true;
```
（路径必须和 NPM 域名+前缀完全一致，大小写、斜杠都不能错）

反代后登录成功却反复跳回登录页？

这是 Cookie 域名或路径不匹配导致的典型表现：phpMyAdmin 写了 Path=/ 的 Cookie，但实际部署在 /phpmyadmin/ 下，浏览器拒绝发送该 Cookie 给子路径请求。

FastAPI Flask Proxy

FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。

下载

实操建议：

在 NPM 的「Advanced」配置中加入：
```
proxy_cookie_path / "/phpmyadmin/";
```
（把所有后端返回的 Cookie Path 重写成子路径）
确保 phpMyAdmin 容器里没有硬编码 session.cookie_path，否则会覆盖 Nginx 设置；检查 php.ini 或启动脚本里是否含 session.cookie_path=/
如果用了自签名证书或非标准端口，还要加：
```
proxy_cookie_flags ~ secure samesite=Strict;
```
（避免 Chrome 80+ 拒绝不安全上下文中的 Cookie）

如何让 NPM 正确透传 WebSocket（用于实时查询日志）？

phpMyAdmin 的「实时查询日志」功能依赖 WebSocket，但 NPM 默认不处理 Upgrade 和 Connection 头，导致连接被降级为普通 HTTP，页面卡在“Connecting…”。

实操建议：

在 NPM 的「Advanced」配置中追加：

proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";

确认 phpMyAdmin 容器监听的是 HTTP（不是 HTTPS）——NPM 只负责反代，后端不需要开 TLS；若后端强制 HTTPS，WebSocket 握手必失败
路径必须严格匹配：WebSocket 请求是 wss://db.example.com/phpmyadmin/js/.../websocket.php，NPM 的 Domain Names 必须包含完整路径，且不能有重定向规则干扰

Nginx Proxy Manager 对 phpMyAdmin 的反代，核心不在“能不能通”，而在“头字段是否可信、Cookie 是否可达、路径是否对齐”。漏掉任意一个 proxy_set_header 或环境变量，都可能让界面看起来正常，但点击几下就断连。