OpenList 项目介绍

社区驱动 · 代码透明 · 持续迭代

OpenList 是由社区独立维护的开源文件列表程序,基于 Gin 与 SolidJS 构建,目标是把分散在本地磁盘与各类网盘中的文件集中到同一个 Web 界面里管理和分享。它支持本地存储、阿里云盘、百度网盘、OneDrive、Google Drive、天翼云盘、123云盘、PikPak、S3 兼容对象存储以及 FTP、SFTP、WebDAV 等多种后端,用户只需在后台添加对应驱动并完成授权,即可在统一目录树中浏览、预览、下载与分享。

项目继承并延续了文件列表类工具的核心能力,同时强调长期治理与代码透明度。部署方式覆盖二进制一键运行、Docker 容器、包管理器安装等,默认监听常见端口,首次启动会生成管理员信息。界面支持明暗主题切换,文件预览覆盖 PDF、Markdown、代码、音视频(含字幕歌词)、Office 文档等常见格式,也可通过 WebDAV 把整个列表挂载到本地文件管理器中使用。

对于需要把多个网盘账号聚合使用、搭建私人文件站或给小团队提供统一入口的用户,OpenList 提供了权限路由、访客控制、离线下载与跨存储复制等实用功能。社区保持活跃更新,文档与安装脚本持续完善,适合有一定自托管经验的个人与技术团队直接上手。

功能亮点推荐

真实场景驱动 · 驱动覆盖广泛 · 预览体验完整

驱动 关注 12.8k

多云统一挂载

📁 存储聚合入口
阿里云盘OneDrive百度网盘

将本地与数十种云存储挂载到同一目录树,减少在不同客户端间切换的操作成本。

👁 28.4k👍 3.2k⭐ 1.9k🔗 860
协议 关注 9.6k

WebDAV 全支持

🔗 协议挂载区
WebDAV本地映射读写控制

开启 WebDAV 后可用系统文件管理器直接访问列表内容,适合与本地工具深度配合。

👁 21.1k👍 2.7k⭐ 1.5k🔗 720
预览 关注 11.2k

丰富文件预览

🎬 在线预览面板
音视频文档代码

支持 PDF、Markdown、代码高亮、Office 文档以及音视频字幕歌词在线预览,减少下载步骤。

👁 25.6k👍 3.0k⭐ 1.7k🔗 690
安全 关注 8.4k

权限与访客控制

🔒 访问策略区
密码保护路由权限访客模式

可为路径设置密码与鉴权,区分管理权限与访客浏览,便于分享特定目录而不暴露全部内容。

👁 18.9k👍 2.3k⭐ 1.3k🔗 540
传输 关注 7.9k

离线与跨存储

⬇️ 任务队列
离线下载跨盘复制批量操作

支持离线下载任务与不同存储间直接复制移动,减少本机中转带来的流量与时间消耗。

👁 16.7k👍 2.1k⭐ 1.1k🔗 480
部署 关注 10.5k

多方式部署

🚀 安装入口
Docker二进制包管理

提供 Docker 镜像、官方脚本、APT/Scoop/WinGet 等安装途径,覆盖主流系统与容器环境。

👁 23.2k👍 2.8k⭐ 1.6k🔗 810
界面 关注 6.8k

SolidJS 前端

🖥 响应式界面
响应式明暗主题多语言

前端基于 SolidJS,界面清爽,支持明暗模式与多语言,在桌面与移动浏览器均有良好表现。

👁 14.3k👍 1.8k⭐ 980🔗 390
扩展 关注 5.7k

驱动持续扩展

📦 驱动市场
对象存储网盘分享协议驱动

社区持续补充新驱动与分享链接支持,覆盖更多国内与国际存储服务,满足不同地区用户习惯。

👁 12.6k👍 1.5k⭐ 820🔗 350
工具 关注 4.9k

桌面与移动端

📱 多端配套
DesktopMobile托盘

配套桌面客户端与移动端应用可辅助管理服务与挂载,适合不习惯纯命令行的用户。

👁 11.4k👍 1.3k⭐ 710🔗 280
社区 关注 15.3k

开源透明治理

🤝 社区协作
AGPLGitHub文档

项目采用 AGPL-3.0 许可,代码与变更公开,社区通过 Issues 与 Discussions 参与功能讨论与问题反馈。

👁 31.5k👍 4.1k⭐ 2.4k🔗 1.1k

项目更新动态

近期提交与版本节奏 · 功能与修复同步推进

11-10

新增 CtFile OpenAPI 驱动

社区贡献者完成城通网盘 OpenAPI 驱动接入,支持列表与基础文件操作,已合并至主分支。

11-09

OneDrive 站点库挂载优化

完善 SharePoint 站点文档库挂载逻辑,解决部分租户下目录结构识别不完整的问题。

11-08

媒体扫描与进度展示

媒体相关任务支持逐层扫描与增量保存,种子任务进度在界面中更清晰可见。

11-07

115 上传重试逻辑加固

针对解密失败与分片上传异常增加重试与安全回退,降低大文件传输中断概率。

11-06

依赖与 WebDAV 细节修复

更新 PostgreSQL 与 rclone 相关模块,同时修正 WebDAV LOCK 响应中的 lockroot 处理。

11-05

前端资源与构建流水线

前端仓库同步版本标签与压缩选项,CI 构建稳定性提升,便于各端配套发布。

11-04

本地驱动列表异常处理

本地存储驱动在权限不足或路径异常时返回明确错误,避免空白目录误导用户。

11-03

文档站点结构整理

新文档站完成安装、驱动与迁移章节梳理,中英文对照内容持续补充中。

11-02

桌面端托盘与挂载状态

Desktop 版本增强服务状态监控与托盘提示,方便后台运行时快速查看挂载情况。

11-01

访客权限说明补充

文档强调迁移时需重新审视访客与 WebDAV 写权限配置,避免旧配置带来的暴露面。

功能分类索引

按使用场景划分 · 快速定位所需能力

☁️

多云聚合

将本地磁盘与多种网盘、对象存储挂载到同一目录树,实现统一浏览与管理入口。

👁️

文件预览

在线预览文档、代码、音视频及 Office 文件,减少不必要的下载,提升日常查阅效率。

🔗

WebDAV挂载

通过标准 WebDAV 协议把列表映射到本地文件管理器,像操作本机文件夹一样使用。

🔒

安全访问

支持路径密码、用户鉴权与访客模式,按需控制可见范围与操作权限,便于安全分享。

⬇️

离线下载

在服务端发起离线下载任务,完成后直接落入指定存储目录,节省本机带宽与时间。

📱

跨端同步

配套桌面与移动端辅助工具,方便在不同设备上管理服务状态与查看挂载情况。

🚀

部署指南

提供 Docker、脚本、包管理器等多种安装路径,覆盖 Linux、Windows、macOS 等环境。

🤝

社区驱动

开源代码与公开讨论区,用户可提交问题、驱动需求与补丁,共同推动项目演进。

相关行业资讯

围绕自托管与网盘聚合生态的观察

自托管文件列表工具使用率持续上升

2026-11-09

越来越多用户选择将多个网盘统一到自建列表服务中,既方便管理又避免单一客户端限制,带动相关开源项目关注度提升。

WebDAV 在个人媒体库中的常见用法

2026-11-08

许多用户通过 WebDAV 将云端视频目录挂载给本地播放器或 NAS 应用,减少重复下载,同时保持目录结构一致。

容器化部署成为文件服务主流选择

2026-11-07

Docker 与 docker-compose 降低了自托管门槛,用户更倾向用容器隔离运行文件列表服务,并配合反向代理对外提供访问。

多存储复制对带宽与配额的影响

2026-11-06

跨网盘直接复制虽方便,但仍受源与目标 API 限速与配额约束,合理规划任务时段与并发数仍有必要。

开源项目治理透明度受用户重视

2026-11-05

在经历部分项目商业化或治理争议后,用户更关注代码公开程度、提交记录与社区响应速度,透明成为选型重要因素。

移动端辅助管理工具需求增加

2026-11-04

除了浏览器访问,用户希望在手机上快速查看服务状态或临时挂载,推动桌面与移动配套应用的发展。

开源文件列表生态深度解析

从聚合需求到治理实践的完整观察

个人与小团队往往同时使用多个网盘与对象存储,账号分散导致查找与分享成本升高。文件列表类工具通过驱动层抽象不同存储 API,把目录结构映射到统一 Web 界面,本质上是在应用层做“存储联邦”。用户不再需要为每个网盘单独打开客户端,而是在一个入口完成浏览、预览与基础管理,这正是此类项目持续受关注的核心原因。

技术实现上,后端通常采用高性能语言处理鉴权、列表缓存与流式传输,前端则负责目录树、预览组件与权限交互。WebDAV 的加入让列表可被系统级文件管理器识别,进一步模糊了“网页工具”与“本地磁盘”的边界。离线下载与跨存储复制则把流量留在服务端或云端之间,减少本机中转,适合带宽充足的服务器环境。

部署形态以自托管为主,Docker 降低了环境差异带来的摩擦。用户需要自行处理域名、HTTPS、反向代理与备份,这也意味着对基础运维有一定要求。权限模型从简单密码保护发展到路径级鉴权与访客模式,反映了从“个人私用”向“有限分享”场景的扩展。迁移时尤其要注意旧配置中的访客与写权限是否仍然合适,避免无意扩大暴露面。

生态层面,驱动数量与更新频率直接影响可用性。国内网盘 API 变更频繁,国际存储则存在区域与合规差异,维护者需要持续跟进。社区贡献驱动与修复补丁,是项目生命力的重要来源。文档质量同样关键,清晰的安装步骤、驱动参数说明与故障排查能显著降低新用户的试错成本。

治理透明度成为近年选型的重要维度。代码公开、提交可追溯、讨论区活跃,能增强用户对长期可维护性的信心。采用宽松或强 copyleft 许可也会影响二次开发与商业使用边界,选型时需结合自身场景阅读许可条款。配套桌面与移动端应用的出现,说明用户并不满足于纯浏览器体验,希望在更多场景下保持对服务的控制。

展望未来,文件列表工具可能与媒体库、同步盘、备份策略进一步结合,形成更完整的个人数据中枢。与此同时,API 稳定性、速率限制与账号安全仍是长期挑战。对使用者而言,合理规划挂载范围、定期检查权限与备份配置,比单纯追求驱动数量更为重要。选择活跃、文档完善且社区响应及时的项目,往往比追逐短暂的功能噱头更稳妥。

快速上手体验指南

从安装到日常使用的五个关键步骤

①

选择部署方式

Docker 适合长期运行,二进制适合快速试用,包管理器便于系统级维护。

②

完成首次启动

启动后记录管理员信息,通过浏览器访问默认端口进入后台完成初始化。

③

添加存储驱动

按文档填写对应网盘或对象存储的授权参数,测试列表是否正常返回。

④

配置访问策略

为敏感路径设置密码或关闭访客,按需开启 WebDAV 并限制写权限。

⑤

日常预览与分享

使用在线预览减少下载,通过链接或 WebDAV 与其他设备或同事协作。

完成上述步骤后,建议先用少量测试目录验证预览、下载与权限是否符合预期,再挂载重要数据。定期关注项目发布说明与驱动变更,遇到 API 失效时及时更新版本或调整参数。备份配置目录可避免重建挂载关系的麻烦,反向代理与 HTTPS 能提升远程访问的安全性与稳定性。

常见问题解答

安装、驱动、权限与使用中的高频疑问

OpenList 与同类文件列表工具有何主要区别?▼
OpenList 由社区独立维护,强调代码公开与长期治理,支持多种存储驱动与 WebDAV,界面基于 SolidJS,部署方式覆盖 Docker、二进制与包管理器,适合希望自托管并关注项目透明度的用户。
支持哪些常见网盘与存储?▼
常见支持包括本地存储、阿里云盘、百度网盘、OneDrive/SharePoint、Google Drive、天翼云盘、123云盘、PikPak、S3 兼容存储、FTP/SFTP、WebDAV 等,具体以官方文档驱动列表为准,社区仍在持续补充。
推荐的部署方式是什么?▼
长期运行优先考虑 Docker 或 docker-compose,便于升级与数据卷管理;临时试用可用官方二进制;熟悉包管理的用户可使用 APT、Scoop、WinGet 等渠道安装,按文档选择对应系统架构。
忘记管理员密码如何处理?▼
可通过命令行工具重置或重新设置管理员密码,具体命令见官方文档。容器部署时也可结合环境变量或进入容器执行管理命令,操作前建议备份配置数据。
如何开启 WebDAV?▼
在后台相关设置中启用 WebDAV 功能,并配置访问账号与权限。启用后可使用支持 WebDAV 的客户端或系统挂载功能连接,注意写权限应仅授予可信账号。
访客模式是否安全?▼
访客模式便于分享公开目录,但若配置不当可能暴露更多内容。建议仅开放必要路径,重要目录加密码或关闭访客,并在迁移旧配置后重新检查权限设置。
文件预览支持哪些格式?▼
常见支持包括 PDF、Markdown、纯文本、代码高亮、图片、音视频(部分支持字幕与歌词)以及 Office 文档预览。具体能力与浏览器解码能力有关,大文件预览可能受带宽影响。
跨存储复制会消耗本机流量吗?▼
多数情况下复制在服务端或云端之间完成,不经过本机,因此主要消耗服务器或云存储的流量与配额。若开启代理或中转模式,则可能占用服务器带宽,需根据实际网络规划。
Docker 部署时数据如何持久化?▼
将数据目录映射为宿主机卷,例如配置与数据库所在路径,升级镜像时保留该卷即可保留挂载与用户信息。具体路径以当前版本文档说明为准。
是否可以只用局域网访问?▼
可以。绑定内网地址并关闭公网端口即可实现局域网访问。若需远程使用,建议配合 VPN、反向代理与 HTTPS,而不是直接暴露管理端口到公网。
驱动授权失败常见原因有哪些?▼
常见原因包括回调地址填写错误、账号权限不足、区域节点选择不当、令牌过期或网盘侧接口变更。对照文档逐步检查参数,并查看服务日志中的具体错误信息。
如何限制某些用户只能读不能写?▼
通过用户与路径权限配置,将目标目录设为只读,或单独控制 WebDAV 写权限。不同版本界面略有差异,以当前后台权限管理页面说明为准。
离线下载需要什么条件?▼
需要服务端具备访问目标资源的网络条件,部分协议对网络环境要求较高。下载完成后文件会落入指定存储目录,可在任务列表中查看进度与结果。
移动端如何管理 OpenList?▼
可通过手机浏览器访问 Web 界面,也可使用社区或官方相关的移动端辅助应用查看服务状态。Android 后台运行受系统策略影响,需根据机型调整电池与自启动设置。
项目使用什么开源许可?▼
核心项目采用 AGPL-3.0 许可,使用与修改时需遵守该许可关于源码公开与网络使用的相关条款。前端等子项目可能采用其他许可,以各仓库声明为准。
更新版本会丢失配置吗?▼
正确映射并保留数据目录的情况下,配置与挂载关系通常会保留。重大版本升级前建议阅读迁移说明并备份,个别驱动参数可能需要手动调整。
是否适合多人协作使用?▼
可通过多用户与路径权限实现有限协作,适合小团队共享资料库。高并发写入或复杂权限需求可能需要结合其他系统,评估时关注性能与审计需求。
音视频播放卡顿怎么优化?▼
卡顿可能来自源存储限速、服务器带宽或播放器缓冲策略。可尝试开启代理、使用直链、调整播放器缓冲,或将热门内容放到速度更好的存储节点。
如何参与社区贡献?▼
可在 GitHub 仓库提交 Issue 反馈问题,通过 Discussions 讨论需求,或按贡献指南提交驱动与修复补丁。文档改进与多语言翻译同样欢迎。
官方文档与演示地址在哪里?▼
文档站点与项目主页以 OpenList 官方仓库与 oplist.org 相关域名公布的信息为准,注意识别非官方仿冒站点,避免使用来源不明的安装包。

用户反馈精选

基于常见使用场景整理的体验描述(非真实用户评价)

林

林小川

2026-11-10

把家里几台 NAS 和两个网盘挂到一起后,找文件方便很多,WebDAV 挂到笔记本上也能直接用。

周

周明远

2026-11-09

Docker 部署很顺利,文档里的卷映射示例帮了大忙,升级时不用重新配驱动。

陈

陈可心

2026-11-09

预览 PDF 和代码很够用,视频带字幕也能播,少下了很多临时文件。

赵

赵一帆

2026-11-08

权限按目录分开后,给同事开只读链接心里踏实不少,不用整盘暴露。

吴

吴思远

2026-11-08

跨盘复制对整理归档很实用,虽然受源站限速,但比本机来回传轻松。

郑

郑小满

2026-11-07

界面干净,手机浏览器也能凑合用,暗色模式晚上翻目录不刺眼。

孙

孙浩然

2026-11-07

从旧列表工具迁过来花了点时间核对权限,文档提醒很有必要,别直接照搬访客设置。

钱

钱志强

2026-11-06

驱动种类够用,偶发授权失败对照日志基本能定位,社区 Issue 回复也算及时。

冯

冯晓彤

2026-11-06

给家里老人做了个只读相册目录,打开链接就能看,不用教复杂客户端。

褚

褚文博

2026-11-05

桌面端托盘能看服务是否在跑,重开机器后不用每次找命令行,省事。

卫

卫思琪

2026-11-05

对象存储挂载后当备份盘用,列表清晰,配合生命周期规则更省心。

蒋

蒋立成

2026-11-04

整体满足个人聚合需求,希望后续驱动对分享链接的支持再稳一点。

社区关注热点

近期讨论较多的话题与实践方向

迁移时权限复查成为共识

2026-11-10

不少用户在更换列表服务后重新梳理访客与 WebDAV 写权限,避免沿用旧配置造成意外暴露。

媒体库与列表工具联动实践

2026-11-09

通过 WebDAV 或直链把云端视频目录提供给本地媒体服务,减少重复占盘,讨论热度较高。

新驱动贡献流程更清晰

2026-11-08

社区整理驱动提交规范与测试要点,降低新人贡献门槛,近期合并速度有所提升。

容器资源占用与缓存策略

2026-11-07

用户分享在小内存设备上的运行经验,合理设置缓存与并发可避免列表卡顿。

文档中英对照持续补全

2026-11-06

安装与驱动章节补充示例与截图,减少因语言或版本差异导致的配置错误。

桌面端挂载状态可视化

2026-11-05

配套桌面应用增强服务与挂载状态展示,方便在图形界面完成日常启停与检查。