如何在1Panel面板中部署phpMyAdmin？-phpMyAdmin-PHP中文网

1Panel中无法一键安装phpMyAdmin，因其未上架应用商店，需手动Docker部署：必须与MySQL容器同网络、启用PMA_ARBITRARY=1、配置非标端口并避免挂载覆盖PHP文件。

phpMyAdmin 在 1Panel 中不是直接“安装应用”，而是通过容器方式手动部署——因为 1Panel 应用商店里没有独立上架 phpMyAdmin，它通常作为 MySQL 管理配套工具，需自行拉取镜像并配置网络、权限与访问路径。

为什么不能在应用商店一键安装 phpMyAdmin？

1panel 官方应用商店目前（截至 2026 年 7 月）仅上架了 mysql、openresty、php 等核心运行环境，但未将 phpmyadmin 封装为标准应用。它的定位是“数据库管理前端”，依赖已存在的 mysql 服务，且需手动绑定网络和认证逻辑，不适合无配置一键部署。

如何用 Docker 手动部署 phpMyAdmin 容器？

必须确保你已在 1Panel 中安装并运行了 MySQL（或 MariaDB），且开启了“端口外部访问”。部署步骤如下：

PMA_ARBITRARY=1 必须启用：否则 phpMyAdmin 只允许连接预设的服务器（如 localhost），无法手动输入 MySQL 地址
网络要与 MySQL 容器一致：比如 MySQL 在 panel-network，你的 phpMyAdmin 容器也得加 --network=panel-network，否则容器间 DNS 不通，填 mysql 或 mysql-container 会报错 mysqli_real_connect(): (HY000/2002): Connection refused
端口映射建议用非标准端口：比如 -p 5555:80，避免和 OpenResty 或其他 Web 服务冲突
不要挂载空目录到 /var/www/html：这会覆盖镜像内自带的 PHP 文件，导致白屏或 500 错误；只挂载自定义图标或配置（如 /ico）才安全

典型命令示例（替换 your-mysql-root-password 和网络名）：

docker run -d \
  --name phpmyadmin \
  --restart unless-stopped \
  --network panel-network \
  -e PMA_ARBITRARY=1 \
  -p 5555:80 \
  -v /opt/1panel/apps/phpmyadmin/ico:/usr/share/phpmyadmin/ico \
  phpmyadmin:5.2.2

访问时连不上 MySQL？检查这三点

常见错误是登录页能打开，但点“登录”后提示 #2002 Cannot log in to the MySQL server 或空白响应。原因通常是：

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

MySQL 容器没开“端口外部访问”：即使在同一网络，phpMyAdmin 容器默认用 localhost 连接，而 MySQL 实际监听的是容器 IP；正确做法是在登录页手动填 MySQL 容器名（如 mysql）和端口 3306，而非 localhost
root 用户权限受限：1Panel 部署的 MySQL 默认禁用 root 远程登录；建议新建一个用户（如 pma_user），赋予对应数据库权限，并在 phpMyAdmin 登录时使用该用户
防火墙或安全组没放行目标端口：比如你映射了 5555，但服务器防火墙或云厂商安全组没开这个端口，浏览器会直接超时

配置文件 `config.inc.php` 能否挂载？

官方镜像不支持直接挂载完整 config.inc.php —— 因为启动时会生成默认配置，覆盖你挂载的内容。若需定制（如改 $cfg['blowfish_secret'] 或启用双因素），有两种办法：

进入容器修改：docker exec -it phpmyadmin bash，再编辑 /etc/phpmyadmin/config.inc.php（注意该文件可能被启动脚本重写）
构建自定义镜像：基于官方镜像 COPY 修改后的 config.inc.php，再 push 到私有 registry；这是生产环境唯一可靠方式

临时测试可以跳过加密密钥设置，但正式使用必须配置 $cfg['blowfish_secret']，否则登录 Cookie 无法加密，存在会话劫持风险。