Docker 环境搭建怎么从零部署前后端分离项目

胖瑶酱_9675

胖瑶酱_9675

2026-08-26

1027人浏览

原创

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

docker 环境搭建怎么从零部署前后端分离项目

从零用 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:

Docker Cli
Docker Cli

使用 Docker CLI 构建、运行、停止、检查和管理容器与镜像的助手。用于执行容器相关任务。

下载
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。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

docker

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2203

5

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

5830

13

后端的主要工作内容介绍
后端的主要工作内容介绍

后端是应用程序的服务端部分,负责核心任务,如数据库交互、业务逻辑处理和响应客户端请求。想了解更多后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

5126

10

k8s和docker区别
k8s和docker区别

k8s和docker区别有抽象层次不同、管理范围不同、功能不同、应用程序生命周期管理不同、缩放能力不同、高可用性等等区别。本专题为大家提供k8s和docker区别相关的各种文章、以及下载和课程。

2023.07.24

665

4

docker进入容器的方法有哪些
docker进入容器的方法有哪些

docker进入容器的方法:1. Docker exec;2. Docker attach;3. Docker run --interactive --tty;4. Docker ps -a;5. 使用 Docker Compose。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

4659

6

docker容器无法访问外部网络怎么办
docker容器无法访问外部网络怎么办

docker 容器无法访问外部网络的原因和解决方法:配置 nat 端口映射以将容器端口映射到主机端口。根据主机兼容性选择正确的网络驱动(如 host 或 overlay)。允许容器端口通过主机的防火墙。配置容器的正确 dns 服务器。选择正确的容器网络模式。排除主机网络问题,如防火墙或连接问题。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

5577

6

docker镜像有什么用
docker镜像有什么用

docker 镜像是预构建的软件组件,用途广泛,包括:应用程序部署:简化部署,提高移植性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

2093

7

Docker容器化部署与DevOps实践
Docker容器化部署与DevOps实践

本专题面向后端与运维开发者,系统讲解 Docker 容器化技术在实际项目中的应用。内容涵盖 Docker 镜像构建、容器运行机制、Docker Compose 多服务编排,以及在 DevOps 流程中的持续集成与持续部署实践。通过真实场景演示,帮助开发者实现应用的快速部署、环境一致性与运维自动化。

2026.02.11

219

16

Docker 容器部署
Docker 容器部署

本专题整合了Docker容器部署相关内容,阅读专题下面的文章了解更多详细操作教程。

2026.03.31

411

14

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpMyAdmin 安装文档
phpMyAdmin 安装文档

共0课时 | 0人学习

Docker 官方文档
Docker 官方文档

共0课时 | 0人学习

宝塔 Docker 模块使用手册
宝塔 Docker 模块使用手册

共0课时 | 0人学习