Docker部署MySQL全攻略：从环境隔离到生产级配置

1. 项目概述：为什么选择Docker部署MySQL？

如果你还在纠结是去官网下载安装包，还是用系统包管理器安装MySQL，我建议你停下来看看Docker。作为一个常年和数据库打交道的开发者，我几乎已经放弃了传统的本地安装方式，无论是开发、测试还是搭建临时环境，Docker都成了我的首选。这不仅仅是为了“炫技”，而是因为它实实在在地解决了几个痛点：环境隔离、版本切换、快速部署和一致性保证。

想象一下这个场景：你手头有一个老项目，需要MySQL 5.7，另一个新项目需要MySQL 8.0。传统方式下，你需要在同一台机器上处理端口冲突、配置文件打架、数据目录混乱等一系列问题，稍有不慎就会把环境搞崩。而用Docker，你只需要两条docker run命令，就能让两个不同版本的MySQL实例同时、独立、互不干扰地运行起来。这种“开箱即用，用完即弃”的轻量化体验，极大地提升了开发和运维效率。

更重要的是，Docker化的MySQL镜像，其配置和数据都是通过“卷”持久化在宿主机上的。这意味着容器本身可以随时销毁和重建，但你的数据库数据、用户权限、自定义配置却完好无损。这种将“不可变基础设施”和“持久化状态”分离的思想，是现代应用部署的最佳实践。接下来，我将带你从零开始，完成一次完整的Docker MySQL部署，并深入每个环节背后的原理和避坑指南。

2. 核心思路与准备工作

2.1 理解Docker运行MySQL的核心逻辑

在拉取镜像和运行容器之前，我们必须先搞清楚Docker运行MySQL的几个核心概念，这能帮你避开后面90%的坑。

首先，镜像和容器的关系。你可以把官方MySQL镜像理解为一个“模具”，这个模具里包含了运行MySQL所需的最小化Linux系统（通常是Debian或Alpine）、预装的MySQL服务器软件以及一个预设的启动脚本。当你执行docker run时，Docker引擎就用这个“模具”造出了一个活的、正在运行的“实例”，这就是容器。容器是临时的，而镜像是永久的模板。

其次，数据持久化。这是数据库容器的生命线。默认情况下，容器内部产生的所有数据（包括你创建的库、表、用户信息）都只存在于容器内部的“可写层”中。一旦容器被删除，这些数据就灰飞烟灭了。因此，我们必须使用Docker的“卷”或“绑定挂载”功能，将容器内MySQL的数据目录（默认是/var/lib/mysql）映射到宿主机的某个物理路径上。这样，数据就存储在了宿主机，容器只是个无状态的“计算单元”。

最后，配置与初始化。官方MySQL镜像提供了丰富的环境变量（如MYSQL_ROOT_PASSWORD）来让你在容器启动时进行最基础的配置。但对于更复杂的配置（如调整innodb_buffer_pool_size、设置字符集），你需要通过挂载自定义的my.cnf配置文件，或者在容器启动后进入其中修改。同时，镜像也支持在首次启动时自动执行你提供的SQL脚本，用于初始化数据库和用户，这对于自动化部署至关重要。

2.2 环境准备与工具选型

在开始动手前，确保你的环境已经就绪。

1. Docker引擎安装这是基础中的基础。根据你的操作系统选择安装方式：

• Windows/macOS：强烈推荐使用Docker Desktop。它提供了一个集成的图形界面和命令行环境。安装时，请务必在设置中启用“虚拟化”支持。如果你遇到“Virtualization support not detected”或“Docker Desktop failed to start because virtualization support wasn‘t detected”这类错误，通常是因为电脑的BIOS/UEFI设置中未开启虚拟化技术（如Intel VT-x或AMD-V），你需要重启电脑进入BIOS进行开启。
• Linux：直接使用各发行版的包管理器安装Docker Engine即可，例如在Ubuntu上使用apt，在CentOS上使用yum或dnf。Linux原生支持容器，无需虚拟化层，性能损耗更小。

安装完成后，在终端运行docker --version和docker run hello-world来验证安装是否成功。

2. 镜像源加速（针对国内用户）直接从Docker Hub拉取镜像可能会非常慢。建议配置国内镜像加速器，如阿里云、腾讯云、中科大的镜像加速服务。以阿里云为例，你需要在Docker Desktop的设置（Preferences）中的Docker Engine配置里，添加如下注册镜像地址：

{ "registry-mirrors": ["https://your-id.mirror.aliyuncs.com"] }

配置后重启Docker，拉取镜像的速度会有质的飞跃。

3. 客户端工具准备虽然我们可以通过命令行操作MySQL，但一个图形化管理工具能极大提升效率。这里有几个选择：

• MySQL Command-Line Client：最原生的工具，适合自动化脚本和深度调试。
• MySQL Workbench：官方出品的图形化工具，功能全面，适合数据库设计和管理。
• Navicat for MySQL：第三方商业软件，界面友好，功能强大，支持多种数据库。
• DBeaver：开源免费的通用数据库工具，支持MySQL、PostgreSQL等，也是一个不错的选择。

在本文的后续操作中，我会同时演示命令行和Navicat连接的方式。

3. 实战：拉取镜像与运行容器

3.1 拉取官方MySQL镜像

打开你的终端（Windows PowerShell, macOS Terminal, 或Linux Shell），执行拉取命令。我建议指定版本标签，而不是使用默认的latest标签，以保证环境的一致性。

# 拉取MySQL 8.0的最新版本镜像 docker pull mysql:8.0 # 或者拉取MySQL 5.7的最新版本镜像（适用于老项目兼容） docker pull mysql:5.7

docker pull命令会从配置的镜像仓库（默认是Docker Hub）下载指定的镜像及其所有依赖层。你可以通过docker images命令查看本地已下载的镜像列表。

注意：mysql:latest标签指向的是MySQL最新的大版本（目前是8.0）。但在生产环境中，明确指定8.0.x这样的具体小版本号是更严谨的做法，可以避免因自动升级到不兼容的新版本而导致服务故障。你可以去Docker Hub的MySQL官方页面查看所有可用的标签。

3.2 运行你的第一个MySQL容器

现在，让我们用一行命令启动一个MySQL 8.0容器。这是最基础也是最常用的启动方式：

docker run -d \ --name mysql8 \ -p 3306:3306 \ -e MYSQL_ROOT_PASSWORD=your_strong_password_here \ mysql:8.0

让我拆解一下这个命令的每个部分：

• -d：代表“detached”，让容器在后台运行。
• --name mysql8：给容器起一个名字，方便后续管理（如docker stop mysql8），而不是去记一长串容器ID。
• -p 3306:3306：端口映射，格式为宿主机端口:容器内端口。这里将宿主机的3306端口映射到容器的3306端口。这样，你通过localhost:3306访问的就是容器内的MySQL服务。
• -e MYSQL_ROOT_PASSWORD=...：设置环境变量。这是官方MySQL镜像要求必须设置的变量，用于定义root用户的初始密码。请务必替换your_strong_password_here为一个高强度的密码。
• mysql:8.0：指定使用的镜像名和标签。

执行命令后，使用docker ps查看容器状态，当STATUS显示为“Up”时，说明MySQL服务已经启动。

3.3 验证连接与基础操作

容器运行起来后，我们验证一下它是否正常工作。

方法一：使用Docker命令行进入容器内部连接

# 进入正在运行的mysql8容器的bash终端 docker exec -it mysql8 bash # 在容器内部，使用root用户登录MySQL mysql -u root -p # 然后输入你之前设置的密码

登录成功后，你会看到MySQL的命令行提示符mysql>。可以执行一些简单命令：

SHOW DATABASES; CREATE DATABASE test_db; USE test_db; CREATE TABLE users (id INT, name VARCHAR(100));

这种方式适合快速检查和执行管理命令。

方法二：使用宿主机上的MySQL客户端连接因为你已经做了端口映射（-p 3306:3306），所以可以直接在宿主机上使用任何MySQL客户端连接。

# 假设宿主机已安装mysql-client mysql -h 127.0.0.1 -P 3306 -u root -p

或者，打开Navicat，新建一个MySQL连接：

• 连接名：任意，如“Local Docker MySQL”
• 主机：127.0.0.1或localhost
• 端口：3306
• 用户名：root
• 密码：你之前设置的密码

点击“测试连接”，如果显示成功，恭喜你，一个基于Docker的MySQL服务已经搭建完毕。

4. 进阶配置：实现数据持久化与自定义

基础运行只是第一步。要让这个MySQL容器真正可用、可维护，我们必须解决数据持久化和配置自定义问题。

4.1 挂载数据卷实现持久化

如前所述，不挂载数据卷的容器，数据会随容器消亡。下面我们创建一个新的容器，并指定数据卷挂载。

# 首先，在宿主机上创建一个目录用于存放MySQL数据 mkdir -p /home/yourname/docker_data/mysql8 # 运行容器，并挂载数据卷 docker run -d \ --name mysql8-persistent \ -p 3307:3306 \ # 为了避免和上一个容器冲突，换一个宿主机端口 -e MYSQL_ROOT_PASSWORD=your_strong_password \ -v /home/yourname/docker_data/mysql8:/var/lib/mysql \ mysql:8.0

关键参数是-v（或--volume）：

• /home/yourname/docker_data/mysql8：这是宿主机上的一个绝对路径，用于存储数据。
• /var/lib/mysql：这是MySQL容器内部默认的数据存储目录。

现在，所有数据库文件（表结构、数据、日志等）都会物理存储在宿主机的/home/yourname/docker_data/mysql8目录下。你可以随时停止、删除mysql8-persistent容器，然后用同样的-v参数启动一个新容器，所有数据都会完好无损地加载回来。

实操心得：数据卷权限问题这是新手最常踩的坑。MySQL容器内的mysql用户（UID通常是999）需要对挂载的目录有读写权限。如果你在宿主机上用root创建的目录，容器可能因权限不足而启动失败。解决方法有两种：

1. 在运行容器前，确保宿主机目录对“其他用户”有足够权限：chmod 755 /home/yourname/docker_data/mysql8。
2. 更好的做法是，先以root身份运行一次容器，让MySQL初始化数据目录，生成正确的文件结构和权限，然后再停止容器，修改宿主机目录的属主：sudo chown -R 999:999 /home/yourname/docker_data/mysql8。之后再用普通用户启动容器就不会有问题了。

4.2 挂载自定义配置文件

默认的MySQL配置可能不符合你的需求，比如缓冲区大小、字符集、日志设置等。我们可以通过挂载自定义的my.cnf文件来覆盖容器内的默认配置。

步骤：

1. 在宿主机上创建配置文件目录和文件。

   mkdir -p /home/yourname/docker_config/mysql vim /home/yourname/docker_config/mysql/my.cnf

2. 编辑my.cnf文件，添加你需要的配置。例如，设置默认字符集为utf8mb4并调整一些性能参数：

   [mysqld] character-set-server=utf8mb4 collation-server=utf8mb4_unicode_ci default-authentication-plugin=mysql_native_password # 兼容老客户端 innodb_buffer_pool_size=1G # 根据你的机器内存调整 [client] default-character-set=utf8mb4 [mysql] default-character-set=utf8mb4

3. 运行容器时，挂载这个配置文件。注意，MySQL镜像的配置文件路径是/etc/mysql/conf.d，任何放在这个目录下的.cnf文件都会被加载。

   docker run -d \ --name mysql8-custom \ -p 3308:3306 \ -e MYSQL_ROOT_PASSWORD=your_strong_password \ -v /home/yourname/docker_data/mysql8-custom:/var/lib/mysql \ -v /home/yourname/docker_config/mysql/my.cnf:/etc/mysql/conf.d/custom.cnf \ mysql:8.0

   这里我们把宿主机的my.cnf文件，以custom.cnf的名字挂载到了容器的配置目录下。

启动后，你可以进入容器查看配置是否生效：

docker exec -it mysql8-custom mysql -uroot -p -e "SHOW VARIABLES LIKE 'character_set_server';"

应该会输出utf8mb4。

4.3 容器初始化：自动创建数据库和用户

在自动化部署中，我们常常需要在MySQL服务首次启动时，就创建好应用所需的数据库、用户并授权。官方MySQL镜像支持在/docker-entrypoint-initdb.d目录下放置.sh、.sql或.sql.gz文件，容器在首次初始化时会按字母顺序执行这些文件。

操作步骤：

1. 准备一个初始化SQL脚本，例如init.sql：

   -- init.sql CREATE DATABASE IF NOT EXISTS `app_db` CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER 'app_user'@'%' IDENTIFIED BY 'AppUserPassword123!'; GRANT ALL PRIVILEGES ON `app_db`.* TO 'app_user'@'%'; FLUSH PRIVILEGES;

2. 运行容器时，将这个脚本挂载到初始化目录：

   docker run -d \ --name mysql8-init \ -p 3309:3306 \ -e MYSQL_ROOT_PASSWORD=your_strong_root_password \ -v /home/yourname/docker_data/mysql8-init:/var/lib/mysql \ -v /path/to/your/init.sql:/docker-entrypoint-initdb.d/init.sql \ mysql:8.0

   容器第一次启动时，在完成root用户初始化后，会自动执行init.sql中的命令。请注意，这个机制只在数据目录为空（即首次创建容器）时触发。如果数据目录已存在（例如你挂载了一个已有的数据卷），这些初始化脚本将不会执行。

5. 生产环境考量与编排

将Docker MySQL用于个人开发测试很简单，但要用于生产环境，还需要考虑更多因素。

5.1 资源限制与监控

不能让一个数据库容器无限制地占用宿主机的资源。Docker提供了--memory、--cpus等参数来限制容器的资源使用。

docker run -d \ --name mysql8-prod \ -p 3306:3306 \ --memory="4g" \ # 限制最大内存为4GB --cpus="2.0" \ # 限制最多使用2个CPU核心 --memory-swap="6g" \ # 内存+交换分区总共6GB -e MYSQL_ROOT_PASSWORD=your_very_strong_password \ -v /data/mysql/prod_data:/var/lib/mysql \ -v /data/mysql/prod_conf:/etc/mysql/conf.d \ mysql:8.0 \ --default-authentication-plugin=mysql_native_password

同时，你需要监控容器的运行状态。可以使用docker stats mysql8-prod实时查看资源占用，或者集成更专业的监控工具如Prometheus+Grafana，通过收集MySQL的指标（连接数、查询速率、缓冲池命中率等）来监控数据库健康度。

5.2 使用Docker Compose编排多服务

在实际项目中，MySQL很少单独存在，它通常与Web应用、缓存等服务一起构成一个应用栈。使用Docker Compose可以通过一个YAML文件定义和管理所有服务，一键启动整个环境。

创建一个docker-compose.yml文件：

version: '3.8' services: mysql: image: mysql:8.0 container_name: app_mysql restart: always # 总是重启，保证服务高可用 environment: MYSQL_ROOT_PASSWORD: your_root_password MYSQL_DATABASE: app_db # 可选的，自动创建数据库 MYSQL_USER: app_user # 可选的，自动创建用户 MYSQL_PASSWORD: app_user_password ports: - "3306:3306" volumes: - ./mysql_data:/var/lib/mysql - ./mysql_conf/custom.cnf:/etc/mysql/conf.d/custom.cnf - ./init.sql:/docker-entrypoint-initdb.d/init.sql networks: - app-network # 资源限制 deploy: resources: limits: memory: 4G cpus: '2.0' webapp: # 假设还有一个Web应用服务 image: your-webapp-image:latest depends_on: - mysql environment: DB_HOST: mysql # 使用服务名直接通信，这是Docker Compose提供的内部DNS DB_PORT: 3306 networks: - app-network networks: app-network: driver: bridge

然后在文件所在目录运行docker-compose up -d，Compose会自动创建网络、按依赖顺序启动服务（先启动mysql，再启动webapp）。这种方式使得多服务应用的部署和团队共享变得极其简单。

5.3 备份与恢复策略

即使有了数据卷，定期备份仍然是铁律。备份Docker中的MySQL，本质就是备份挂载出来的数据目录，或者在容器内执行mysqldump。

方法一：直接备份数据卷目录这是最直接的方法，但需要停服或确保MySQL处于静默状态（如锁表），否则备份文件可能不一致。适合计划内的停机维护。

# 1. 停止容器 docker stop mysql8-prod # 2. 打包备份宿主机上的数据目录 tar -czf /backup/mysql_data_$(date +%Y%m%d).tar.gz -C /data/mysql/prod_data . # 3. 启动容器 docker start mysql8-prod

方法二：使用mysqldump进行逻辑备份（推荐）这种方式无需停服，备份的是逻辑SQL语句，恢复时更灵活，且可以跨版本迁移。

# 在宿主机上执行，通过docker exec在容器内运行mysqldump命令 docker exec mysql8-prod mysqldump -uroot -p'your_password' --all-databases --single-transaction --routines --triggers > /backup/full_backup_$(date +%Y%m%d).sql

参数说明：

• --all-databases：备份所有库。
• --single-transaction：对于InnoDB表，开启一个事务来确保备份的一致性，避免锁表。
• --routines：备份存储过程和函数。
• --triggers：备份触发器。

恢复数据：

# 将备份文件复制到容器内，或通过管道恢复 cat /backup/full_backup_20231027.sql | docker exec -i mysql8-prod mysql -uroot -p'your_password'

6. 常见问题与故障排查实录

在实际操作中，你几乎一定会遇到下面这些问题。我把它们和解决方案整理出来，希望能帮你节省大量搜索时间。

6.1 容器启动失败排查

问题1：容器状态一直是Restarting或Exited。这是最常见的问题。首先查看容器日志，这是定位问题的第一线索。

docker logs mysql8-container-name

• 日志显示：“error: database is uninitialized and password option is not specified”原因与解决：你没有设置MYSQL_ROOT_PASSWORD环境变量，或者设置了空密码。这是强制要求。确保-e MYSQL_ROOT_PASSWORD=xxx参数正确，且密码符合强度要求（MySQL 8.0默认策略较强）。
• 日志显示：“mysqld: Can‘t create/write to file ‘/var/lib/mysql/is_writable‘ (Errcode: 13 - Permission denied)”原因与解决：数据卷挂载的宿主机目录权限不足。参考4.1节中的“实操心得”，调整宿主机目录的权限或属主。
• 日志显示：“Different lower_case_table_names settings for server (‘2’) and data dictionary (‘0’).”原因与解决：这是一个MySQL的经典问题。lower_case_table_names参数控制了表名大小写敏感性。数据目录在初始化时（即第一次创建）就根据这个参数生成了内部元数据。之后如果你在my.cnf里修改了这个参数，与已有的数据字典不匹配，就会导致启动失败。解决方法：要么删除数据目录（注意备份！）让容器用新参数重新初始化；要么保持配置文件中的参数与数据目录初始化时一致。生产环境务必在初始化前就确定好这个参数。

问题2：客户端无法连接，报错“ERROR 1130 (HY000): Host ‘xxx.xxx.xxx.xxx‘ is not allowed to connect to this MySQL server”。原因与解决：MySQL默认的root用户只允许从localhost（即容器内部）连接。你需要授权root用户可以从任意主机（或特定IP）连接。

# 进入容器内的MySQL docker exec -it mysql8-container-name mysql -uroot -p # 执行授权命令 mysql> ALTER USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY 'your_password'; mysql> FLUSH PRIVILEGES;

注意，‘root’@‘%’代表来自任何主机的root用户。在生产环境中，为了安全，你应该创建专属的应用用户并限制其来源IP。

6.2 性能与连接问题

问题：应用出现“Too many connections”错误。原因与解决：MySQL默认的最大连接数（max_connections）是151，对于高并发应用可能不够。你需要修改MySQL配置。

1. 通过自定义my.cnf文件增加连接数：

   [mysqld] max_connections=1000

2. 挂载配置文件重启容器。
3. 注意：连接数增加会消耗更多内存。每个连接都会占用一定的缓冲区内存。你需要根据innodb_buffer_pool_size和系统总内存来合理设置max_connections。

问题：容器内MySQL性能感觉不如原生安装。原因与排查：

1. I/O性能：确保数据卷挂载的是宿主机本地SSD硬盘，而不是网络存储（如NFS）。使用docker run的--mount type=bind相比-v有时性能更优。
2. 内存与CPU限制：检查是否对容器做了过低的资源限制（--memory,--cpus）。数据库是资源敏感型应用，限制过紧会导致性能瓶颈。
3. 配置优化：默认配置很保守。根据你的机器配置，重点调整innodb_buffer_pool_size（通常设为系统内存的50%-70%）、innodb_log_file_size等参数。

6.3 数据迁移与版本升级

从物理机/虚拟机迁移到Docker容器：

1. 在旧服务器上，使用mysqldump进行全量逻辑备份。
2. 在新宿主机上，启动一个MySQL容器（配置好字符集等参数），并将数据卷挂载到空目录。
3. 容器首次启动初始化后，将备份的SQL文件通过docker cp复制到容器内，或通过管道用mysql命令恢复。
4. 更稳妥的方式是，将备份文件放在宿主机，挂载到容器的/docker-entrypoint-initdb.d/目录，然后使用一个全新的、未挂载过数据卷的容器来启动，让它自动执行恢复。恢复完成后，再将生成的数据目录备份出来，用于后续正式容器的挂载。

Docker内MySQL版本升级（如5.7升8.0）：这是一个高风险操作，务必先在测试环境演练并完整备份！

1. 停止旧版本容器。
2. 备份旧容器的数据卷（整个/var/lib/mysql对应的宿主机目录）。
3. 使用新版本镜像（如mysql:8.0）启动一个新容器，但先不要挂载旧的数据卷。让新容器自己初始化一个空的数据目录。
4. 参考官方升级文档，将备份的旧数据通过mysqldump逻辑备份的方式导出，再导入到新版本容器中。强烈不建议直接挂载旧数据卷到新版本容器，因为MySQL的数据文件格式在不同大版本间可能不兼容，直接挂载极易导致数据库损坏。
5. 导入后，在新容器中运行mysql_upgrade命令（如果官方镜像的启动脚本未自动执行的话），检查和升级系统表。
6. 全面测试应用连接和功能。

7. 安全加固与日常维护建议

将数据库放入容器并不意味着可以忽视安全。相反，你需要遵循“最小权限原则”来加固你的Docker MySQL实例。

1. 使用非root用户运行MySQL进程在docker run命令中，你可以通过-e环境变量指定一个普通用户来运行mysqld，但这通常由镜像内部处理。更关键的是，不要在应用中使用root用户连接数据库。

2. 创建专属应用账户永远不要让你的应用程序直接使用root账户。像我们在4.3节初始化脚本中做的那样，为每个应用创建独立的数据库和用户，并授予最小必要的权限。

CREATE USER 'app_user'@'application_container_ip' IDENTIFIED BY 'ComplexPassword123!'; GRANT SELECT, INSERT, UPDATE, DELETE ON `app_db`.* TO 'app_user'@'application_container_ip';

这里将‘application_container_ip’替换为你的应用容器的实际IP（在Docker网络中），或者使用‘%’（但风险较高）。

3. 保护环境变量在docker run或docker-compose.yml中明文书写密码是危险的。建议使用Docker Secrets（在Swarm模式下）或将密码放在.env文件中，通过--env-file参数加载。

# 创建.env文件 echo "MYSQL_ROOT_PASSWORD=SuperSecretRootPwd" > .env echo "MYSQL_USER_PASSWORD=AnotherSecretPwd" >> .env # 运行容器时引用 docker run -d --name mysql-secure --env-file .env ... mysql:8.0

在docker-compose.yml中，也可以使用env_file指令或secrets。

4. 定期更新镜像定期关注MySQL官方镜像的更新，特别是安全更新。使用具体的版本标签（如mysql:8.0.33），而不是latest。更新时，遵循“先测试，后生产”的原则，在新容器中测试无误后，再切换流量。

5. 日志管理MySQL容器会产生错误日志、慢查询日志等。建议将这些日志也通过卷挂载到宿主机，方便集中收集和分析（如使用ELK栈）。可以在my.cnf中配置日志路径，然后挂载出来。

[mysqld] slow_query_log = 1 slow_query_log_file = /var/log/mysql/slow.log log-error = /var/log/mysql/error.log

然后在docker run命令中添加挂载：-v /host/log/mysql:/var/log/mysql。

从最初的一条docker run命令，到如今考虑持久化、配置、安全、编排和监控，你会发现用Docker部署MySQL远不止是“安装”那么简单。它是一套完整的环境管理和交付思路。我个人的体会是，一旦习惯了这种容器化的方式，就很难再回到过去那种“污染”宿主机环境的手动安装模式了。它带来的环境一致性、快速复制和销毁的能力，对于需要频繁切换上下文、维护多个项目的开发者来说，效率提升是巨大的。最后一个小技巧是，善用docker-compose文件来记录你的服务配置，并把它纳入版本控制（记得排除密码等敏感信息），这将是你的项目中最有价值的文档之一。