跳到主要内容
极客日志极客日志
首页博客AI提示词GitHub精选代理工具
|注册
博客列表

目录

  1. 前言
  2. 准备工作
  3. 第一步:连接到你的服务器
  4. 第二步:装 Docker(最简单的方式)
  5. 第三步:一键部署 OpenList
  6. 第四步:放行防火墙(如果需要)
  7. 第五步:初始化设置
  8. 第六步:挂载你的第一个网盘(以夸克为例)
  9. 第七步:让视频播放更流畅(开启 302 重定向)
  10. 第八步:在外网访问(安全地暴露到公网)
  11. 日常维护:常用命令
  12. 写在最后
Shell / Bash

OpenList 部署完整指南:将网盘挂载至服务器

OpenList 是一款开源目录列表程序,支持多种网盘挂载。本文介绍在 Linux 服务器上通过 Docker 部署 OpenList 的完整流程,包括环境准备、容器安装、防火墙配置、初始化设置、网盘挂载(以夸克为例)、302 重定向优化及外网访问方案(Cloudflare Tunnel)。内容涵盖常用维护命令及安全建议。

咸鱼开飞机发布于 2026/3/17更新于 2026/4/172 浏览

前言

不知道你有没有这样的烦恼:手机里装着百度网盘、阿里云盘、夸克网盘好几个 App,想找个文件得挨个翻一遍;遇到喜欢的电影资源,还得先下载到本地才能看;想给朋友分享个文件,不是限速就是过期。

OpenList 这个工具能帮你解决这些问题。它是一个开源的目录列表程序,可以把各种网盘挂载到一起,统一管理和访问。你打开它的页面,就像打开了自己的文件管理器,里面是你所有网盘的内容,点一下视频就能直接播放,不用下载,也不用担心带宽不够——它会自动帮你找到最快的播放链接。

该工具最早是 AList 的一个分支。原来的 AList 被商业公司收购后,社区里有人担心代码不再透明、可能会有数据收集的问题,所以分出来做了 OpenList,继续走开源的路子。现在它支持阿里云盘、百度网盘、OneDrive、夸克、WebDAV 等几十种存储服务,而且资源占用很低,一台普通的小主机就能跑起来。

本教程将逐步引导你在 Linux 服务器上把 OpenList 搭起来。不管你是刚买了个云服务器想折腾点东西,还是手头有闲置的机器想利用起来,跟着做就行。不需要你有多深的 Linux 基础,我把每个命令都写出来了,复制粘贴就能跑。

准备工作

准备一台具备公网 IP 的 Linux 云服务器

确保服务器已安装 Docker 环境,并可通过 SSH 远程连接。

  1. 注册云服务器账号。
  2. 根据需求选择合适的配置,建议选择国内节点以获得更低延迟。
  3. 购买完成后,使用 SSH 客户端远程连接服务器。

第一步:连接到你的服务器

首先通过 SSH 登录到服务器。打开终端,输入以下命令(把 IP 换成你服务器的实际地址):

ssh root@你的服务器 IP 

如果是第一次连接,会提示你确认主机指纹,输入 yes 回车就行。然后输入密码,登录成功后你会看到类似 root@hostname:~# 的命令行提示符。

第二步:装 Docker(最简单的方式)

OpenList 的安装方式有好几种,编译安装、二进制包、Docker。对新手来说,Docker 是最友好的——装好就能用,不用操心依赖环境,以后升级也方便。

我们先装 Docker。执行下面这一串命令,它会自动把 Docker 装好:

curl -fsSL https://get.docker.com | bash -s docker

这个过程可能有点慢,因为要下载东西。装完之后,确认一下是否成功:

docker --version 

如果看到类似 Docker version 24.0.7 这样的输出,就说明装好了。

第三步:一键部署 OpenList

Docker 装好了,接下来部署 OpenList。运行下面的命令:

docker run -d \
  --name openlist \
  --restart unless-stopped \
  -p 5244:5244 \
  -v /opt/openlist/data:/opt/openlist/data \
  openlistteam/openlist:latest 

解释一下这几行是什么意思:

  • -d:让容器在后台运行,不会占着你的终端窗口。
  • --name openlist:给这个容器起个名字,以后操作它直接用这个名字就行。
  • --restart unless-stopped:如果服务器重启了,容器会自动跟着启动,除非你手动停掉它。
  • -p 5244:5244:把服务器上的 5244 端口映射到容器里的 5244 端口,这样你就能通过服务器的 IP 访问 OpenList 了。
  • -v /opt/openlist/data:/opt/openlist/data:把容器里的数据目录挂载到宿主机上。这一步很重要——如果不挂载,哪天容器删了,你所有的配置就都没了。

运行之后,可以用 docker ps 看看容器是不是正常启动了:

docker ps

输出里应该能看到 openlist 这个容器,状态是 几秒钟或几分钟。

极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog

更多推荐文章

查看全部
  • 本地瓦片地图服务器搭建与配置指南
  • Docker Desktop 中文界面设置指南
  • MySQL 乐观锁与悲观锁详解及高并发方案
  • GoldenDB 分布式数据库架构与 MySQL 迁移实践
  • 金仓数据库 Oracle 与 SQL Server 迁移兼容性对比及实操指南
  • C++ 使用 AMQP-CPP 库集成 RabbitMQ 消息队列详解
  • 前端跨标签页通信:BroadcastChannel 原理解析与实战
  • 利用 RAII 实现 C++ 作用域退出钩子:手写类似 Go defer 的宏

相关免费在线工具

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online

  • HTML转Markdown

    将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online

  • JSON 压缩

    通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online

  • JSON美化和格式化

    将JSON字符串修饰为友好的可读格式。 在线工具,JSON美化和格式化在线工具,online

Up

第四步:放行防火墙(如果需要)

如果服务器有防火墙,需要放行 5244 端口。不同系统命令不太一样:

Ubuntu/Debian 用 ufw:

ufw allow 5244

CentOS 用 firewall-cmd:

firewall-cmd --zone=public --add-port=5244/tcp --permanent
firewall-cmd --reload 

第五步:初始化设置

现在 OpenList 应该已经跑起来了。打开浏览器,输入 http://你的服务器 IP:5244,就能看到登录页面。

第一次登录需要初始化。OpenList 默认的账号密码都是 admin,但为了安全起见,建议先改掉。在终端里执行下面的命令来重置密码(把 你的密码 换成你想设置的):

docker exec openlist ./openlist admin set 你的密码 

执行后会有提示说密码更新成功。然后回到浏览器,用 admin 和新密码登录。

登录进去之后,建议先点右下角的「管理」,进到后台把基本信息改一下。在「个人资料」里可以修改用户名,还有站点标题什么的,按自己喜好来就行。

第六步:挂载你的第一个网盘(以夸克为例)

这一步我们挂载一个夸克网盘试试。登录 OpenList 后台,点左边菜单的「存储」,然后点右上角的「添加」。

在驱动列表里找到「夸克」。需要填几项东西:

  1. 挂载路径:就是你希望在 OpenList 首页看到的文件夹名字,比如 quark。
  2. Cookie:这个是用来让 OpenList 替你访问夸克网盘的。

获取 Cookie 的方法:在浏览器里打开夸克网盘的网页版(https://pan.quark.cn),登录你的账号。然后按 F12 打开开发者工具,找到「网络」标签页。刷新一下页面,在请求列表里随便点一个,找到请求头里的 Cookie 字段,复制整段内容。

还有一个可选填的是「根文件夹 ID」。如果你想挂载夸克网盘的某个子目录,可以填对应文件夹的 ID。获取方法也是在开发者工具里,点进那个文件夹,看地址栏或者网络请求就能找到。如果不填,默认挂载根目录。

填完之后点「添加」,状态应该会变成「工作」。回到主页,就能看到刚才添加的夸克网盘了。点进去试试,里面的文件应该都能看到。

第七步:让视频播放更流畅(开启 302 重定向)

OpenList 有个很实用的功能叫 302 重定向。简单来说,当你点播一个视频时,它不是把视频数据从你的服务器转发给你,而是直接给你一个网盘官方的直链,你的播放器会直接去连接网盘服务器。这样一来,播放视频走的不是你的服务器带宽,而是网盘官方的带宽。

开启方法:在「存储」列表里,找到刚才添加的夸克网盘,点「编辑」。往下翻,找到「使用转码地址」或者「Web 代理」之类的选项(不同驱动叫法可能不太一样),把它打开,保存即可。

之后再播放视频,在播放器里右键查看视频信息,应该能看到地址是夸克的域名,流量不经过你的服务器了。

第八步:在外网访问(安全地暴露到公网)

如果你想让 OpenList 能从外网访问,有几种方式。

最简单直接的是在路由器上做端口映射,但这样不安全,因为 OpenList 本身只靠密码保护,暴力破解的风险比较大。

更好的办法是用 Cloudflare Tunnel。它可以在你和 Cloudflare 之间建立一个加密通道,外面的人访问你的域名时,流量先到 Cloudflare,再通过隧道转发到你的服务器。这样你不需要开放任何入站端口,安全很多。

具体步骤:

  1. 在 Cloudflare 后台,进入 Zero Trust 仪表板。
  2. 左边菜单选「Access」>「Tunnels」,点「Create a tunnel」。
  3. 给隧道起个名字,比如 openlist-tunnel。
  4. 选择你的服务器操作系统,会看到对应的安装命令。在你的服务器上执行那条命令,cloudflared 就会装好并连接上。
  5. 隧道显示活跃后,点「Next」,配置路由。Public hostname 填你想用的域名(比如 pan.你的域名.com),Service 类型选 HTTP,URL 填 localhost:5244。
  6. 保存即可。

过一两分钟,访问你填的域名,应该就能看到 OpenList 了。而且这次是 HTTPS 加密的,地址栏会有小锁图标。

日常维护:常用命令

用 Docker 部署的好处是维护起来很简单。这几个命令你可能会用到:

查看运行状态:

docker ps | grep openlist 

查看日志(如果出问题了先看这个):

docker logs openlist 

重启 OpenList:

docker restart openlist 

停止:

docker stop openlist 

启动:

docker start openlist 

写在最后

到这里,你的 OpenList 应该已经跑起来了,也挂载了第一个网盘。接下来你可以试着添加更多的存储驱动——百度网盘、阿里云盘、OneDrive 的配置方法都差不多,主要就是获取 token 或 cookie,官方文档里写得很详细。

这个工具其实挺能折腾的,有人把它当成家庭影音中心的后端,有人用来做文件分享,也有人配合定时任务做自动备份。怎么用,就看你的需求了。

如果你在安装过程中遇到问题,可以先看看日志,大部分错误提示都能直接告诉你哪里不对。实在搞不定的,去 GitHub 的 issues 里搜一搜,或者找个社区问问。玩开源项目就是这样,边用边学,慢慢就熟了。

2022 年信奥赛 C++ 提高组 CSP-S 初赛真题及答案解析(完善程序第 2 题)
  • C++ 使用 OMPL 库实现 RRT*与 Informed RRT*路径规划对比
  • Kafka Java 生态分布式高吞吐消息队列详解
  • DICOM 标准详解:文件解析、Java/Python 库与 AI 应用
  • 鲁大魔 AI 视频处理工具:安卓端智能二创与去重
  • Claude Code Router 结合内网穿透实现多模型路由与公网访问
  • VcXsrv Windows X Server 使用指南:在 Windows 上运行 Linux 图形应用
  • HarmonyOS 应用开发:常见布局 Row 和 Column
  • Docker 运行 hello-world 镜像失败或超时问题排查
  • Docker 彻底卸载指南:跨平台基础移除与深度清理
  • Docker Compose 常用命令详解
  • Windows 安装 Ubuntu-20.04 操作超时解决方法