mobile wallpaper 1mobile wallpaper 2mobile wallpaper 3mobile wallpaper 4mobile wallpaper 5mobile wallpaper 6
768 字
2 分钟
Ubuntu (WSL2) 下 Docker 安装
2026-01-17

简介#

Docker 是一款轻量级的容器化技术,它能将应用程序及其运行所需的所有依赖打包成一个标准化的 “容器”。这个容器就像一个独立的、可移植的 “软件盒子”,可以在任何支持 Docker 的操作系统上以完全一致的方式运行。

它既解决了 “在我电脑上能跑,到你电脑上就报错” 的环境不一致问题,又相比传统虚拟机更轻量、启动更快、资源占用更少。同时,通过镜像仓库可以轻松实现容器的分发和复用,是现代软件开发、测试、部署环节中实现环境统一、快速交付的核心工具。

环境准备#

  • 操作系统: Ubuntu 22.04 (WSL2)
  • 网络要求: 由于网络环境原因,连接 Docker 官方源可能需要科学上网环境。

安装 Docker#

我们将使用 Docker 官方提供的安装脚本进行安装,这是最快捷的方式。

1. 下载安装脚本#

使用 curl 下载官方安装脚本,并命名为 docker-install.sh

curl -fsSL https://get.docker.com -o docker-install.sh

2. 执行安装#

使用 sudo 权限执行脚本:

sudo sh docker-install.sh

注意:如果使用的是 WSL 环境,安装过程中可能会出现如下提示:

Terminal window
WSL DETECTED: We recommend using Docker Desktop for Windows.
Please get Docker Desktop from https://www.docker.com/products/docker-desktop/
You may press Ctrl+C now to abort this script.
+ sleep 20

这是官方推荐在 Windows 上使用 Docker Desktop。在 WSL2 中直接安装 Docker Engine 也是完全可行的(且通常性能更好)。只需要等待 20 秒或直接回车继续即可。

3. 验证安装#

当脚本执行完毕,出现类似以下内容则代表安装成功:

Terminal window
Client: Docker Engine - Community
Version: 29.1.5
API version: 1.52
Go version: go1.25.6
Git commit: 0e6fee6
Built: Fri Jan 16 12:48:49 2026
OS/Arch: linux/amd64
Context: default
Server: Docker Engine - Community
Engine:
Version: 29.1.5
API version: 1.52 (minimum version 1.44)
Go version: go1.25.6
Git commit: 3b01d64
Built: Fri Jan 16 12:48:49 2026
OS/Arch: linux/amd64
Experimental: false

你可以使用以下命令再次确认 Docker 版本:

docker --version

Docker Compose 通常也会随脚本一同安装,检查其版本:

docker compose version

服务管理#

在 WSL2 (Ubuntu 22.04+) 中,Systemd 已经得到支持。使用官方脚本安装后,Docker 服务通常会自动启动。

启动与停止#

如果服务未启动,可以使用以下命令手动管理:

# 启动 Docker
sudo systemctl start docker
# 停止 Docker
sudo systemctl stop docker
# 重启 Docker
sudo systemctl restart docker

开机自启#

你可以根据需要设置 Docker 是否随 WSL 实例启动而自动运行:

# 开启自启动
sudo systemctl enable docker
# 关闭自启动
sudo systemctl disable docker

权限设置(免 sudo 使用 Docker)#

默认情况下,Docker 守护进程 dockerd 运行在 root 权限下,其监听的 Unix Socket /var/run/docker.sock 只有 root 用户和 docker 用户组才有读写权限。

为了避免每次运行 Docker 命令都需要输入 sudo,我们可以将当前用户添加到 docker 用户组。

1. 加入用户组#

执行以下命令将当前用户($USER)添加到 docker 组:

sudo usermod -aG docker $USER

2. 刷新权限#

为了让用户组变更立即生效,可以执行 newgrp 命令(或者注销并重新登录):

newgrp docker

3. 验证权限#

尝试不带 sudo 运行 docker ps

docker ps

如果能成功输出容器列表(即使为空),则说明权限配置成功。

Terminal window
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES

至此,你已经在 Ubuntu (WSL2) 上成功安装并配置了 Docker。

分享

如果这篇文章对你有帮助,欢迎分享给更多人!

Ubuntu (WSL2) 下 Docker 安装
https://blog.srka.top/posts/docker-install-ubuntu-wsl2/
作者
Srka
发布于
2026-01-17
许可协议
CC BY-NC-SA 4.0

部分信息可能已经过时