1. 项目概述最近在Windows平台上使用Docker Desktop结合WSL运行小雅Alist的需求越来越多。这种组合既能发挥Windows系统的易用性又能利用Linux环境的高效特性特别适合需要在本地搭建网盘管理系统的用户。小雅作为一款基于Alist的开源网盘聚合工具能够将多个云存储服务统一管理。通过Docker部署可以避免环境依赖问题而WSL2则提供了接近原生Linux的性能表现。我在实际部署过程中发现这种组合方案确实比纯Windows环境或虚拟机方案更加稳定高效。2. 环境准备2.1 WSL安装与配置首先需要确保Windows系统版本符合要求。建议使用Windows 10 2004及以上版本或Windows 11系统。按WinR输入winver可以查看当前系统版本。安装WSL2的完整命令如下wsl --install -d Ubuntu-22.04如果遇到下载速度慢的问题可以尝试以下解决方案使用管理员权限打开PowerShell执行netsh interface tcp set global autotuninglevelrestricted重新运行WSL安装命令安装完成后建议进行以下优化配置# 在WSL终端中执行 sudo apt update sudo apt upgrade -y sudo apt install -y docker.io2.2 Docker Desktop安装从Docker官网下载最新版Docker Desktop for Windows安装包。安装时需要注意确保勾选Use WSL 2 based engine选项安装完成后在Settings Resources WSL Integration中启用与已安装的WSL发行版的集成如果安装后启动报错virtualisation support not detected需要进入BIOS启用虚拟化支持通常为Intel VT-x或AMD-V在Windows功能中开启Hyper-V和Windows Hypervisor Platform以管理员身份运行bcdedit /set hypervisorlaunchtype auto3. 小雅镜像部署3.1 获取小雅镜像小雅官方提供了Docker镜像可以通过以下命令拉取docker pull xiaoya-alist:latest由于国内网络环境建议配置镜像加速右键点击Docker Desktop图标选择Settings进入Docker Engine配置页面在registry-mirrors中添加国内镜像源例如{ registry-mirrors: [ https://docker.mirrors.ustc.edu.cn, https://hub-mirror.c.163.com ] }3.2 容器运行配置小雅容器需要一些特定的环境变量和挂载点。推荐使用docker-compose方式管理version: 3 services: xiaoya: image: xiaoya-alist:latest container_name: xiaoya restart: unless-stopped volumes: - ./data:/opt/alist/data - ./config:/opt/alist/config ports: - 5244:5244 environment: - PUID1000 - PGID1000 - TZAsia/Shanghai network_mode: bridge关键参数说明PUID/PGID应与WSL中的用户ID一致可通过id -u和id -g查询TZ时区设置建议按实际位置调整端口5244是小雅的默认Web访问端口4. 网盘挂载配置4.1 初始化Alist管理容器启动后访问http://localhost:5244 进入小雅管理界面。首次使用需要点击右下角初始化按钮记录生成的随机密码也可在容器日志中查看登录后立即修改默认密码4.2 挂载夸克网盘小雅支持挂载多种网盘以夸克网盘为例在管理界面点击存储-添加选择夸克云盘驱动类型填写必要信息挂载路径/quark排序1Cookie需要从浏览器获取夸克网盘的登录Cookie获取Cookie的方法登录夸克网盘网页版按F12打开开发者工具在Application Cookies中复制token字段值注意Cookie属于敏感信息请勿泄露。建议定期更新特别是当遇到访问问题时。5. 常见问题排查5.1 权限问题处理如果遇到文件读写权限错误可以尝试# 在WSL终端中执行 sudo chown -R 1000:1000 ./data ./config这里的1000对应docker-compose中的PUID/PGID如果修改了这些值这里的数字也需要相应调整。5.2 端口冲突解决如果5244端口被占用可以通过两种方式解决修改docker-compose.yml中的端口映射例如ports: - 5245:5244查找并终止占用端口的进程netstat -ano | findstr 5244 taskkill /PID 进程ID /F5.3 数据备份与迁移建议定期备份重要数据备份配置文件docker cp xiaoya:/opt/alist/config ./config_backup备份数据库docker exec xiaoya sqlite3 /opt/alist/data/data.db .backup /opt/alist/data/data.db.bak迁移到新环境时只需将备份的config和data目录复制到新环境的对应位置然后重新启动容器即可。6. 性能优化建议6.1 WSL2内存调整默认情况下WSL2会占用大量内存可以通过在用户目录下创建.wslconfig文件进行限制[wsl2] memory4GB swap2GB localhostForwardingtrue6.2 Docker资源限制对于小雅容器可以适当限制资源使用# 在docker-compose.yml中添加 deploy: resources: limits: cpus: 1 memory: 1G6.3 缓存优化小雅支持配置缓存策略在管理界面设置-全局中可以调整缓存过期时间建议设置为6-12小时缓存类型内存缓存性能更好文件缓存更稳定对于大文件较多的场景建议启用直接链接功能减少服务器中转负担。 
长河君 · 2026/10/28 15:53:23 · 阅读 1.2k Windows下使用Docker和WSL2部署小雅Alist网盘
1. 项目概述最近在Windows平台上使用Docker Desktop结合WSL运行小雅Alist的需求越来越多。这种组合既能发挥Windows系统的易用性又能利用Linux环境的高效特性特别适合需要在本地搭建网盘管理系统的用户。小雅作为一款基于Alist的开源网盘聚合工具能够将多个云存储服务统一管理。通过Docker部署可以避免环境依赖问题而WSL2则提供了接近原生Linux的性能表现。我在实际部署过程中发现这种组合方案确实比纯Windows环境或虚拟机方案更加稳定高效。2. 环境准备2.1 WSL安装与配置首先需要确保Windows系统版本符合要求。建议使用Windows 10 2004及以上版本或Windows 11系统。按WinR输入winver可以查看当前系统版本。安装WSL2的完整命令如下wsl --install -d Ubuntu-22.04如果遇到下载速度慢的问题可以尝试以下解决方案使用管理员权限打开PowerShell执行netsh interface tcp set global autotuninglevelrestricted重新运行WSL安装命令安装完成后建议进行以下优化配置# 在WSL终端中执行 sudo apt update sudo apt upgrade -y sudo apt install -y docker.io2.2 Docker Desktop安装从Docker官网下载最新版Docker Desktop for Windows安装包。安装时需要注意确保勾选Use WSL 2 based engine选项安装完成后在Settings Resources WSL Integration中启用与已安装的WSL发行版的集成如果安装后启动报错virtualisation support not detected需要进入BIOS启用虚拟化支持通常为Intel VT-x或AMD-V在Windows功能中开启Hyper-V和Windows Hypervisor Platform以管理员身份运行bcdedit /set hypervisorlaunchtype auto3. 小雅镜像部署3.1 获取小雅镜像小雅官方提供了Docker镜像可以通过以下命令拉取docker pull xiaoya-alist:latest由于国内网络环境建议配置镜像加速右键点击Docker Desktop图标选择Settings进入Docker Engine配置页面在registry-mirrors中添加国内镜像源例如{ registry-mirrors: [ https://docker.mirrors.ustc.edu.cn, https://hub-mirror.c.163.com ] }3.2 容器运行配置小雅容器需要一些特定的环境变量和挂载点。推荐使用docker-compose方式管理version: 3 services: xiaoya: image: xiaoya-alist:latest container_name: xiaoya restart: unless-stopped volumes: - ./data:/opt/alist/data - ./config:/opt/alist/config ports: - 5244:5244 environment: - PUID1000 - PGID1000 - TZAsia/Shanghai network_mode: bridge关键参数说明PUID/PGID应与WSL中的用户ID一致可通过id -u和id -g查询TZ时区设置建议按实际位置调整端口5244是小雅的默认Web访问端口4. 网盘挂载配置4.1 初始化Alist管理容器启动后访问http://localhost:5244 进入小雅管理界面。首次使用需要点击右下角初始化按钮记录生成的随机密码也可在容器日志中查看登录后立即修改默认密码4.2 挂载夸克网盘小雅支持挂载多种网盘以夸克网盘为例在管理界面点击存储-添加选择夸克云盘驱动类型填写必要信息挂载路径/quark排序1Cookie需要从浏览器获取夸克网盘的登录Cookie获取Cookie的方法登录夸克网盘网页版按F12打开开发者工具在Application Cookies中复制token字段值注意Cookie属于敏感信息请勿泄露。建议定期更新特别是当遇到访问问题时。5. 常见问题排查5.1 权限问题处理如果遇到文件读写权限错误可以尝试# 在WSL终端中执行 sudo chown -R 1000:1000 ./data ./config这里的1000对应docker-compose中的PUID/PGID如果修改了这些值这里的数字也需要相应调整。5.2 端口冲突解决如果5244端口被占用可以通过两种方式解决修改docker-compose.yml中的端口映射例如ports: - 5245:5244查找并终止占用端口的进程netstat -ano | findstr 5244 taskkill /PID 进程ID /F5.3 数据备份与迁移建议定期备份重要数据备份配置文件docker cp xiaoya:/opt/alist/config ./config_backup备份数据库docker exec xiaoya sqlite3 /opt/alist/data/data.db .backup /opt/alist/data/data.db.bak迁移到新环境时只需将备份的config和data目录复制到新环境的对应位置然后重新启动容器即可。6. 性能优化建议6.1 WSL2内存调整默认情况下WSL2会占用大量内存可以通过在用户目录下创建.wslconfig文件进行限制[wsl2] memory4GB swap2GB localhostForwardingtrue6.2 Docker资源限制对于小雅容器可以适当限制资源使用# 在docker-compose.yml中添加 deploy: resources: limits: cpus: 1 memory: 1G6.3 缓存优化小雅支持配置缓存策略在管理界面设置-全局中可以调整缓存过期时间建议设置为6-12小时缓存类型内存缓存性能更好文件缓存更稳定对于大文件较多的场景建议启用直接链接功能减少服务器中转负担。