先说主线:文件散在七八个网盘里,是时候收拢了
很多人手里的文件是这样的:一部分在百度网盘,一部分在阿里云盘,工作文件在 OneDrive,老照片在移动硬盘挂着的本地目录里。每个网盘一个客户端、一个 App,找文件先要想「它到底在哪个盘里」。
Alist 解决的就是这个问题:它是一个支持几十种存储的文件列表程序,把各家网盘、对象存储、WebDAV、本地目录统统挂载成一个统一的目录树,用一个网页(或 WebDAV)访问所有文件。它本身不存文件,只做「聚合与转发」,所以部署极轻,几十 MB 内存就能跑。
要先分清 Alist 和上一篇 Cloudreve 的定位区别:
| 对比项 | Alist | Cloudreve |
|---|---|---|
| 定位 | 聚合网关:把别处的存储拢到一起 | 网盘本体:文件存在自己服务器上 |
| 文件存放 | 各原始存储处,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)方式挂进去当一个存储源,避免误删。启动后取初始管理员密码:
docker compose up -ddocker exec -it alist ./alist admin random # 随机重置并打印管理员密码# 或者查看首次启动日志里的初始密码docker logs alist | grep -i password登录后第一件事:改管理员密码、把站点地址(外部访问用的完整 URL,含 HTTPS 域名)在「设置 → 站点」里填对。Alist 生成的下载直链、WebDAV 地址都依赖这个设置,填错了外网就下不动文件。入口同样建议走 Nginx Proxy Manager 反代并套上 HTTPS。
WARNINGAlist 默认允许访客(Guest)浏览部分内容,公开部署前务必检查「设置 → 权限」和每个存储的可见范围。把私人网盘以访客可读的方式挂出去,等于把文件目录贴在公网上,曾经有大量公开 Alist 站点因为访客权限没关,被人当成免费资源站甚至翻出私人文件。
添加存储:驱动体系怎么理解
Alist 的核心概念是「存储驱动」:每添加一个存储,就选一个驱动类型,填入该平台的授权信息,再指定挂载路径。比如把阿里云盘挂到 /阿里云盘、百度网盘挂到 /百度网盘、本地目录挂到 /本地,最终呈现为一棵统一目录树。
添加入口在「管理 → 存储 → 添加」。几类最常用的驱动:
| 驱动 | 授权方式 | 注意点 |
|---|---|---|
| 本地存储 | 填容器内路径 | 路径是容器内的,如 /mnt/local |
| 阿里云盘 Open | 扫码授权拿 refresh token | 官方开放接口,相对稳定 |
| 百度网盘 | Cookie 或 OAuth | 官方限速依旧存在,Alist 不绕过会员限速 |
| 夸克网盘 | Cookie | Cookie 会过期,失效后重新获取 |
| OneDrive | OAuth 登录授权 | 国际版与世纪互联版驱动不同,别选错 |
| WebDAV | 地址 + 账号密码 | 可以把 Cloudreve 的 WebDAV 再挂进来 |
| S3 对象存储 | AK/SK + Bucket + Endpoint | 和 Cloudreve 的对象存储策略是同一批桶也能共用 |
几个通用要点:
- 挂载路径就是目录名,用中文没问题,但给播放器、脚本调用时英文路径更少踩坑
- Web 代理 / WebDAV 代理开关决定文件流量是否经过你的 VPS:开代理则下载走服务器带宽(能隐藏源站、但吃流量),关代理则 302 跳转到源站直链(省流量、速度看源站)
- 驱动的令牌、Cookie 都会过期,某个存储突然打不开,先怀疑授权失效,重新授权即可,别急着删了重加
以本地存储为例,添加时驱动选「本地存储」,根文件夹路径填 /mnt/local,挂载路径填 /本地,保存后回到首页就能看到。云盘类驱动按官方文档的授权指引走一遍即可,各平台授权细节时有变化,以 Alist 官方文档对应驱动页为准,这里不写死容易过期的步骤。
权限、用户与访客控制
Alist 的权限分三层,公开部署前逐层确认:
- 全局设置:「设置」里关掉不需要的功能,如访客访问、文件上传、WebDAV 的写入权限按需开
- 用户管理:除管理员外,给家人朋友单独建普通用户,限定其可见的根目录范围(Base Path),比如只能看
/公开分享 - 存储级设置:每个存储可单独设隐藏、只读、禁止下载等;敏感目录用「元信息(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 的「家」,自建文件体系就齐了:外面聚合、里面安放。