WSL2#

WSL2（Windows Subsystem for Linux 2）在 Windows 上提供一个真正的 Linux 内核。在它里面跑 SnowLuma 的 Linux 容器，是不想用原生 Windows QQ 时的另一条路。

本页讲：先装好 WSL2，再用两种方式之一把 Docker 跑起来，最后启动规范的 SnowLuma 容器。

1. 安装 WSL2#

以管理员身份打开 PowerShell，运行：

wsl --install

这会装好 WSL2 + 默认的 Ubuntu 发行版。重启电脑，重启后 Ubuntu 会首次启动，让你创建 Linux 用户名和密码。

确认版本是 2：

wsl -l -v
# VERSION 一列应为 2
wsl --set-default-version 2

当前 Ubuntu-on-WSL 默认已开启 systemd。

官方文档：https://learn.microsoft.com/windows/wsl/install

2. 在 WSL2 里准备 Docker（二选一，别两个都装）#

方式 A：Docker Desktop 的 WSL 集成（推荐）#

装好 Docker Desktop 后，到 Settings → Resources → WSL Integration，给你的 Ubuntu 发行版打开集成开关。这样在 Ubuntu 终端里就能直接用 docker 命令，引擎跑在 Docker Desktop 那边。安装与系统要求见 Windows · Docker Desktop。

官方文档：https://docs.docker.com/desktop/features/wsl/

方式 B：发行版内的原生 Docker Engine#

不想装 Docker Desktop，就在 Ubuntu 发行版里直接装原生 Docker Engine。官方 apt 仓库（deb822 docker.sources 格式）方式见 https://docs.docker.com/engine/install/ubuntu/。

仅用于本机 / 开发，也可以用便捷脚本：

curl -fsSL https://get.docker.com | sudo sh
sudo usermod -aG docker $USER

加完用户组要重开终端才生效。启动 Docker：

# 已开 systemd 的发行版：
sudo systemctl start docker
sudo systemctl enable docker

# 没开 systemd 的旧环境：
sudo service docker start

3. 运行 SnowLuma 容器#

Docker 就绪后，在 Ubuntu 终端里运行和规范 Docker 页完全一样的命令：

docker run -d \
  --name snowluma \
  --restart unless-stopped \
  --shm-size=1g \
  --cap-add=SYS_PTRACE \
  --security-opt seccomp=unconfined \
  -e VNC_PASSWD=vncpasswd \
  -p 5900:5900 \
  -p 6081:6081 \
  -p 5099:5099 \
  -p 3000:3000 \
  -p 3001:3001 \
  -v snowluma-data:/app/snowluma-data \
  -v snowluma-qq-config:/app/.config \
  -v snowluma-qq-data:/app/.local/share \
  motricseven7/snowluma:latest

Compose、环境变量、数据卷、多账号、首次登录等完整参考都在 Docker（Linux）部署，本页不重复。

4. 从 Windows 访问端口#

WSL2 默认会把容器监听的端口转发到 Windows 的 localhost，所以在 Windows 浏览器里直接用 localhost 即可：

也可以：在 WSL2 里走 Linux 手动流程#

WSL2 终究是个 Linux 环境，理论上你也能在里面不靠 Docker、直接按 Linux 手动方式跑 SnowLuma（自己起 Xvfb / VNC / noVNC、装 linuxqq、给 node 加 ptrace capability 等）。但那套步骤明显更繁琐，Docker 更省事，所以本页推荐容器路线。

该看哪一页#

• Docker（Linux）部署 —— 容器的完整参考。
• Windows · Docker Desktop —— 用 Docker Desktop 而不是发行版内 Engine。
• Windows 手动部署 —— 想跑原生 Windows QQ 而不是容器里的 Linux QQ。