1. 为什么要在飞牛NAS上挂载夸克网盘把夸克网盘挂到飞牛NAS上本质上解决的是一个很现实的问题网盘里的资源怎么让家里的所有设备都能像访问本地硬盘一样直接用。我自己用飞牛NAS有一段时间了最开始的想法很简单就是想把夸克网盘里攒的那几百个G的影视资源、学习资料、软件安装包直接通过飞牛影视刮削出来在电视上、手机上、平板上都能看不用每次下载到本地再折腾一遍。这个需求听起来不复杂但实际操作下来涉及到的技术点比想象中要多。核心链路是这样的夸克网盘通过AList挂载成WebDAV服务飞牛NAS再通过WebDAV协议把这个服务接入到本地文件系统最后飞牛影视扫描这个挂载目录完成媒体库的刮削和播放。整条链路里AList是桥梁WebDAV是协议飞牛影视是最终的消费端。为什么选AList而不是其他方案市面上能挂载网盘的工具不少比如CloudDrive2、Rclone、 RaiDrive这些但AList的优势在于它对国内网盘的支持非常全面夸克网盘、阿里云盘、百度网盘、115网盘都能挂而且更新频率高夸克网盘的接口变动后通常几天内就能适配。另外AList本身支持WebDAV服务端模式这意味着飞牛NAS不需要装额外的客户端直接用系统自带的WebDAV挂载功能就能接入省去了很多配置上的麻烦。还有一个很重要的原因飞牛影视对WebDAV挂载的目录支持得很好。它会把挂载目录当作本地媒体库来扫描刮削海报、简介、演员信息都没问题播放时走的是WebDAV的HTTP流不会占用本地存储空间。对于我这种NAS硬盘容量有限、但又想访问大量网盘资源的人来说这个方案几乎是刚需。适合看这篇内容的人大概分三类第一类是刚入手飞牛NAS想扩展媒体库但不想买大容量硬盘的第二类是已经在用AList但不知道怎么和飞牛影视打通的第三类是遇到过挂载失败、播放卡顿、刮削不出海报这些问题想找排查思路的。不管你是哪一类下面的内容都会从最基础的部署开始一步步把整条链路讲清楚。2. 部署前的准备工作与核心思路拆解2.1 硬件与系统环境确认在开始之前先确认你的飞牛NAS满足以下条件。飞牛NAS的系统版本建议在0.8以上早期版本对Docker和WebDAV的支持不够完善可能会出现挂载后无法读取目录的情况。CPU架构方面x86_64和ARM都支持但如果你用的是ARM设备比如某些矿渣盒子刷的飞牛需要注意AList的Docker镜像要选对应的架构版本否则容器起不来。内存建议至少2GB因为AList本身占用不大但飞牛影视刮削时会消耗一定的内存资源。如果你同时还在跑其他Docker容器比如qBittorrent、Jellyfin这些4GB会更稳妥。存储方面系统盘至少留出10GB的可用空间用来存放AList的配置文件和数据库。虽然AList的配置数据很小但日志和缓存时间长了也会占一些空间。网络环境这块飞牛NAS需要能正常访问外网因为AList要调用夸克网盘的API接口。如果你的网络环境有特殊的DNS或者代理设置需要确保AList容器能正常解析夸克网盘的域名。另外飞牛NAS和你的播放设备电视、手机最好在同一个局域网内这样WebDAV走内网传输速度会快很多。2.2 为什么选择AList加WebDAV的组合AList的核心能力是聚合多种存储服务它支持挂载的网盘列表非常长夸克网盘只是其中之一。选择AList作为中间层有几个很实际的好处。第一AList把不同网盘的API差异屏蔽掉了对外统一暴露成WebDAV协议飞牛NAS只需要支持WebDAV就能接入所有网盘。第二AList支持缓存和重试机制网盘接口偶尔抽风的时候AList会自动重试不会直接导致飞牛影视播放失败。第三AList的WebDAV服务支持多用户和权限控制你可以给不同的设备分配不同的账号避免所有人都用同一个管理员账号。WebDAV这个协议虽然老但胜在兼容性好。飞牛NAS原生支持WebDAV挂载Windows、macOS、iOS、Android也都有成熟的WebDAV客户端。这意味着你挂载好之后不光是飞牛影视能用手机上的nPlayer、电脑上的PotPlayer也能直接通过WebDAV访问夸克网盘里的内容。一套配置多端受益这是我觉得这个方案最划算的地方。2.3 夸克网盘的前期准备夸克网盘这边你需要提前做好两件事。第一是确认你的夸克网盘账号能正常登录并且里面已经有你想要访问的资源。第二是获取夸克网盘的Cookie这是AList挂载夸克网盘时必须的凭证。Cookie的获取方法后面会详细讲这里先提醒一点夸克网盘的Cookie是有有效期的通常几个月会过期一次过期后AList会提示挂载失败需要重新获取并更新。另外夸克网盘对非会员的下载速度有限制但通过AList挂载后走的是WebDAV流实际播放速度取决于夸克网盘对API请求的响应速度。根据我的实测非会员账号在AList下播放视频1080P的码率基本能流畅播放4K高码率的话可能会缓冲。如果你对画质要求很高可以考虑开通夸克网盘会员或者把常看的内容提前缓存到本地。注意夸克网盘的Cookie包含你的账号登录凭证不要分享给任何人也不要在公开的论坛或群里截图展示。AList的配置文件里会明文存储Cookie所以飞牛NAS的访问权限也要控制好避免被其他人看到。3. 在飞牛NAS上部署AList的完整操作3.1 通过Docker Compose部署AList飞牛NAS自带Docker管理功能部署AList最推荐的方式是用Docker Compose因为配置清晰、容易维护、升级也方便。打开飞牛NAS的Docker管理界面找到Compose选项新建一个项目名称填alist然后把下面的配置粘贴进去。version: 3.8 services: alist: image: xhofe/alist:latest container_name: alist restart: unless-stopped ports: - 5244:5244 volumes: - /vol1/1000/docker/alist/data:/opt/alist/data environment: - PUID1000 - PGID1000 - UMASK022 - TZAsia/Shanghai这里有几个参数需要根据你的实际情况调整。/vol1/1000/docker/alist/data这个路径是AList的数据目录你需要改成你自己飞牛NAS上的实际路径。PUID和PGID是运行AList的用户和组ID飞牛NAS默认的第一个用户通常是1000如果你不确定可以在飞牛NAS的终端里输入id命令查看。TZ设置成Asia/Shanghai这样AList的日志时间就是北京时间排查问题的时候方便对照。端口映射这里用的是5244这是AList的默认端口。如果你这个端口已经被其他服务占用了可以改成别的比如15244但后面的访问地址也要相应调整。restart: unless-stopped这个配置很重要它保证AList在飞牛NAS重启后会自动启动不需要你手动去开。配置写好后点击部署飞牛NAS会自动拉取AList的镜像并启动容器。第一次拉取镜像可能需要几分钟取决于你的网络速度。部署完成后在浏览器里输入http://你的飞牛NAS IP:5244如果能看到AList的登录页面说明部署成功了。3.2 获取AList的初始管理员密码AList第一次启动时会自动生成一个随机密码你需要通过命令行查看。在飞牛NAS的终端里执行下面的命令docker exec -it alist ./alist admin random这个命令会重置管理员密码并输出新的随机密码。如果你不想用随机密码也可以直接设置一个固定的docker exec -it alist ./alist admin set 你的新密码执行完命令后用用户名admin和刚才设置的密码登录AList后台。登录后建议第一时间在“个人资料”里修改用户名和密码避免用默认的admin账号。实操心得有些朋友在飞牛NAS的Docker管理界面里找不到终端入口其实可以在飞牛NAS的SSH里执行上面的命令。飞牛NAS默认开启了SSH端口是22用你飞牛NAS的登录账号密码就能连上。如果你没开SSH也可以在Docker管理界面里找到alist容器点击“终端”按钮选择/bin/sh进入容器的命令行后再执行上面的命令。3.3 挂载夸克网盘到AList登录AList后台后点击左侧的“存储”菜单然后点击“添加存储”。在存储类型里选择“夸克网盘”然后填写下面的信息。配置项填写内容说明挂载路径/quark这是AList内部的路径后面WebDAV会用到根文件夹ID留空或填0留空表示挂载整个网盘Cookie你的夸克网盘Cookie核心凭证获取方法见下文排序名称按文件名排序提取文件夹是让AList能识别文件夹结构Cookie的获取方法是这样的在电脑浏览器上登录夸克网盘网页版按F12打开开发者工具切换到Network网络标签然后刷新页面。在请求列表里找到任意一个对夸克网盘域名的请求点击它在右侧的Headers里找到Request Headers部分的Cookie字段把那一整串内容复制下来。注意要复制完整的Cookie包括所有分号分隔的键值对。把Cookie粘贴到AList的配置里后点击“保存”。如果配置正确AList会显示“保存成功”并且在存储列表里能看到夸克网盘的状态是“正常工作”。如果显示“失败”或者“错误”通常是Cookie过期了或者复制不完整重新获取一次再试。注意夸克网盘的Cookie里包含__puus、__pus这些关键字段复制的时候不要漏掉。另外Cookie里可能有换行符粘贴到AList之前最好先去掉换行保证是一整行。3.4 开启AList的WebDAV服务夸克网盘挂载成功后还需要开启AList的WebDAV服务飞牛NAS才能通过WebDAV协议访问。在AList后台点击左侧的“设置”然后找到“WebDAV”相关的配置项。确认WebDAV服务是开启状态默认端口是5244路径是/dav。如果你修改了AList的访问端口WebDAV的端口也会跟着变。AList的WebDAV服务默认使用AList的账号密码进行认证。也就是说飞牛NAS挂载WebDAV时用户名填admin或者你修改后的用户名密码填你设置的AList密码。如果你想让飞牛NAS用单独的账号访问WebDAV可以在AList的“用户”菜单里新建一个用户然后在WebDAV配置里指定这个用户只能访问特定的挂载路径。验证WebDAV是否正常工作可以在电脑上打开浏览器输入http://你的飞牛NAS IP:5244/dav如果弹出认证对话框输入AList的账号密码后能看到目录列表说明WebDAV服务正常。如果提示404或者无法访问检查一下AList的WebDAV配置是否开启以及端口是否正确。4. 飞牛NAS挂载WebDAV与飞牛影视接入4.1 在飞牛NAS上添加WebDAV挂载飞牛NAS的文件管理里自带“远程挂载”功能支持WebDAV协议。打开飞牛NAS的“文件管理”在左侧找到“远程挂载”或者“网络存储”选项点击“添加挂载”。在协议类型里选择WebDAV然后填写下面的信息。配置项填写内容说明挂载名称夸克网盘自定义名称方便识别服务器地址http://127.0.0.1:5244/dav如果AList和飞牛NAS在同一台机器上用户名adminAList的登录用户名密码你的AList密码AList的登录密码挂载路径/vol1/1000/quark飞牛NAS本地的挂载点服务器地址这里有个细节如果AList和飞牛NAS在同一台设备上可以用127.0.0.1或者localhost但有些飞牛NAS的版本对localhost的支持不太好建议直接用飞牛NAS的局域网IP比如192.168.1.100:5244/dav。这样即使AList容器重启挂载也不会断。挂载路径是飞牛NAS本地的目录你需要提前在文件管理里创建好这个目录。比如我在/vol1/1000/下面新建了一个quark文件夹挂载成功后夸克网盘里的内容就会出现在这个文件夹里。挂载类型建议选“读写”虽然大部分时候我们只需要读取但有时候飞牛影视刮削时需要写入一些元数据文件只读挂载可能会导致刮削失败。点击“确定”后飞牛NAS会尝试连接AList的WebDAV服务。如果配置正确几秒钟后就能在文件管理里看到挂载的目录点进去就能浏览夸克网盘里的文件了。如果提示“连接失败”或者“认证失败”先检查AList的WebDAV服务是否正常再确认用户名密码是否正确。4.2 飞牛影视添加媒体库的注意事项WebDAV挂载成功后打开飞牛影视进入“媒体库”设置点击“添加媒体库”。媒体库类型根据你的内容选择电影选“电影”剧集选“电视剧”混合内容选“其他”。媒体库文件夹选择刚才挂载的WebDAV目录比如/vol1/1000/quark/影视资源。这里有一个很关键的细节飞牛影视扫描WebDAV目录的速度比扫描本地目录慢很多因为每次读取文件信息都要通过WebDAV协议请求AListAList再去请求夸克网盘的API。如果你的夸克网盘里文件很多比如几千个视频文件第一次扫描可能需要十几分钟甚至更久。建议第一次添加媒体库时先只挂载一个子目录比如/quark/电影等扫描完成后再逐步添加其他目录。刮削器的选择上飞牛影视默认用的是TMDB这个刮削器对国内影视资源的识别率还可以但如果你存的是国产剧或者综艺可能需要手动调整。我自己的做法是先把文件命名规范好比如“电影名称 (年份).mkv”或者“剧集名称/Season 01/剧集名称 S01E01.mkv”这样刮削器识别起来准确率会高很多。实操心得飞牛影视在扫描WebDAV目录时如果遇到某个文件读取超时会跳过这个文件继续扫描后面的。但有时候超时会导致整个扫描任务卡住表现就是进度条一直不动。遇到这种情况可以在飞牛影视的设置里把“扫描超时时间”调大一些比如从默认的30秒改成60秒。另外尽量在飞牛NAS空闲的时候进行首次扫描避免同时跑其他占用网络的任务。4.3 播放体验与性能调优挂载完成后实际播放体验取决于几个因素。首先是夸克网盘对API请求的响应速度这个我们控制不了但可以通过AList的缓存设置来优化。在AList的存储配置里有一个“缓存过期时间”的选项默认是30分钟。意思是30分钟内重复访问同一个文件AList会直接用缓存不再请求夸克网盘。你可以把这个时间调大一些比如120分钟减少对夸克网盘API的请求次数。其次是飞牛NAS到播放设备的网络带宽。WebDAV走的是HTTP协议播放视频时是流式传输。如果你的飞牛NAS和电视之间是千兆局域网播放1080P的视频完全没问题。但如果是WiFi连接而且信号不太好可能会缓冲。建议电视或者盒子尽量用网线连接或者用5GHz WiFi。还有一个影响播放体验的因素是视频的编码格式。飞牛影视在播放时如果视频编码是H.264大部分设备都能直接硬解流畅度很好。如果是H.265或者AV1一些老设备可能不支持硬解需要飞牛NAS进行转码。转码会消耗CPU资源如果你的飞牛NAS CPU性能一般转码可能会导致播放卡顿。这种情况下可以在飞牛影视的播放设置里选择“直接播放”而不是“转码播放”让播放设备自己解码。影响因素优化建议预期效果夸克API响应慢增大AList缓存过期时间减少API请求提升响应速度局域网带宽不足电视用网线连接或5GHz WiFi减少缓冲提升播放流畅度视频编码不兼容选择直接播放或提前转码避免NAS转码压力文件数量过多分目录逐步添加媒体库避免扫描卡死5. 常见问题排查与避坑经验5.1 挂载失败与认证错误的排查挂载失败是最常见的问题表现通常是飞牛NAS提示“连接失败”或者“认证失败”。排查的时候按照从近到远的顺序来先确认AList的WebDAV服务是否正常再确认飞牛NAS到AList的网络是否通最后确认AList到夸克网盘的挂载是否正常。具体操作上先在电脑浏览器里访问http://飞牛NAS IP:5244/dav如果能弹出认证框并输入账号密码后看到目录说明AList的WebDAV服务没问题。如果这一步就失败了去AList后台检查WebDAV配置是否开启以及AList容器是否正常运行。如果AList的WebDAV正常但飞牛NAS挂载失败检查飞牛NAS的服务器地址是否填对特别是端口号有没有写错。如果飞牛NAS挂载成功但目录是空的或者提示“无法读取目录”那问题可能出在AList到夸克网盘的挂载上。去AList后台的存储列表里看看夸克网盘的状态如果是“失败”重新获取Cookie并更新。有时候夸克网盘的Cookie没有完全过期但部分接口已经失效表现就是AList显示“正常工作”但实际读取文件时报错。这种情况只能重新获取Cookie。注意飞牛NAS挂载WebDAV时如果服务器地址填的是localhost或者127.0.0.1而AList是跑在Docker里的可能会因为Docker的网络模式导致无法访问。建议直接用飞牛NAS的局域网IP这样最稳妥。5.2 播放卡顿与缓冲的优化思路播放卡顿的原因很多需要逐一排查。先确认是所有视频都卡还是只有特定视频卡。如果只有4K或者高码率的视频卡那大概率是带宽或者夸克网盘的限速问题。如果所有视频都卡那可能是飞牛NAS到播放设备的网络问题或者AList的响应速度问题。一个很实用的排查方法是在电脑上用PotPlayer或者VLC直接通过WebDAV打开视频文件看看播放是否流畅。如果电脑上流畅但电视上卡那就是电视的解码能力或者网络问题。如果电脑上也卡那就是AList到夸克网盘这一段的问题。可以尝试在AList的存储配置里把“下载代理”打开让AList先下载到本地缓存再传给播放端这样能改善播放体验但会占用飞牛NAS的存储空间。还有一个容易被忽略的点飞牛影视在播放WebDAV视频时默认会尝试读取视频的元数据信息比如时长、码率、编码格式。如果视频文件很大这个读取过程可能会比较慢导致播放开始前有一段等待时间。可以在飞牛影视的设置里把“预加载元数据”关掉让播放器直接开始播放减少等待。5.3 Cookie过期与重新获取的时机夸克网盘的Cookie有效期不固定根据我的经验通常在两到三个月左右。过期的表现是AList的存储状态变成“失败”或者飞牛影视里之前能播放的视频突然提示“文件不存在”。这时候就需要重新获取Cookie并更新到AList里。重新获取的步骤和第一次一样浏览器登录夸克网盘F12打开开发者工具找到Cookie字段复制完整内容粘贴到AList的存储配置里保存。更新后不需要重启AList容器也不需要重新挂载飞牛NAS的WebDAVAList会自动使用新的Cookie。为了避免Cookie过期导致服务中断可以设置一个提醒比如每两个月检查一次AList的存储状态。另外如果你在多个设备上登录了夸克网盘或者修改了夸克网盘的密码Cookie可能会提前失效。所以建议专门用一个账号来挂载AList不要和其他人共用。5.4 飞牛影视刮削不出海报的解决方法刮削不出海报通常是因为文件命名不规范或者刮削器无法识别文件内容。飞牛影视的刮削器是根据文件名来匹配的所以文件名里要包含影视作品的名称和年份。比如“流浪地球2 (2023).mkv”就比“新建文件夹/视频1.mkv”更容易被识别。如果文件名没问题但还是刮削不出来可以尝试手动匹配。在飞牛影视的媒体库界面找到那个没有海报的视频点击“编辑”然后手动搜索正确的影视名称选择匹配的结果。飞牛影视会重新刮削这个视频的元数据。还有一个可能的原因是WebDAV挂载的目录权限问题。飞牛影视在刮削时需要读取视频文件的元数据如果WebDAV挂载是只读模式飞牛影视可能无法写入刮削结果。建议把WebDAV挂载设置为读写模式或者在飞牛影视的设置里指定一个本地的刮削缓存目录。问题现象可能原因解决方法挂载失败AList WebDAV未开启或端口错误检查AList设置确认端口和路径目录为空夸克Cookie过期或挂载路径错误重新获取Cookie检查挂载路径播放卡顿带宽不足或夸克限速优化网络开启AList下载代理刮削不出海报文件命名不规范或权限不足规范命名改为读写挂载Cookie频繁过期多设备登录或修改密码专用账号定期检查更新6. 进阶玩法与长期维护建议6.1 多网盘聚合与统一管理AList支持同时挂载多个网盘你可以把夸克网盘、阿里云盘、115网盘都挂到同一个AList实例里然后在飞牛NAS上只挂载一个WebDAV就能访问所有网盘的内容。这样做的好处是管理方便飞牛影视只需要扫描一个媒体库目录就能覆盖多个网盘的资源。具体操作是在AList里添加多个存储每个存储的挂载路径不同比如/quark、/aliyun、/115。然后在飞牛NAS的WebDAV挂载里把根路径指向AList的/dav这样就能看到所有网盘的目录。飞牛影视添加媒体库时可以选择只扫描某个子目录也可以扫描整个根目录。多网盘聚合的一个实际问题是不同网盘的响应速度不一样。夸克网盘通常比较快阿里云盘也还可以115网盘有时候会慢一些。如果飞牛影视同时扫描多个网盘可能会因为某个网盘响应慢而拖慢整个扫描进度。建议把不同网盘的内容分开放在不同的媒体库里这样扫描和播放时互不影响。6.2 定期备份AList配置AList的配置文件存储在数据目录里主要是data文件夹下的config.json和alist.db。这两个文件包含了你的存储配置、用户信息和WebDAV设置。如果飞牛NAS重装或者Docker容器被误删这些配置就会丢失需要重新配置一遍。备份的方法很简单在飞牛NAS的文件管理里找到AList的数据目录把整个data文件夹复制到另一个位置比如飞牛NAS的另一个存储卷或者通过SMB共享复制到电脑上。建议每个月备份一次特别是在添加了新的网盘挂载或者修改了重要配置之后。恢复的时候把备份的data文件夹放回原来的位置然后重启AList容器所有配置就会恢复。注意恢复前要先停止AList容器否则可能会因为文件占用导致恢复失败。6.3 安全加固与访问控制AList的WebDAV服务默认使用AList的账号密码如果你把AList暴露在公网上安全性就很重要。建议不要直接把AList的端口映射到公网如果确实需要远程访问可以通过飞牛NAS自带的远程访问功能或者用其他安全的隧道方案。在AList的用户管理里可以创建多个用户给每个用户分配不同的权限。比如给飞牛NAS创建一个专用用户只允许访问WebDAV不允许登录管理后台。这样即使这个用户的密码泄露也不会影响到AList的管理权限。另外AList的WebDAV服务支持HTTPS如果你有SSL证书可以在AList的设置里开启HTTPS这样WebDAV传输就是加密的。不过对于局域网内的使用场景HTTP已经足够了开启HTTPS反而会增加配置的复杂度。6.4 性能监控与日志排查AList的日志里会记录每次API请求的详细信息包括请求的网盘、文件路径、响应时间、错误信息。如果遇到挂载或者播放问题查看AList的日志是最直接的排查方法。在AList后台的“日志”菜单里可以实时查看日志输出也可以下载日志文件。飞牛NAS的Docker管理界面里也能看到AList容器的资源占用情况包括CPU、内存、网络流量。如果发现AList的内存占用持续增长可能是缓存没有及时清理可以在AList的设置里调整缓存策略或者定期重启AList容器。我自己的做法是每周检查一次AList的存储状态和日志看看有没有异常的错误信息。如果发现某个网盘的挂载频繁失败就提前更新Cookie避免影响使用。飞牛影视的媒体库也定期手动扫描一次确保新增的文件能被及时识别。最后分享一个小技巧如果你在飞牛NAS上同时跑了多个Docker容器建议给AList分配固定的资源限制比如限制内存使用不超过512MBCPU不超过1个核心。这样即使AList出现异常也不会影响到飞牛NAS上其他服务的正常运行。在Docker Compose里可以通过deploy.resources.limits来配置具体参数根据你的飞牛NAS硬件情况调整。
飞牛NAS挂载夸克网盘：AList+WebDAV打通飞牛影视全攻略
1. 为什么要在飞牛NAS上挂载夸克网盘把夸克网盘挂到飞牛NAS上本质上解决的是一个很现实的问题网盘里的资源怎么让家里的所有设备都能像访问本地硬盘一样直接用。我自己用飞牛NAS有一段时间了最开始的想法很简单就是想把夸克网盘里攒的那几百个G的影视资源、学习资料、软件安装包直接通过飞牛影视刮削出来在电视上、手机上、平板上都能看不用每次下载到本地再折腾一遍。这个需求听起来不复杂但实际操作下来涉及到的技术点比想象中要多。核心链路是这样的夸克网盘通过AList挂载成WebDAV服务飞牛NAS再通过WebDAV协议把这个服务接入到本地文件系统最后飞牛影视扫描这个挂载目录完成媒体库的刮削和播放。整条链路里AList是桥梁WebDAV是协议飞牛影视是最终的消费端。为什么选AList而不是其他方案市面上能挂载网盘的工具不少比如CloudDrive2、Rclone、 RaiDrive这些但AList的优势在于它对国内网盘的支持非常全面夸克网盘、阿里云盘、百度网盘、115网盘都能挂而且更新频率高夸克网盘的接口变动后通常几天内就能适配。另外AList本身支持WebDAV服务端模式这意味着飞牛NAS不需要装额外的客户端直接用系统自带的WebDAV挂载功能就能接入省去了很多配置上的麻烦。还有一个很重要的原因飞牛影视对WebDAV挂载的目录支持得很好。它会把挂载目录当作本地媒体库来扫描刮削海报、简介、演员信息都没问题播放时走的是WebDAV的HTTP流不会占用本地存储空间。对于我这种NAS硬盘容量有限、但又想访问大量网盘资源的人来说这个方案几乎是刚需。适合看这篇内容的人大概分三类第一类是刚入手飞牛NAS想扩展媒体库但不想买大容量硬盘的第二类是已经在用AList但不知道怎么和飞牛影视打通的第三类是遇到过挂载失败、播放卡顿、刮削不出海报这些问题想找排查思路的。不管你是哪一类下面的内容都会从最基础的部署开始一步步把整条链路讲清楚。2. 部署前的准备工作与核心思路拆解2.1 硬件与系统环境确认在开始之前先确认你的飞牛NAS满足以下条件。飞牛NAS的系统版本建议在0.8以上早期版本对Docker和WebDAV的支持不够完善可能会出现挂载后无法读取目录的情况。CPU架构方面x86_64和ARM都支持但如果你用的是ARM设备比如某些矿渣盒子刷的飞牛需要注意AList的Docker镜像要选对应的架构版本否则容器起不来。内存建议至少2GB因为AList本身占用不大但飞牛影视刮削时会消耗一定的内存资源。如果你同时还在跑其他Docker容器比如qBittorrent、Jellyfin这些4GB会更稳妥。存储方面系统盘至少留出10GB的可用空间用来存放AList的配置文件和数据库。虽然AList的配置数据很小但日志和缓存时间长了也会占一些空间。网络环境这块飞牛NAS需要能正常访问外网因为AList要调用夸克网盘的API接口。如果你的网络环境有特殊的DNS或者代理设置需要确保AList容器能正常解析夸克网盘的域名。另外飞牛NAS和你的播放设备电视、手机最好在同一个局域网内这样WebDAV走内网传输速度会快很多。2.2 为什么选择AList加WebDAV的组合AList的核心能力是聚合多种存储服务它支持挂载的网盘列表非常长夸克网盘只是其中之一。选择AList作为中间层有几个很实际的好处。第一AList把不同网盘的API差异屏蔽掉了对外统一暴露成WebDAV协议飞牛NAS只需要支持WebDAV就能接入所有网盘。第二AList支持缓存和重试机制网盘接口偶尔抽风的时候AList会自动重试不会直接导致飞牛影视播放失败。第三AList的WebDAV服务支持多用户和权限控制你可以给不同的设备分配不同的账号避免所有人都用同一个管理员账号。WebDAV这个协议虽然老但胜在兼容性好。飞牛NAS原生支持WebDAV挂载Windows、macOS、iOS、Android也都有成熟的WebDAV客户端。这意味着你挂载好之后不光是飞牛影视能用手机上的nPlayer、电脑上的PotPlayer也能直接通过WebDAV访问夸克网盘里的内容。一套配置多端受益这是我觉得这个方案最划算的地方。2.3 夸克网盘的前期准备夸克网盘这边你需要提前做好两件事。第一是确认你的夸克网盘账号能正常登录并且里面已经有你想要访问的资源。第二是获取夸克网盘的Cookie这是AList挂载夸克网盘时必须的凭证。Cookie的获取方法后面会详细讲这里先提醒一点夸克网盘的Cookie是有有效期的通常几个月会过期一次过期后AList会提示挂载失败需要重新获取并更新。另外夸克网盘对非会员的下载速度有限制但通过AList挂载后走的是WebDAV流实际播放速度取决于夸克网盘对API请求的响应速度。根据我的实测非会员账号在AList下播放视频1080P的码率基本能流畅播放4K高码率的话可能会缓冲。如果你对画质要求很高可以考虑开通夸克网盘会员或者把常看的内容提前缓存到本地。注意夸克网盘的Cookie包含你的账号登录凭证不要分享给任何人也不要在公开的论坛或群里截图展示。AList的配置文件里会明文存储Cookie所以飞牛NAS的访问权限也要控制好避免被其他人看到。3. 在飞牛NAS上部署AList的完整操作3.1 通过Docker Compose部署AList飞牛NAS自带Docker管理功能部署AList最推荐的方式是用Docker Compose因为配置清晰、容易维护、升级也方便。打开飞牛NAS的Docker管理界面找到Compose选项新建一个项目名称填alist然后把下面的配置粘贴进去。version: 3.8 services: alist: image: xhofe/alist:latest container_name: alist restart: unless-stopped ports: - 5244:5244 volumes: - /vol1/1000/docker/alist/data:/opt/alist/data environment: - PUID1000 - PGID1000 - UMASK022 - TZAsia/Shanghai这里有几个参数需要根据你的实际情况调整。/vol1/1000/docker/alist/data这个路径是AList的数据目录你需要改成你自己飞牛NAS上的实际路径。PUID和PGID是运行AList的用户和组ID飞牛NAS默认的第一个用户通常是1000如果你不确定可以在飞牛NAS的终端里输入id命令查看。TZ设置成Asia/Shanghai这样AList的日志时间就是北京时间排查问题的时候方便对照。端口映射这里用的是5244这是AList的默认端口。如果你这个端口已经被其他服务占用了可以改成别的比如15244但后面的访问地址也要相应调整。restart: unless-stopped这个配置很重要它保证AList在飞牛NAS重启后会自动启动不需要你手动去开。配置写好后点击部署飞牛NAS会自动拉取AList的镜像并启动容器。第一次拉取镜像可能需要几分钟取决于你的网络速度。部署完成后在浏览器里输入http://你的飞牛NAS IP:5244如果能看到AList的登录页面说明部署成功了。3.2 获取AList的初始管理员密码AList第一次启动时会自动生成一个随机密码你需要通过命令行查看。在飞牛NAS的终端里执行下面的命令docker exec -it alist ./alist admin random这个命令会重置管理员密码并输出新的随机密码。如果你不想用随机密码也可以直接设置一个固定的docker exec -it alist ./alist admin set 你的新密码执行完命令后用用户名admin和刚才设置的密码登录AList后台。登录后建议第一时间在“个人资料”里修改用户名和密码避免用默认的admin账号。实操心得有些朋友在飞牛NAS的Docker管理界面里找不到终端入口其实可以在飞牛NAS的SSH里执行上面的命令。飞牛NAS默认开启了SSH端口是22用你飞牛NAS的登录账号密码就能连上。如果你没开SSH也可以在Docker管理界面里找到alist容器点击“终端”按钮选择/bin/sh进入容器的命令行后再执行上面的命令。3.3 挂载夸克网盘到AList登录AList后台后点击左侧的“存储”菜单然后点击“添加存储”。在存储类型里选择“夸克网盘”然后填写下面的信息。配置项填写内容说明挂载路径/quark这是AList内部的路径后面WebDAV会用到根文件夹ID留空或填0留空表示挂载整个网盘Cookie你的夸克网盘Cookie核心凭证获取方法见下文排序名称按文件名排序提取文件夹是让AList能识别文件夹结构Cookie的获取方法是这样的在电脑浏览器上登录夸克网盘网页版按F12打开开发者工具切换到Network网络标签然后刷新页面。在请求列表里找到任意一个对夸克网盘域名的请求点击它在右侧的Headers里找到Request Headers部分的Cookie字段把那一整串内容复制下来。注意要复制完整的Cookie包括所有分号分隔的键值对。把Cookie粘贴到AList的配置里后点击“保存”。如果配置正确AList会显示“保存成功”并且在存储列表里能看到夸克网盘的状态是“正常工作”。如果显示“失败”或者“错误”通常是Cookie过期了或者复制不完整重新获取一次再试。注意夸克网盘的Cookie里包含__puus、__pus这些关键字段复制的时候不要漏掉。另外Cookie里可能有换行符粘贴到AList之前最好先去掉换行保证是一整行。3.4 开启AList的WebDAV服务夸克网盘挂载成功后还需要开启AList的WebDAV服务飞牛NAS才能通过WebDAV协议访问。在AList后台点击左侧的“设置”然后找到“WebDAV”相关的配置项。确认WebDAV服务是开启状态默认端口是5244路径是/dav。如果你修改了AList的访问端口WebDAV的端口也会跟着变。AList的WebDAV服务默认使用AList的账号密码进行认证。也就是说飞牛NAS挂载WebDAV时用户名填admin或者你修改后的用户名密码填你设置的AList密码。如果你想让飞牛NAS用单独的账号访问WebDAV可以在AList的“用户”菜单里新建一个用户然后在WebDAV配置里指定这个用户只能访问特定的挂载路径。验证WebDAV是否正常工作可以在电脑上打开浏览器输入http://你的飞牛NAS IP:5244/dav如果弹出认证对话框输入AList的账号密码后能看到目录列表说明WebDAV服务正常。如果提示404或者无法访问检查一下AList的WebDAV配置是否开启以及端口是否正确。4. 飞牛NAS挂载WebDAV与飞牛影视接入4.1 在飞牛NAS上添加WebDAV挂载飞牛NAS的文件管理里自带“远程挂载”功能支持WebDAV协议。打开飞牛NAS的“文件管理”在左侧找到“远程挂载”或者“网络存储”选项点击“添加挂载”。在协议类型里选择WebDAV然后填写下面的信息。配置项填写内容说明挂载名称夸克网盘自定义名称方便识别服务器地址http://127.0.0.1:5244/dav如果AList和飞牛NAS在同一台机器上用户名adminAList的登录用户名密码你的AList密码AList的登录密码挂载路径/vol1/1000/quark飞牛NAS本地的挂载点服务器地址这里有个细节如果AList和飞牛NAS在同一台设备上可以用127.0.0.1或者localhost但有些飞牛NAS的版本对localhost的支持不太好建议直接用飞牛NAS的局域网IP比如192.168.1.100:5244/dav。这样即使AList容器重启挂载也不会断。挂载路径是飞牛NAS本地的目录你需要提前在文件管理里创建好这个目录。比如我在/vol1/1000/下面新建了一个quark文件夹挂载成功后夸克网盘里的内容就会出现在这个文件夹里。挂载类型建议选“读写”虽然大部分时候我们只需要读取但有时候飞牛影视刮削时需要写入一些元数据文件只读挂载可能会导致刮削失败。点击“确定”后飞牛NAS会尝试连接AList的WebDAV服务。如果配置正确几秒钟后就能在文件管理里看到挂载的目录点进去就能浏览夸克网盘里的文件了。如果提示“连接失败”或者“认证失败”先检查AList的WebDAV服务是否正常再确认用户名密码是否正确。4.2 飞牛影视添加媒体库的注意事项WebDAV挂载成功后打开飞牛影视进入“媒体库”设置点击“添加媒体库”。媒体库类型根据你的内容选择电影选“电影”剧集选“电视剧”混合内容选“其他”。媒体库文件夹选择刚才挂载的WebDAV目录比如/vol1/1000/quark/影视资源。这里有一个很关键的细节飞牛影视扫描WebDAV目录的速度比扫描本地目录慢很多因为每次读取文件信息都要通过WebDAV协议请求AListAList再去请求夸克网盘的API。如果你的夸克网盘里文件很多比如几千个视频文件第一次扫描可能需要十几分钟甚至更久。建议第一次添加媒体库时先只挂载一个子目录比如/quark/电影等扫描完成后再逐步添加其他目录。刮削器的选择上飞牛影视默认用的是TMDB这个刮削器对国内影视资源的识别率还可以但如果你存的是国产剧或者综艺可能需要手动调整。我自己的做法是先把文件命名规范好比如“电影名称 (年份).mkv”或者“剧集名称/Season 01/剧集名称 S01E01.mkv”这样刮削器识别起来准确率会高很多。实操心得飞牛影视在扫描WebDAV目录时如果遇到某个文件读取超时会跳过这个文件继续扫描后面的。但有时候超时会导致整个扫描任务卡住表现就是进度条一直不动。遇到这种情况可以在飞牛影视的设置里把“扫描超时时间”调大一些比如从默认的30秒改成60秒。另外尽量在飞牛NAS空闲的时候进行首次扫描避免同时跑其他占用网络的任务。4.3 播放体验与性能调优挂载完成后实际播放体验取决于几个因素。首先是夸克网盘对API请求的响应速度这个我们控制不了但可以通过AList的缓存设置来优化。在AList的存储配置里有一个“缓存过期时间”的选项默认是30分钟。意思是30分钟内重复访问同一个文件AList会直接用缓存不再请求夸克网盘。你可以把这个时间调大一些比如120分钟减少对夸克网盘API的请求次数。其次是飞牛NAS到播放设备的网络带宽。WebDAV走的是HTTP协议播放视频时是流式传输。如果你的飞牛NAS和电视之间是千兆局域网播放1080P的视频完全没问题。但如果是WiFi连接而且信号不太好可能会缓冲。建议电视或者盒子尽量用网线连接或者用5GHz WiFi。还有一个影响播放体验的因素是视频的编码格式。飞牛影视在播放时如果视频编码是H.264大部分设备都能直接硬解流畅度很好。如果是H.265或者AV1一些老设备可能不支持硬解需要飞牛NAS进行转码。转码会消耗CPU资源如果你的飞牛NAS CPU性能一般转码可能会导致播放卡顿。这种情况下可以在飞牛影视的播放设置里选择“直接播放”而不是“转码播放”让播放设备自己解码。影响因素优化建议预期效果夸克API响应慢增大AList缓存过期时间减少API请求提升响应速度局域网带宽不足电视用网线连接或5GHz WiFi减少缓冲提升播放流畅度视频编码不兼容选择直接播放或提前转码避免NAS转码压力文件数量过多分目录逐步添加媒体库避免扫描卡死5. 常见问题排查与避坑经验5.1 挂载失败与认证错误的排查挂载失败是最常见的问题表现通常是飞牛NAS提示“连接失败”或者“认证失败”。排查的时候按照从近到远的顺序来先确认AList的WebDAV服务是否正常再确认飞牛NAS到AList的网络是否通最后确认AList到夸克网盘的挂载是否正常。具体操作上先在电脑浏览器里访问http://飞牛NAS IP:5244/dav如果能弹出认证框并输入账号密码后看到目录说明AList的WebDAV服务没问题。如果这一步就失败了去AList后台检查WebDAV配置是否开启以及AList容器是否正常运行。如果AList的WebDAV正常但飞牛NAS挂载失败检查飞牛NAS的服务器地址是否填对特别是端口号有没有写错。如果飞牛NAS挂载成功但目录是空的或者提示“无法读取目录”那问题可能出在AList到夸克网盘的挂载上。去AList后台的存储列表里看看夸克网盘的状态如果是“失败”重新获取Cookie并更新。有时候夸克网盘的Cookie没有完全过期但部分接口已经失效表现就是AList显示“正常工作”但实际读取文件时报错。这种情况只能重新获取Cookie。注意飞牛NAS挂载WebDAV时如果服务器地址填的是localhost或者127.0.0.1而AList是跑在Docker里的可能会因为Docker的网络模式导致无法访问。建议直接用飞牛NAS的局域网IP这样最稳妥。5.2 播放卡顿与缓冲的优化思路播放卡顿的原因很多需要逐一排查。先确认是所有视频都卡还是只有特定视频卡。如果只有4K或者高码率的视频卡那大概率是带宽或者夸克网盘的限速问题。如果所有视频都卡那可能是飞牛NAS到播放设备的网络问题或者AList的响应速度问题。一个很实用的排查方法是在电脑上用PotPlayer或者VLC直接通过WebDAV打开视频文件看看播放是否流畅。如果电脑上流畅但电视上卡那就是电视的解码能力或者网络问题。如果电脑上也卡那就是AList到夸克网盘这一段的问题。可以尝试在AList的存储配置里把“下载代理”打开让AList先下载到本地缓存再传给播放端这样能改善播放体验但会占用飞牛NAS的存储空间。还有一个容易被忽略的点飞牛影视在播放WebDAV视频时默认会尝试读取视频的元数据信息比如时长、码率、编码格式。如果视频文件很大这个读取过程可能会比较慢导致播放开始前有一段等待时间。可以在飞牛影视的设置里把“预加载元数据”关掉让播放器直接开始播放减少等待。5.3 Cookie过期与重新获取的时机夸克网盘的Cookie有效期不固定根据我的经验通常在两到三个月左右。过期的表现是AList的存储状态变成“失败”或者飞牛影视里之前能播放的视频突然提示“文件不存在”。这时候就需要重新获取Cookie并更新到AList里。重新获取的步骤和第一次一样浏览器登录夸克网盘F12打开开发者工具找到Cookie字段复制完整内容粘贴到AList的存储配置里保存。更新后不需要重启AList容器也不需要重新挂载飞牛NAS的WebDAVAList会自动使用新的Cookie。为了避免Cookie过期导致服务中断可以设置一个提醒比如每两个月检查一次AList的存储状态。另外如果你在多个设备上登录了夸克网盘或者修改了夸克网盘的密码Cookie可能会提前失效。所以建议专门用一个账号来挂载AList不要和其他人共用。5.4 飞牛影视刮削不出海报的解决方法刮削不出海报通常是因为文件命名不规范或者刮削器无法识别文件内容。飞牛影视的刮削器是根据文件名来匹配的所以文件名里要包含影视作品的名称和年份。比如“流浪地球2 (2023).mkv”就比“新建文件夹/视频1.mkv”更容易被识别。如果文件名没问题但还是刮削不出来可以尝试手动匹配。在飞牛影视的媒体库界面找到那个没有海报的视频点击“编辑”然后手动搜索正确的影视名称选择匹配的结果。飞牛影视会重新刮削这个视频的元数据。还有一个可能的原因是WebDAV挂载的目录权限问题。飞牛影视在刮削时需要读取视频文件的元数据如果WebDAV挂载是只读模式飞牛影视可能无法写入刮削结果。建议把WebDAV挂载设置为读写模式或者在飞牛影视的设置里指定一个本地的刮削缓存目录。问题现象可能原因解决方法挂载失败AList WebDAV未开启或端口错误检查AList设置确认端口和路径目录为空夸克Cookie过期或挂载路径错误重新获取Cookie检查挂载路径播放卡顿带宽不足或夸克限速优化网络开启AList下载代理刮削不出海报文件命名不规范或权限不足规范命名改为读写挂载Cookie频繁过期多设备登录或修改密码专用账号定期检查更新6. 进阶玩法与长期维护建议6.1 多网盘聚合与统一管理AList支持同时挂载多个网盘你可以把夸克网盘、阿里云盘、115网盘都挂到同一个AList实例里然后在飞牛NAS上只挂载一个WebDAV就能访问所有网盘的内容。这样做的好处是管理方便飞牛影视只需要扫描一个媒体库目录就能覆盖多个网盘的资源。具体操作是在AList里添加多个存储每个存储的挂载路径不同比如/quark、/aliyun、/115。然后在飞牛NAS的WebDAV挂载里把根路径指向AList的/dav这样就能看到所有网盘的目录。飞牛影视添加媒体库时可以选择只扫描某个子目录也可以扫描整个根目录。多网盘聚合的一个实际问题是不同网盘的响应速度不一样。夸克网盘通常比较快阿里云盘也还可以115网盘有时候会慢一些。如果飞牛影视同时扫描多个网盘可能会因为某个网盘响应慢而拖慢整个扫描进度。建议把不同网盘的内容分开放在不同的媒体库里这样扫描和播放时互不影响。6.2 定期备份AList配置AList的配置文件存储在数据目录里主要是data文件夹下的config.json和alist.db。这两个文件包含了你的存储配置、用户信息和WebDAV设置。如果飞牛NAS重装或者Docker容器被误删这些配置就会丢失需要重新配置一遍。备份的方法很简单在飞牛NAS的文件管理里找到AList的数据目录把整个data文件夹复制到另一个位置比如飞牛NAS的另一个存储卷或者通过SMB共享复制到电脑上。建议每个月备份一次特别是在添加了新的网盘挂载或者修改了重要配置之后。恢复的时候把备份的data文件夹放回原来的位置然后重启AList容器所有配置就会恢复。注意恢复前要先停止AList容器否则可能会因为文件占用导致恢复失败。6.3 安全加固与访问控制AList的WebDAV服务默认使用AList的账号密码如果你把AList暴露在公网上安全性就很重要。建议不要直接把AList的端口映射到公网如果确实需要远程访问可以通过飞牛NAS自带的远程访问功能或者用其他安全的隧道方案。在AList的用户管理里可以创建多个用户给每个用户分配不同的权限。比如给飞牛NAS创建一个专用用户只允许访问WebDAV不允许登录管理后台。这样即使这个用户的密码泄露也不会影响到AList的管理权限。另外AList的WebDAV服务支持HTTPS如果你有SSL证书可以在AList的设置里开启HTTPS这样WebDAV传输就是加密的。不过对于局域网内的使用场景HTTP已经足够了开启HTTPS反而会增加配置的复杂度。6.4 性能监控与日志排查AList的日志里会记录每次API请求的详细信息包括请求的网盘、文件路径、响应时间、错误信息。如果遇到挂载或者播放问题查看AList的日志是最直接的排查方法。在AList后台的“日志”菜单里可以实时查看日志输出也可以下载日志文件。飞牛NAS的Docker管理界面里也能看到AList容器的资源占用情况包括CPU、内存、网络流量。如果发现AList的内存占用持续增长可能是缓存没有及时清理可以在AList的设置里调整缓存策略或者定期重启AList容器。我自己的做法是每周检查一次AList的存储状态和日志看看有没有异常的错误信息。如果发现某个网盘的挂载频繁失败就提前更新Cookie避免影响使用。飞牛影视的媒体库也定期手动扫描一次确保新增的文件能被及时识别。最后分享一个小技巧如果你在飞牛NAS上同时跑了多个Docker容器建议给AList分配固定的资源限制比如限制内存使用不超过512MBCPU不超过1个核心。这样即使AList出现异常也不会影响到飞牛NAS上其他服务的正常运行。在Docker Compose里可以通过deploy.resources.limits来配置具体参数根据你的飞牛NAS硬件情况调整。
