Discover AI in Your Lab

中文

English

中文

English

如何在Windows用Docker安装应用 ​

大部分开源AI应用，想在本地部署需要具备很多知识和技巧，还要碰运气。使用Python开发的应用，对运行环境要求非常苛刻，直接在电脑上安装，很容易因“运行环境不兼容”而导致失败。

魔当提供了自动化安装流程，尽可能地兼容Windows系统的各种复杂环境，但仍然会遇到无法正常运行的特殊情况。这时，你可以试试用Docker来安装。

可从Docker官网下载安装包，https://www.docker.com/

注意，Docker的使用需要电脑硬件和系统版本达到一定条件，并且其安装和使用有一定复杂性，如果对Docker技术不熟悉，请谨慎操作，建议寻求熟悉Docker的技术人员协助。

如果需要协助，请联系魔当技术团队。tech@daiyl.com

扫一扫加微信群

使用Docker的优势 ​

  1. 环境一致性：容器将应用及其依赖完整打包，避免因配置差异导致的兼容性问题。
  2. 资源隔离与轻量化：通过内核级虚拟化技术，容器实现进程级资源隔离，相比传统虚拟机占用更少内存和CPU资源，支持同时运行多个应用。
  3. 快速部署与版本管理：一键启动容器即可运行应用，支持快速切换不同版本镜像，显著提升工作效率。

在Windows安装和使用Docker ​

Windows安装Docker流程较多，而且Windows家庭版和专业版也有一定差异，本文介绍的方式是足够通用的，家庭版和专业版均可使用。

二、安装WSL2与Docker的流程 ​

系统环境准备 ​

  1. 硬件要求：

    • 64位处理器（支持二级地址转换SLAT）
    • 至少4GB内存
    • BIOS中启用虚拟化技术（VT-x/AMD-V）

  2. 软件要求：

    • Windows 10/11专业版、企业版或教育版（Build 19041及以上）
    • 推荐使用Windows 11 24H2版本以获得最佳兼容性

启用WSL2 ​

  1. 以管理员身份打开PowerShell，执行以下命令：

    powershell
    wsl --install

    该命令将自动安装WSL2及默认Ubuntu子系统，安装完成后重启计算机。

  2. 验证WSL2安装：

    powershell
    wsl --list --verbose

    确保目标Linux发行版状态为"Running"且版本为2。

安装Docker Desktop ​

  1. 下载安装包： 访问Docker官方下载页面，选择"Download for Windows"获取安装程序。

  2. 运行安装向导：

    • 勾选"Use the WSL 2 based engine"启用WSL2后端
    • 建议勾选"Start Docker Desktop when you log in"实现开机自启
    • 完成安装后重启计算机。

  3. 配置WSL2集成：

    • 右键系统托盘Docker图标，选择"Settings"
    • 进入"Resources > WSL Integration"，勾选 "Enable integration with my default WSL distro"
    • 点击"Apply & Restart"保存配置。

  4. 调整资源：

.wslconfig 是位于 Windows 用户目录（如 C:\Users\YourName.wslconfig）的配置文件，用于自定义 WSL 2 的全局设置。它会影响所有 WSL 2 发行版（包括 Docker Desktop 使用的 docker-desktop）的性能和资源分配。如果文件不存在，可手动创建文件。生成视频和图片的AI应用往往需要较多内存，建议尽量给Docker分配较多内存，也要合理控制，别影响电脑稳定运行。

[wsl2]
# WSL 2 虚拟机的 CPU 核心数（默认：所有可用核心）
processors = 4

# 内存使用，（默认：总内存的 50%），建议尽可能多地分配内存
memory = 14GB

# 交换文件大小（用于内存不足时的临时存储），如果C盘空间不够可指向D盘。
swap = 16GB
swapFile = D:\\work\\temp\\wsl-swap.vhdx
  1. 验证安装：
    powershell
    docker --version
docker run hello-world
    若输出Docker版本信息及"Hello from Docker!"提示，则安装成功。

三、使用魔当团队推荐的镜像 ​

（一）镜像仓库访问 ​

我们构建了部分的应用镜像仓库，您可直接通过pull命令拉取，如兼容CUDA 12.8的FramePack：

bash
docker pull crpi-ru0fy7yg2nq6feyc.cn-shanghai.personal.cr.aliyuncs.com/lmdown/framepack:1.0.0-gpu-cu128

示例：

完整镜像列表和示例请访问 AI应用Docker镜像。

四、在魔当中使用Docker模式安装应用 ​

可在图形化界面中简单操作。此功能正在内测中，即将发布。

五、常见问题解决方案 ​

  1. WSL2无法启动：

    • 检查BIOS虚拟化是否启用
    • 执行命令wsl --shutdown后重新启动WSL

  2. 权限不足错误：

    • 以管理员身份运行Docker客户端
    • 将当前用户添加到Docker用户组（WSL环境中执行sudo usermod -aG docker $USER）

在macOS安装Docker ​

  • 在macOS中什么时候不用Docker？

    • macOS系统环境比较适合Python程序运行，应用安装成功率高，一般不需要使用Docker。
    • 在 macOS中，不支持通过 Docker 直接调用 Metal Performance Shaders (MPS)，所以对显卡要求高且使用MPS的应用，没法正常运行。

  • 什么时候需要用Docker？

    • 使用Docker可以方便地管理应用，避免因环境不兼容导致安装失败的问题。
    • 部分应用官方只提供Docker版。

下载地址 ​

Docker 官网下载页面：https://www.docker.com/products/docker-desktop。

选择 Apple Chip（M1/M2）或 Intel 版本，根据你的 Mac 芯片类型下载。

如需进一步技术支持，请联系魔当技术团队。tech@daiyl.com