# Docker 容器环境完整打包与迁移实战指南

## 前言

在开发过程中，我们经常需要将配置好的开发环境（前端、后端、数据库）从一台电脑迁移到另一台电脑。本文记录了如何将一个包含前端（Vue + Vite）、后端（Flask）和 MySQL 的完整项目环境通过 Docker 进行打包和迁移的完整过程，以及遇到的问题和解决方案。

## 项目背景

项目包含以下组件：
- **前端**：Vue 3 + Vite，运行在端口 34568
- **后端**：Flask + vLLM，运行在端口 5000
- **数据库**：MySQL，运行在端口 3306

所有组件都运行在同一个 Docker 容器中。

## 一、环境同步问题

### 问题描述

在容器中运行 Flask 应用时遇到配置文件路径错误：

```bash
FileNotFoundError: [Errno 2] No such file or directory: '/home/ubuntu/vcis-front/moral-backend/resources/config/app_config.yaml'


本机代码已经修改，但容器内的代码没有同步更新。

方案一：使用 docker cp 复制文件（临时方案）

# 复制单个文件
docker cp /本机路径/app.py <容器ID>:/workspace/moral_backend-main/flask/app.py

# 复制整个目录
docker cp /本机路径/moral_backend-main/. <容器ID>:/workspace/moral_backend-main/


方案二：使用 Volume 挂载（推荐）

停止容器后重新运行，挂载本机目录：

docker run -d \
    -v /本机代码路径/moral_backend-main:/workspace/moral_backend-main \
    -p 5000:5000 \
    -p 34568:34568 \
    -p 3306:3306 \
    --name moral-backend \
    <镜像名>


这样本机的代码修改会实时同步到容器中。

方案三：修改代码使用相对路径（治本）

# 原代码
config = Config('/home/ubuntu/vcis-front/moral-backend/resources/config/app_config.yaml')

# 修改为相对路径
import os
config_path = os.path.join(os.path.dirname(__file__), '../resources/config/app_config.yaml')
config = Config(config_path)

# 或使用环境变量
config_path = os.getenv('CONFIG_PATH', './resources/config/app_config.yaml')
config = Config(config_path)


尝试使用 PM2 启动前端服务时报错：

# 安装 PM2
npm install -g pm2

# 启动前端服务
pm2 start "npm run dev -- --host 0.0.0.0 --port 34568" --name frontend


┌────┬─────────────┬─────────────┬─────────┬─────────┬──────────┬────────┬──────┬───────────┐
│ id │ name        │ namespace   │ version │ mode    │ pid      │ uptime │ ↺    │ status    │
├────┼─────────────┼─────────────┼─────────┼─────────┼──────────┼────────┼──────┼───────────┤
│ 0  │ frontend    │ default     │ N/A     │ fork    │ 1918     │ 3s     │ 3    │ online    │
│ 1  │ frontend    │ default     │ N/A     │ fork    │ 1883     │ 21s    │ 0    │ online    │
│ 2  │ frontend    │ default     │ N/A     │ fork    │ 1962     │ 0s     │ 0    │ online    │
└────┴─────────────┴─────────────┴─────────┴─────────┴──────────┴────────┴──────┴───────────┘


# 删除所有同名进程
pm2 delete frontend

# 或删除所有进程
pm2 delete all

# 重新启动单个进程
pm2 start "npm run dev -- --host 0.0.0.0 --port 34568" --name frontend

# 常用 PM2 命令
pm2 list              # 查看所有进程
pm2 logs frontend     # 查看日志
pm2 restart frontend  # 重启进程
pm2 stop frontend     # 停止进程
pm2 monit            # 监控面板


curl http://localhost:34568
# 返回正常的 HTML 页面


Docker 容器没有正确映射端口到宿主机。使用 

docker ps
# 如果没有看到 0.0.0.0:34568->34568/tcp，说明端口未映射


Docker 容器必须在创建时指定端口映射，无法在已运行的容器上添加。因此需要：

# 1. 提交当前容器为镜像
docker commit 2512765dce20 moral-all:v1

# 2. 停止当前容器
docker stop 2512765dce20

# 3. 重新运行容器，映射所有需要的端口
docker run -d \
    -p 34568:34568 \
    -p 5000:5000 \
    -p 3306:3306 \
    --name moral-backend \
    moral-all:v1 \
    /bin/bash -c "tail -f /dev/null"

# 4. 进入容器启动服务
docker exec -it moral-backend bash
cd /workspace/frontend
pm2 start "npm run dev -- --host 0.0.0.0 --port 34568" --name frontend


# 查看端口映射
docker port moral-backend

# 应该看到：
# 34568/tcp -> 0.0.0.0:34568
# 5000/tcp -> 0.0.0.0:5000
# 3306/tcp -> 0.0.0.0:3306

# 从宿主机测试
curl http://localhost:34568


// vite.config.js
export default {
  server: {
    host: '0.0.0.0',  // 重要！允许外部访问
    port: 34568,
    strictPort: true,
    hmr: {
      clientPort: 34568
    }
  }
}
 

方案一：直接导出镜像（适合单容器）

# 1. 提交容器为镜像
docker commit <容器ID> moral-all:v1

# 2. 导出镜像为 tar 文件
docker save -o moral-all-v1.tar moral-all:v1

# 3. 查看文件大小
ls -lh moral-all-v1.tar


# 导入镜像
docker load -i moral-all-v1.tar

# 运行容器
docker run -d \
    -p 34568:34568 \
    -p 5000:5000 \
    -p 3306:3306 \
    --name moral-backend \
    moral-all:v1


方案二：使用 Docker Compose（推荐）

version: '3.8'

services:
  mysql:
    image: mysql:8.0
    volumes:
      - ./mysql-data:/var/lib/mysql
      - ./mysql-init:/docker-entrypoint-initdb.d
    environment:
      MYSQL_ROOT_PASSWORD: your_password
      MYSQL_DATABASE: your_db
    ports:
      - "3306:3306"

  backend:
    build: ./backend
    volumes:
      - ./backend:/app
    ports:
      - "5000:5000"
    depends_on:
      - mysql
    environment:
      DB_HOST: mysql
      DB_USER: root
      DB_PASSWORD: your_password

  frontend:
    build: ./frontend
    volumes:
      - ./frontend:/app
    ports:
      - "34568:34568"
    depends_on:
      - backend


通过本次实践，我们完整地完成了一个多服务 Docker 环境的打包和迁移。关键要点包括：

Docker容器环境打包与迁移指南

通过本次实践，我们完整地完成了一个多服务 Docker 环境的打包和迁移。

开发工具

运维

后端

Docker容器环境完整打包迁移指南：详解Vue+Vite前端、Flask后端和MySQL数据库的容器化迁移方案，包含端口映射、PM2进程管理、数据备份恢复等实战技巧，解决路径同步、端口访问等常见问题，提供Docker Compose和镜像导出两种迁移方法，帮助开发者实现开发环境快速迁移部署。

数据备份与恢复

数据备份

数据丢失

数据库

容器

Docker

MySQL

Linux

11.11畅享AI算力 云启新增长

tencentdb-catalog

云数据库采购特惠，高性能、高可靠、高安全，超值优惠等你享！


文章

问答

视频

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

Docker容器环境打包与迁移指南

Docker容器环境打包与迁移指南

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐