phpMyAdmin 安裝、配置與安全防護完整指南

phpMyAdmin 簡介

phpMyAdmin 是最流行的 MySQL/MariaDB Web 管理介面，以 PHP 撰寫，提供直觀的資料庫、資料表、資料操作、SQL 執行、匯入匯出、使用者權限管理等功能。

安裝方式

方式一：Composer 安裝 (推薦，易更新)

composer create-project phpmyadmin/phpmyadmin --repository-url=https://www.phpmyadmin.net/packages.json --no-dev

方式二：官方壓縮包

1. 下載：phpMyAdmin 官網 (選擇 all-languages 版本)
2. 解壓至 Web 目錄：/var/www/html/phpmyadmin
3. 重命名 config.sample.inc.php 為 config.inc.php

方式三：Linux 套件管理器

# Ubuntu/Debian
apt update && apt install phpmyadmin
# 安裝過程會詢問 Web 伺服器 (apache2/lighttpd) 和資料庫設定

# CentOS/RHEL (EPEL)
yum install epel-release && yum install phpmyadmin

核心配置檔解析 (config.inc.php)

<?php
// 基礎設定
$cfg['blowfish_secret'] = 'your-32-char-random-string-here'; // Cookie 加密金鑰 (32 字元)
$cfg['DefaultLang'] = 'zh_TW';                              // 預設語言
$cfg['ServerDefault'] = 1;                                  // 預設伺服器索引
$cfg['UploadDir'] = '';                                     // 上傳目錄 (空為停用)
$cfg['SaveDir'] = '';                                       // 儲存目錄

// 伺服器群組設定 (支援多伺服器)
$i = 0;
$i++;
$cfg['Servers'][$i]['auth_type'] = 'cookie';          // 驗證方式：cookie/http/config/signon
$cfg['Servers'][$i]['host'] = '127.0.0.1';            // 主機
$cfg['Servers'][$i]['port'] = '3306';                 // 埠號
$cfg['Servers'][$i]['socket'] = '';                   // Unix socket
$cfg['Servers'][$i]['compress'] = false;              // 壓縮傳輸
$cfg['Servers'][$i]['controluser'] = 'pma_control';   // 控制使用者 (進階功能)
$cfg['Servers'][$i]['controlpass'] = 'control_pass';
$cfg['Servers'][$i]['pmadb'] = 'phpmyadmin';          // phpMyAdmin 設定儲存資料庫
$cfg['Servers'][$i]['bookmarktable'] = 'pma__bookmark';
$cfg['Servers'][$i]['relation'] = 'pma__relation';
$cfg['Servers'][$i]['table_info'] = 'pma__table_info';
$cfg['Servers'][$i]['table_coords'] = 'pma__table_coords';
$cfg['Servers'][$i]['pdf_pages'] = 'pma__pdf_pages';
$cfg['Servers'][$i]['column_info'] = 'pma__column_info';
$cfg['Servers'][$i]['history'] = 'pma__history';
$cfg['Servers'][$i]['table_uiprefs'] = 'pma__table_uiprefs';
$cfg['Servers'][$i]['tracking'] = 'pma__tracking';
$cfg['Servers'][$i]['userconfig'] = 'pma__userconfig';
$cfg['Servers'][$i]['recent'] = 'pma__recent';
$cfg['Servers'][$i]['favorite'] = 'pma__favorite';
$cfg['Servers'][$i]['users'] = 'pma__users';
$cfg['Servers'][$i]['usergroups'] = 'pma__usergroups';
$cfg['Servers'][$i]['navigationhiding'] = 'pma__navigationhiding';
$cfg['Servers'][$i]['savedsearches'] = 'pma__savedsearches';
$cfg['Servers'][$i]['central_columns'] = 'pma__central_columns';
$cfg['Servers'][$i]['designer_settings'] = 'pma__designer_settings';
$cfg['Servers'][$i]['export_templates'] = 'pma__export_templates';

// 安全性設定
$cfg['LoginCookieValidity'] = 1440;       // Cookie 有效期 (秒)
$cfg['LoginCookieStore'] = 0;             // 瀏覽器關閉即失效
$cfg['ForceSSL'] = true;                  // 強制 HTTPS
$cfg['CheckConfigurationPermissions'] = true; // 檢查配置檔權限
$cfg['CaptchaLoginPublicKey'] = '...';    // reCAPTCHA 公鑰
$cfg['CaptchaLoginPrivateKey'] = '...';   // reCAPTCHA 私鑰
$cfg['TwoFactor'] = 'totp';               // 兩步驟驗證 (TOTP)
?>

驗證模式比較

資料庫權限最小化原則

-- 建立專用管理帳號 (僅限必要權限)
CREATE USER 'pma_admin'@'%' IDENTIFIED BY 'strong_password';
GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, ALTER, INDEX 
ON `myapp`.* TO 'pma_admin'@'%';

-- phpMyAdmin 進階功能所需控制帳號
CREATE USER 'pma_control'@'%' IDENTIFIED BY 'control_password';
GRANT SELECT, INSERT, UPDATE, DELETE ON `phpmyadmin`.* TO 'pma_control'@'%';
FLUSH PRIVILEGES;

安全防護必要措施 (必做清單)

常見問題排查

• 「設定檔權限錯誤」：chmod 640 config.inc.php && chown www-data:www-data config.inc.php
• 「無法建立控制使用者連線」：檢查 controluser 權限、資料庫 phpmyadmin 是否存在、匯入 sql/create_tables.sql
• 「Token 不匹配」：清除瀏覽器 Cookie、檢查 blowfish_secret 設定、Session 目錄可寫
• 匯入大檔案失敗：調整 php.ini：upload_max_filesize、post_max_size、max_execution_time、memory_limit；或使用命令列 mysql < dump.sql

替代方案推薦

• Adminer：單一 PHP 檔案、輕量、支援多種資料庫
• DBeaver / DataGrip / TablePlus：桌面端 GUI，功能更強、安全性更高 (SSH 通道)
• MySQL Workbench：官方工具，適合架構設計、效能調校

phpMyAdmin 功能強大但攻擊面大，生產環境務必實施多層防護，或改用桌面工具透過 SSH 通道管理，將管理介面完全隔離於公網之外。