Openlist Q&A 整理

-3、先看文档，进群提醒你看文档不是说着玩的。
-2、先看文档，进群提醒你看文档不是说着玩的。
-1、先看文档，进群提醒你看文档不是说着玩的。
0、不懂的、报错的、运行不了的先截图找日志问 AI。
1、是的，大多数跟 Alist 兼容，不过建议你不要直接转移配置文件，这样会造成签名错误。
2、阿里网盘 open 先用小雅提供的方案（群里关键词：xiaoya 直接搜就行），Openlist 的正在写。
3、百度网盘的方案理论上是“善意”盗用 es 的，不过直接提供 Openlist 的 client_secret 也属于违规行为。
在 https://api.oplist.org/ 选择 oob，参照上面图片，配置刷新令牌等参数即可。
不过已经写好远程刷新的方法了，等待后续更新。
4、列表里的网盘都支持，或者都在符合一定条件下支持，不如自己对着文档试试。
5、如果你有开发者权限，请参照对应网盘的开发文档，在如下网页：https://api.oplist.org/ 填自己申请到的 id 和 secret，网页开源实现回调功能，由 cf-worker 托管自动运行。
6、WebDAV 的问题：路径需要加入 /dav，记得在用户权限里打开 WebDAV 的权限。
7、关于 Docker 镜像：
ghcr.io/openlistteam/openlist-git:beta和 openlistteam/openlist:beta同步自动构建，更新比较快，
该处镜像的 tag 可能会后续失效。
8、记得自己换映射的文件地址，注意用户权限。

Docker Compose 示例：

services:
openlist-git:
image: 'ghcr.io/openlistteam/openlist-git:beta'
container_name: openlist-git
volumes:
- '/etc/openlist:/opt/openlist/data'
ports:
- '5244:5244'
environment:
- PUID=0
- PGID=0
- UMASK=022
restart: unless-stopped

docker run 方式：

docker run -d
--name openlist-git
-p 5244:5244
-v /etc/openlist:/opt/openlist/data
-e PUID=0
-e PGID=0
-e UMASK=022
--restart unless-stopped
ghcr.io/openlistteam/openlist-git:beta

9、关于 aria2、ffmpeg、aio 的区别：自行查看文档等相关资料，作为阅读能力自测题进行练习。
使用 aria2 和 qb 等外部下载器离线下载需要同时对两边的容器进行目录映射。
10、一键部署脚本（在文档里）似乎已经修复，自行测试，不保证可用性。
11、多看看置顶，里面有好东西。
12、多试少问，开源的乐趣在于折腾。

自有115密钥填写方式。

感谢 Telegram 用户 35*****86 的支持
我们目前临时借用到了阿里云盘开发者账户
正在紧急上线中
已上线API站点

感谢 BV1kuN2zhEyX 作者提供的视频
我们将尽快进行Google认证
以去除100用户数限制
---
失败了，但是应该是我们自己的问题，我们还要重新做一个，会做视频想上感谢榜的联系一下管理
---
又失败了 说视频里还得加Consent页面的内容。。。😑Consent我们是之后才加的。。。请大家继续耐心等候

🎉🎉🎉
📣CLAWCLOUD已恢复支持
请使用Lite 版本镜像
Image Tag: latest-lite
内存 64M CPU 0.1C 即可使用
每日仅 0.01 USD
Github 注册满6个月的用户可以 点此 每月白嫖5 USD

🚨 更新提醒：4.0.8
📣
用户悉知：
🔧 版本 4.0.7 存在以下已知问题，建议有需要的用户尽快更新至 4.0.8：
1.⚠️并发下载异常：影响默认并发下载驱动（如夸克Quark、UC、超星ChaoXing）、支持并发的驱动如别名Alias驱动等。
2.📦无法从 S3 驱动下载文件。

📥 请有需要的用户尽快更新，避免受影响。

各位开发者及用户，衷心感谢大家长期以来对 OpenList 项目的关注与支持。
近期，我们注意到有部分名称相似的项目（例如 OpenListApp/OpenListApp）在社区内开展活动，其间出现了与本项目相关的许可证争议及不当言论。同时，我们也关注到，在沟通交流过程中，我方部分开发成员遭遇了不恰当、不专业的言语攻击。

为避免社区误解，现作以下澄清：
✅ OpenList 项目为免费开源软件，基于上游 Alist 项目分叉开发，由 OpenListTeam 负责维护。
✅ 本项目长期遵循 AGPL-3.0 开源许可证，所有代码均免费公开，文档和 API 服务依托 Cloudflare 公益资源运行，目前无任何收费计划或商业行为

我们欢迎第三方在合规前提下衍生使用，但也希望：
🙏 尊重开源协议，以符合开源精神的方式选择适当的开源许可证
🙏 避免以 “OpenList” 名义开展商业活动
🙏 保持开放、友善的沟通氛围，珍惜社区协作

🎉🎉🎉 🎉
📣中国大陆API站点现已可用：https://api.oplist.org.cn/

⚠️温馨提示⚠️
海外API站点 https://api.oplist.org/ 因CF近期节点问题
可能无法连接，请受影响用户在Openlist内替换为大陆URL

📣v4.1.0 版本已发布🎉🎉🎉 🎉改善了搜索、排序、驱动等功能
本版本修复了大量新增问题，建议4.0.9和<=4.0.6版本的用户都更新
https://github.com/OpenListTeam/OpenList/releases/tag/v4.1.0

关于123云盘驱动及OpenList相关说明公告

由于123云盘在其平台上引入了防盗链措施（详见：
https://www.123pan.com/Notice/101
），这对基于逆向驱动的使用方式产生了影响。为确保用户能够持续获得最新功能和稳定支持，我们建议仍在使用逆向驱动的用户尽早切换至官方提供的123云盘开放平台驱动 🔧📈。

对于仍坚持使用逆向驱动的用户，我们建议使用“本地代理功能”，以维持现有使用方式。但请注意，未来我们不承诺继续更新或提供对该驱动的进一步支持⚠️。

我们在此重申，OpenList 始终致力于提供开放、透明的技术支持 💡。项目将聚焦于官方支持的接口与规范，并优先保障这些方案的可持续性与稳定性。

对于一些采用逆向方式接入服务的尝试，我们理解部分用户的技术探索需求，但需要提醒大家，相关方式可能不符合服务提供商的条款政策📜，也可能存在后续不稳定或服务中断的风险⚖️。

OpenList 项目代码保持公开，所有开发者与用户均可查看与使用 👨‍💻👩‍💻。我们鼓励大家在使用第三方服务时，优先考虑开放平台和官方支持的方式。

我们也期待更多服务提供商能够明确开放标准与接入方式 🚀，从而为开发者与用户提供更加稳健、可持续的支持🔧。

OpenListTeam 是一个完全由志愿者组成的开源社区维护团队 🤝。我们支持多样化的市场探索方式，并相信开放竞争将推动形成更健康、透明的技术生态 🌱。

感谢大家一直以来的支持与理解！🙏
—— OpenListTeam

补发：
📢 尊敬的社区成员及用户：

为了更好地符合容器规范（甚至哪怕是RedHat的公约性质规定），从第74号问题开始，我们就已经开始准备对容器化使用方式的重构，涉及但不限于将aria2迁移为独立镜像等。

在4.1.1版本中，我们已移除PUID/PGID的运行方式，并且借鉴MariaDB等多个知名镜像的构建方法，通过useradd新增用户和用户组 openlist（UID: 1001，GID: 1001），并以该用户身份运行openlist server。
• 新安装用户：理论上无需额外操作，开箱即用。
• 已有安装用户：如有权限问题，请在宿主机为该用户进行相应授权。

由于Docker和Podman在用户命名空间映射上的差异，宿主机用户与容器用户可能不完全对应。Podman环境下，可以通过UIDMap或UserNS映射用户。

更多详细信息请等待后续文档合并发布。

❓ 常见问题：
Q: 宿主机没有UID 1001的用户怎么办？
A: 不影响使用，授权时采用数字UID即可，无需宿主机实际存在该用户。

感谢大家理解与支持！

⚠️4.1.1版本已经发布，如果遇到权限问题，请参考 文档 来修改权限。
另请参阅: Linux101 Linux201 ArchWiki Linux101-Chapter05-File-Permission

我是这样配置的

需要CDN配置的用户可以按这个demo
为了存储进文档页面，特此转发留存

🚨 更新提醒：4.1.5
📣
用户悉知：
🔧 版本 4.1.3、4.1.4 存在以下已知问题，建议有需要的用户尽快更新至 4.1.5：
1.📈CPU占用高

📥 请有需要的用户尽快更新，避免受影响。

🚨 更新提醒：4.1.7
ℹ️ 支持了docx xlsx pptx前端预览
ℹ️ 修复了百度、谷歌网盘一些问题
ℹ️ 修复了strm、zip、189部分问题

🚨 更新提醒：4.1.9

✨ 新增功能
1、🚗 驱动：新增 AList v3（与Openlist拆分）、个人/企业 WPS 网盘、Cloudreve v4（支持 ks3）
2、🔐 LDAP：WebDAV、FTP、SFTP 登录均可走 LDAP 认证
3、⏱️ 缓存：可针对单一路径单独设置缓存时间
3、📄 STRM：支持“本地保存”模式，可带签名生成
5、🖐 115 网盘：可自定义每页拉取数量
6、⚖️ 别名：支持负载均衡配置
7、📞 139 网盘：新增用户认证与批量文件操作

🌈 体验优化
1、🧹 上传逻辑、启动流程、userAgent 合并等代码全面重构，减少冗余
2、🗂 生成 STRM 时不再留下空文件夹
3、🙈 忽略群晖 @eaDir 系统文件，目录更干净
4、📖 文档：README 新增中文说明、Demo 站点

🔥 问题修复
1、🚫 OneDrive 分享链接、MediaFire、HalalCloud、123 盘、微云、S3（含“+”号复制）等下载/上传异常
2、💥 139 盘容量溢出解析失败、ilanzou VIP 容量识别错误、任务无限被取消
3、🧟 复制到 123 盘时 etag 错误导致失败、S3 默认修改时间为空等细节修复
4、🪞 123 盘递归调用溢出的严重 bug
5、🛡 CI 语言文件仅同步新增字段，避免覆盖已有翻译
6、⏱️豆包分享的默认下载接口改为下载信息

下载地址：https://github.com/OpenListTeam/OpenList/releases/tag/v4.1.9
本次为2026年第一次更新，祝大家新年快乐🎉🎉，假期愉快🎉🎉

各位社区成员：🎉

随着农历新年的临近，为了让开发者和贡献者能够与家人团聚、休整身心，OpenList将在2026年春节期间适度减缓开发和维护节奏。
🛠️ Issue、PR处理可能延迟。
📅 节后恢复正常。

预祝大家新春愉快！🐎🧧✨

🎊 春节假期已结束，OpenList 开发与维护节奏现已恢复。
🛠️ Issue、PR 正常处理。
📅 欢迎继续提交反馈与贡献。

感谢大家的理解与支持！ 🚀

🚨 更新提醒：OpenList v4.2.0

✨ 新增功能
1、🚗 驱动：新增豆包（doubao_new）驱动
2、🔐 权限：实现细粒度权限控制系统
3、⚡️ 迅雷：补全 GetDetails 存储容量接口
4、📝 123 网盘：支持官方 APP API 接入
5、⚡️ 123 网盘：SHA1 秒传支持
6、🔒 安全策略：新增 SECURITY.md 文档

🌈 体验优化
1、✅ 认证模块错误响应优化
2、🔧 CI 标题检查支持 Breaking Change ! 标记
3、📦 go4.org digest 依赖升级至 a507140
4、🔤 UpdateFileReq 字段名拼写修正
5、🔄 CI Issue 配置同步调整

🔥 问题修复
1、🚗 teldrive 分页列表与随机分块命名
2、🔗 115 分享适配官方 API 变更
3、⚠️ 夸克 UC TV 错误码判断修正
4、📄 WPS 文件列表不完整修复
5、☁️ Azure Blob 路径前缀修复
6、🌐 代理设置生效修复
7、🛠 服务端 return 缺失修复
8、🔄 OpenList 驱动透传前端刷新标志
9、⏳ 离线下载防无限重试
10、🔓 Cloudreve v4 分享免 Token 校验

下载地址：https://github.com/OpenListTeam/OpenList/releases/tag/v4.2.0

🚨 更新提醒：OpenList v4.2.1

🔥 问题修复
1、⚠️ 修复了musl静态链接问题
2、☁️ 修复了元信息一些路径问题

如果您之前更新了4.2.0遇到了无法启动的问题，更新4.2.1即可解决

下载地址：https://github.com/OpenListTeam/OpenList/releases/tag/v4.2.1