2334 字
12 分钟
Alist:把各家网盘聚合成一个文件站
2026-11-15

先说主线:文件散在七八个网盘里,是时候收拢了#

很多人手里的文件是这样的:一部分在百度网盘,一部分在阿里云盘,工作文件在 OneDrive,老照片在移动硬盘挂着的本地目录里。每个网盘一个客户端、一个 App,找文件先要想「它到底在哪个盘里」。

Alist 解决的就是这个问题:它是一个支持几十种存储的文件列表程序,把各家网盘、对象存储、WebDAV、本地目录统统挂载成一个统一的目录树,用一个网页(或 WebDAV)访问所有文件。它本身不存文件,只做「聚合与转发」,所以部署极轻,几十 MB 内存就能跑。

要先分清 Alist 和上一篇 Cloudreve 的定位区别:

对比项AlistCloudreve
定位聚合网关:把别处的存储拢到一起网盘本体:文件存在自己服务器上
文件存放各原始存储处,Alist 只转发自己的磁盘或对象存储
上传透传到对应存储存进自有空间
多用户/分享有,但偏轻量完整网盘式权限与分享
适合统一入口浏览、下载、挂载给播放器长期保存、私人文件托管

一句话:Alist 是「门」,Cloudreve 是「家」。门负责把散落各处的东西找出来,家负责安放真正重要的文件。两者搭配,是自建文件体系最常见的组合。

Docker Compose 部署#

官方镜像 xhofe/alist,部署非常简单:

services:
alist:
image: xhofe/alist:latest
container_name: alist
restart: unless-stopped
environment:
- TZ=Asia/Shanghai
- UMASK=022
ports:
- "127.0.0.1:5244:5244"
volumes:
- ./data:/opt/alist/data
- /你的本地目录:/mnt/local:ro

本地目录建议以只读(:ro)方式挂进去当一个存储源,避免误删。启动后取初始管理员密码:

Terminal window
docker compose up -d
docker exec -it alist ./alist admin random # 随机重置并打印管理员密码
# 或者查看首次启动日志里的初始密码
docker logs alist | grep -i password

登录后第一件事:改管理员密码、把站点地址(外部访问用的完整 URL,含 HTTPS 域名)在「设置 → 站点」里填对。Alist 生成的下载直链、WebDAV 地址都依赖这个设置,填错了外网就下不动文件。入口同样建议走 Nginx Proxy Manager 反代并套上 HTTPS。

WARNING

Alist 默认允许访客(Guest)浏览部分内容,公开部署前务必检查「设置 → 权限」和每个存储的可见范围。把私人网盘以访客可读的方式挂出去,等于把文件目录贴在公网上,曾经有大量公开 Alist 站点因为访客权限没关,被人当成免费资源站甚至翻出私人文件。

添加存储:驱动体系怎么理解#

Alist 的核心概念是「存储驱动」:每添加一个存储,就选一个驱动类型,填入该平台的授权信息,再指定挂载路径。比如把阿里云盘挂到 /阿里云盘、百度网盘挂到 /百度网盘、本地目录挂到 /本地,最终呈现为一棵统一目录树。

添加入口在「管理 → 存储 → 添加」。几类最常用的驱动:

驱动授权方式注意点
本地存储填容器内路径路径是容器内的,如 /mnt/local
阿里云盘 Open扫码授权拿 refresh token官方开放接口,相对稳定
百度网盘Cookie 或 OAuth官方限速依旧存在,Alist 不绕过会员限速
夸克网盘CookieCookie 会过期,失效后重新获取
OneDriveOAuth 登录授权国际版与世纪互联版驱动不同,别选错
WebDAV地址 + 账号密码可以把 Cloudreve 的 WebDAV 再挂进来
S3 对象存储AK/SK + Bucket + Endpoint和 Cloudreve 的对象存储策略是同一批桶也能共用

几个通用要点:

  • 挂载路径就是目录名,用中文没问题,但给播放器、脚本调用时英文路径更少踩坑
  • Web 代理 / WebDAV 代理开关决定文件流量是否经过你的 VPS:开代理则下载走服务器带宽(能隐藏源站、但吃流量),关代理则 302 跳转到源站直链(省流量、速度看源站)
  • 驱动的令牌、Cookie 都会过期,某个存储突然打不开,先怀疑授权失效,重新授权即可,别急着删了重加

以本地存储为例,添加时驱动选「本地存储」,根文件夹路径填 /mnt/local,挂载路径填 /本地,保存后回到首页就能看到。云盘类驱动按官方文档的授权指引走一遍即可,各平台授权细节时有变化,以 Alist 官方文档对应驱动页为准,这里不写死容易过期的步骤。

权限、用户与访客控制#

Alist 的权限分三层,公开部署前逐层确认:

  1. 全局设置:「设置」里关掉不需要的功能,如访客访问、文件上传、WebDAV 的写入权限按需开
  2. 用户管理:除管理员外,给家人朋友单独建普通用户,限定其可见的根目录范围(Base Path),比如只能看 /公开分享
  3. 存储级设置:每个存储可单独设隐藏、只读、禁止下载等;敏感目录用「元信息(Meta)」给指定路径单独加密码

实用做法:自己用管理员账号全量访问;对外分享只给一个受限用户 + 带密码的 Meta 路径;访客(Guest)直接禁用或只放行一个公开目录。

尤其注意搜索功能:Alist 的索引搜索会把文件名建进索引,公开站点开着搜索等于把全部文件名目录对外可查。自用站点无所谓,要对外就关掉搜索或限制范围。

进阶用法:直链、WebDAV 与给播放器供片#

  • 下载直链:文件详情里可复制直链(带签名的 /d/ 路径),拿去给下载工具或当临时图床都行;签名有效期在设置里可调
  • WebDAV 输出:地址是 https://你的域名/dav,用 Alist 账号登录。这样所有挂载的存储又能被当成一个 WebDAV 挂进电脑、手机或播放器
  • 给影音服务供片:Jellyfin 等媒体服务器可以直接添加 Alist 的 WebDAV 或本地路径作为媒体库来源——如果你的影片本来就躺在某个网盘里,这条路能省掉「先下载到本地」的步骤。具体到影音库的搭建看 Jellyfin:私人影音库与硬件转码

流量策略上再强调一次:云盘文件经 Alist 代理下载时,流量走 VPS。1 TB 流量的小鸡别开全站代理下载大文件,一个月就能跑光;自用浏览开直链跳转、给播放器供片时再按需开代理,是流量最省的用法。

和 Cloudreve 怎么搭#

两种典型组合,按需求二选一:

组合方式做法适合
Alist 挂 Cloudreve把 Cloudreve 的 WebDAV 作为一个存储加进 Alist想用一个入口看全部文件
并行使用Alist 管外部网盘聚合,Cloudreve 管自有文件权限边界清晰,最推荐

一般推荐并行:重要文件进 Cloudreve 长期保存并纳入备份;各家网盘的存量文件用 Alist 统一浏览、下载、供片。两者都怕丢的只有 Cloudreve 那份,备份策略不用为网盘平台的存量文件操心。备份体系见 自建服务备份与迁移实战。

常见问题与排障#

添加存储后显示不出来或报错 先看「管理 → 存储」里该条的状态信息,Alist 会给出驱动返回的错误。九成是授权失效(Cookie/token 过期)或根目录 ID 填错,重新授权即可。

下载速度慢 先分清是源站限速还是代理吃带宽:关掉该存储的 Web 代理试直链下载,若立刻变快,说明瓶颈在 VPS 带宽;若依旧慢,是网盘平台本身的限速,Alist 解决不了。

WebDAV 挂载失败或只能读 检查三处:站点地址是否填了正确的外网 HTTPS 地址、用户是否开了 WebDAV 相关权限、反代是否放行了大文件请求体。部分客户端需要用应用密码或单独的 WebDAV 密码,按客户端报错信息对。

容器重启后配置丢失 data 目录没挂载或挂错路径。确认 Compose 里 ./data:/opt/alist/data 存在且目录属主可写。

升级后驱动失效 大版本升级偶尔会调整驱动参数,升级前看一眼官方更新日志;升级后某个存储报错,进编辑页重新保存一次往往就能恢复,切忌手一抖把存储删了重加——分享链接和路径全会变。

小结#

Alist 的价值在于「收拢」:几十种存储一个入口,浏览、下载、WebDAV、供片全解决。部署十分钟,真正要用心的是权限——访客、搜索、用户范围这三处关好,它就是个安全好用的文件门户。搭配 Cloudreve 的「家」,自建文件体系就齐了:外面聚合、里面安放。

Alist:把各家网盘聚合成一个文件站
https://www.anexns.cloudns.org/posts/selfhost-alist/
作者
Anexns
发布于
2026-11-15
许可协议
CC BY-NC-SA 4.0