phpMyAdmin 是最流行的 MySQL/MariaDB Web 管理工具,免安裝、即解壓即用。但初學者常在配置文件、認證模式、權限設置上踩坑。本文提供從下載、部署、配置到常見錯誤排查的完整圖文級教程。
.zip 或 .tar.gz。# 假設 Web 根目錄 /var/www/html
cd /var/www/html
unzip phpMyAdmin-5.2.1-all-languages.zip
mv phpMyAdmin-5.2.1-all-languages phpmyadmin
# 或自定義目錄名,如 pma、dbadmin 等 (安全性建議修改默認名稱)
phpMyAdmin 尋找配置文件順序:config.inc.php (根目錄) → config.sample.inc.php → libraries/config.default.php。
cd /var/www/html/phpmyadmin
cp config.sample.inc.php config.inc.php
# 若無 sample 文件,從 libraries 複製
cp libraries/config.default.php config.inc.php
<?php
// config.inc.php
// 1. 絕對 URI (可選,建議設置,防重定向問題)
$cfg['PmaAbsoluteUri'] = 'https://your-domain.com/phpmyadmin/';
// 2. Blowfish 密鑰 (Cookie 認證模式必填,32 字符隨機字符串)
$cfg['blowfish_secret'] = 'a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6'; // 32 字符
// 3. 服務器配置 (支援多服務器,索引 $i 從 1 開始)
$i = 0;
$i++;
$cfg['Servers'][$i]['auth_type'] = 'cookie'; // 認證模式:cookie (推薦)、http、config、signon
$cfg['Servers'][$i]['host'] = 'localhost'; // MySQL 主機
$cfg['Servers'][$i]['port'] = '3306'; // 端口
$cfg['Servers'][$i]['user'] = 'root'; // 登錄用戶 (config 模式需填)
$cfg['Servers'][$i]['password'] = ''; // 密碼 (config 模式需填)
$cfg['Servers'][$i]['connect_type'] = 'tcp'; // tcp 或 socket
$cfg['Servers'][$i]['compress'] = false;
$cfg['Servers'][$i]['AllowNoPassword'] = false; // 禁止空密碼登錄 (安全)
// 4. 僅顯示指定數據庫 (可選)
$cfg['Servers'][$i]['only_db'] = ''; // 留空顯示所有
// 5. 語言設置
$cfg['DefaultLang'] = 'zh_CN'; // 簡體中文
$cfg['DefaultConnectionCollation'] = 'utf8mb4_general_ci';
// 6. 安全相關
$cfg['LoginCookieValidity'] = 1440; // 登錄有效期 (秒)
$cfg['LoginCookieStore'] = 0; // 瀏覽器關閉即失效
$cfg['ForceSSL'] = true; // 強制 HTTPS (若已配置 SSL)
$cfg['CheckConfigurationPermissions'] = true; // 檢查配置文件權限
// 7. 功能開關
$cfg['ShowPhpInfo'] = false;
$cfg['ShowChgPassword'] = true;
$cfg['ShowCreateDb'] = true;
$cfg['Export']['compression'] = 'gzip'; // 導出壓縮
$cfg['Import']['compression'] = 'gzip'; // 導入支援 gzip
| 模式 | auth_type 值 | 特點 | 適用場景 |
|---|---|---|---|
| Cookie | cookie | 表單登錄、Session 保持、支援多用戶、需 blowfish_secret | 生產環境、共享主機、多用戶 |
| HTTP Basic | http | 瀏覽器原生彈窗、無 Session、每請求發送憑證 | 內網、API 測試、單用戶 |
| Config | config | 配置文件寫死用戶/密、**極不安全**、無登錄頁 | 僅本地開發調試 |
| Signon | signon | 單點登錄 (SSO) 集成,需實現 signon_session/signon_url | 企業內部系統整合 |
強烈建議生產環境使用 cookie 模式,並設置強 `blowfish_secret`、啟用 `ForceSSL`。
640,屬主 `www-data:www-data` (或 PHP-FPM 運行用戶),禁止其他用戶讀寫。# Nginx
location /phpmyadmin {
allow 192.168.1.0/24; # 僅內網 IP
deny all;
auth_basic "Restricted";
auth_basic_user_file /etc/nginx/.htpasswd;
}
mysqli::real_connect(): (HY000/2002): No such file or directory$cfg['Servers'][$i]['socket'] = '/var/run/mysqld/mysqld.sock'; // 實際路徑
// 或強制 TCP
$cfg['Servers'][$i]['host'] = '127.0.0.1';
$cfg['Servers'][$i]['connect_type'] = 'tcp';
The configuration file now needs a secret passphrase (blowfish_secret)openssl rand -hex 16。Cannot load or save configurationdocker run -d \
--name phpmyadmin \
-e PMA_HOST=mysql-host \
-e PMA_PORT=3306 \
-e PMA_USER=root \
-e PMA_PASSWORD=secret \
-e PMA_ARBITRARY=0 \
-e UPLOAD_LIMIT=100M \
-p 8080:80 \
--restart unless-stopped \
phpmyadmin/phpmyadmin:latest
訪問 https://localhost:8080,自動處理配置、SSL、時區、語言。
phpMyAdmin 雖老牌,但功能強大、社區活躍。掌握「配置文件生成 → 核心參數設置 → 認證模式選擇 → 權限加固 → 常見錯誤排查」全流程,即可輕鬆駕馭數據庫管理。生產環境強烈建議走 Docker 部署 + 內網訪問限制 + HTTPS + 2FA,安全無憂。