|
1 | | -# QQ Docker (Linux QQ for WSL2) |
| 1 | +# QQBox (盒装QQ) |
2 | 2 |
|
3 | 3 | > **Note:** 本项目仅在 Windows 11 的 WSL2 (Debian) 上测试,其他平台请自行修改和适配。 |
4 | 4 |
|
|
9 | 9 | - 解决高分辨率缩放模糊问题 |
10 | 10 | - 解决缩放后鼠标大小异常问题 |
11 | 11 |
|
12 | | -## 启动命令 |
13 | | - |
14 | | -```bash |
15 | | -# 在 WSL2 中启动 QQ 容器 |
16 | | -wsl docker run -tid \ |
17 | | - --rm \ # 容器停止时自动删除 |
18 | | - --name qqbox \ # 容器名称 |
19 | | - --shm-size="1g" \ # 设置共享内存大小,避免卡顿 |
20 | | - -e DISPLAY=$DISPLAY \ # 转发 X11 显示 |
21 | | - -e WAYLAND_DISPLAY=$WAYLAND_DISPLAY \ # 转发 Wayland 显示 |
22 | | - -e XDG_RUNTIME_DIR=$XDG_RUNTIME_DIR \ # 转发用户运行时目录 |
23 | | - -v /tmp/.X11-unix:/tmp/.X11-unix \ # 挂载 X11 套接字 |
24 | | - -v /mnt/wslg:/mnt/wslg \ # 挂载 WSLg 目录(支持音频、图形等) |
25 | | - -v /usr/lib/wsl/lib:/usr/lib/wsl/lib \ # 挂载 WSL 库 |
26 | | - -v /mnt/c/Windows/Fonts:/usr/share/fonts/win11 \ # 挂载 Windows 字体 |
27 | | - -v /mnt/d/QQ:/root/.config/QQ \ # 挂载 QQ 目录到D:\QQ |
28 | | - -v /mnt/d/QQfiles:/root/QQfiles \ # 挂载 QQ 文件目录到D:\QQfiles |
29 | | - qqbox:latest |
30 | | -``` |
31 | | - |
32 | | - |
33 | | -## 高分屏适配 |
34 | | - |
35 | | -如果在高分辨率环境中需要缩放,请将 `.wslgconfig` 文件放到 `%USERPROFILE%` 下,例如: |
36 | | - |
37 | | -``` |
38 | | -C:\Users\<你的用户名>\.wslgconfig |
39 | | -``` |
| 12 | +## 使用方法 |
| 13 | + |
| 14 | +1. **获取镜像** |
| 15 | + |
| 16 | + 你可以选择以下任一方式获取镜像: |
| 17 | + |
| 18 | + - 直接拉取: |
| 19 | + ```bash |
| 20 | + docker pull ayfun/qqbox |
| 21 | + ``` |
| 22 | + - 本地构建: |
| 23 | + ```bash |
| 24 | + docker build -t qqbox . |
| 25 | + ``` |
| 26 | + |
| 27 | +2. **运行容器** |
| 28 | + |
| 29 | + 修改QQ.bat执行,或按需调整执行以下命令启动容器: |
| 30 | + ```bash |
| 31 | + wsl docker run -tid \ |
| 32 | + --rm \ # 容器停止时自动删除 |
| 33 | + --name qqbox \ # 容器名称 |
| 34 | + --shm-size="1g" \ # 设置共享内存大小,避免卡顿 |
| 35 | + -e DISPLAY=$DISPLAY \ # 转发 X11 显示 |
| 36 | + -e WAYLAND_DISPLAY=$WAYLAND_DISPLAY \ # 转发 Wayland 显示 |
| 37 | + -e XDG_RUNTIME_DIR=$XDG_RUNTIME_DIR \ # 转发用户运行时目录 |
| 38 | + -v /tmp/.X11-unix:/tmp/.X11-unix \ # 挂载 X11 套接字 |
| 39 | + -v /mnt/wslg:/mnt/wslg \ # 挂载 WSLg 目录(支持音频、图形等) |
| 40 | + -v /usr/lib/wsl/lib:/usr/lib/wsl/lib \ # 挂载 WSL 库 |
| 41 | + -v /mnt/c/Windows/Fonts:/usr/share/fonts/win11 \ # 挂载 Windows 字体 |
| 42 | + -v /mnt/d/QQ:/root/.config/QQ \ # 挂载 QQ 目录到D:\QQ |
| 43 | + -v /mnt/d/QQfiles:/root/QQfiles \ # 挂载 QQ 文件目录到D:\QQfiles |
| 44 | + qqbox:latest |
| 45 | + ``` |
| 46 | + |
| 47 | +3. **常见问题** |
| 48 | + |
| 49 | + - 高分屏适配:如果在高分辨率环境中需要缩放,请将 `.wslgconfig` 文件放到 `%USERPROFILE%` 下,例如: |
| 50 | + ``` |
| 51 | + C:\Users\<你的用户名>\.wslgconfig |
| 52 | + ``` |
0 commit comments