WSL 设置指南#

本页包含关于如何设置 Windows Linux 子系统 (WSL) 以部署或试用 Audio2Face-3D 创作微服务的说明。除非另有说明，否则请在 WSL 终端内运行所有步骤。

先决条件#

本文档假定以下系统要求

WSL

v2 和 Ubuntu 22.04

Windows Nvidia 驱动程序

560.94

CUDA

12.6

在没有 Docker Desktop 的情况下设置 Docker#

使用便捷脚本安装 docker

$ curl -fsSL https://get.docker.com get-docker.sh
$ sudo sh ./get-docker.sh

将您的用户帐户添加到 docker 组

$ sudo groupadd docker
$ sudo usermod -aG docker <username>

注销并重新登录您的系统，然后进行健全性检查

$ docker run hello-world

您应该看到打印输出“Hello from Docker!”。

安装 Docker Compose 插件

$ sudo apt-get update
$ sudo apt-get install docker-compose-plugin

通过运行以下命令检查安装是否成功

$ docker compose version

设置 iptables 兼容性

$ sudo update-alternatives --config iptables

当提示时，选择选项1，路径为/usr/sbin/iptables-legacy。

通过关闭终端窗口或在 Powershell 中键入来关闭 WSL 实例

$ wsl --shutdown Ubuntu-22.04

启动 WSL 实例并检查 Docker 状态

$ service docker status

您应该在消息中看到“active (running)”。要退出，按 q。

安装 CUDA 工具包#

一旦在系统上安装了 Windows Nvidia 驱动程序，CUDA 就可以在 WSL2 中使用。因此，用户不得在 WSL 2 中安装任何 Nvidia Linux 驱动程序。

要下载并安装 CUDA 工具包，请访问 Nvidia Developer - Cuda downloads，并按照 deb(local) 的说明进行操作。确保您为您的系统选择正确的架构类型。

安装 NVIDIA 容器工具包#

对于安装，请按照 NVIDIA 容器工具包文档进行操作

然后配置 docker

$ sudo nvidia-ctk runtime configure --runtime=docker
$ sudo systemctl restart docker

如果一切顺利，那么您应该能够启动 Docker 容器并在其中运行 nvidia-smi。

$ sudo docker run --rm --gpus all ubuntu nvidia-smi

安装 NGC CLI#

下载适用于 Linux 和您的系统架构的正确 NGC CLI，并按照安装说明进行操作。

我们建议返回到快速入门以开始在 WSL 内使用 Audio2Face-3D 创作微服务。

在本页中