如何在离线内网环境中安装phpMyAdmin_源码包下载与手动解压部署-phpMyAdmin-PHP中文网

phpMyAdmin离线部署必须使用source版本，即phpMyAdmin-x.x.x-source.tar.gz（或.zip），因其不含预编译资源、无外部依赖，需在有网环境执行./build.sh --no-dev生成vendor及前端文件后移入内网。

phpMyAdmin 离线部署必须用 source 版本，别下错包

官网下载页上混着 phpmyadmin-x.x.x-all-languages.7z 和 phpmyadmin-x.x.x-all-languages.tar.gz，这两个是带完整依赖的“all-in-one”压缩包，但它们不是源码包——它们只是预编译好的 web 可运行文件，不包含 composer.json 或构建脚本，也不需要安装。你真正要找的是标着 source 的那个：phpmyadmin-x.x.x-source.tar.gz（或 .zip）。这个包体积小、无语言预编译、所有翻译和 js/css 都得手动处理，但好处是：完全不联网、不调外部 cdn、不依赖 npm 或 composer install。

常见错误现象：
— 下了 all-languages 包却在内网访问时报 Missing language file 或界面乱码
— 解压后打开首页直接 500，日志里出现 require_once(): Failed opening required 'vendor/autoload.php'
— 以为要自己跑 composer install，结果发现内网连不上 packagist.org

确认下载链接含 source 字样，比如：https://files.phpmyadmin.net/phpMyAdmin/5.2.1/phpMyAdmin-5.2.1-source.tar.gz
解压后目录里应有 composer.json、build/、libraries/vendor/ 是空的 —— 这才对
别碰 setup/ 目录，它依赖 Web 交互，在离线环境根本走不通

离线生成 vendor 和前端资源：提前在有网机器上跑 build

phpMyAdmin 的 source 包本身不能直接运行，必须先生成 vendor/（PHP 依赖）和 js/、css/（前端资源）。这个过程必须在能联网的机器上完成，再把产物拷进内网 —— 没有捷径。

使用场景：
— 内网服务器无任何出网权限（DNS 也封死）
— 安全审计要求所有代码来源可追溯，不允许运行时动态拉取

在有网 Linux 机器上装好 PHP 7.4+、composer、nodejs（v16+）、npm
解压 source 包，进入目录后执行：./build.sh --no-dev（别用 make，它会尝试 git 拉 submodule）
成功后检查：libraries/vendor/ 非空、js/dist/ 和 css/dist/ 存在且文件数 > 50
把整个目录打包（不含 .git、build/、tests/），传入内网

内网 Apache/Nginx 配置要点：别漏掉 rewrite 和 upload 限制

phpMyAdmin 对 Web 服务器配置很敏感，尤其在离线环境没法靠报错提示反推问题。最常卡住的是 URL 重写失败导致路由 404，或上传大 SQL 文件时被静默截断。

btpanel phpsite 宝塔面板PHP网站

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

下载

常见错误现象：
— 点击“导入”跳转到空白页或 404
— 登录后点任意数据库就报 The requested URL was not found on this server
— 上传 2MB 以上 SQL 文件时进度条走到一半就停，没报错也没日志

Apache 必须启用 mod_rewrite，且站点配置中要有：RewriteEngine On 和 AllowOverride All（对应目录的 .htaccess 才生效）
Nginx 要显式加 location 块：location /phpmyadmin/ { try_files $uri $uri/ /phpmyadmin/index.php?$args; }
PHP 配置需同步调整：upload_max_filesize = 128M、post_max_size = 128M、max_execution_time = 300（改完重启 php-fpm）
确保 config.inc.php 中的 $cfg['TempDir'] 指向 Web 可写的绝对路径，比如 /var/lib/phpmyadmin/tmp，别用相对路径

config.inc.php 手动配置避坑：$cfg['Servers'] 不要照抄示例

离线环境下没有 setup 脚本帮你生成配置，config.sample.inc.php 里的默认值多数不能直接用。最危险的是 $cfg['Servers'][$i]['host'] 和认证方式 —— 设错会导致登录即 500 或无限重定向。

参数差异：
— 'auth_type' => 'cookie'：安全但每次登录都要输密码，适合多用户
— 'auth_type' => 'config'：密码明文写在配置里，仅限单人、高信任内网
— 'host' 别写 localhost：MySQL 默认监听 127.0.0.1，而 localhost 触发 socket 连接，容易因 socket 路径不对失败

务必改成 IP：$cfg['Servers'][$i]['host'] = '127.0.0.1';
如果 MySQL 改过端口，必须显式写：$cfg['Servers'][$i]['port'] = '3307';
禁用 blowfish_secret 自动生成逻辑（它会尝试读 /dev/urandom，某些加固系统会拒绝）：$cfg['blowfish_secret'] = '随便32位字符如Xa7Kp2mQv9RfBn4Tj8LcEw5Yz1NsGh6';
删掉所有带 https:// 的配置项（比如 $cfg['UploadDir'] 示例值），内网不存在这些路径

复杂点在于：不同版本的 config.sample.inc.php 结构微调频繁，5.1 和 5.2 的 $cfg['Servers'] 数组键名略有出入，拷配置前最好用 diff 对比下字段是否存在。别信网上搜到的“万能配置”，少一个分号或引号错位，就是白屏。