Windows 11零基础搭建小雅Alist影音库全攻略想在Windows电脑上打造专属的私人影院小雅Alist影音库绝对是你的不二之选。这个基于Docker的解决方案能让你轻松访问海量高清影视资源从4K电影到杜比视界内容应有尽有。本文将手把手教你如何在Windows 11上完成从零到一的完整部署过程特别针对没有任何Docker或命令行经验的用户设计确保每一步都清晰明了。1. 环境准备WSL2与Docker Desktop安装在开始之前我们需要为Windows 11准备好运行Docker的环境。微软的WSL2Windows Subsystem for Linux是最佳选择它能让Linux环境无缝运行在Windows上而不需要虚拟机或双系统。1.1 启用WSL2功能首先我们需要确保Windows 11已经启用了WSL2功能以管理员身份打开PowerShell右键开始菜单选择Windows终端(管理员)输入以下命令并回车wsl --install等待安装完成后重启电脑提示如果你的系统较旧可能需要先手动启用适用于Linux的Windows子系统和虚拟机平台功能可以通过控制面板-程序和功能-启用或关闭Windows功能中找到。1.2 安装Docker DesktopDocker Desktop是Windows上运行Docker容器最简单的方式访问Docker官网下载安装包双击下载的Docker Desktop Installer.exe文件安装过程中保持默认选项但可以自定义安装路径安装完成后启动Docker Desktop首次启动时Docker会进行一些初始化配置可能需要几分钟时间。启动成功后你会在系统托盘区看到Docker的鲸鱼图标。1.3 配置Docker环境为了让Docker运行更顺畅我们需要进行一些基本配置右键系统托盘中的Docker图标选择Settings在General选项卡中确保勾选了Use WSL 2 based engine切换到Resources-WSL Integration启用你的Linux发行版通常是Ubuntu在Docker Engine选项卡中添加国内镜像源加速下载{ registry-mirrors: [ https://hub-mirror.c.163.com, https://mirror.baidubce.com ] }2. 获取阿里云盘Token这是部署小雅Alist最关键也最容易出错的步骤。我们需要获取两种Token普通Token和Open Token。2.1 获取普通Token打开浏览器访问阿里云盘Token获取页面使用阿里云盘App扫描页面上的二维码扫码成功后页面会显示你的Token复制保存下来2.2 获取Open Token访问阿里云盘Open Token页面点击Scan QrCode按钮再次使用阿里云盘App扫码扫码后点击I have scan按钮页面会显示你的Open Token复制保存重要提示这两个Token都有有效期普通Token通常为2小时Open Token为30天。如果后续使用中出现问题可能需要重新获取Token。2.3 获取转存目录Folder ID在浏览器中打开小雅资源链接https://www.aliyundrive.com/s/rP9gP3h9asE点击转存按钮选择保存到你的资源库不要存到我的文档转存完成后进入该目录观察浏览器地址栏https://www.aliyundrive.com/drive/file/resource/640xxxxxxxxxxxxxxxxxxxca8a最后那串字符就是Folder ID复制保存3. 部署小雅Alist容器现在我们已经准备好了所有必要的凭证可以开始部署小雅Alist容器了。3.1 运行一键安装脚本打开Windows Terminal如果没有安装可以从微软商店免费获取选择Ubuntu标签页进入Linux环境输入以下命令运行安装脚本bash -c $(curl http://docker.xiaoya.pro/update_new.sh)脚本运行后会依次提示你输入之前获取的三个参数普通TokenOpen TokenFolder ID3.2 验证安装安装完成后我们可以通过几种方式验证是否成功打开Docker Desktop在Containers列表中应该能看到一个名为xiaoya的容器正在运行在浏览器中访问http://localhost:5678如果看到小雅Alist的界面说明安装成功初次访问时可能会显示获取设置失败请稍后正在加载储存这是正常现象需要等待资源加载完成。你可以在Docker Desktop中查看容器日志当看到类似下面的信息时表示资源加载完成2023-12-19 11:52:29 INFO[2023-12-19 11:52:29] success load storage: [/©️ v.1213.1952(B)], driver: [UrlTree]4. 连接播放器使用小雅Alist支持多种播放器通过WebDAV协议连接下面介绍几种常用播放器的配置方法。4.1 PotPlayer配置Windows打开PotPlayer按F5进入设置左侧选择网络-WebDAV/HTTP点击添加按钮填写以下信息名称小雅Alist主机地址localhost端口5678路径/dav用户名guest密码guest_Api789保存后在PotPlayer的网络菜单中就能看到添加的小雅Alist点击即可浏览播放4.2 VidHub配置Mac/iOS/Apple TV打开VidHub应用点击添加媒体源-WebDAV填写连接信息名称小雅Alist地址http://[你的电脑IP]:5678/dav用户名guest密码guest_Api789保存后即可浏览播放4.3 Reex配置Android打开Reex应用点击左上角菜单-添加存储选择WebDAV填写连接信息名称小雅Alist地址http://[你的电脑IP]:5678/dav用户名guest密码guest_Api789保存后即可浏览播放5. 常见问题解决即使按照教程一步步操作也可能会遇到一些问题。下面列出几个常见问题及解决方法。5.1 端口冲突问题如果启动容器时遇到端口冲突错误可以尝试以下命令重置网络net stop winnat net start winnat5.2 资源加载缓慢小雅Alist首次启动或长时间未使用后资源加载可能需要较长时间。这是正常现象请耐心等待。你可以通过查看容器日志来了解加载进度。5.3 Token失效如果突然无法访问资源可能是Token失效了。需要重新获取Token然后重启小雅容器docker restart xiaoya5.4 开机自动启动默认情况下Docker Desktop不会随系统启动你可以通过以下设置让它自动启动右键Docker系统托盘图标选择Settings-General勾选Start Docker Desktop when you log in6. 进阶使用技巧掌握了基本部署后下面介绍一些提升使用体验的技巧。6.1 使用域名访问如果你觉得记住IP地址麻烦可以在本地hosts文件中添加一条记录127.0.0.1 xiaoya.local然后就可以通过http://xiaoya.local:5678访问了。6.2 多设备访问要让同一局域网下的其他设备访问你的小雅Alist需要确保防火墙允许5678端口的入站连接在其他设备播放器中将地址中的localhost替换为你的电脑IP6.3 定期维护为了保证小雅Alist的最佳性能建议每月检查一次Token是否有效定期清理阿里云盘中转存目录的内容但不要删除目录本身关注小雅官网的更新公告及时获取新版本实际使用中我发现小雅Alist的资源更新非常及时几乎能找到所有热门影视内容。通过PotPlayer直接播放4K资源也非常流畅完全能满足家庭影院的需求。唯一需要注意的是长时间播放高码率内容可能会对网络带宽有一定要求建议使用有线网络连接。