Docker 网络与 Compose ：部署前后端分离项目（MySQL + Java + Nginx）

上一篇文章中学习了如何将 Java 应用打包成 Docker 镜像。但一个完整的项目往往需要多个容器协同工作比如应用容器、数据库容器、前端 Nginx 容器。本文将从 Docker 网络基础讲起通过自定义网络实现容器互联最后使用 Docker Compose 一键部署完整的前后端分离项目。一、Docker 网络基础1.1 默认网络bridge安装 Docker 后会自动创建一个名为bridge的虚拟网桥所有容器默认都会连接到这个网络。每个容器会分配一个虚拟 IP如172.17.0.2但容器之间不能通过容器名直接通信只能通过 IP 地址访问。# 1. 查看 MySQL 容器的 IP 地址dockerinspect mysql|grep-A5Networks# 2. 进入 Nginx 容器dockerexec-itnginxbash# 3. 在 Nginx 容器内ping MySQL 容器的 IP假设上一步查到的 IP 为 172.17.0.2ping172.17.0.21.2 自定义网络Docker 提供了自定义网络可以让容器通过容器名互相访问利用内置 DNS 解析。这对于微服务架构非常有用。查看默认网络dockernetworkls创建自定义网络dockernetwork create my-net查看网络详情dockernetwork inspect my-net将容器加入/移出网络dockernetwork connect my-net mysql# 将已有容器 mysql 加入 my-netdockernetwork disconnect my-net mysql# 移出在创建容器时指定网络dockerrun-d--namemyapp--networkmy-net myapp:latest二、容器互联实战Java 应用 MySQL假设我们已经有一个 Java 应用镜像demo-app构建过程参考上篇文章还有一个 MySQL 容器。我们希望通过自定义网络让它们互相通信。2.1 准备 MySQL 容器# 创建 MySQL 容器挂载数据卷并加入自定义网络dockerrun-d\--namemysql\-p3306:3306\-eTZAsia/Shanghai\-eMYSQL_ROOT_PASSWORD123\-v/root/mysql/data:/var/lib/mysql\-v/root/mysql/init:/docker-entrypoint-initdb.d\-v/root/mysql/conf:/etc/mysql/conf.d\--networkmy-net\mysql2.2 启动 Java 应用容器并加入同一网络dockerrun-d\--namedemo-app\-p8080:8080\--networkmy-net\demo-app:latest2.3 验证容器间通信进入 Java 应用容器尝试 ping MySQL 容器需确保容器内安装了 pingdockerexec-itdemo-appbash# 如果容器内没有 ping可先安装Debian/Ubuntu 系aptupdateaptinstalliputils-ping-ypingmysql如果网络配置正确应该能 ping 通三、部署完整项目Java MySQL Nginx部署一个完整的前后端分离项目后端 Java 应用demo-app提供 REST API前端 Nginx 作为静态资源服务器和反向代理将 API 请求转发到后端MySQL 数据库这里假设你已经有一个可运行的 Java 应用 jar 包例如demo-app.jar。3.1 准备项目文件假设项目目录结构如下/root/ ├── demo-app/ │ ├── Dockerfile │ └── target/ │ └── demo-app.jar ├── mysql/ │ ├── data/ 空目录用于挂载数据 │ ├── init/ 初始化 SQL 脚本 │ └── conf/ 自定义配置文件 └── nginx/ ├── nginx.conf Nginx 配置文件 └── html/ 前端静态文件3.2 构建后端镜像cd/root/demo-appdockerbuild-tdemo-app.Dockerfile 示例参考上篇文章FROM openjdk:11.0-jre-buster COPY target/demo-app.jar /app.jar ENTRYPOINT [java, -jar, /app.jar]3.3 准备 Nginx 配置nginx.conf中需要配置反向代理将 API 请求转发到后端容器注意容器名demo-app要与实际容器名一致location /api/ { proxy_pass http://demo-app:8080/; # 后端容器名 }3.4 手动启动所有容器不使用 Compose# 1. 创建网络dockernetwork create demo-net# 2. 启动 MySQLdockerrun-d\--namemysql\-p3306:3306\-eMYSQL_ROOT_PASSWORD123\-v/root/mysql/data:/var/lib/mysql\-v/root/mysql/init:/docker-entrypoint-initdb.d\-v/root/mysql/conf:/etc/mysql/conf.d\--networkdemo-net\mysql# 3. 启动后端应用dockerrun-d\--namedemo-app\-p8080:8080\--networkdemo-net\demo-app# 4. 启动 Nginx挂载配置和静态文件dockerrun-d\--namenginx\-p18080:18080\-p18081:18081\-v/root/nginx/nginx.conf:/etc/nginx/nginx.conf\-v/root/nginx/html:/usr/share/nginx/html\--networkdemo-net\nginx⚠️注意事项启动时容器名重复会报错确保名称唯一如果端口冲突可以考虑移除旧容器docker rm -f nginxNginx 配置中的proxy_pass地址要使用容器名http://demo-app:8080而不是 IP3.5 验证项目浏览器访问前端页面http://虚拟机IP:18080API 测试根据你的应用实际提供的接口路径访问例如http://虚拟机IP:18080/search/list?pageNo1pageSize5如果一切正常前后端和数据库能够协同工作。说明本文在写作时将项目名称统一为demo-app以保持示例通用性。截图中的项目名称可能为实际学习时的名称如 hmall不影响对操作步骤的理解。四、使用 Docker Compose 一键部署Docker Compose 是用于定义和运行多容器 Docker 应用程序的工具。手动启动多个容器比较繁琐Docker Compose 可以通过一个docker-compose.yml文件定义所有服务和网络实现一键启动。4.1 编写 docker-compose.yml在项目根目录如/root创建docker-compose.yml以下 docker-compose.yml 配置基于学习项目整理已改为通用示例读者可根据自己的实际项目调整。version:3.8services:mysql:image:mysql:latestcontainer_name:mysqlports:-3306:3306environment:TZ:Asia/ShanghaiMYSQL_ROOT_PASSWORD:123volumes:-./mysql/conf:/etc/mysql/conf.d-./mysql/data:/var/lib/mysql-./mysql/init:/docker-entrypoint-initdb.dnetworks:-demo-netdemo-app:build:./demo-app# 指定 Dockerfile 所在目录container_name:demo-appports:-8080:8080networks:-demo-netdepends_on:-mysqlnginx:image:nginx:latestcontainer_name:nginxports:-18080:18080-18081:18081volumes:-./nginx/nginx.conf:/etc/nginx/nginx.conf-./nginx/html:/usr/share/nginx/htmlnetworks:-demo-netdepends_on:-demo-appnetworks:demo-net:name:demo-app说明build指定镜像构建目录Docker Compose 会自动构建镜像depends_on控制启动顺序但不保证服务就绪仅等待容器启动networks所有服务加入同一自定义网络通过服务名即可互相访问4.2 使用 Compose 启动# 在 docker-compose.yml 所在目录执行dockercompose up-d-d表示后台运行。常用命令命令说明docker compose up -d启动所有服务后台docker compose down停止并移除所有容器、网络docker compose ps列出当前项目的容器状态docker compose logs -f service查看指定服务的日志docker compose stop停止所有服务不删除容器docker compose start启动已停止的服务4.3 验证部署# 查看运行中的容器dockercomposeps# 查看日志dockercompose logs-fdemo-app访问前端页面和 API确认功能正常。4.4 清理dockercompose down此命令会移除所有容器和网络但不会删除数据卷MySQL 数据仍在./mysql/data中。⚠️注意若使用 docker-compose down -v 会同时删除数据卷注意数据安全。五、常见问题5.1 Maven 编译报错Java 版本不兼容在打包项目时可能遇到类似错误java.lang.NoSuchFieldError: Class com.sun.tools.javac.tree.JCTree$JCImport does not have member field com.sun.tools.javac.tree.JCTree qualid原因项目使用的 Java 版本与 Maven 编译器插件版本不兼容。解决调整项目 JDK 版本或在pom.xml中指定合适的编译器插件版本。mvn clean package-DskipTests也可临时跳过单元测试打包5.2 容器名冲突启动时提示Conflict. The container name /nginx is already in use解决先停止并删除旧容器dockerrm-fnginx5.3 Nginx 无法访问后端502 Bad Gateway检查 Nginx 配置中的proxy_pass是否使用了正确的容器名确保后端容器与 Nginx 在同一个自定义网络中检查后端服务是否正常运行docker logs demo-app5.4 Compose 中depends_on的局限性depends_on只保证容器启动顺序但不保证服务已经就绪例如 MySQL 可能还在初始化。对于需要等待数据库就绪的场景可以使用脚本如wait-for-it或使用更高级的工具如docker-compose-wait。六、总结通过本文可学习Docker 网络基础及自定义网络的创建通过自定义网络实现容器间通过容器名通信手动部署前后端分离项目MySQL Java Nginx使用 Docker Compose 简化多容器编排常见问题的解决方法Docker Compose 是本地开发和测试多容器应用的高效工具也是走向容器编排如 Kubernetes的必经之路。掌握了这些技能就可以轻松地将任何复杂项目容器化实现“一次构建随处运行”。参考资料https://www.bilibili.com/video/BV1S142197x7/?p22https://docs.docker.com/network/https://docs.docker.com/compose/https://hub.docker.com/_/mysqlhttps://github.com/vishnubob/wait-for-it