先说来历:一个开源项目是怎么「换主人」的
2025 年,网盘聚合圈出了一件大事。用了好几年的 AList 突然被曝出项目已经易主:原作者把项目连同背后的公司卖给了第三方。消息传开后,社区最担心的不是功能,而是信任——AList 里存着大量用户各家网盘的授权令牌,一个天天经手你云盘钥匙的程序,一旦代码不再透明、更新不再可控,谁还敢继续用?
OpenList 就是在这样的背景下诞生的。2025 年 6 月,社区维护者把 AList 分叉出来,成立 OpenListTeam 独立维护,主打两件事:长期治理与代码透明,许可证继续走 AGPL-3.0,代码全部公开在 GitHub 上。半年时间,它已经攒下约 2.56 万星,成为原 AList 用户迁移的主力选择。这篇就把它讲透:它和 AList 是什么关系、怎么部署、老用户怎么迁过来。
项目地址:https://github.com/OpenListTeam/OpenList
功能上,OpenList 和 AList 基本同源:一个网页界面把 50 多种存储聚合到一起——本地目录、阿里云盘、OneDrive、天翼云盘、Google Drive、123 云盘、FTP/SFTP、PikPak、S3、Seafile、又拍云、WebDAV、百度网盘、夸克、迅雷、蓝奏云、115、SMB、Cloudreve、Dropbox、Azure Blob 等等,全都能挂进来统一浏览。文件预览(PDF、Markdown、代码、Office 文档)、图片画廊、音视频在线播放(带歌词与字幕)、直链复制、文件夹打包下载、暗色模式、多语言界面、受保护路径、WebDAV 服务、离线下载、跨存储复制、多线程下载加速,也都齐全。
OpenList 与 AList:到底差在哪
先把两者的关系用一张表说清,免得选型时纠结:
| 对比项 | AList | OpenList |
|---|---|---|
| 维护方 | 已易主至第三方公司 | OpenListTeam 社区团队 |
| 代码透明度 | 后续走向不确定 | 全量开源,AGPL-3.0 |
| 功能与驱动 | 原版功能集 | 与 AList 基本同源,持续同步新驱动 |
| 配置与数据 | — | 与 AList 结构兼容,可直接迁移 |
| 官方渠道 | 原 AList 仓库 | 只认 OpenListTeam 的 GitHub 仓库 |
| 文档 | 原 AList 文档站 | doc.oplist.org |
一句话概括:OpenList 不是另起炉灶的新软件,而是 AList 的社区接管版——功能照旧,治理换人。你之前看过本系列的 Alist 篇 的话,里面的使用习惯九成可以原样搬过来,差的主要是部署镜像和项目归属。
WARNING认准官方仓库,别下到仿冒版。 OpenList 官方明确声明:它与任何同名的第三方项目、付费「同名软件」都没有关系。市面上已经出现挂着 OpenList 名字的仿冒和收费版本,从非官方渠道下载的网盘程序,等于把各家网盘的授权令牌交给陌生人。只从 OpenListTeam 的 GitHub 仓库和官方文档 doc.oplist.org 获取程序与说明,其他来源一律不要信。
部署:Docker Compose 一把梭
部署方式有官方 Docker 镜像、二进制直装等几种,本文以 Docker Compose 为主线,也是官方仓库自带 docker-compose.yml 与 Dockerfile 的路线。找一台能跑 Docker 的机器(VPS、NAS、家里的 Linux 小主机都行),新建一个目录放编排文件:
services: openlist: image: openlistteam/openlist:latest container_name: openlist restart: unless-stopped volumes: - ./data:/opt/openlist/data ports: - "5244:5244" environment: - TZ=Asia/Shanghai - PUID=0 - PGID=0 - UMASK=022几个参数的含义:
- 镜像:
openlistteam/openlist,这是官方镜像名,和 AList 时代的镜像不是同一个,别填错。 - 端口:默认
5244,网页界面、API 与 WebDAV 都走这一个端口。 - 数据目录:
/opt/openlist/data里放着数据库和配置,映射到宿主机的./data,升级、迁移时保住这个目录就行。 - PUID/PGID:控制容器读写挂载目录时的用户身份,填
0是图省事用 root;介意的话改成你宿主机普通用户的编号。
启动:
docker compose up -ddocker logs -f openlist拿管理员密码:第一次登录
OpenList 首次启动时会自动生成管理员密码,初始密码只在第一次启动的日志里出现一次,所以启动后第一件事就是翻日志:
docker logs openlist | grep -i password日志里会有一行类似 initial password is: xxxxxxxx,记下它,浏览器打开 http://你的服务器IP:5244,用用户名 admin 和这个密码登录。
如果日志翻不到了(比如容器重启过几次),不用重装,直接重置:
# 随机生成一个新密码并打印出来docker exec -it openlist ./openlist admin random
# 或者直接指定一个新密码docker exec -it openlist ./openlist admin set 你的新密码登录成功后,先去「个人资料」里把密码改成自己记得住的强密码,再到管理后台的「设置」里把站点标题、公告等按喜好调整一遍。至此网盘本体已经跑起来了,接下来是往里挂存储。
添加存储:本地目录先行,云盘随后
OpenList 的核心玩法是「存储驱动」。进管理后台 →「存储」→「添加」,驱动列表里能看到全部 50 多种类型。建议先加一个本地存储练手:
- 驱动选「本地存储」,挂载路径填
/(这是访客看到的路径,比如填/本地就出现在根目录的「本地」文件夹里)。 - 根文件夹路径填容器内能看到的目录。想把宿主机某个目录映射进来,先在 Compose 里加一行卷映射:
volumes: - ./data:/opt/openlist/data - /你的/宿主机目录:/mnt/files然后根文件夹路径填 /mnt/files,重启容器生效:
docker compose downdocker compose up -d- 保存后回首页,目录应该已经能浏览、能预览了。
再挂云盘的流程都大同小异:选对应驱动(比如阿里云盘、OneDrive、百度网盘),按官方文档 doc.oplist.org 里该驱动的说明拿到授权令牌或刷新令牌,填进表单保存即可。每个驱动需要什么凭证,文档里都写得很细,本文不逐个展开。只提醒一点原则:令牌只填进你自己部署的 OpenList,不要填进任何在线「代挂」「代获取」网站,那些网站拿到的就是你网盘的完整访问权。
挂好之后,几个日常功能顺手就有了:
- 直链与分享:任意文件可以复制直链发给别人,也可以把某个目录设为受保护路径,加密码才可见。
- 离线下载:把下载链接丢给 OpenList,它在服务器上先把文件拉回指定存储,再慢慢取——服务器带宽好时比本地直连快得多。
- 跨存储复制:文件可以在两个已挂载的存储之间直接搬运,比如从 OneDrive 复制到本地目录,全程在网页里点完。
- 聚合其他自建网盘:驱动列表里有 Cloudreve、Seafile、WebDAV,也就是说你之前搭的 Cloudreve 也能作为一个存储挂进 OpenList,当统一入口用。
WebDAV:挂到电脑和手机上当本地盘
OpenList 自带 WebDAV 服务,和网页共用 5244 端口,地址是:
http://你的服务器IP:5244/dav用户名、密码就是 OpenList 的账号(普通用户需要在后台给它开 WebDAV 权限)。Windows 资源管理器、macOS 的 Finder、手机上的文件管理器都能直接连。更进一步,想把云存储真正「变成」本地磁盘、让所有软件都能读写,可以配合本系列后面的 Rclone 篇:Rclone 能把 WebDAV 挂载成本地目录,OpenList 出存储、Rclone 出挂载,正好互补。
如果你的需求其实只是临时中转几个小文件、连服务器都不想开,那是另一条路线——Davflare 把网盘搭在 Cloudflare 上,零服务器成本;OpenList 则是「我有台机器,把所有盘都收拢进来」的路线,两者定位不同,不冲突。
套个域名:反向代理与 HTTPS
5244 端口直接裸奔在公网有两个问题:一是没加密,登录密码和令牌都在明文里跑;二是有些 WebDAV 客户端对非 HTTPS 地址直接拒绝连接。常规做法是前面套一层反向代理,用域名加证书访问。Nginx 的核心配置就这么几行:
server { listen 443 ssl; server_name pan.example.com;
ssl_certificate /path/to/fullchain.pem; ssl_certificate_key /path/to/privkey.pem;
client_max_body_size 0;
location / { proxy_pass http://127.0.0.1:5244; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; }}其中 client_max_body_size 0 这一行别漏:不写的话 Nginx 默认只允许 1 MB 的请求体,网页上传稍大一点的文件就会报 413。反代生效后,进 OpenList 后台的「设置 → 其他」里把「站点地址」填成你的 https://pan.example.com,这样复制出来的直链和 WebDAV 地址才会是正确的外网地址,而不是内网的 IP 加端口。
用户与权限:别只用管理员到处跑
OpenList 支持多用户,日常使用建议分三层,别拿管理员账号到处登录:
- 管理员:只用来改设置、挂存储,不参与日常浏览和 WebDAV 挂载。
- 普通用户:给自己日常用的账号,可以按目录限定它的可见范围——比如只让它看
/本地和/阿里云盘,其他存储对它不可见;再按需勾选 WebDAV 读取、管理等权限。 - 访客(guest):未登录时能看到什么由访客账号决定。只想自己用的话,把访客的可见路径收成空,或者只放一个公开分享目录。
再配合两个小设置,安全性会好很多:一是给敏感目录设「路径密码」,在存储或元信息(Meta)里给指定路径加访问密码,链接发出去也不怕被随便翻;二是在元信息里设置隐藏规则,把不想出现在列表里的文件藏起来。家里有孩子共用、或者要把某个目录临时公开给朋友时,这套权限组合足够用了。
从 AList 迁移:十分钟换完
老 AList 用户迁过来非常简单,因为两者数据结构兼容:
- 停掉旧的 AList 容器,把它的数据目录(原
data文件夹)完整复制一份出来备份。 - 用上面的 Compose 把 OpenList 起起来,先让它生成自己的
data目录,然后停掉。 - 把旧 AList 的
data内容覆盖进 OpenList 的data目录,再启动 OpenList。
docker compose downcp -r /旧alist路径/data/* ./data/docker compose up -d启动后检查一遍:存储列表、用户、站点设置应该都在。个别驱动在新版本里字段有调整的,编辑一下重新保存即可。迁移的核心就一句:保住 data 目录,就保住了一切配置。所以无论用不用 OpenList,平时也要记得备份这个目录。
升级 OpenList 本身同样是三行:
docker compose pulldocker compose up -ddocker image prune -f排障清单
- 5244 打不开:先
docker ps看容器是否在跑,再docker logs openlist看有没有报错;云服务器还要检查安全组/防火墙有没有放行 5244 端口。 - 登录时提示密码错误:多半是初始密码抄错或已经被改过。直接
docker exec -it openlist ./openlist admin random重置,进后台后再改成自己的密码。 - 存储添加后状态显示错误:绝大多数是令牌过期或填错。回驱动表单重新走一遍该驱动文档里的授权流程;阿里云盘、OneDrive 这类用刷新令牌的,令牌失效就要重新获取。
- 本地存储看不到文件:检查 Compose 的卷映射有没有把宿主机目录映射进容器、根文件夹路径写的是不是容器内路径;再确认 PUID/PGID 对应的用户对该目录有读权限。
- WebDAV 连不上或 401:确认地址带了
/dav后缀、端口对;再去后台看该用户是否开启了 WebDAV 读取/管理权限。有些客户端要求 HTTPS,套一层反向代理加证书后再试。 - 在线播放卡、直链下载慢:OpenList 本身只做聚合,流量是否经过你的服务器取决于驱动类型:本地存储和部分驱动走服务器中转,服务器带宽就是上限;302 跳转类驱动则是客户端直连网盘官方,速度与 OpenList 无关。先分清是哪种,再对症下药。
- 升级后页面空白:清浏览器缓存或强制刷新;还不行就看日志里有没有数据库迁移报错,必要时拿备份的
data目录回滚到旧镜像版本。
小结
OpenList 的故事,一半是技术,一半是信任:功能上它就是那个你熟悉的网盘聚合器——50 多种存储挂到一个网页里,预览、直链、WebDAV、离线下载全都有;来历上它把 AList 丢掉的「代码透明、社区治理」重新捡了回来。对新用户,直接从 OpenList 开始;对 AList 老用户,保住 data 目录十分钟就能迁完。最后再重复一遍那句最重要的话:只认 OpenListTeam 的 GitHub 仓库,别的「同名版本」不要碰。