Windows Docker 最佳实践分享

1. 网络加速

Docker Desktop：Settings -> Resources -> Proxies -> ✅ Manual proxy configuration

镜像

2. 部署方式及路径统一

通过 docker compose 的方式进行部署，所有的compose.yml以及容器的数据都存储在一个文件夹下的不同 container 名称对应的文件夹下面，最终生成大概如下的数据结构：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
📂docker
├── 📂allinone
│   └── 📄compose.yml
├── 📂allinone_format
│   ├── 📄compose.yml
│   └── config
├── 📂ddns-go
│   └── 📄compose.yml
├── 📂moviepilot
│   ├── 📄compose.yml
│   ├── 📂config
│   └── 📂core
├── 📂portainer-ce
│   ├── 📄compose.yml
│   └── 📂data
├── 📂qbittorrent
│   ├── 📂appdata
│   └── 📄compose.yml
└── 📂qinglong
    ├── 📄compose.yaml
    └── 📂data

另外，我这里遇到的问题比较特殊，这里也列举出来，我是在 Win11 安装的 Docker Desktop，然后出于一些原因又安装了WSL2（ Ubuntu 24.04.1 LTS）并且集成了 WSL integration，然后在 WSL 上面部署了一些 Docker 项目，这就导致了我的 compose.yml 很乱，绝对路径和相对路径两种写法混杂，另外 windows 的路径和 Ubuntu 的路径也都有，很不方便未来的迁移，于是我统一了 compose 文件中关于路径的处理，相关的流程如下：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
### 在 Windows PowerShell（管理员权限）中执行
mkdir C:\opt\docker
[Environment]::SetEnvironmentVariable("DOCKER_DIR", "C:\opt\docker", "User")

### 在 WSL 终端中执行
echo 'export DOCKER_DIR="/mnt/c/opt/docker"' >> ~/.bashrc
source ~/.bashrc

### WSL中执行迁移（假设原WSL项目在 /home/kiwi4814/docker/ ）
sudo rsync -avh --progress /home/kiwi4814/docker/ /mnt/c/opt/docker/
sudo rm -rf ~/docker

### 在 Windows 验证迁移结果
dir C:\opt\docker

### 修改 compose.yml 文件
volumes:
  - "${DOCKER_DIR}/project_name/config:/config"
  - "${DOCKER_DIR}/project_name/data:/data"
  - "${DOCKER_DIR}/common:/shared"
  
### 验证 - windows
cd C:\opt\docker\project_name
docker-compose up -d
docker exec moviepilot cmd /c "dir C:\config"

### 验证 - WSL
cd /mnt/c/opt/docker/moviepilot
docker-compose up -d
docker exec -it moviepilot ls /config

### Docker项目迁移并重启
# 清理旧容器（保留数据卷）
docker compose down
# 这里是更新的命令，不更新则不执行
docker-compose pull
# 强制重建容器（使用新配置）
docker compose up -d --force-recreate
# 查看启动日志
docker-compose logs -f --tail=100