快捷導(dǎo)航

Docker部署遠(yuǎn)程MySQL從端口踩坑到權(quán)限全開完整步驟(附避坑指南)

更新時(shí)間：2026年04月20日 09:15:04 作者：rrrjqy

MySQL遠(yuǎn)程連接問題是軟件開發(fā)與數(shù)據(jù)庫(kù)運(yùn)維過程中極為常見且令人困擾的技術(shù)難題,其背后涉及權(quán)限控制、網(wǎng)絡(luò)通信、系統(tǒng)安全策略及容器化部署等多個(gè)層面的協(xié)同機(jī)制,這篇文章主要介紹了Docker部署遠(yuǎn)程MySQL從端口踩坑到權(quán)限全開的相關(guān)資料,需要的朋友可以參考下

一、部署環(huán)境與核心工具

服務(wù)器：阿里云輕量應(yīng)用服務(wù)器（Ubuntu/CentOS 均可）
核心技術(shù)：Docker + Docker Compose
數(shù)據(jù)庫(kù)版本：MySQL 8.0
本地連接工具：DataGrip

二、基礎(chǔ)部署流程：三步走方案

1. 目錄隔離與 Docker Compose 配置

version: '3.8'
services:
  new-db:
    image: mysql:8.0
    container_name: xxx-db  # 容器名稱
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: xxx  # root用戶密碼
      MYSQL_DATABASE:xxx_db  # 自動(dòng)創(chuàng)建的數(shù)據(jù)庫(kù)名
    ports:
      - "3307:3306"  # 關(guān)鍵！宿主機(jī)端口:容器端口
    volumes:
      - ./mysql_data:/var/lib/mysql  # 數(shù)據(jù)持久化掛載

核心配置解析：

端口映射 3307:3306：外部連接必須使用宿主機(jī)端口（本處如果是3307記得改因?yàn)?306就是 MySQL 數(shù)據(jù)庫(kù)的“官方出廠默認(rèn)端口”如果改了宿主機(jī)端口記得改）

持久化掛載：避免容器刪除后數(shù)據(jù)丟失

2. 一鍵啟動(dòng)服務(wù)

docker compose up -d

三、血淚避坑指南：解決“連不上”的三個(gè)死理

坑位 1：Connection timed out

癥狀：

DataGrip 提示 [28000][1045] Connection timed out: connect

原因：

云服務(wù)器安全組默認(rèn)攔截非標(biāo)準(zhǔn)端口（如 3307）

解決方案：

登錄云服務(wù)器控制臺(tái)
在安全組中添加入方向規(guī)則：
協(xié)議：TCP
端口范圍：3307
授權(quán)對(duì)象：0.0.0.0/0（生產(chǎn)環(huán)境建議限制 IP）

坑位 2：誤把容器名當(dāng)用戶名

癥狀：

Access denied for user ‘resumer-db’@‘xxx’

原因：

混淆了容器名（xxx-db）與數(shù)據(jù)庫(kù)用戶名（root）

解決方案：

在連接工具中填寫：

User: root
Password: xxx（即 MYSQL_ROOT_PASSWORD 的值）

坑位 3：MySQL 8.0 的權(quán)限與加密限制

癥狀：

Access denied for user ‘root’@‘你的IP’ (using password: YES)

原因：

權(quán)限限制：root 默認(rèn)僅允許 localhost 訪問

加密沖突：MySQL 8.0 默認(rèn)使用 caching_sha2_password，舊客戶端不支持

解決方案：

docker exec -it resumer-db mysql -uroot -proot -e \
"ALTER USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY 'root'; \
GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' WITH GRANT OPTION; \
FLUSH PRIVILEGES;"

命令解析：

修改 root 用戶加密方式為 mysql_native_password

授權(quán)所有 IP（%）訪問

立即刷新權(quán)限

連不上 → 查云服務(wù)器安全組
賬號(hào)錯(cuò)誤 → 確認(rèn)使用 root 而非容器名
密碼錯(cuò)誤 → 解決 MySQL 8.0 權(quán)限與加密問題
理清這三點(diǎn)，從此告別數(shù)據(jù)庫(kù)連接報(bào)錯(cuò)！

?總結(jié)

到此這篇關(guān)于Docker部署遠(yuǎn)程MySQL從端口踩坑到權(quán)限全開的文章就介紹到這了,更多相關(guān)Docker部署遠(yuǎn)程MySQL內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: