把云盘都装进一个篮子里：Openlist 部署详细指南

前言你有没有遇到过这样的烦恼手机里装着阿里云盘、百度网盘、夸克甚至还有自己家里 NAS 上的文件每次找个东西都要在几个 App 之间来回切换。想搭个简单的分享页面又觉得搞个专门的网盘系统太重了。Openlist 就是为了解决这个“碎片化”问题而出现的。它是一个轻量级的目录列表程序可以把各种存储服务——不管是各大网盘还是你服务器本地的硬盘——全都聚合到一个统一的 Web 界面里管理。可能有人会问市面上不是有个叫 AList 的工具吗Openlist 和它是什么关系简单来说Openlist 是 AList 被商业公司收购后由原社区用户创建的一个“分支”。因为担心原项目可能存在的闭源风险和隐私问题社区选择 fork 出来继续维护主打的就是完全开源透明和隐私安全优先。如果你比较在意数据自主权这个背景值得了解一下。这篇文章不讲太深的理论我把自己在云服务器上从零开始搭的过程完整写了下来。哪怕你之前没碰过几次命令行跟着一步一步走应该也能搭起来。第一步准备工作1.准备一台具备公网IP的云服务器推荐使用雨云优惠注册地址https://www.rainyun.com/sn_使用优惠码sn注: 使用优惠码注册后绑定微信可领取5折优惠券服务器选购步骤(1). 注册后在总览页面找到云服务器入口进入后点击购买云服务器​(2).根据需求选择合适的配置建议选择国内的服务器访问更快选好后点击立即购买即可(3).选好后进入控制台使用SSH客户端远程连接服务器即可SSH客户端建议选择FinalShell2. 安装 Docker这里我们用一个国内开发者维护的一键安装脚本速度快也不容易出错。bash(curl-f-s--connect-timeout10--retry3https://linuxmirrors.cn/docker.sh)--sourcemirrors.tencent.com/docker-ce --source-registry docker.1ms.run--protocolhttps --install-latestedtrue跑这个脚本的时候中间可能会让你选“公网”还是“内网”默认就是公网直接按回车继续就行。整个过程大概一两分钟等屏幕上出现“安装成功”的提示就 ok 了。装完后验证一下docker--version如果输出了 Docker 的版本号说明环境已经 ready。第二步用 Docker 跑起 Openlist环境准备好之后真正的部署其实就是一行命令的事。但这里有个细节需要注意Openlist 在 2025 年的 v4.1.1 版本里做了一个重大变更改变了权限处理的方式。很多照着旧教程去装的人会遇到“权限不足”的问题。我们这里直接用新版的方法。1. 创建数据目录先给 Openlist 准备一个窝用来存放它的配置文件和数据库。这个目录建议放在/etc下比较符合 Linux 的习惯。mkdir-p/etc/openlist2. 拉取并启动容器执行下面的命令。不用怕我把它拆开解释一下。dockerrun-d\--nameopenlist\--userroot\-p5244:5244\-v/etc/openlist:/opt/openlist/data\--restartunless-stopped\openlistteam/openlist:latest-lite-d后台运行。--name openlist给容器起个名叫 openlist。--user root这是关键。新版本的 Openlist 默认是用 UID 1001 的用户运行但如果你映射的目录权限没调好容器可能无法写入配置。用--user root可以暂时绕开这个问题保证首次启动成功。我们后面再来收紧权限。-p 5244:5244把服务器上的 5244 端口映射到容器的 5244 端口。Openlist 默认跑在这个端口。-v /etc/openlist:/opt/openlist/data把刚才创建的目录挂载到容器里这样配置就不会因为容器删除而丢失。--restart unless-stopped服务器重启或者容器异常退出时Docker 会自动把它拉起来。跑完之后可以用docker ps看一下容器状态。如果STATUS那一栏是Up开头说明已经正常运行了。3. 设置管理员密码新版的 Openlist 默认用户名是admin但初始密码需要我们自己手动设置一下。dockerexecopenlist ./openlist adminset你想要的密码比如你想设成123456就写成docker exec openlist ./openlist admin set 123456。执行成功后命令行会提示你用户名和密码已更新。4. 防火墙放行端口很多云服务器默认有防火墙比如阿里云的“安全组规则”记得去控制台里把5244 端口放开。不然浏览器是访问不到的。现在打开浏览器输入http://你的服务器IP:5244应该就能看到 Openlist 的登录界面了。用刚才设置的账号密码登录进去。第三步把网盘挂进去以夸克为例登录进去之后主页是空的因为还没挂载任何存储。我们来试一下挂载网盘。1. 进入管理后台在页面底部有一个很小的“管理”按钮点进去。2. 添加存储左边菜单栏找到“存储”点“添加”。这时候会看到一个长长的驱动列表从阿里云、百度网盘到 WebDAV 都有。3. 获取夸克网盘的 Cookie以夸克为例以夸克网盘为例。选择驱动为“夸克”。挂载路径可以随便填一个比如quark这是你之后在主页看到的文件夹名字。关键的一步是获取 Cookie用电脑浏览器打开 https://pan.quark.cn/登录你的夸克账号。登录后按 F12 打开开发者工具找到“网络”(Network) 标签。刷新页面然后在网络请求列表里随便点一个请求在右侧的“请求头”(Request Headers) 里找到Cookie:那一长串字符复制下来。另外还需要一个“根文件夹 ID”。在夸克网盘网页版里进入你想挂载的目录地址栏里会有一串数字那就是文件夹 ID。如果想挂载整个网盘填0就行。把 Cookie 和文件夹 ID 填到配置页面里拉到最下面点“添加”。如果状态显示“工作”就说明挂载成功了。4. 开启 302 重定向提升播放体验如果你打算用 Openlist 来看网盘里的视频尤其是 4K 原画有一个设置必须打开。回到存储列表点击刚才添加的网盘“编辑”找到 **“使用转码地址”**或者“Web 代理”之类的开关不同版本叫法可能略有差异但作用类似。这个功能的原理是302 重定向。当你在外网点击播放视频时流量并不是经过你的云服务器中转而是由 Openlist 返回一个网盘的官方直链你的播放器直接去连接网盘服务器。这样一来视频播放的带宽不消耗你云服务器的流量也不受你内网穿透带宽的限制只要你的网盘是 SVIP就能流畅播放。第四步让 Openlist 随系统自动启动这一点其实前面启动容器的时候已经用--restart unless-stopped参数搞定了。不放心的话可以测试一下重启服务器或者手动把容器停掉docker stop openlist过一会儿再看容器应该会自动恢复运行。补充一点关于权限的后续处理如果你是个完美主义者不想让容器以 root 身份运行可以在确认 Openlist 正常运行后去修改权限。先停掉容器docker stop openlist修改映射目录的所有权chown -R 1001:1001 /etc/openlist新版 Openlist 容器内用户 UID 是 1001删掉旧容器docker rm openlist去掉--user root参数重新运行一次docker run命令。不过对于个人使用场景用 root 跑其实问题不大省心第一。写在后面到这里你的云服务器上应该已经跑起了一个功能完整的 Openlist。回想一下整个过程其实就是把各种网盘的“入口”统一到了一个地方。以后再往朋友圈分享文件给一个链接就行不用管对方用的是百度还是阿里。如果只是想临时共享也不用费劲去登录各个网盘的网页版。如果你想把 Openlist 暴露在公网上方便随时访问除了直接用云服务器的公网 IP也可以用 frp 或者 cpolar 这类内网穿透工具配个域名顺便还能套上 HTTPS。不过那就是另一个话题了这里先不展开。希望这篇笔记对你有用。动手试试看吧。