系统要求

  • Windows 10 专业版
    • x64 系统：版本为 1903 及以上，构建版本为 18362.1049 及以上。
    • ARM64 系统：版本为 2004 及以上版本，Build 19041 及以后版本。
  • Windows 11 专业版

Windows 部分

按下 Win + X，打开 终端管理员(A)

启用 WSL & 虚拟机平台

1
2
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

完成后，重启计算机。

更新到 WSL2

  1. 下载适用于 x64 或 ARM64 的 WSL2 Linux 内核更新包，并安装。
  2. 将 WSL2 设置为默认版本。
1
wsl --set-default-version 2

安装 Ubuntu 子系统

  • 根据 Apollo 10.0 文档，Ubuntu 系统推荐: 18.04、20.04、22.04，不推荐24.04
  • 以 22.04 为例，下载得到 Ubuntu2204-221101.AppxBundle 文件，用 7-Zip 打开。
    • x64系统: Ubuntu_2204.1.7.0_x64.appx → install.tar.gz
    • ARM64系统: Ubuntu_2204.1.7.0_ARM64.appx → install.tar.gz
  • 将 install.tar.gz 文件解压到任意目录 (例如 E:\WSL\install.tar.gz)
  • 将 Ubuntu 22.04 导入到 WSL2 中。
1
wsl --import <Distro> <InstallLocation> <FileName>
  • 例如
1
wsl --import Ubuntu E:\WSL\Ubuntu E:\WSL\install.tar.gz
  • 其中 Ubuntu 是自定义的发行版名称，若使用其他名称，需要在后续命令中替换。
  • E:\WSL\Ubuntu 是 Ubuntu 子系统的安装目录，请自行选择空间充足的目录。

为 WSL2 启用 Systemd

1
2
wsl -d Ubuntu -u root bash -c "echo -e '[boot]\nsystemd=true' > /etc/wsl.conf"
wsl -d Ubuntu --shutdown

Ubuntu 部分

进入 Ubuntu 子系统

1
wsl -d Ubuntu

安装 Docker

  1. 添加 Docker 官方仓库密钥和列表
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
# Add Docker's official GPG key:
sudo apt update
sudo apt install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Add the repository to Apt sources:
sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF

sudo apt update
  1. 安装 Docker
1
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

安装 NVIDIA 容器工具包

  1. 添加 NVIDIA 官方仓库密钥和列表
1
2
3
4
5
6
curl -fsSL https://nvidia.github.io/libnvidia-container/gpgkey | \
    sudo gpg --dearmor -o /usr/share/keyrings/nvidia-container-toolkit-keyring.gpg
curl -s -L https://nvidia.github.io/libnvidia-container/stable/deb/nvidia-container-toolkit.list | \
    sed 's#deb https://#deb [signed-by=/usr/share/keyrings/nvidia-container-toolkit-keyring.gpg] https://#g' | \
    sudo tee /etc/apt/sources.list.d/nvidia-container-toolkit.list
sudo apt update
  1. 安装 NVIDIA 容器工具包
1
sudo apt install -y nvidia-container-toolkit
  1. 配置 NVIDIA 容器工具包
1
sudo nvidia-ctk runtime configure --runtime=docker
  1. 重启 Docker 服务
1
sudo service docker restart

后续步骤

至此准备工作已经完成，请参考以下文档完成 Apollo 的安装：