核心是三步:装docker环境、前后端分别容器化、用docker-compose统一编排并打通网络。具体包括卸载旧版docker、配置阿里云镜像源、安装引擎、启用开机自启、设置镜像加速;后端用openjdk镜像运行jar,前端用nginx-alpine托管dist并代理/api到backend服务;通过自定义bridge网络使服务名互通,避免localhost或宿主ip导致的econnrefused。

从零用 Docker 部署前后端分离项目,核心是分三步走:装好 Docker 环境、分别容器化前后端、再让它们网络互通并协同工作。不依赖本地开发环境,也不需要手动配服务器,整套流程可复现、易维护。
一、Docker 环境准备(Linux 云服务器为例)
以 CentOS 7/8 或 Ubuntu 20.04+ 为基准,执行以下命令快速安装并配置:
- 卸载旧版 Docker:
sudo yum remove docker docker-client docker-client-latest docker-common docker-latest docker-latest-logrotate docker-logrotate docker-engine - 配置阿里云镜像源加速拉取:
sudo yum-config-manager --add-repo https://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo - 安装 Docker 引擎及插件:
sudo yum install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin - 启动并设为开机自启:
sudo systemctl start docker && sudo systemctl enable docker - 配置国内镜像加速器(避免 pull 失败):
创建或编辑/etc/docker/daemon.json,填入:
{
"registry-mirrors": [
"https://docker.m.daocloud.io",
"https://docker.1panel.live"
]
}保存后执行 sudo systemctl daemon-reload && sudo systemctl restart docker 生效。
二、前后端各自容器化
前后端独立构建镜像,互不干扰。目录结构建议如下:
my-project/ ├── backend/ # Spring Boot jar 包 + Dockerfile ├── frontend/ # Vue/React 打包后 dist + Dockerfile + nginx.conf(可选) └── docker-compose.yml
后端(Spring Boot):在 backend/ 下放好 app.jar,新建 Dockerfile:
FROM openjdk:11-jre-slim ENV TZ=Asia/Shanghai RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone COPY app.jar /app.jar EXPOSE 8080 ENTRYPOINT ["java","-jar","/app.jar"]
构建命令:docker build -t my-backend .
前端(Vue/React):在 frontend/ 中确保已有 dist/ 目录(npm run build 产出),新建 Dockerfile:
FROM nginx:alpine COPY dist/ /usr/share/nginx/html/ COPY nginx.conf /etc/nginx/conf.d/default.conf # 自定义配置(如代理后端) EXPOSE 80
若需反向代理后端接口,nginx.conf 内写明:
location /api/ {
proxy_pass http://backend:8080/;
proxy_set_header Host $host;
}三、用 docker-compose 统一编排与网络打通
根目录下创建 docker-compose.yml,关键点在于:定义自定义网络、服务间用服务名通信、端口对外暴露清晰:
version: '3.8'
services:
backend:
image: my-backend
ports:
- "8080" # 容器内端口,不映射到宿主机(仅内部访问)
environment:
- SPRING_PROFILES_ACTIVE=docker
networks:
- mynet
<p>nginx:
image: my-frontend
ports:</p>
- "80:80" depends_on:
- backend networks:
- mynet
mysql: image: mysql:8.0 environment: MYSQL_ROOT_PASSWORD: 123456 MYSQL_DATABASE: ruoyi volumes:
- ./mysql-data:/var/lib/mysql networks:
- mynet
networks: mynet: driver: bridge
启动只需一条命令:docker-compose up -d。此时:
- 前端通过 Nginx 访问
http://你的服务器IP - Nginx 内部用
http://backend:8080转发 API 请求(不是 localhost,也不是宿主机 IP) - 后端 Java 应用连接 MySQL,配置中 host 填
mysql(即服务名),端口 3306
四、常见问题快速定位
前端调后端 404 或 ECONNREFUSED:检查三点
- Nginx 配置里
proxy_pass是否指向http://backend:8080(不是localhost或宿主机 IP) - 后端容器是否真的在
mynet网络中(docker inspect 容器名 | grep Networks) - 后端应用是否已监听
0.0.0.0:8080(非127.0.0.1:8080),Spring Boot 加server.address=0.0.0.0
MySQL 连不上:确认后端配置的 spring.datasource.url=jdbc:mysql://mysql:3306/xxx,且 mysql 是 compose 中的服务名。
静态资源 404:进 Nginx 容器查文件是否存在:docker exec -it 项目名-nginx-1 ls /usr/share/nginx/html。











