用 Docker 一键启动隔离的 Node.js + MySQL 开发环境：通过 docker-compose.yml 编排，MySQL 挂载卷持久化数据并自动建库，Node.js 服务与 MySQL 同网络、以服务名互连，5 分钟内完成部署且避免端口冲突、认证失败等常见坑。
直接用 Docker 启动一个隔离、开箱即用的 Node.js + MySQL 开发环境，5 分钟内就能跑起来，不需要本地装 MySQL、配环境变量、调端口冲突。关键不是“能不能搭”，而是“怎么搭得干净、可复用、不踩坑”。
一步拉起 MySQL 容器（带数据持久化）
别用 docker run -it mysql 临时跑着玩——关掉容器数据就没了。真正开发要用挂载卷 + 环境变量预设：
- 执行命令启动带持久化的 MySQL 实例：
docker run -d --name mysql-dev -p 3306:3306 -e MYSQL_ROOT_PASSWORD=dev123 -v mysql-data:/var/lib/mysql -e MYSQL_DATABASE=myapp mysql:8.0 - mysql-data 是 Docker 卷名，自动创建并保存所有数据库文件，删容器也不丢数据
- 加
-e MYSQL_DATABASE=myapp会自动建好库，省去进容器手动CREATE DATABASE - 首次启动后，可用
docker exec -it mysql-dev mysql -uroot -pdev123 -D myapp直接连进去验证
Node.js 服务直连容器内 MySQL
本地 Node.js 项目不用改代码逻辑，只需把数据库连接地址从 localhost 换成容器名 mysql-dev ——前提是它们在同一个 Docker 网络里：
minimax-mcp-docker版（适配极空间）
下载
MiniMax 图片理解 + 网络搜索 MCP 工具。适配 Docker 环境（极空间等），支持图片 OCR 识别、图像内容理解、网络搜索。API Key 安全存储在本地 credentials 文件，不暴露在代码中。
- 先创建自定义网络：
docker network create node-mysql-net - 把 MySQL 加入该网络：
docker network connect node-mysql-net mysql-dev - 运行你的 Node.js 服务时也指定同一网络，并用
--link或环境变量传地址：docker run -d --name node-api --network node-mysql-net -p 3000:3000 -e DB_HOST=mysql-dev -e DB_USER=root -e DB_PASS=dev123 your-node-app - Node.js 代码中连接字符串写成：
mysql://root:dev123@mysql-dev:3306/myapp（注意：host 是容器名，不是 localhost）
用 Docker Compose 一键编排整套环境
手动敲一堆 docker run 容易漏参数、难维护。推荐直接写 docker-compose.yml，三行配置搞定协同启动：
- 示例最小配置：
version: '3.8'<br>services:<br> db:<br> image: mysql:8.0<br> environment:<br> MYSQL_ROOT_PASSWORD: dev123<br> MYSQL_DATABASE: myapp<br> volumes:<br> - mysql-data:/var/lib/mysql<br> ports:<br> - "3306:3306"<br><br> app:<br> build: .<br> environment:<br> DB_HOST: db<br> DB_USER: root<br> DB_PASS: dev123<br> ports:<br> - "3000:3000"<br> depends_on:<br> - db<br><br>volumes:<br> mysql-data:
- 存好文件后，终端执行
docker-compose up -d，MySQL 和 Node.js 自动按依赖顺序启动 - 前端请求后端时，后端通过
db这个服务名就能访问 MySQL，完全不用管 IP
常见问题快速绕过
实际操作中最常卡在这几个点，提前知道就能少查一小时文档：
-
连接被拒绝？ 检查 Node.js 服务是否监听
0.0.0.0:3000而非127.0.0.1:3000（Docker 容器外无法访问 localhost） -
报错 “Client does not support authentication protocol”？ MySQL 8 默认用
caching_sha2_password，Node.js 的 mysql2 驱动旧版本不兼容，启动容器时加参数：-e default_authentication_plugin=mysql_native_password -
数据初始化脚本没执行？ 把
.sql文件放进/docker-entrypoint-initdb.d/目录（通过volumes挂载），MySQL 启动时会自动执行 - 想快速验证整套流程？ 直接上 InsCode（快马）平台选 “MySQL+Node.js 快速启动模板”，生成即用的全栈项目，含 Swagger 文档和 React 管理后台，适合创意验证阶段
