Linux Docker Compose 部署.NET+Vue+MySQL+Redis+Nginx 完整记录（亲测无坑）

写在前面为什么用 Docker Compose比单容器部署好在哪做容器化部署时单靠docker run命令逐个启动 MySQL、Redis、后端、Nginx 容器会非常繁琐 —— 不仅要记大量命令参数还得手动控制容器启动顺序、配置网络联动一旦服务器重启所有容器要重新逐个启动维护成本极高。Docker Compose是 Docker 官方的多容器编排工具核心是通过一个docker-compose.yml配置文件集中管理所有容器的镜像、端口、挂载、环境变量、网络、依赖关系等所有配置能完美解决单容器部署的痛点。Docker Compose 核心优点也是本次部署选择它的原因一键启停一条docker-compose up -d启动所有服务docker-compose down停止并清理无需逐个执行docker run/docker stop配置统一所有容器配置集中在一个 yaml 文件易编辑、易备份后续修改只需改配置文件无需记复杂命令容器自动联动自动创建专属网络容器间通过服务名即可通信无需手动配置网络可通过depends_on控制启动顺序解决服务依赖问题环境一致性配置文件可跨环境复用本地测试、服务器部署用同一套配置避免 “本地能跑服务器不行”易维护易迁移项目目录 配置文件 离线镜像包可直接迁移到其他服务器解压后一键启动无需重新配置数据卷 / 网络自动管理自动创建数据卷、自定义网络无需手动执行docker volume create/docker network create。相比单容器部署Docker Compose 让多服务容器化部署的效率提升数倍尤其适合后端 前端 数据库 缓存 代理这类多组件的项目部署也是目前中小型项目容器化的主流方案。一、部署环境准备提前确认避免后续兼容问题1. 虚拟机环境个人测试用非生产系统CentOS 7.9最小化安装已配置静态 IP192.168.1.100虚拟 IP替换真实 IP内存4G建议不低于 2G否则 Docker 容器启动可能卡顿硬盘50G足够存放镜像、项目文件和数据库数据网络能访问外网前期拉取镜像 / 安装依赖用后期可断网运行2. 软件版本全程统一版本避免兼容问题DockerDocker CE 24.0.7CentOS7 稳定版Docker ComposeV2.27.1解决旧版配置兼容问题后端.NET 8本地 VS2022 发布到 publish 文件夹前端Vue3本地 yarn 打包到 dist 文件夹MySQL8.0Docker 镜像数据持久化Redis7-alpine轻量版适合容器部署Nginxalpine轻量版代理前端静态文件 后端接口3. 本地准备文件提前打包好上传到虚拟机后端publish 文件夹VS2022 发布后的.NET8 项目文件含核心 dll、配置文件前端dist 文件夹Vue3 打包后的静态文件含 index.html、css、js镜像 tar 包rdif-all-images.tar离线镜像包含 MySQL、Redis、Nginx 等 6 个所需镜像解决网络拉取超时配置文件my.cnfMySQL 配置、nginx.confNginx 配置、init.sqlMySQL 初始化 SQL、docker-compose.yml核心编排文件二、前期准备工作必做奠定部署基础1. CentOS7 系统基础配置最小化安装补充依赖最小化安装的 CentOS7 缺少很多基础工具先安装必要依赖避免后续 Docker 安装、命令执行失败# 更新系统软件包可选建议执行避免依赖版本过低 yum update -y # 安装基础工具wget、vim、net-tools等后续常用 yum install -y wget vim net-tools epel-release2. 安装 Docker CECentOS7 稳定版步骤固定CentOS7 默认源没有 Docker需要配置 Docker 官方源同时解决依赖缺失问题重点解决 container-selinux 依赖# 1. 卸载旧版本Docker如果之前装过避免冲突没装过可跳过 yum remove -y docker docker-client docker-client-latest docker-common docker-latest docker-latest-logrotate docker-logrotate docker-engine # 2. 安装Docker依赖必做否则安装失败 yum install -y yum-utils device-mapper-persistent-data lvm2 container-selinux # 3. 配置Docker官方源 yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo # 4. 安装Docker CE稳定版 yum install -y docker-ce docker-ce-cli containerd.io # 5. 启动Docker服务并设置开机自启提前配置后续不用再改 systemctl start docker systemctl enable docker # 6. 验证Docker安装成功输出版本号即成功 docker --version✅ 成功标识Docker version 24.0.7, build afdd53b3. 配置 Docker 镜像加速国内必做否则镜像拉取超时Docker 默认拉取官方镜像国外源国内访问极慢甚至超时。这里用阿里云个人专属镜像加速比公共源更稳定步骤如下登录阿里云官网https://www.aliyun.com/搜索 “容器镜像服务”进入 “镜像加速器”复制自己的专属加速地址示例https://xxxxxx.mirror.aliyuncs.com替换成自己的配置镜像加速修改 Docker 守护进程配置文件# 创建Docker配置目录如果不存在 mkdir -p /etc/docker # 写入加速配置替换成自己的阿里云专属加速地址 tee /etc/docker/daemon.json -EOF { registry-mirrors: [https://xxxxxx.mirror.aliyuncs.com, https://mirror.ccs.tencentyun.com] } EOF # 重新加载配置重启Docker让加速生效 systemctl daemon-reload systemctl restart docker # 验证加速配置是否生效输出配置的加速地址即成功 docker info | grep -A 2 Registry Mirrors✅ 成功标识输出中包含自己配置的阿里云加速地址。4. 升级 Docker Compose解决旧版配置兼容问题CentOS7 默认安装的 Docker Compose 是 1.x 版本不支持新版 docker-compose.yml 中的配置如 condition、start_period升级到 V2 版本官方推荐# 1. 删除旧版docker-compose如果之前装过 rm -f /usr/local/bin/docker-compose # 2. 安装Docker Compose V2插件形式稳定 yum install -y docker-compose-plugin # 3. 建立软链接保持docker-compose命令可用和旧版用法一致 ln -s /usr/libexec/docker/cli-plugins/docker-compose /usr/local/bin/docker-compose # 4. 验证升级成功输出V2版本号即成功 docker-compose --version✅ 成功标识Docker Compose version v2.27.1版本号可不同5. 关闭防火墙测试环境避免端口访问失败个人测试用直接关闭 CentOS7 的 FirewallD 防火墙避免前端、后端、数据库端口被拦截生产环境可按需开放端口# 1. 立即停止防火墙服务 systemctl stop firewalld # 2. 禁止防火墙开机自启避免虚拟机重启后防火墙又开启 systemctl disable firewalld # 3. 验证防火墙状态输出inactive即成功关闭 systemctl status firewalld三、项目目录结构整理规范目录避免后续混乱将本地准备好的所有文件上传到 CentOS7 虚拟机的/root/rdif-docker目录自定义目录方便记忆最终目录结构如下重点前后端仅保留打包 / 发布文件无源码、无多余文件rdif-docker/ # 项目根目录所有文件都放在这里 ├── docker-compose.yml # 核心编排文件管理所有容器 ├── backend/ # 后端目录仅保留VS发布的publish │ └── publish/ # .NET8发布文件含RDIF.WebHost.dll、appsettings.json ├── frontend/ # 前端目录仅保留Vue3打包的dist │ └── dist/ # Vue3静态文件index.html、css、js、assets ├── nginx/ # Nginx配置目录 │ └── nginx.conf # Nginx配置文件代理前端后端接口 ├── mysql/ # MySQL配置目录 │ ├── my.cnf # MySQL配置不区分大小写、字符集等 │ └── init.sql # MySQL初始化SQL创建库、表、初始化数据 └── rdif-all-images.tar # 离线镜像包含所有所需镜像避免拉取超时上传文件方法新手推荐可视化操作用 MobaXterm或Xftp 或 WinSCP 工具连接虚拟机IP192.168.1.100账号root密码Root123456虚拟密码将本地的 publish、dist、配置文件、镜像 tar 包拖到对应目录下即可。四、编写 docker-compose.yml核心配置重中之重这是整个部署的核心所有容器MySQL、Redis、后端、Nginx的联动、端口映射、目录挂载都在这里配置。结合本次需求前后端已打包 / 发布无需编译构建编写如下配置注释详细可直接复制修改替换自己的对应信息Redis 密码已替换为通用虚拟密码version: 3.8 # 所有服务的集合 services: # 1. MySQL8 服务数据库数据持久化 mysql: image: mysql:8.0 # 使用的镜像本地已导入无需拉取 container_name: rdif-mysql # 自定义容器名方便管理 restart: always # 容器异常退出/ Docker启动时自动重启 environment: MYSQL_ROOT_PASSWORD: Root123456 # MySQL root密码虚拟替换成自己的 MYSQL_USER: guosisoft # 项目访问MySQL的用户名自定义 MYSQL_PASSWORD: Mysql123456 # 项目访问MySQL的密码虚拟 MYSQL_DATABASE: rdif_vue3 # 项目所用数据库名自定义 MYSQL_TZINFO_TO_SYS_TABLES: 1 # 初始化MySQL时区表解决时差问题 TZ: Asia/Shanghai # 强制容器时区为东八区核心解决时差 ports: - 3306:3306 # 端口映射宿主机3306 → 容器内3306本地工具可连接 volumes: # 挂载MySQL配置文件实现自定义配置 - ./mysql/my.cnf:/etc/mysql/conf.d/my.cnf # 挂载初始化SQL容器启动时自动执行创建库表 - ./mysql/init.sql:/docker-entrypoint-initdb.d/init.sql # 挂载数据卷持久化MySQL数据docker-compose down不会删除数据 - mysql-data:/var/lib/mysql # 挂载宿主机时区文件双重保障时区同步只读避免容器修改 - /etc/localtime:/etc/localtime:ro - /etc/timezone:/etc/timezone:ro command: --lower_case_table_names1 # MySQL不区分大小写避免项目表名大小写问题 networks: - rdif-network # 加入自定义网络实现容器间通信 # 健康检查检测MySQL是否真正就绪避免后端启动早于MySQL healthcheck: test: [CMD, mysqladmin, ping, -h, localhost, -uguosisoft, -pMysql123456] interval: 5s # 每5秒检测一次 timeout: 30s # 超时时间30秒 retries: 10 # 重试10次失败则认为容器未就绪 start_period: 20s # 容器启动后延迟20秒开始检测 # 2. Redis 服务缓存轻量版密码已替换为虚拟通用密码 redis: image: redis:7-alpine # 轻量版Redis占用资源少 container_name: rdif-redis # 自定义容器名 restart: always # 自动重启 ports: - 6379:6379 # 端口映射宿主机6379 → 容器内6379 volumes: - redis-data:/data # 数据卷持久化Redis数据 command: redis-server --requirepass Redis123456 # Redis虚拟密码替换成自己的复杂密码 networks: - rdif-network # 加入自定义网络 environment: TZ: Asia/Shanghai # 同步东八区时区 # 3. .NET8 后端服务已发布直接挂载运行Redis连接密码同步替换 backend: image: mcr.microsoft.com/dotnet/aspnet:8.0 # .NET8运行时镜像无需构建 container_name: rdif-backend # 自定义容器名 restart: always # 自动重启 ports: - 58588:58588 # 端口映射宿主机58588 → 容器内58588后端接口端口 depends_on: mysql: condition: service_healthy # 仅在MySQL健康检查通过就绪后才启动后端 redis: condition: service_started # Redis启动后即可启动后端 volumes: # 核心挂载本地publish到容器的/app目录 - ./backend/publish:/app # 宿主机/wwwroot/Resources → 容器内/wwwroot/Resources - /wwwroot/Resources:/wwwroot/Resources environment: TZ: Asia/Shanghai # 同步东八区时区 ASPNETCORE_URLS: http://*:58588 # 强制.NET8容器内监听58588端口解决端口不通 ASPNETCORE_ENVIRONMENT: Production # .NET环境生产环境 # MySQL连接字符串替换成自己的用户名、密码、数据库名server用容器名mysql ConnectionStrings__MySQL: servermysql;port3306;databaserdif_vue3;userguosisoft;passwordMysql123456;charsetutf8mb4;AllowPublicKeyRetrievalTrue;SslModeNone # Redis连接字符串server用容器名redis密码同步替换为虚拟密码 ConnectionStrings__Redis: redis:6379,passwordRedis123456,defaultDatabase0,sslfalse,abortConnectfalse working_dir: /app # 容器工作目录指向挂载的publish目录 entrypoint: [dotnet, RDIF.WebHost.dll] # 启动后端核心dll替换成自己的dll名 networks: - rdif-network # 加入自定义网络 # 4. Nginx 服务代理前端静态文件后端接口 nginx: image: nginx:alpine # 轻量版Nginx container_name: rdif-nginx # 自定义容器名 restart: always # 自动重启 ports: - 6866:6866 # 端口映射宿主机6866 → 容器内6866前端访问端口 volumes: # 挂载Nginx配置文件实现前端代理和接口转发 - ./nginx/nginx.conf:/etc/nginx/nginx.conf # 挂载前端dist目录Nginx直接代理静态文件核心 - ./frontend/dist:/usr/share/nginx/html depends_on: - backend # 后端启动后再启动Nginx networks: - rdif-network # 加入自定义网络 environment: TZ: Asia/Shanghai # 同步东八区时区 # 数据卷持久化MySQL和Redis数据docker-compose down不会删除 volumes: mysql-data: redis-data: # 自定义网络所有容器加入同一网络实现容器间通信用容器名即可访问 networks: rdif-network: driver: bridge关键配置说明必看避免踩坑所有容器都配置了restart: always配合 Docker 开机自启实现虚拟机重启后所有服务自动启动后端配置ASPNETCORE_URLS: http://*:58588强制监听 58588 端口和端口映射一致解决.NET8 默认监听 8080 导致的端口不通MySQL 连接字符串中servermysql用容器名而非虚拟机 IP容器间通信必须这样配置补充AllowPublicKeyRetrievalTrue;SslModeNone解决容器内连接 MySQL 失败所有容器都配置TZ: Asia/Shanghai同步东八区时区解决 MySQL 时差 8 小时问题后端depends_on配置了condition: service_healthy确保 MySQL 完全就绪后再启动后端避免后端启动时 MySQL 未初始化完成导致的连接失败所有敏感密码MySQL/Redis均为虚拟示例实际部署请替换为字母 数字 特殊符号的复杂密码提升安全性。五、本地拉取镜像并打包为 tar离线方案前置步骤关键本次部署采用离线镜像导入方案解决服务器网络拉取超时问题需在本地能正常联网的电脑上提前拉取所有所需镜像再打包为 tar 文件最后上传到 CentOS 服务器。5.1 本地拉取镜像的前提条件本地电脑Windows/macOS需安装Docker DesktopDocker 桌面版内置 Docker 引擎和镜像管理功能是本地操作 Docker 的必备工具下载地址https://www.docker.com/products/docker-desktop/安装后验证打开 Docker Desktop启动后在本地终端CMD/PowerShell/ 终端执行docker --version输出版本号即安装成功关键设置Docker Desktop 中配置镜像加速和服务器端一致阿里云 / 网易云均可避免本地拉取镜像超时。5.2 本地终端拉取本次部署所有所需镜像打开本地终端Windows 用 PowerShell/CMDmacOS/Linux 用终端执行以下docker pull命令逐个拉取镜像按本次部署的版本号拉取确保版本一致# 1. 拉取MySQL8.0镜像 docker pull mysql:8.0 # 2. 拉取Redis7轻量版镜像 docker pull redis:7-alpine # 3. 拉取.NET8运行时镜像后端运行依赖 docker pull mcr.microsoft.com/dotnet/aspnet:8.0 # 4. 拉取Nginx轻量版镜像 docker pull nginx:alpine✅ 拉取成功验证本地终端执行docker images能看到以上 4 个镜像无报错即拉取完成。5.3 本地将镜像打包为 tar 文件单镜像 / 批量镜像两种方式打包镜像有单镜像打包和批量镜像打包两种方式推荐批量打包为一个 tar 文件方便上传和服务器导入以下两种方式均提供代码示例。方式 1批量打包所有镜像为一个 tar 文件推荐一次导入所有将所有拉取的镜像打包为一个统一的 tar 文件示例rdif-all-images.tar放在本地易找到的目录如桌面执行命令前先切换到目标目录如 Windows 桌面目录# Windows PowerShell切换到桌面目录示例可替换为自己的目录 cd C:\Users\你的用户名\Desktop # 批量打包镜像为rdif-all-images.tar核心命令包含所有所需镜像 docker save -o rdif-all-images.tar mysql:8.0 redis:7-alpine mcr.microsoft.com/dotnet/aspnet:8.0 nginx:alpine关键参数-o指定输出的 tar 文件名和路径后面跟所有需要打包的镜像名版本用空格分隔。方式 2单个镜像单独打包按需使用适合单独更新镜像如果后续只需更新某个镜像如仅更新 MySQL可单独打包该镜像命令如下# 打包MySQL8.0为单独的tar文件 docker save -o mysql_8.0.tar mysql:8.0 # 打包Redis7-alpine为单独的tar文件 docker save -o redis_7_alpine.tar redis:7-alpine # 打包.NET8运行时为单独的tar文件 docker save -o dotnet_aspnet_8.0.tar mcr.microsoft.com/dotnet/aspnet:8.0 # 打包Nginx-alpine为单独的tar文件 docker save -o nginx_alpine.tar nginx:alpine5.4 验证本地打包成功打包完成后在本地目标目录如桌面能看到生成的 tar 文件如 rdif-all-images.tar文件大小约 2-3G正常大小即打包成功后续用 MobaXterm/Xftp/WinSCP 将该 tar 文件上传到 CentOS 服务器的/root/rdif-docker目录即可。六、服务器端核心部署步骤离线导入镜像 启动服务6.1 离线导入镜像解决网络拉取超时核心步骤将本地打包好的镜像 tar 文件上传到服务器后执行以下命令离线导入无需再联网拉取# 1. 进入项目根目录确保镜像tar包在该目录下 cd /root/rdif-docker # 2. 查看镜像tar包是否存在能看到rdif-all-images.tar即正常 ls -l # 3. 离线导入所有镜像耐心等待约1-2分钟镜像包约2-3G docker load -i rdif-all-images.tar # 4. 验证镜像导入成功能看到4个所需镜像即正常 docker images✅ 成功标识docker images输出中包含mysql:8.0、redis:7-alpine、nginx:alpine、mcr.microsoft.com/dotnet/aspnet:8.0等镜像。6.2 启动所有服务核心命令一键启动所有配置和准备工作完成后执行以下命令一键启动所有容器无需手动逐个启动# 进入项目根目录必须在docker-compose.yml所在目录执行 cd /root/rdif-docker # 后台启动所有服务-d后台运行无需构建因为前后端已打包 docker-compose up -d # 查看所有服务运行状态所有服务State列显示Up即正常 docker-compose ps✅ 成功标识docker-compose ps输出中mysql、redis、backend、nginx 四个服务的 State 列均为Up (healthy)或Up。6.3 验证服务启动成功逐个验证确保无问题启动后逐个验证前端、后端、数据库、Redis 是否正常避免后续使用时出现问题1验证后端服务Swagger 访问核心.NET8 后端默认集成 Swagger访问地址http://192.168.1.100:58588/swagger/index.html替换成自己的虚拟机 IP 和后端端口✅ 成功标识浏览器能正常打开 Swagger 页面无报错能看到所有接口❌ 失败排查如果打不开执行docker-compose logs -f backend查看后端实时日志排查问题如端口监听错误、MySQL 连接失败。2验证前端服务静态页面访问