Docker 安装 | Hinerの小窝

在安装 Docker 之前，我们要知道，Docker 并非是一个通用的容器工具，它依赖于已存在并且运行的 Linux 内核环境。

Docker 是一个开源的应用容器引擎，让开发者可以打包应用以及依赖包到一个可移植的镜像中，然后发布到任何流行的 Linux或Windows机器上，也可以实现虚拟化。
Docker 一般在 GNU/Linux 系统中运行。其他系统想要部署 Docker 就必须安装一个虚拟的 Linux 环境。
虚拟机（VM）的理解和使用也是 Docker 得以运行的先决条件。
Docker 实质上是在已经运行的 Linux 下制造了一个隔离的文件环境，因此它的执行效率几乎等同于所部署的 Linux 主机。
容器是完全使用沙箱机制，相互之间不会有任何接口。

¶安装 WSL

¶开启电脑的 Hyper-V 功能，否则 Docker 等其他虚拟化工具会报错

打开控制面板 -> 程序 -> 程序和功能 -> 启用或关闭 Windows 功能
Hyper-V 和适用于 Linux 的 Windows 子系统和虚拟机平台（勾选）

¶下载适用于 Linux 的 Windows 子系统和虚拟机

启用 WSL 功能

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

启用虚拟机平台（WSL 2 必需）

1	dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

重启计算机
1
shutdown -r -t 0

安装最新版本 WSL

1	dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

设置 WSL 2 为默认版本
1
wsl --set-default-version 2
安装 Linux 发行版
从 Microsoft Store 安装（如 Ubuntu），或通过命令行：
1
wsl --install -d <Distributions Name>

设置 Linux 用户名和密码
请注意，输入密码时，屏幕上不会显示任何内容。这称为盲人键入。你不会看到你正在键入的内容，这是完全正常的。

¶设置 WSL 语言环境

# 检查当前语言环境
locale

# 如果未设置中文 UTF-8，运行：
sudo apt install language-pack-zh-hans
sudo update-locale LANG=zh_CN.UTF-8

# 重新登录 WSL
exit
wsl  # 重新进入

¶CPU 漏洞警告

Speculative Return Stack Overflow: IBPB-extending microcode not applied!
原因：CPU 微码未更新，缺少针对 “推测性返回栈溢出” 漏洞的缓解措施。
建议：更新系统微码（sudo apt install intel-microcode或amd64-microcode）。
解决方案：
安装 CPU 漏洞修复补丁

1
2
3

sudo apt update # 在升级或安装新软件包之前，建议始终先运行一次更新软件包索引。
sudo apt install intel-microcode  # 适用于 Intel 平台
sudo apt install amd64-microcode # 适用于 AMD 平台

¶在 GNU/Linux 中安装 Firefox

下载：https://support.mozilla.org

¶firefox 报错 dxgkio（GPU 加速问题）

1	nvidia-smi # 检查显卡驱动是否安装成功

如果出现 Command 'nvidia-smi' not found，请检查显卡驱动是否正确安装。
没有问题就更改 firefox 的配置
在 Firefox 地址栏中输入 about:config，并承诺小心操作。然后搜索以下首选项，确保它们被设置为 true：

gfx.webrender.all - 确保此项为 true。这是启用现代渲染后端的关键。
gfx.webrender.compositor.force-enabled - 设置为 true
layers.acceleration.force-enabled - 设置为 true
media.hardware-video-decoding.force-enabled - 设置为 true (强制启用硬件视频解码)

注意：修改后需要完全关闭 Firefox 再重新打开才能生效。

¶GUI 缩放问题

gtk_widget_set_size_request: assertion 'width >= -1' failed: 这意味着某个 GUI 组件尝试设置一个无效的宽度（小于 -1），触发了 GTK 的断言错误。

将最有效的配置写入你的 ~/.bashrc 或 ~/.zshrc 文件，这样就不用每次手动设置了。
1
2
3
echo 'export GDK_SCALE=1' >> ~/.bashrc
echo 'export GDK_DPI_SCALE=1' >> ~/.bashrc
source ~/.bashrc
使用 --class 参数启动 Firefox
有时为 Firefox 创建一个独立的窗口类可以避免与其他应用的设置冲突。
1
firefox --class "FirefoxWSL"
在 Firefox 内部修改配置
在 Firefox 地址栏输入 about:config，然后搜索并修改以下选项：
- layout.css.devPixelsPerPx - 将其值改为 1.0 或 1.5 等数字。这个值直接控制 Firefox 自身的缩放比例。1.0 表示 100% 缩放。

¶安装 Noto 字体

1 2	# Ubuntu/Debian sudo apt install fonts-noto-cjk # 包含简体中文、繁体中文、日文、韩文字体

¶安装 WSLg 支持

** (firefox:16322): WARNING **: 23:55:47.805: Failed to create DBus proxy for org.a11y.Bus: Could not connect: No such file or directory
Firefox 在尝试连接 DBus（Linux 进程通信服务）时失败，特别是与辅助功能总线（a11y.Bus）相关的部分。在 WSL 环境中，DBus 默认未运行，因此 Firefox 会报错（尽管它仍然可以运行，但某些功能可能受限）。

解决方案

安装并启动 DBus
如果某些应用依赖 DBus（如 GNOME 相关工具），可以手动启用：

# 安装 DBus
sudo apt install dbus-x11

# 启动 DBus 服务
sudo service dbus start

# 验证是否运行
ps aux | grep dbus

调整 DBus 的安全配置

注意：WSL 对 systemd 支持有限，DBus 可能无法自启动，每次重启 WSL 后需手动运行 sudo service dbus start。

解决方案：强制 Firefox 使用 X11 而非 Wayland
如果使用 WSLg（Windows 11 的 GUI 支持），Firefox 可能默认尝试 Wayland，而 WSLg 的 Wayland 支持不完善：
1
2
3
4
5
6
7
# 临时生效
export MOZ_ENABLE_WAYLAND=0
firefox

# 永久生效
echo "export MOZ_ENABLE_WAYLAND=0" >> ~/.bashrc
source ~/.bashrc

¶Docker 下载与安装

去官网下载 Docker（速度慢自行想办法）
更改默认安装路径
软件默认安装 C 盘，如需更改：
1
Start-Process -Wait -Filepath "下载的 exe 程序" -ArgumentList "install --installation-dir=D:\Docker"
- 汉化：https://github.com/asxez/DockerDesktop-CN
检验成功
打开 powershell 或 cmd 并键入
1
2
docker -v
docker-compose -v