如何在腾讯云服务器一键部署phpMyAdmin_镜像市场应用-phpMyAdmin-PHP中文网

腾讯云镜像市场中的phpmyadmin镜像并非开箱即用，它仅预装apache+php+phpmyadmin，不含mysql服务，需手动配置config.inc.php指向真实mysql实例、启用apache rewrite模块，并补全https下cookie安全设置。

镜像市场里的 phpmyadmin 不是“开箱即用”的数据库管理工具

腾讯云镜像市场中名为 phpmyadmin 的应用，本质是一个预装了 apache + php + phpmyadmin 的轻量 lamp 环境镜像，但它**不包含 mysql 服务本身**，也不自动连接你已有的云数据库。直接启动后访问首页，大概率遇到 mysqli_real_connect(): (hy000/2002): connection refused 或空白页 —— 因为它默认尝试连本地 127.0.0.1:3306，而该端口根本没 mysql 在跑。

常见错误现象：

打开 http:///phpmyadmin 显示 “无法连接到 MySQL 服务器”
日志里反复出现 mysql.sock not found 或 Connection refused
镜像启动后 systemctl status mysql 显示服务未安装或 inactive

必须手动配置 config.inc.php 指向真实 MySQL 实例

镜像自带的 phpMyAdmin 默认配置文件路径是 /var/www/html/phpmyadmin/config.inc.php，但该文件通常为空或只有基础模板，**不会自动生成有效配置**。你需要手动编辑它，明确告诉 phpMyAdmin 去连哪台 MySQL。

实操建议：

如果你用的是腾讯云 CVM 自建 MySQL：确认 MySQL 已启动、允许远程连接（bind-address = 0.0.0.0）、且用户有对应权限（如 CREATE USER 'pma'@'%' IDENTIFIED BY 'xxx'; GRANT ALL ON *.* TO 'pma'@'%';）
如果你用的是腾讯云 云数据库 CDB for MySQL：在控制台获取「内网地址」（如 xxx.mysql.gz.cdb.myqcloud.com:63125），并确保安全组放行该端口，同时在 CDB 控制台添加对应账号
编辑 /var/www/html/phpmyadmin/config.inc.php，在 $cfg['Servers'][$i]['host'] = 'localhost'; 行改为你的实际地址，例如：$cfg['Servers'][$i]['host'] = 'xxx.mysql.gz.cdb.myqcloud.com';；端口用 $cfg['Servers'][$i]['port'] = '63125';
别漏掉认证方式：加上 $cfg['Servers'][$i]['auth_type'] = 'cookie';，否则可能跳登录页失败

Apache 默认没启用 rewrite，导致部分链接 404

phpMyAdmin 的 URL 路由（比如点击“导入”后跳转 /phpmyadmin/import.php）依赖 Apache 的 mod_rewrite 和 .htaccess 支持。但腾讯云该镜像默认未开启 rewrite，访问子页面常报 404。

解决方法很简单：

腾讯云跨账号资源迁移

腾讯云跨账号资源迁移工具，支持将账号A的VPC、CLB、NAT、CVM、安全组等资源迁移至账号B，通过CCN云联网实现跨账号网络互通，提供自动扫描、配置生成、Terraform部署功能。

下载

运行 a2enmod rewrite 启用模块
编辑 /etc/apache2/sites-available/000-default.conf，在 <directory></directory> 块内加入：AllowOverride All
重启 Apache：systemctl restart apache2

不改的话，你点导航栏任何二级页面都会卡住，但首页能刷出来 —— 容易误判为“部署成功”。

HTTPS 和 cookie 安全标志需手动补全

如果用 Nginx 反代或启用了腾讯云 SSL 证书，phpMyAdmin 登录后可能反复跳回登录页。原因是它的 session cookie 默认没设 Secure 和 HttpOnly 标志，HTTPS 下被浏览器拒绝携带。

只需在 config.inc.php 末尾追加两行：

$cfg['LoginCookieRecall'] = true;
$cfg['LoginCookieStore'] = 0;
$cfg['LoginCookieDeleteAll'] = true;
$cfg['ForceSSL'] = true;
ini_set('session.cookie_secure', 1);
ini_set('session.cookie_httponly', 1);

漏掉 ini_set('session.cookie_secure', 1) 这句，哪怕整个站走 HTTPS，登录态也维持不住 —— 这个坑在镜像文档里完全没提。

复杂点在于：每个配置项生效条件不同，$cfg['ForceSSL'] 控制界面跳转逻辑，ini_set 才真正影响 Cookie 发送行为。两者缺一不可，顺序也不能颠倒。