先说我为什么折腾这个。家里电视、手机、电脑各自存了一堆片子和资料阿里云盘、夸克网盘、百度网盘里都有平时想看个东西得挨个App翻找资源比看资源还累。后来在论坛里看到有人聊AList和小雅说能把网盘统一管理起来小雅还能自动整理出一套现成的资源目录一下就心动了。这篇就把我从零开始装AList小雅的完整过程写下来包括环境准备、Docker部署、夸克网盘挂载还有后面踩过的各种坑给同样想搭一个影音资料库的朋友做个参考。如果你对Linux和Docker不太熟也能按着步骤走只是遇到问题时要多查多试。1. 先搞清楚AList和小雅是什么关系1.1 AList到底扮演什么角色很多朋友第一次接触AList容易把它当成网盘客户端或者下载工具其实不是。AList本质上是一个“存储统一入口”它本身不存任何文件也不负责下载加速它的核心工作是把各种网盘、本地目录、对象存储这些零散存储源挂载到一个统一的文件列表界面里。你打开AList的网页就像打开一个自己的文件管理器里面能看到所有已经挂载进来的网盘目录点开就能预览、播放、下载。AList是Go语言写的开源程序部署形式很灵活直接跑二进制文件或者用Docker容器运行都可以。它支持WebDAV协议意味着很多支持WebDAV的播放器、同步工具可以直接连上来使用。这也是为什么很多人把它当作家庭影音库的中间层——前端接Emby、Jellyfin这类媒体服务器后端接网盘资源用起来就像自己拥有一个流媒体平台。举个例子我在群晖NAS上装好AList之后把阿里云盘挂载进去客厅的电视通过支持WebDAV的播放器直接访问不用再把视频从网盘下载到本地了。只要网速跟得上在线播放体验和本地相差不大。所以说AList解决的是“多网盘入口分散”的问题帮你把资源聚拢在一个地方。1.2 小雅为什么能让安装门槛大幅降低小雅这名字听着文艺其实是套在AList上的一套配置与资源组织方案。它本身是一个Docker镜像里面预置了整理好的目录结构、自动更新脚本和大量现成的资源索引。官方提供一键安装脚本运行后会自动下载镜像、生成初始配置、把资源目录结构搭好你只需要按提示准备几个token文件整个过程大概几分钟跑完。可以这么理解裸装AList相当于给你一台空机器所有挂载得自己动手配置而小雅相当于一台预装好操作系统的电脑你把必要的信息填进去开机就能用。小雅内部本身就跑着AList程序所以不需要另外再装一个AList它是“全家桶”式的部署。不过这里有个容易混淆的地方。很多人以为装了小雅就不能再单独用AList了其实小雅是建立在AList基础上的资源整合方案它把常用网盘、公开目录、资源站这些内容都整理成了配置模板。如果你想在自己原来的AList里把小雅的内容也加进去也是可行的后边实操部分我会分别说。想用最简单的方式体验直接用官方脚本部署小雅镜像即可想在已有AList上扩充就按自己的存储配置手动添加。2. 环境准备把Docker跑起来2.1 选一台合适的机器NAS、云服务器还是小主机部署AList小雅硬件要求真的不高它主要吃内存和磁盘CPU倒不是瓶颈。我自己的实际感受是只要能跑Docker的设备基本都能胜任。常用的部署位置有几种部署位置优点缺点适合人群NAS群晖、绿联、威联通等7x24小时运行、功耗低、内网访问快内存一般不大需要省着用家里有NAS的朋友云服务器公网访问方便、不受家里断网影响带宽费钱、数据在远方想在外网随时访问的人软路由/小主机J4125之类安静省电、性能足够、扩展性好需要一点点硬件折腾经验喜欢折腾硬件的玩家日常电脑安装Docker Desktop不需要额外设备、上手最快关机就不能访问、不适合长期运行先体验试试水的朋友我自己是在群晖NAS上跑的内存8GB给小雅分了大概2GB左右连续运行下来没什么压力。如果你打算长期用我建议优先考虑NAS或软路由这类低功耗设备因为它们本来就是为7x24运行设计的。用普通电脑跑不是不行但电费和噪音会让你很快失去兴趣。云服务器也是一条路好处是随时随地都能访问不需要折腾内网穿透。但小雅拉取和缓存资源会占网络带宽云服务器的流量费用有时候还挺扎心的1TB流量看着多看几天蓝光原盘就见底了。我的看法是如果只是自己在家里用NAS或小主机是更好的选择如果要分享给朋友在外面看再考虑云服务器和反向代理。2.2 Docker环境安装的两种常规方式不管用哪种设备第一步都是把Docker装好。Linux服务器上的安装非常简单官方提供了一键脚本curl -fsSL https://get.docker.com | bash -s docker sudo systemctl enable --now docker上面这行命令做的事情是下载Docker官方安装脚本并执行脚本会自动识别你的Linux发行版配置软件源把Docker Engine装好。安装完成后第二条命令将Docker设置为开机自启并立即启动服务。执行完可以用docker version验证能输出版本信息就说明装好了。如果你用的是群晖、绿联这类带图形界面的NAS可能连命令行都不用碰。群晖在套件中心装Container Manager旧版叫Docker套件安装后打开就是图形化管理界面左边有容器、映像、项目这些菜单可以点点鼠标完成部署。绿联NAS也有类似Docker管理功能在控制面板里启用即可。这类图形界面工具特别适合不太习惯命令行的朋友后面跑小雅的时候直接下载镜像、创建容器就行。Windows和macOS的同学可以用Docker Desktop安装包下载后一路下一步即可。需要注意一点Docker Desktop在Windows上依赖WSL2安装过程中如果提示启用WSL按指示打开即可不要跳过。装好之后右下角会有一个小鲸鱼图标表示Docker后台正在运行。对了很多朋友下载Docker镜像时会遇到“拉取缓慢”的问题这个跟网络环境有关。解决方法是给Docker配置国内镜像加速器Linux下修改/etc/docker/daemon.jsonWindows和macOS在Docker Desktop的Settings - Docker Engine里改加上注册镜像地址后重启Docker服务即可。我当年没配镜像加速前拉一个小雅镜像等半天还经常失败配完之后半分钟就下来了这个细节强烈建议一开始就处理好。3. 部署小雅脚本与Compose文件两种路线3.1 一键脚本到底做了些什么小雅的一键安装脚本在各类帖子里传得很多常见的是这样一条命令bash -c $(curl -s https://docker.xiaoya.pro/update_new.sh)这条命令的意思是先用curl下载远程脚本内容然后直接用bash执行。注意执行前最好先看一眼脚本内容确认没有可疑操作这是基本的网络素养。你可以先用curl -s https://docker.xiaoya.pro/update_new.sh | head -n 100预览一下脚本大致逻辑。从脚本的输出来看它主要做的事情有检查当前系统是否已安装Docker没有则提示先安装。创建默认的数据目录常见是/opt/xiaoya。检测或生成mytoken.txt、myopentoken.txt这两个关键token文件的模板。下载docker-compose.yml编排文件。docker compose拉取镜像并启动容器。一键脚本适合初次接触、想快速跑通流程的朋友。但它的缺点是“黑盒”出了问题不太容易排查。如果你对配置想有更多掌控或者已经有了自己的AList实例我更推荐手动用Docker Compose部署下面详细写。3.2 手动Docker Compose部署配置更透明小雅官方提供了docker-compose.yml模板我用到的核心配置如下services: xiaoya: image: xiaoyaliu/alist:latest container_name: xiaoya ports: - 5678:80 - 5344:5344 volumes: - /opt/xiaoya/data:/data - /opt/xiaoya/config:/config - /opt/xiaoya/d:/d environment: - PUID0 - PGID0 - TZAsia/Shanghai restart: unless-stopped这个文件的关键点在于ports把容器内的80端口映射到宿主机的5678这样浏览器访问http://IP:5678就是AList界面。5344是小雅IEAD模式的端口如果不需要可以删掉。volumes把宿主机的/opt/xiaoya下的目录挂载到容器内。/data存数据库和配置/config存网络配置/d是资源目录后续下载的媒体文件、临时缓存都会放到这里。PUID/PGID设置为0代表以root运行很多教程推荐这个值主要是为了避免容器内的权限问题。如果追求更安全也可以改成你当前用户的UID但可能会遇到目录写入权限不足的问题。TZAsia/Shanghai设置时区避免日志时间对不上。写好配置文件后在文件所在目录下执行docker compose up -d-d参数表示后台运行。启动后执行docker logs -f xiaoya可以实时看容器日志确认启动过程正常。我对比过脚本和手动两种方式对于第一次使用的朋友脚本确实更省心但如果你后续想调整挂载路径、改端口、换时区手动写Compose文件反而更容易定位问题。我个人后来一直用的手动方式因为反向代理、HTTPS证书这些配置都跟着docker-compose走整个服务栈一处管理逻辑清晰。3.3 两个token文件的神奇作用小雅这套方案中最重要的准备工作就是准备token文件。整个部署过程中最容易卡住的地方也在这里。小雅默认会读取/opt/xiaola/data下的两个文本文件mytoken.txt放的是阿里云盘的refresh_token用于访问云盘资源。myopentoken.txt放的是阿里云盘开放平台的token用于部分目录的只读访问。为什么小雅特别依赖阿里云盘的token因为小雅整理的很多公共资源索引都以阿里云盘为存储载体没有有效的token容器起来了也拉取不到数据。获取token的方法本质上就是让阿里云盘网页版登录后在浏览器开发者工具里找到认证信息。大致步骤如下使用浏览器登录阿里云盘网页版确保登录成功。按F12打开开发者工具切到Network网络面板。在页面中随便点一个文件夹刷新一下看到有请求返回后从请求头或Cookie里找到refresh_token字段。把这一串字符完整复制下来保存到mytoken.txt中。这里要特别提醒mytoken.txt里的token等于你网盘的访问凭证相当于一把备用钥匙。任何人拿到它都能读取授权范围内的资源千万不能截图、不能发到聊天群里、不能传给别人。每次修改完token文件需要重启容器才能生效docker restart xiaoya等一两分钟再打开网页如果目录正常加载说明token没有问题。如果还是显示空目录或者报错多半是token复制不全或已失效重新获取一次再试。4. 给AList挂载夸克网盘全程记录4.1 为什么夸克网盘被问得最多启动小雅之后你会发现默认挂载的网盘以阿里云盘为主。但现实中很多朋友的主力网盘其实是夸克因为夸克的下载速度、在线播放体验都挺不错加上各种会员活动用户量很大。论坛里“AList挂载夸克网盘”的问题被反复提起说明这确实是个刚需。AList本身对夸克网盘有完善的支持在存储类型里选“Quark”即可。挂载后AList就能以目录形式展示夸克网盘的内容实现在线预览、直接播放相当于给了夸克网盘一个更轻量的访问入口。但夸克网盘的接入方式和阿里云盘不太一样它主要靠Cookie认证没有类似refresh_token的长期凭证所以Cookie过期后需要重新更新这也是后面最常遇到的问题。4.2 从浏览器里拿夸克Cookie的正确姿势获取夸克网盘的Cookie说起来不算复杂但有几个细节容易翻车。第一步用浏览器打开夸克网盘的网页版完成登录。这一步一定要注意账号要在干净环境下登录不建议在公共电脑上操作避免账号信息残留。第二步按F12打开开发者工具切到「网络(Network)」标签页。这时页面上随便点进一个文件夹刷新一下工具面板里会出现一堆请求。第三步在请求列表里找一个类型为xhr或fetch的请求点击它在右侧「请求头(Request Headers)」区域找到Cookie字段。夸克的Cookie很长一般包含__pus、QC-USR等关键标识我们需要把整个Cookie字符串完整复制下来。复制下来之后先不要急着粘贴到AList里。我习惯把它先粘贴到一个临时文本文件里因为AList配置页输入框操作有点笨拙容易误触提前放到文本文件里可以避免二次复制时丢失内容。另外Cookie中包含账号相关标识保存时注意桌面不要被其他人看到。需要注意的一点很多人会错复制成请求头里的Authorization值那个不是Cookie两者需要区分清楚。Cookie的特征是包含一大堆分号分隔的键值对而Authorization是单独的Bearer令牌串。4.3 在AList后台添加夸克挂载打开AList后台默认地址是http://IP:5678用管理员账号登录后进入「管理后台」-「存储」-「添加」。驱动类型选夸克网盘(Quark)然后填入以下内容挂载路径填/quark这个路径决定了你在AList首页看到的目录名可以按自己喜好改成/我的夸克。Cookie把上一步复制的内容粘贴进去。排序策略一般选“按名称排序”或“按修改时间排序”我习惯用修改时间因为新下载的文件靠前找起来方便。提取文件夹可以留空表示展示全部内容如果想只展示某个文件夹可以填文件夹名。保存之后回到存储列表刷新一下页面如果状态显示为work说明挂载成功。这时回到AList首页点开/quark目录应该就能看到夸克网盘里的文件夹了。如果状态显示unauthorized或invalid不要慌绝大多数情况是Cookie复制不完整或者夸克那边检测到风险强制刷新了登录态。重新走一遍获取Cookie的流程替换掉旧的基本都能解决。挂载成功后你可以把小雅的资源目录和自己的夸克目录放在同一个AList里统一管理。比如小雅挂在/xiaoya夸克挂在/quark打开一个页面就能在这两套资源之间自由切换比之前在多个App之间来回跳舒服太多了。5. 体验优化从“能跑”到“好用”5.1 对接Emby/Jellyfin搭出海报墙AList本身就是一个文件列表界面比较朴素。如果想让资源以海报墙的形式展示刮削出封面、简介、演员信息那还需要一个媒体管理工具常用的是Emby和Jellyfin。小雅项目里也提供了Emby的模板配置安装好后可以直接接入。对接思路其实很简单AList/小雅负责把网盘目录虚拟成本地文件系统Emby负责把这些目录当作媒体库进行扫描和刮削。在Emby里添加媒体库时选择小雅映射出来的目录路径设置好内容类型为“电影”或“电视剧”Emby就会自动扫描并匹配海报信息。实际操作中需要留意权限。Emby容器和小雅容器如果都跑在同一台Docker主机上共享文件时要注意挂载路径一致比如宿主机/opt/xiaoya/d映射给小雅是/d映射给Emby也要保持同一个路径否则Emby扫描不到文件。这个问题当时折腾了我半个多小时后来把所有容器对同一个目录的挂载路径统一成一致一下就好了。海报墙搭出来之后效果非常直观。电视端装一个支持Jellyfin或Emby的客户端比如Jellyfin Media Player、Emby for Android TV就能像用流媒体平台一样浏览和播放自己网盘里的资源长辈用起来也没压力。5.2 定时更新脚本让内容保持新鲜小雅的资源目录不是一次性固定的它会定期更新。官方提供了一键更新脚本可以手工执行也可以挂到crontab里定时跑。我写了个简单的定时任务0 4 * * * bash /opt/xiaoya/update_script.sh /var/log/xiaoya_update.log 21这段cron表达式的含义是每天凌晨4点执行更新脚本把输出写入日志文件。选凌晨4点是避开晚高峰实测这个时间网络通常比较空闲拉取更新快也不影响白天使用。如果你用的是NAS也可以直接借助NAS的「计划任务」功能在图形界面里填一下执行时间和命令效果与crontab一样管理起来更直观。定时更新还有一个好处就是能趁你不注意的时候把token过期、目录变更这类问题自动修复一部分。但cookie类内容比如夸克官方更新脚本不一定覆盖所以我的更新脚本里除了更新小雅本身之外还会检查夸克挂载状态发现异常就写一条告警日志。有精力的话还可以让脚本在检测到异常时通过微信通知你别问我是怎么知道这功能很有用的——问就是有一次夸克Cookie过期两天我才发现。5.3 配置备份与恢复防患于未然小雅这套部署最珍贵的不是镜像而是你积累的配置和挂载信息。特别是自定义添加的夸克网盘、分享目录、代理设置这些全部存在/opt/xiaoya/config下一旦丢失全部得重新配。我自己的备份策略是每周日凌晨用tar把/opt/xiaoya打包一次压缩后保留最近4份滚动删除更早的备份。tar -czf /backup/xiaoya_$(date %Y%m%d).tar.gz -C /opt xiaoya find /backup -name xiaoya_*.tar.gz -mtime 28 -delete第一行把/opt/xiaoya打包到/backup目录文件名带日期第二行删除28天前的旧备份避免占用过多磁盘空间。我把/backup目录放到了另一块盘上避免系统盘坏了把所有备份一锅端。恢复的时候就更简单了把备份包解压回原目录重新docker compose up -d即可。我试过一次恢复流程从解压到服务完全启动大概5分钟比重新配置快得多。不用的时候备份静静躺着真出了问题它就是你最值钱的保险。6. 实操中遇到的坑与排查实录6.1 常见问题速查表折腾AList小雅这套东西遇到问题是必然的关键是怎么定位。我把这段时间遇到的高频问题整理成了表格按照“现象 - 原因 - 解决办法”的方式来查看现象可能原因排查与解决办法容器反复重启目录权限不足或配置损坏查看docker logs xiaoya确认报错信息执行chmod -R 777 /opt/xiaoya后重启容器打不开5678界面防火墙未放行端口宿主机执行firewall-cmd --add-port5678/tcp --permanent firewall-cmd --reload云服务器还需检查安全组规则网盘目录空白token失效或未正确写入检查mytoken.txt内容是否完整替换新token后docker restart xiaoya夸克挂载状态unauthorizedCookie过期或复制不完整重新获取浏览器Cookie在AList后台更新存储配置镜像拉取失败网络原因或镜像源问题配置Docker镜像加速器重新docker compose pull容器启动但页面转圈内网DNS解析异常在宿主机ping几个常用域名看能否通必要时修改DNS为公共DNS磁盘占用增长过快临时缓存和日志堆积定期清理/opt/xiaoya/d/temp目录配置日志轮转6.2 分享链接失效与Cookie过期的连环坑先说分享链接。小雅中很多公共资源是通过分享链接方式挂载的一旦原始分享者取消分享或其账号违规被封对应目录就会失效。表现是你打开小雅首页一切正常但点进某个目录时提示“目标地址不存在”或“禁止访问”。这种情况不是你配置错了而是上游资源本身变了。解决办法只有等资源更新脚本重新抓取可用链接或者自己找替代资源挂载。Cookie过期则是另外一种体验AList里夸克挂载状态一直显示work但点进去目录列表空白或者提示“401”。这里有个迷惑性状态显示work只代表认证信息的格式有效不代表夸克服务器真正接受了。遇到这种表象我第一反应就是重新登录夸克网页版把新Cookie换上再说。换Cookie有个小技巧先不要把旧Cookie删掉直接在AList后端“编辑”存储填入新Cookie后保存。万一新Cookie也不生效还能退回旧值对比排查。直接删掉存储再重建虽然也能解决但会把该存储的某些个性化设置一起清掉没必要冒险。6.3 内存和端口冲突的处理记录小雅容器跑起来后内存占用有时候会超出预期。我观察过一次Jellyfin转码占一块、小雅缓存占一块、AList本体又占一块小主机8GB内存一度被吃满UI操作明显变卡。后来定位到问题主要出在小雅的临时转码缓存上它在处理大量视频封面预览时会把中间文件写在/d/temp里时间一长占用很大。处理办法是定期清理/d/temp下的过期文件同时把容器的内存限制写进compose文件services: xiaoya: image: xiaoyaliu/alist:latest mem_limit: 2gmem_limit: 2g表示该容器最多使用2GB内存超过后会被内核回收避免拖垮整机。家用的NAS和小主机配置不高这是个很有效的保护手段。端口冲突也是老问题。很多人NAS上已经装了别的服务占用了80、443这类常用端口小雅镜像内部默认用的是容器80端口映射到宿主机如果撞车容器启动直接报错。解决方案很简单把宿主机映射的端口改掉改成5678:80这种不冲突的组合。改完之后后续使用的地址也跟着变化记得自己记录下来。最后说一点个人体会。AList小雅这套玩法本质上是用本地轻量服务把网盘资源重组成私人媒体中心它解决的不是“存哪”的问题而是“怎么快速找到并播放”的问题。如果你平时收藏了大量网盘资源又受够了在不同App之间反复切换花半天时间折腾一下回报率其实很高。最关键的几步就是准备好正确的token、保证Docker网络通畅、定期备份配置。把这三点做好了后面使用基本很顺。