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 文件时被静默截断。
立即学习“PHP免费学习笔记（深入）”；
常见错误现象：
— 点击“导入”跳转到空白页或 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 对比下字段是否存在。别信网上搜到的“万能配置”，少一个分号或引号错位，就是白屏。
