用 Docker 部署一个带 MySQL 的小站：从 0 到 可访问

一、为什么要用 Docker 跑 MySQL？#

在本地或服务器上安装 MySQL，有几种常见方式：

• 直接在系统里安装（apt install mysql-server、安装包下一路下一步等）
• 用各种图形化软件自带的数据库（比如某些集成环境）
• 用 Docker 拉一个 MySQL 容器跑起来（可以理解成在一台“虚拟小机器”里跑 MySQL）

我更倾向于用 Docker，主要有几个原因：

• 环境干净：不用在系统里装一堆服务，删起来也干净。
• 版本可控：想用哪个 MySQL 版本在 docker pull mysql:8.0 里写清楚就行。
• 迁移简单：换一台机器，只要装好 Docker，命令一跑环境就起来了。
• 和应用解耦：应用挂了、数据库挂了都是独立的，互不污染。

后文会从“什么都没有”的状态开始，依次完成：

1. Docker 安装好
2. MySQL 容器跑起来
3. 数据能够持久化（重启容器不丢）
4. 应用（或者本地工具）能连上这个 MySQL。

做到这四步，基本就能支撑一个小项目的数据库需求。

二、准备工作：安装 Docker#

1
docker version
2
docker info

1
sudo apt update
2
sudo apt install ca-certificates curl gnupg -y
3

4
# 添加 Docker 官方 GPG key 和源（略去具体细节）
5
# 安装 Docker Engine
6
sudo apt install docker-ce docker-ce-cli containerd.io -y
7

8
sudo systemctl enable docker
9
sudo systemctl start docker

三、用 Docker 拉起一个 MySQL 容器#

1
docker pull mysql:8.0

1
docker images

1
docker run --name my-mysql \
2
  -e MYSQL_ROOT_PASSWORD=your_root_password \
3
  -p 3306:3306 \
4
  -d mysql:8.0

1
docker ps

四、给 MySQL 加上数据卷：防止数据丢失#

在 Docker 的世界里，有一个非常重要的概念叫 volume（数据卷），用来把容器内部的数据映射 / 挂载到宿主机，可以粗略理解成“专门留给容器用的一块硬盘区域”。这样，即使容器被删掉，只要卷还在，数据就还在。

MySQL 容器默认会把数据写到 /var/lib/mysql 目录，我们要做的，就是把这个目录挂载到宿主机上的一个真实文件夹。

1
mkdir -p ~/docker-data/mysql

1
mkdir C:\docker-data\mysql

1
docker stop my-mysql
2
docker rm my-mysql

1
docker run --name my-mysql \
2
  -e MYSQL_ROOT_PASSWORD=your_root_password \
3
  -e MYSQL_DATABASE=app_db \
4
  -e MYSQL_USER=app_user \
5
  -e MYSQL_PASSWORD=app_user_password \
6
  -v ~/docker-data/mysql:/var/lib/mysql \
7
  -p 3306:3306 \
8
  -d mysql:8.0

五、进入容器里看一眼 MySQL#

要直接在容器里执行几条 SQL、确认数据库是否正常工作，可以进入容器内部：

1
docker exec -it my-mysql bash

进入容器后，使用 MySQL 自带的命令行客户端：

1
mysql -u root -p

输入刚才设置的 MYSQL_ROOT_PASSWORD，登录成功后就能看到熟悉的 MySQL 提示符。

可以简单测一下：

1
SHOW DATABASES;
2
USE app_db;
3
CREATE TABLE test (
4
  id INT PRIMARY KEY AUTO_INCREMENT,
5
  content VARCHAR(255)
6
);
7
INSERT INTO test (content) VALUES ('hello docker mysql');
8
SELECT * FROM test;

确认没问题后，输入：

1
exit
2
exit

第一次是退出 MySQL，第二次是退出容器的 shell。

六、从宿主机或开发工具连接这个 MySQL#

现在 MySQL 容器已经把 3306 端口映射到了宿主机，可以直接用各种工具连上去：

• 数据库可视化工具：如 Navicat、TablePlus、DBeaver 等
• 应用程序：Node.js、Java、Go、Python 等后端服务

假设你的 Docker 跑在本机上，连接信息大致如下：

• 主机（Host）：127.0.0.1 或 localhost
• 端口（Port）：3306
• 用户名（User）：app_user
• 密码（Password）：app_user_password
• 数据库名（Database）：app_db

在可视化工具里把这些填上，测试连接通过即可开始用 GUI 管理表和数据。

如果是 Node.js 应用，可以用 mysql2 举个简单例子：

1
npm install mysql2

1
import mysql from "mysql2/promise";
2

3
const pool = mysql.createPool({
4
  host: "127.0.0.1",
5
  port: 3306,
6
  user: "app_user",
7
  password: "app_user_password",
8
  database: "app_db",
9
});
10

11
async function testConnection() {
12
  const [rows] = await pool.query("SELECT NOW() as now");
13
  console.log(rows);
14
}
15

16
testConnection().catch(console.error);

只要控制台里能打印出当前时间，说明和 Docker 里的 MySQL 已经连通了。

七、用 docker-compose 管理 MySQL（以及未来的应用）#

如果只部署一个 MySQL，用 docker run 还算简单。但一旦出现：

• 应用容器
• 数据库容器
• 可能还有 Redis、Nginx 等

命令一多就很难维护，这时可以用 docker-compose 统一管理。

1
version: "3.9"
2

3
services:
4
  mysql:
5
    image: mysql:8.0
6
    container_name: my-mysql
7
    restart: always
8
    environment:
9
      MYSQL_ROOT_PASSWORD: your_root_password
10
      MYSQL_DATABASE: app_db
11
      MYSQL_USER: app_user
12
      MYSQL_PASSWORD: app_user_password
13
    ports:
14
      - "3306:3306"
15
    volumes:
16
      - ./mysql-data:/var/lib/mysql
17
    command:
18
      - --default-authentication-plugin=mysql_native_password
19
      - --character-set-server=utf8mb4
20
      - --collation-server=utf8mb4_unicode_ci

1
docker compose up -d

1
docker compose ps

1
docker compose down

1
  app:
2
    build: .
3
    container_name: my-app
4
    depends_on:
5
      - mysql
6
    environment:
7
      DB_HOST: mysql
8
      DB_PORT: 3306
9
      DB_USER: app_user
10
      DB_PASSWORD: app_user_password
11
      DB_NAME: app_db
12
    ports:
13
      - "8080:8080"

1
docker compose up -d

八、几件容易踩坑但很关键的小事#

1
ports:
2
  - "3307:3306"

1
sudo chown -R youruser:youruser /home/youruser/docker-data/mysql

1
command:
2
  - --character-set-server=utf8mb4
3
  - --collation-server=utf8mb4_unicode_ci

九、简单回顾：从 0 到 可以用#

最后简单整理一下本文做的事情：

1. 安装 Docker / Docker Desktop，让机器具备跑容器的能力。
2. 拉取 MySQL 官方镜像：docker pull mysql:8.0。
3. 用 docker run 启动一个 MySQL 容器，确认可以运行。
4. 给 MySQL 挂上卷，把 /var/lib/mysql 映射到宿主机目录，实现数据持久化。
5. 通过 docker exec 进入容器，直接在 MySQL 里创建数据库和表，确认一切正常。
6. 从宿主机或者应用代码里，使用正确的主机、端口和账号连接到容器里的 MySQL。
7. 用 docker-compose 把配置写进一个文件里，以后一句命令就能启动完整的服务。

目的只是保留一套自己踩过坑之后沉淀出来的流程，方便以后再部署带 MySQL 的小项目时少查文档、少走弯路，也希望能顺便帮你省点试错时间。

十、如果要放到真正的服务器上，我会怎么做？#

最后补充一点更贴近“上线”的思路，给整篇笔记收个尾，也方便以后自己查阅。

1. 先在本地把 docker-compose 跑顺。
   所有服务（应用、MySQL、缓存、Nginx 等）都写在一个 docker-compose.yml 里，确保在本地一句 docker compose up -d 就能跑起来，并且各个服务之间的网络配置是正确的。

2. 服务器上只做三件事：装 Docker、拉代码、改配置。

   • 安装 Docker / Docker Compose（新版本已经合并成 docker compose）。
   • 从 Git 仓库把项目拉到服务器上。
   • 根据服务器环境，调整 .env 或 docker-compose.yml 里的少量配置（比如端口、域名、密码）。

3. 把所有敏感信息挪到环境变量或 .env 文件里。
   开发阶段可能直接把 MYSQL_ROOT_PASSWORD、DB_PASSWORD 写在 docker-compose.yml 里，上服务器之后更推荐的做法是：

   • 新建 .env 文件（不要提交到 Git 仓库）。
   • 把密码、密钥、连接串等写到 .env 里。
   • 在 docker-compose.yml 里用 ${VAR_NAME} 的形式引用。

4. 做好备份和监控的最低配置。
   即使用的是 Docker 里的 MySQL，也一定要定期备份数据，比如：

   • 写一个简单的备份脚本，用 mysqldump 把数据导出到宿主机目录。
   • 再配合 crontab，让它每天/每周自动执行一次。
   • 最起码在重要更新前，手动备份一份，这一步永远不会多余。

5. 用 Nginx（或其他反向代理）把流量引到应用容器。
   当你的应用也跑在 Docker 里时，可以：

   • 用另一个 Nginx 容器做反向代理，通过域名访问。
   • 或者用宿主机上的 Nginx 转发请求到 Docker 网络里的应用容器。
   • MySQL 通常不会直接对公网开放，而是只允许应用容器访问，或者只对特定的 IP 段开放。

6. 保留一份“最小可用”的部署文档。
   本文其实已经是一个雏形，但你可以在自己的仓库里再写一份更贴近你项目的 README：

   • 如何在新机器上从零开始部署。
   • 所有需要的环境变量列表。
   • 常见错误（比如端口冲突、权限问题）以及解决方式。

当这些东西都跑通之后，再看 Docker + MySQL 部署，你可能会发现它不再是一个“神秘的黑盒”，而只是你工具箱里一套相对顺手的流程而已。等未来你要再加上 Redis、消息队列，甚至是整套 CI/CD，只需要在现在这套基础上继续往前“加一层楼”就行了。