WSL Ubuntu安装Docker完整指南

前提条件

在开始之前，请确保您已满足以下条件：

• Windows 10或更高版本，并已启用WSL 2。
• 已在WSL中安装Ubuntu发行版（建议使用Ubuntu 20.04或更高版本）。
• 具有管理员权限的Ubuntu用户账户。

步骤1：更新系统包

首先，打开WSL Ubuntu终端，运行以下命令更新系统包列表和升级现有包：

    sudo apt updatesudo apt upgrade -y  

这确保您的系统处于最新状态，避免兼容性问题。

步骤2：安装依赖包

安装Docker所需的依赖包，包括CA证书、curl等：

    sudo apt install -y apt-transport-https ca-certificates curl software-properties-common  

这些包帮助系统安全地下载和安装软件。

步骤3：添加Docker官方GPG密钥

为了验证软件包的完整性，添加Docker的官方GPG密钥：

    curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg  

这确保您从官方源安装Docker，避免安全风险。

步骤4：添加Docker仓库

将Docker的APT仓库添加到系统源列表中：

    echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null  

然后更新包列表以应用更改：

    sudo apt update  

步骤5：安装Docker引擎

现在，安装Docker引擎及其组件：

    sudo apt install -y docker-ce docker-ce-cli containerd.io  

这将下载并安装最新版本的Docker，支持容器化应用运行。

步骤6：启动并启用Docker服务

安装完成后，启动Docker服务并设置开机自启：

    sudo systemctl start dockersudo systemctl enable docker  

注意：在WSL中，systemctl可能不直接工作，您可以改用以下命令：

    sudo service docker start  

步骤7：验证安装

运行一个测试命令来验证Docker是否安装成功：

    sudo docker run hello-world  

如果看到欢迎消息，说明安装成功！您已在Ubuntu的WSL环境中准备好使用Docker。

步骤8：将用户添加到docker组（可选）

为了避免每次使用Docker都需要sudo，将当前用户添加到docker组：

    sudo usermod -aG docker $USER  

然后注销并重新登录WSLUbuntu会话，使更改生效。

常见问题

• 如果遇到权限错误，请确保WSL 2已正确配置。
• 对于网络问题，检查代理设置或防火墙。
• 参考官方Docker文档获取更多帮助。

结论

通过本教程，您已成功在WSL的Ubuntu子系统上安装了Docker。这为您的开发环境提供了强大的容器化工具，让您可以轻松构建和运行应用。继续探索Docker的功能，提升您的开发和部署效率！