OpenList 接入豆包云盘：我踩过的那些坑

最近把飞书云盘接入了 OpenList，整个过程比预期曲折得多。倒不是因为驱动本身有多复杂，而是中文资料几乎为零，官方文档 404，GitHub 上的说明也只有一行。折腾了大半天，把整个链路摸清楚之后，决定写一篇完整的配置指南，顺便记录几个关键坑点。

💡 为什么用 OpenList

飞书云盘本身挺好用的，但问题在于——我用的是豆包，而不是飞书。飞书账号体系和豆包互通，但管理界面是割裂的。每次找文件都要想一下它到底在哪个平台，很烦。

OpenList 的思路很简单：一个入口，统一管理所有网盘。接进来之后，不用管底层是 OneDrive 还是飞书还是什么，直接在一个界面里浏览、搜索、预览、下载。体验提升非常明显。

📦 准备工作

在开始配置之前，你需要准备两样东西：

1️⃣ 飞书 Cookie

登录飞书（豆包账号登录也行），打开浏览器开发者工具（F12），切换到 Network 标签，找到任意一个 API 请求，从请求头里复制 Cookie 字段。建议完整复制整个 Cookie，不要遗漏任何部分。

2️⃣ 获取 Auth 相关参数

这是最让人头疼的部分。驱动需要以下参数：

DPoP Key Secret 是最特殊的，它不是明文存储的，而是藏在飞书的 JavaScript 代码里。需要：

1. 打开飞书云盘网页版
2. 在 Sources 里搜索 feishu_dpop_keypair
3. 找到加密用的密钥（通常叫 keyPairSecret 或类似名称）

这个步骤比较折腾，我当时的做法是把飞书的几个主要 JS 文件下下来，用关键词直接搜索。如果你找到了这个值，配置就成功了一半。

⚙️ 驱动配置

把上面这些参数填进 OpenList 后台的豆包云盘驱动配置页。

🚧 最大的坑：文档无法预览

配好之后，文件列表可以正常显示，图片也能打开。但当我点击一个 docx 文件时，预览区域一片空白——文件可以下载，但无法在线预览。

同样的 OpenList，OneDrive 的文档就能正常预览。这个差异说明问题不在 OpenList 本身，而在豆包驱动的 URL 生成方式。

问题根源

排查过程是这样的：

1. 打开 F12，看 Network 面板
2. 点击 docx 文件，观察 iframe 的 src
3. 发现预览服务用的是 Microsoft Office Online：view.officeapps.live.com/op/view.aspx?src=...
4. 再看这个 src 参数指向的 URL

关键发现：豆包云盘的下载链接最终会跳转到飞书的内部 API URL，类似这样：

https://internal-api-drive-stream.feishu.cn/space/api/box/stream/download/all/xxx/?authorization=DPoP+eyJ...&dpop=eyJ...

这个 URL 里带了 authorization 和 dpop 两个认证参数，本质上是一个私有链接。Microsoft Office Online 预览服务去请求这个链接时，不会带这些认证头，所以被飞书服务器拒绝了。

而 OneDrive 的链接是微软自己的，天然对 Office Online 友好，所以没问题。

✅ 解决方案

解决方式很简单——开启 OpenList 的「页面代理」功能。

在豆包云盘的驱动设置里，找到 WebDAV 策略选项，选择「本机代理」。保存之后，OpenList 会在服务器端把文件拉下来，再通过自己的代理 URL 提供给预览服务，这样预览服务就不需要直接访问飞书的私有链接了。

开启之后，docx、xlsx、pptx、PDF 都能正常预览了。

📋 最终配置一览

✍️ 写在最后

豆包云盘这个驱动是社区贡献的（Elegant1E，PR #2114），文档几乎为零，配置过程免不了要看源码。但如果你的需求和我一样——只是想在一个地方管理所有网盘——接进来之后体验还是很值得的。

整个过程中最意外的是「页面代理」这个开关。看起来是个不起眼的选项，却是文档预览的关键。没有它，预览服务永远在试图访问一个它根本访问不了的飞书私有链接。

如果你也在配置过程中遇到其他问题，欢迎交流。