主题
Windows WSL2 安装部署
在 Windows 电脑上，ComfyCarry 通过 WSL2（Windows 的 Linux 子系统）运行 Linux 容器，并直接使用 Windows 显卡驱动提供的 NVIDIA GPU。准备好 Ubuntu WSL2 与 Windows 显卡驱动后，你可以选择使用图形界面的 Docker Desktop，或直接在 Ubuntu 内管理 Docker Engine。硬件与空间要求见部署前准备。
安装 Ubuntu WSL2
以管理员身份打开 PowerShell：
powershell
wsl --install -d Ubuntu按提示重启 Windows。第一次打开 Ubuntu 时，设置 Linux 用户名和密码；随后回到 PowerShell 更新 WSL，并确认 Ubuntu 使用 WSL2：
powershell
wsl --update
wsl --list --verbose列表中 Ubuntu 的 VERSION 应显示为 2。如果显示为 1，使用列表中的发行版名称执行转换，例如：
powershell
wsl --set-version Ubuntu 2在 Windows 中安装支持 WSL2 的 NVIDIA Windows 驱动。当前镜像使用 CUDA 13.0，请选择 R580 或更新分支的驱动。打开 Ubuntu 并运行：
bash
nvidia-smi看到 GPU 名称和驱动信息后，说明 Windows 已经把显卡提供给 WSL2。WSL 中直接使用 Windows 提供的 GPU 驱动。
选择 Docker 运行方式
Docker Desktop 和 Ubuntu 内的 Docker Engine 是两种独立的运行方式，选择其中一种即可。已经启用 Docker Desktop 的 WSL Integration 时，使用第一种；希望由 Ubuntu 自己管理 Docker 服务时，使用第二种。
Docker Desktop 与 Docker Engine
- 已经在 Windows 中使用 Docker，希望通过图形界面管理，选择 Docker Desktop。
- 希望 Docker 完全运行在 WSL Ubuntu 中，并由 Ubuntu 管理服务，选择 Ubuntu 内的 Docker Engine。
使用 Docker Desktop
- 安装 Docker Desktop。
- 在 Docker Desktop 设置中启用 Use the WSL 2 based engine。
- 打开 Resources → WSL Integration，启用 Ubuntu。
- 回到 Ubuntu，运行
docker version。输出中同时出现 Client 和 Server 后，再验证 GPU 支持：
bash
docker run --rm --gpus all ubuntu nvidia-smi看到 GPU 信息后，在 Ubuntu 中运行以下命令启动 ComfyCarry（Docker Desktop 的 GPU 使用要求见官方说明）：
bash
docker run -d \
--name comfycarry \
--gpus all \
--restart unless-stopped \
-p 5000:5000 \
-p 8188:8188 \
-p 8888:8888 \
-p 2222:22 \
-v comfycarry-workspace:/workspace \
erocraft/comfycarry:latest各项参数的作用与调整方式见本地 Linux 安装部署中的启动参数说明。
在 Ubuntu 中使用 Docker Engine
如果运行 systemctl 时提示当前 WSL 没有启用 systemd，把对应命令中的 sudo systemctl enable --now docker 换成 sudo service docker start，把 sudo systemctl restart docker 换成 sudo service docker restart。
进入 Ubuntu，依次完成本地 Linux 安装部署中的以下步骤：
打开部署向导
容器启动后，可以在 Ubuntu 中运行 docker logs -f comfycarry（或 sudo docker logs -f comfycarry）查看首次启动进度，按 Ctrl+C 即可退出日志查看。
在 Windows 浏览器中打开 http://localhost:5000，页面出现环境检测通过后，继续完成首次部署向导。