导读:本站Aria2篇解决了"下载",Jellyfin篇解决了"播放"——但文件存储这盘棋还有半局没下完:现代人的文件散落在五六个云盘里——阿里云盘存着照片、百度网盘存着资源、OneDrive跟着Office订阅、iCloud锁着苹果设备、加上自己MinIO搭的对象存储——每个盘一个APP、一套会员、一种限速,找个文件要在五个应用之间反复横跳。Alist是这个问题在国内圈最火的答案:一个开源的网盘聚合网关,把所有云盘挂载成统一目录树,网页端像本地文件管理器一样浏览,还能通过WebDAV把云盘"变成本地磁盘"。这篇讲透:多云时代的碎片化困局、Alist的架构与支持列表、Docker部署与初始化、把各家网盘接进来(含refresh token的获取)、网页端与WebDAV挂载的玩法、与Jellyfin/Infuse的组合拳(云盘直接当媒体库)、只读与缓存的流量账、安全加固与公网暴露的纪律、以及它的边界——聚合是"门面",不是"仓库"。
一、多云碎片化:每个人都成了自己的网管
先数数一个普通互联网用户的"存储资产":阿里云盘(送的空间大、不限速,存照片备份)、百度网盘(资源生态最全,下载限速)、OneDrive(Office 365附赠1TB)、iCloud(苹果生态绑定)、夸克/迅雷云盘(下载送的)、还有本站读者特有的——MinIO对象存储(MinIO篇搭的)、小鸡的磁盘、家里的NAS(Syncthing篇连起来的)。每个盘都有存在的理由,但碎片化的代价每天都在付:找文件先想"它在哪个盘"——手机上翻三个APP找一份两年前的PDF;会员费一年交好几份——每家都限速,每家都暗示你开会员;分享链接一家的规矩一套——提取码、限次、有效期各不相同;管理界面五种交互——同一个"移动文件"操作,五套肌肉记忆。这个困局的本质:云盘厂商没有动力互通(数据围墙就是他们的护城河),而用户需要的是"一个入口看到所有文件"。Alist的存在就是为了这最后一句话——它不做存储(数据还在各盘),只做聚合层:统一登录、统一目录树、统一预览、统一分享——把五六个云盘的"门面"收编成一个。
二、Alist是什么:网盘世界的"总前门"
Alist(OpenList的前身故事后面提)是一个Go语言写的开源网盘聚合程序,架构一句话:服务端代理各云盘的API,把它们虚拟成一个统一的文件系统。它的驱动列表是这个项目最惊人的资产——三十多种存储后端全覆盖:国内系(阿里云盘、百度网盘、夸克、迅雷、123云盘、天翼云、移动云盘)、国际系(OneDrive、Google Drive、Dropbox、MEGA)、协议系(WebDAV、SMB、SFTP、S3——你的MinIO直接能挂)、本地磁盘和挂载点——几乎你在用的每一个存储都能被它收编。功能面:网页端的文件管理器(列表/网格视图、预览图片视频音频、在线编辑文本)、多种排序和搜索、直链与分享(任意文件生成下载直链或带密码的分享页)、WebDAV服务端(Alist本身对外暴露WebDAV协议——这个特性是它和各种播放器、同步工具组合的钥匙,后面第六节展开)、离线下载(内置aria2对接——和Aria2篇梦幻联动)、多用户与权限(挂载点可以对不同用户开放不同目录,只读或读写)。和竞品的关系简单交代:CloudDrive2(闭源收费、主打挂载播放)、RaiDrive(客户端挂载工具,不做网页端)——Alist的差异化是开源+驱动全+WebDAV+分享功能四项全能,这也是它GitHub Star数长期领跑的原因。2026年的背景知识:原Alist项目在2025年经历了一次社区分叉(OpenList),本篇以延续维护的版本为准,操作逻辑两者基本一致——选哪个发行版你自己定,功能玩法是同一套。
三、部署:Docker五分钟与初始密码
部署是标准Compose流程(Compose篇配方):
services:
alist:
image: openlistteam/openlist:latest
ports:
- "5244:5244"
volumes:
- ./alist-data:/opt/alist/data
restart: unless-stopped
起来后访问`http://小鸡IP:5244`——首次登录用管理员账号admin,初始密码在容器日志里(`docker logs alist | grep password`能看到随机生成的密码),登录后立刻在"设置→个人资料"里改掉。初始化清单按顺序过:改管理员密码(这个后台能管理你所有网盘的授权,等同于"所有云盘的钥匙串",强密码+记进Vaultwarden——Vaultwarden篇);改站点标题(设置→站点,改成你家的名字,仪式感也是生产力);看一眼版本号(底部或关于页,Alist这类"聚合各云API"的软件更新频繁——云盘厂商改接口,它就要跟进适配,所以保持更新比一般服务更重要,但注意:管理你全部网盘授权的服务,升级前看一眼release note,别无脑追新);对外发布照旧三件套——Nginx反代5244(反代篇)+HTTPS(Caddy篇最省事)+域名(DNS解析篇),`files.example.com`这个地址就是全家的"文件总门"。资源账提前报:Alist本体内存占用100-200MB(驱动多挂几个往上浮),对任何一台2G小鸡都毫无压力——它是轻网关,不是重存储,计算和空间都在各云盘那头。
四、接入网盘:token、cookie与官方OAuth
添加存储是"后台→存储→添加存储",选驱动、填参数——难点集中在身份凭证的获取上,分三档难度讲。简单档,OAuth类:OneDrive、Google Drive、Dropbox这类国际盘——Alist内置OAuth流程,点"获取刷新令牌"跳转官方授权页登录回跳,token自动填入——全程和登录任何网站一样简单;注意挂载路径填个英文名(`/onedrive`),它会成为目录树里的顶层文件夹。中等档,refresh token类:阿里云盘(已改名为阿里云盘open平台,扫码授权流程)——按Alist文档的指引,用官方工具扫码拿到refresh token贴进去——这个token是长期有效的钥匙,泄露等于把整个网盘交给别人,获取工具只用官方文档给的,别用第三方来路不明的"一键获取工具"(token倒卖灰产听说过吧)。坑多档,cookie类:百度网盘——需要从浏览器登录后的开发者工具里提取Cookie字段,且百度风控严:Cookie会过期(几天到几周不等,过期后挂载点变灰要重新提)、频繁大量请求可能触发账号风控——所以百度的正确用法是"浏览和直链为主、别当高速下载通道"。协议类(S3/WebDAV/SFTP)填地址和密钥即可——你的MinIO(MinIO篇)就填endpoint加access key,家庭NAS的SMB也能挂——至此你的所有存储资产在Alist里会师:左侧目录树从上往下:本地磁盘、MinIO、阿里云盘、OneDrive、百度网盘——一个页面,全部文件。挂载参数里值得注意的公共项:根文件夹ID(只挂载网盘的某个子目录,比如只挂阿里云盘的"照片"目录——最小权限原则)、只读模式(只读开关,防误删——多数场景建议开着,真正要写入时再单开一个读写挂载)。
五、网页端与WebDAV:一个入口,两种姿势
Alist的两种使用姿势对应两类场景。姿势一,网页端(浏览与管理):`https://files.example.com`打开就是文件管理器——点开阿里云盘的照片目录直接预览缩略图、点开视频直接网页播放(Alist内置了流式代理播放,画质取决于网盘直链速度)、文本文件在线编辑、右键复制直链或创建分享——给朋友发文件从此不用打开各盘APP:Alist的分享页自带密码和有效期设置,一个链接走天下。多用户玩法:给家人开账号、把"家庭共享"目录(某网盘的子目录)单独挂载给他们——权限只读——网盘的空间是厂商的,但"谁能看什么"的规则从此是你的。姿势二,WebDAV挂载(系统级整合):Alist在网页之外同时暴露标准WebDAV协议(地址就是`https://files.example.com/dav`)——这意味着:Windows/Mac的"映射网络驱动器"直接把它挂成一个盘符(资源管理器里像本地硬盘一样拖拽文件——背后实际在往各云盘读写);iPhone的"文件"APP添加WebDAV服务器——iOS文件管理器直接长出你的全部网盘;各大播放器(Infuse、nPlayer、VidHub)都吃WebDAV——这就打开了第六节的大门。WebDAV账号密码在Alist的用户设置里(注意WebDAV用的密码和网页登录密码是分开的,单独生成一个)。两种姿势的分工:临时找文件、发分享用网页端;长期使用(挂载、播放器接入)用WebDAV——网页端是"总门",WebDAV是"侧门",侧门通向整个生态。
六、组合拳:云盘当媒体库的正确打开方式
Alist最香的应用场景,是它和播放生态的组合——把"云盘"升级成"媒体库"。组合一,Alist+Infuse/VidHub(电视端):Apple TV或电视盒子上装Infuse(或国产的VidHub),添加WebDAV源指向Alist——阿里云盘里那几个TB的影音内容直接变成海报墙:Infuse刮削元数据、记录观看进度,播放时从Alist拉流(Alist代理阿里云盘的直链)——"白嫖网盘空间当私人Netflix"就是这个公式的产物,2024-2025年这玩法在国内圈火到出圈;实操提示:Infuse的WebDAV源填`/dav`路径,Alist挂载里给影音目录建独立挂载点(路径清晰、也方便只读);进度同步用Infuse自己的账户体系。组合二,Alist+Jellyfin(Jellyfin篇的延伸):Jellyfin本身不直接吃WebDAV,但两个路子:其一,Jellyfin的媒体库路径指向rclone挂载的Alist WebDAV(rclone config里加一个webdav类型的remote指向Alist——rclone备份篇的老朋友在新岗位就业)——云盘文件变成Jellyfin的本地目录,刮削、转码、多用户全套照跑;其二,直接用Alist当"冷片库",热门常看的存本地,看Alist的,按需搬运。组合三,Alist+Aria2(Aria2篇的联动):Alist后台可配置离线下载对接aria2 RPC——在Alist网页里丢磁力/HTTP任务,下载落到本地磁盘,再从网页端把文件转存到任意云盘——"下载→归档"一条龙全在浏览器里完成。三个组合共同的甜蜜点:云盘的空间、本地的体验、你自己的规则——厂商给你的是"仓库",Alist+生态给你的是"门面+流水线"。
七、流量与缓存账:小鸡是二传手
Alist的架构决定了它的流量模型:所有经过它的流量都在小鸡上过一遍(它是代理,不是重定向)——这笔账必须算清。浏览和预览:流量极小(缩略图、目录列表都是KB级),忽略不计。在线播放:一部4GB的1080p电影通过Alist代理播放,小鸡流量=4GB进+4GB出(双向各计一次)——家庭看片一天两三部,一个月轻松消耗1-2TB双向——计量小鸡用户看到这里应该已经警觉了:免费的大流量网盘+计量的小鸡=月底账单惊喜。应对策略三层:其一,选大流量或不计量的套餐跑Alist(流量计费篇的表翻出来对一下,现在主流年付小鸡动辄数TB月流量,其实扛得住轻中度使用);其二,直链播放——部分场景可以让客户端直接拿网盘直链播放(绕过小鸡),Alist的设置里有相关选项,但稳定性和通用性不如代理模式;其三,家庭使用走内网——Alist跑在家里NAS上时这条流量不走公网(家里宽带上行扛),小鸡版Alist适合"在外面访问"的轻量场景,家里NAS版适合"日常重度"的看片场景——两台都跑Alist的玩家也不在少数,内外分工。缓存:Alist的目录结构有内存缓存(挂载多、目录大会吃几百MB内存),文件本身不缓存——磁盘压力为零;限速:Alist支持全局限速设置,家里小鸡还跑着别的服务时(哪吒、Vaultwarden全家桶),给Alist限个带宽上限,避免家人看片把你SSH延迟拖到没法用(BBR篇的网络调优也帮不上带宽物理上限的忙)。
八、安全纪律:钥匙串的钥匙串
安全这节比一般服务要重——因为攻破Alist=同时攻破你挂载的所有云盘(它存着各盘的授权token),它是"钥匙串的钥匙串"。清单化:第一,管理员密码强随机(后台能看所有授权token,弱密码等于裸奔——Vaultwarden生成32位随机串);第二,HTTPS必须(WebDAV的密码、各盘token的配置流量都过这条线,明文HTTP等于把钥匙串明着递给沿途所有人——Caddy篇两行配置解决);第三,注册关闭+访客权限最小化(默认有个guest用户,直接禁用或只给公开目录的只读——别让陌生人用你的服务器流量看你的网盘);第四,分享纪律(分享链接自带有效期和密码选项,都设上——Alist分享出去的是网盘直链,对方下载不吃你小鸡流量但也绕过了你的控制,过期回收是好习惯);第五,token的保管(Alist的数据库目录里有各盘的授权凭据——备份时这个目录要加密保管(restic的加密快照天然满足——备份篇),别明文拷进U盘乱放);第六,风控意识(云盘厂商对第三方挂载的态度各异——百度严、阿里松但open接口有频控、微软OneDrive对API调用有配额——重度轮询可能触发账号风控甚至封禁,尤其是用Alist做全自动同步的场景,克制使用,浏览为主)。六条做完,这个聚合层才算配得上它聚合的那些资产。
九、边界:聚合不是备份,门面不是仓库
最后把预期管理做扎实,三条边界。边界一,Alist不是备份工具:它不复制数据,只是换个门面访问——你的文件还是只在原来的云盘里,云盘删了它就没了(哪天网盘清退文件、封号、跑路——百度盘清理违规文件的历史了解一下)——重要数据的3-2-1(备份篇)不因为有了Alist就免除,rclone该跑还得跑。边界二,Alist不是网盘的"去限速"魔法:下载速度的物理上限在各家网盘的策略里(百度不开会员照样限速,Alist代理不了这个——它只是通道,不是加速器);阿里云盘不限速是因为人家本来就不限,不是Alist的功劳——它能给你的是"统一入口",不是"破解",宣传话术里把它说成限速破解工具的都是骗子。边界三,Alist有维护成本:云盘API的变更需要它跟进适配(某盘改版可能让你的挂载失效几天等更新)、token/Cookie会过期要定期重新授权、版本迭代要跟——它是"活的"服务,不是装完就忘的工具——把它接进哪吒监控(哪吒篇)、挂载失效时能收到ntfy通知(ntfy篇,配合健康检查脚本),运维闭环就齐了。三条边界认清后,它依然是目前"多云管理"这个需求下最优雅的答案——毕竟碎片化是厂商强加给你的,而Alist把"统一"的选择权还给了你。
结语
从MinIO的私有对象存储到Syncthing的端到端同步,本站的存储故事一直在讲"把数据搬到自己手里"——这篇的Alist走了另一条路线:数据留在它该在的地方,把入口收归己有。多云是现实,碎片是枷锁,而Alist用三十多个驱动把枷锁熔成了一把总钥匙:网页端一个入口看所有文件、WebDAV让每个播放器和文件管理器都长出你的全部网盘、分享链接一套规矩走天下——连上Jellyfin和Infuse,云盘空间直接升级成家庭媒体库。今晚半小时:拉起容器、先挂一个OneDrive试试OAuth的丝滑、再把阿里云盘的照片目录接进来——当你在手机文件APP里第一次同时看到五六个网盘的目录树时,那种"原来数据一直都在,只是门开错了方向"的通透感,就是折腾的意义。




