如何在腾讯云服务器上部署phpMyAdmin?

酷丽大大_5925

酷丽大大_5925

2026-08-12

401人浏览

原创

phpmyadmin不能在腾讯云轻量服务器上开箱即用,需手动部署;必须确认web服务类型(nginx/apache/宝塔),修改config.inc.php中host、blowfish_secret及nginx fastcgi_pass配置,并解决mysql连接、会话权限与安全暴露问题。

phpmyadmin 不能直接在腾讯云轻量服务器上开箱即用,必须手动部署 —— 它不是官方镜像预装组件,也不支持一键安装(比如宝塔面板里默认不带,lighthouse 应用市场无现成模板)。但部署本身不难,关键在于绕开常见权限、路径和 nginx/apache 配置陷阱。

确认 Web 服务类型再动手

腾讯云轻量服务器常用两种 Web 环境:Nginx 或 Apache,也有用户用 宝塔面板。部署前必须先确认你用的是哪一种,否则 phpMyAdmin 的配置路径、入口 URL、甚至能否访问都会出错。

  • 查 Web 服务:运行 sudo systemctl status nginx 或 sudo systemctl status apache2,看哪个 active
  • 查 PHP 版本:运行 php -v,phpMyAdmin 4.9+ 要求 PHP ≥ 7.4;2026 年主流 Ubuntu 22.04 默认是 PHP 8.1,基本兼容
  • 若用宝塔:直接在「软件商店」搜 phpMyAdmin,但注意——它默认只绑定到 http://你的IP:8888/phpmyadmin,且不开放外网(需手动在「安全组」放行 8888 端口)

手动部署时必须改的三个配置项

从官网下载最新稳定版解压后,phpMyAdmin 默认不允许远程访问,这是安全机制,但也是新手卡住最多的地方。以下三处不改,浏览器打开只会看到 403 Forbidden 或空白页:

  • config.inc.php 中必须设置 $cfg['Servers'][$i]['host'] = 'localhost';(不能留空或写 127.0.0.1)
  • blowfish_secret 必须填满 32 字符(可用 openssl rand -base64 24 生成后截取 32 位)
  • Nginx 配置里要显式允许 location /phpmyadmin/ 的 index.php 执行,否则会下载文件而非运行 —— 常见错误是漏掉 fastcgi_pass unix:/run/php/php8.1-fpm.sock;

绕过登录失败的典型报错

部署完访问 /phpmyadmin,输入账号密码却提示 #2002 Cannot log in to the MySQL server,大概率不是密码错,而是连接方式不对:

btpanel phpsite 宝塔面板PHP网站
btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理:站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载
  • MySQL 默认绑定 127.0.0.1,但 phpMyAdmin 在 Nginx 下常以 www-data 用户运行,无法直连 socket 文件;解决方案是把 $cfg['Servers'][$i]['host'] 改为 127.0.0.1,并确保 MySQL 开启 TCP 监听(检查 /etc/mysql/mysql.conf.d/mysqld.cnf 中 bind-address = 127.0.0.1 未被注释)
  • 如果用的是腾讯云 CVM 自带的云数据库 MySQL(非本地安装),则 $cfg['Servers'][$i]['host'] 必须填云数据库内网地址(如 mysql-xxx.cdb.tencentcloud.com),且安全组要放行 3306 端口
  • 登录页显示 Cannot start session without errors:说明 /var/lib/php/sessions 权限不对,运行 sudo chown -R www-data:www-data /var/lib/php/sessions 即可

安全红线:别暴露默认路径

上线后第一件事不是测试功能,而是关掉默认入口。腾讯云轻量服务器公网 IP 易被扫描,/phpmyadmin 是攻击者高频爆破目标。临时方案是加个简单 HTTP 认证(Nginx 用 auth_basic),长期建议:

  • 把目录名从 /phpmyadmin 改成随机字符串(如 /a3k9x2z),同时更新 Nginx 配置里的 location 路径
  • 限制访问 IP:在 Nginx 的 location 块里加 allow 203.123.45.67;(你的办公 IP),再加 deny all;
  • 禁用 root 登录:MySQL 里新建专用账号(CREATE USER 'pma_user'@'localhost' IDENTIFIED BY 'strong-pass'; GRANT SELECT,INSERT,UPDATE,DELETE ON *.* TO 'pma_user'@'localhost';),并在 config.inc.php 中指定该账号

最后提醒一句:phpMyAdmin 本质是 PHP 写的数据库前端,它自己不加固 MySQL,只是暴露了操作入口。真正的防护靠 MySQL 权限控制 + 网络层隔离 + 定期升级,而不是靠改个路径名糊弄过去。

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2023.09.01

9724

6

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

5821

5

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

2055

5

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

2023.10.23

3628

4

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

2023.10.23

4334

6

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.03

3391

9

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.09

4837

8

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.13

3782

8

sprintf函数用法详解
sprintf函数用法详解

sprintf函数的用法:1、格式化字符串;2、指定输出宽度和精度;3、返回值。更多关于sprintf函数用法详解的内容,大家可以阅读下面的文章。

2023.11.27

11782

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习