如何通过Caddy服务器部署phpMyAdmin_Caddyfile反向代理编写-phpMyAdmin-PHP中文网

phpmyadmin 反向代理必须使用 php_fastcgi 而非 reverse_proxy，因其是 php-fpm 应用；需正确配置 root、split、strip_prefix、权限及 https 环境变量透传，否则导致 502、404、500 或登录失败。

phpmyadmin 反向代理必须指定 `fastcgi` 而非 `reverse_proxy`

很多人误以为 phpmyadmin 是纯静态 php 应用，直接用 reverse_proxy 指向另一个 nginx/apache 就行——这会导致 502 或空白页。phpmyadmin 本质是 php-fpm 应用，caddy 必须通过 php_fastcgi 直接对接本地或远程的 php-fpm socket 或 tcp 地址，不能走 http 反代。

常见错误现象：404 Not Found（路径未匹配）、500 Internal Server Error（PHP 扩展缺失或 session 权限问题）、ERR_TOO_MANY_REDIRECTS（rewrite 和 redir 混用）。

php_fastcgi 是唯一正确入口；reverse_proxy 在这里完全不适用
若 phpMyAdmin 部署在其他机器上（比如 Docker 容器），仍需确保 Caddy 能直连其 PHP-FPM 端口（如 192.168.1.10:9000），而非它暴露的 HTTP 端口
路径前缀（如 /phpmyadmin）必须和 uri strip_prefix、php_fastcgi 的 root 保持一致，否则文件找不到

Caddyfile 中 `php_fastcgi` 的路径与权限配置要点

Caddy 默认不会自动处理 PHP 的 DOCUMENT_ROOT 和 PATH_INFO，漏掉关键参数就会报 No input file specified. 或跳转到下载页面。

使用场景：phpMyAdmin 解压在 /var/www/phpmyadmin，PHP-FPM 运行在本地 Unix socket /run/php/php8.1-fpm.sock。

必须显式设置 root * /var/www/phpmyadmin，否则 Caddy 不知道从哪找 index.php
php_fastcgi 后要跟 split .php（Caddy v2.6+ 已默认，但低版本仍需写明）
若用子路径访问（如 https://example.com/phpmyadmin），需加 uri strip_prefix /phpmyadmin，且 root 保持为完整路径，不要写成 /var/www/phpmyadmin/phpmyadmin
确保 www-data（或 Caddy 运行用户）对 /var/www/phpmyadmin 有读取权限，对 tmp/ 和 config.inc.php（如存在）有写入权限（仅配置时需要）

常见 500 错误背后的真实原因和快速验证法

看到 500 Internal Server Error 别急着改 Caddyfile——90% 是 PHP 层问题，Caddy 日志里往往只显示 “upstream prematurely closed connection”，没价值。

先确认 PHP-FPM 是否真在响应：

执行 curl --unix-socket /run/php/php8.1-fpm.sock http://localhost/index.php（替换为实际 socket 路径），看是否返回 PHP 解析后的内容
检查 phpinfo() 是否能正常输出；如果不能，说明 PHP 扩展（mysqli、mbstring、openssl）缺失或配置错误
phpMyAdmin 的 libraries/vendor_config.php 若被修改过，可能因路径硬编码导致 fatal error；建议用官方 release 包，不手动改 vendor 目录
Caddy 的 log 块若没配 output file /var/log/caddy/error.log，错误会被吞掉；PHP-FPM 的 slowlog 和 error_log 更关键

HTTPS 下 cookie 和登录跳转失效的典型配置补丁

部署在 HTTPS 域名下却始终无法登录，或者登录后立刻跳回登录页——大概率是 phpMyAdmin 检测到协议不一致，拒绝设置 Secure Cookie。

phpMyAdmin 依赖 $_SERVER['HTTPS'] 和 $_SERVER['HTTP_X_FORWARDED_PROTO'] 判断是否启用安全 cookie，而 Caddy 默认不透传这些头。

必须在 php_fastcgi 块内加 transport fastcgi { 子块，并设置 env HTTPS on 和 env HTTP_X_FORWARDED_PROTO https
若前端还有 CDN 或负载均衡，需额外传递 X-Forwarded-Proto，并在 Caddy 中用 header_up X-Forwarded-Proto {http.request.header.X-Forwarded-Proto}
phpMyAdmin 的 config.inc.php 中不要硬写 $cfg['ForceSSL'] = true，除非你确定所有流量都经 HTTPS 入口；更稳妥的是靠 Caddy 注入环境变量驱动判断