夸克网盘可以通过 OpenList 统一接入，并进一步通过 WebDAV、Rclone 等方式映射到本地文件系统。整个过程的关键并不只是“把网盘添加到 OpenList”，而是正确获取夸克网盘 Cookie、配置对应存储驱动，以及根据实际用途选择合适的访问和本地挂载方式。
需要注意的是，OpenList 当前官方文档已经明确说明，夸克驱动属于基于历史接口的逆向实现，项目团队不会主动维护相关逆向接口；同时由于夸克网盘的限速问题，目前官方文档要求使用本地代理进行传输。因此，配置成功后如果发现 302 直链下载、视频播放等方式异常，应优先检查代理策略，而不是反复更换 Cookie。OpenList Docs
一、OpenList挂载夸克网盘需要准备什么
开始配置之前，建议先准备以下环境：
-
一台已经部署 OpenList 的服务器、NAS 或电脑
-
一个正常登录夸克网盘的账号
-
可以登录夸克网盘网页版的浏览器
-
浏览器开发者工具
-
OpenList 管理员账号
-
如果需要映射到 Windows 本地磁盘，还需要 WebDAV 客户端或 Rclone
OpenList 本身负责把夸克网盘作为存储源接入，之后可以通过 OpenList 网页访问文件。
如果需要让 Windows、Linux 或 macOS 上的应用像访问普通文件夹一样访问网盘，则可以进一步利用 OpenList 的 WebDAV 能力。OpenList 官方文档目前提供了 WebDAV 服务，并支持通过 Rclone、RaiDrive、Mountain Duck 等客户端进行本地挂载。OpenList Docs+1
整个链路可以理解为：
夸克网盘 ↓ Cookie认证 ↓ OpenList Quark驱动 ↓ OpenList挂载路径 ↓ WebDAV / Rclone ↓ Windows / Linux / macOS本地目录
二、如何获取夸克网盘Cookie
Cookie 是整个配置过程中最容易出错的地方。
不要直接复制浏览器地址栏，也不要把普通网页链接当成 Cookie。OpenList 官方夸克驱动文档给出的方式，是通过浏览器开发者工具中的 Network 网络请求查找包含 Cookie 参数的请求。OpenList Docs
1. 浏览器登录夸克网盘
首先打开夸克网盘网页版：
https://pan.quark.cn
登录自己的夸克网盘账号，并确认网页中可以正常看到文件。
登录完成后不要退出账号，因为后续需要从当前登录状态中读取 Cookie。
2. 打开开发者工具
以 Chrome、Edge 等 Chromium 内核浏览器为例，可以按：
F12
或者：
Ctrl + Shift + I
打开开发者工具。
然后切换到：
Network
也就是“网络”面板。
3. 刷新夸克网盘页面
按：
Ctrl + R
刷新页面。
如果 Network 中请求很多，可以点击筛选区域，然后打开夸克网盘中的某个文件夹，让浏览器重新产生文件列表请求。
官方文档建议选择 Network 中的请求，然后查找带有 Cookie 参数的请求。OpenList Docs
4. 找到Cookie
点击一个与夸克网盘接口相关的请求，在请求详情中找到：
Request Headers
然后寻找：
Cookie:
后面的完整内容。
通常会类似：
Cookie: xxx=xxxx; yyy=yyyy; zzz=zzzz
复制 Cookie 的完整值即可。
注意，不要把：
Cookie:
这个字段名称一起复制进去。
最终填写到 OpenList 的应该是 Cookie 内容本身。
三、Cookie复制时最容易出现的问题
Cookie 配置失败，很多时候并不是 OpenList 本身的问题，而是复制内容不完整。
不要多复制引号
错误示例：
"xxx=123; yyy=456"
通常应该填写：
xxx=123; yyy=456
不要把Header名称一起复制
错误：
Cookie: xxx=123; yyy=456
正确：
xxx=123; yyy=456
不要随意删除Cookie字段
Cookie 往往由多个字段组成。为了避免认证信息缺失，建议直接复制完整 Cookie，而不是凭经验只保留某一个字段。
Cookie不要泄露
Cookie 本质上属于登录状态凭证。
不要把自己的 Cookie：
-
发布到论坛
-
发到交流群
-
上传到代码仓库
-
截图公开
-
填入不可信的网站
-
提交给第三方所谓的 Cookie 获取工具
如果 Cookie 泄露，别人可能在有效期内利用你的登录状态访问相关资源。
如果怀疑 Cookie 已经泄露，最稳妥的处理方式是退出登录、重新登录，必要时修改账号安全设置并重新获取新的认证信息。
四、OpenList添加夸克网盘
获取 Cookie 后，就可以进入 OpenList 管理后台。
进入：
管理后台 → 存储 → 添加
然后在驱动列表中选择夸克网盘对应的驱动。
当前 OpenList 文档将相关驱动列为：
Quark / TV / Open
其中普通夸克网盘配置对应 Quark 驱动。官方文档同时特别提醒，这套接口基于历史产品的逆向接口，并不会主动维护。OpenList Docs
1. 填写挂载路径
例如：
/quark
这个路径是 OpenList 中对外显示的目录。
最终访问效果类似：
http://你的OpenList地址/quark
挂载路径并不是夸克网盘本身的目录，而是 OpenList 中给这个存储分配的名称。
OpenList 要求每个挂载路径具有唯一性，不能同时创建多个相同的挂载路径，否则数据库会出现唯一约束错误。OpenList Docs
2. 填写Cookie
将刚才获取的 Cookie 粘贴到夸克驱动对应的 Cookie 配置项。
例如：
Cookie: xxxx=xxxx; yyyy=yyyy; zzzz=zzzz
不要把示例内容原样使用，实际填写自己的 Cookie。
3. 保存并测试
保存配置后，OpenList 会初始化存储。
如果初始化成功，可以进入：
/quark
查看夸克网盘目录。
能够正常显示文件夹和文件，说明基础挂载已经完成。
五、OpenList挂载成功后如何判断配置正常
不要只看“存储添加成功”这一项。
建议进行三个测试。
测试一：目录读取
打开夸克挂载目录，确认能够看到：
文件夹 文件 文件大小 修改时间
如果目录为空或者加载失败，需要重点检查 Cookie 和驱动类型。
测试二：文件信息
选择一个普通文件，查看文件详细信息。
如果文件信息可以正常读取，说明 OpenList 已经能够访问夸克网盘 API。
测试三：实际下载
再选择一个体积较小的文件进行下载。
如果：
目录可以打开 文件可以看到 但是下载失败
那么问题就不一定是 Cookie。
此时应该进一步检查 OpenList 的 Web 代理、WebDAV 策略以及夸克当前的访问限制。
六、为什么挂载成功后下载速度仍然很慢
这是很多人第一次配置 OpenList 时容易产生的误解。
OpenList 只是统一管理文件访问，并不意味着它可以自动绕过网盘服务商的带宽策略。
目前 OpenList 官方夸克驱动文档已经明确提示，由于夸克网盘限速问题，夸克网盘现在只能使用本地代理进行传输。OpenList Docs
因此，如果出现：
文件列表正常 文件信息正常 但是下载速度异常
应该先检查传输策略，而不是重新获取 Cookie。
七、为什么不建议盲目使用302直链
OpenList 支持不同的 WebDAV 和下载策略，包括 302 重定向、代理 URL、本机代理等。
官方文档对这些策略进行了明确区分：
-
302 重定向：直接把真实地址返回给客户端
-
使用代理 URL：通过指定代理地址传输
-
本机代理：由 OpenList 所在设备直接中转文件
其中本机代理通常兼容性最好，但会消耗运行 OpenList 设备的网络流量；302 虽然可以减少中转流量，但实际使用时受到目标地址可访问性、授权状态和服务商策略等条件限制。Oplist Pages
对于夸克网盘，当前更应该按照 OpenList 官方夸克驱动的要求使用本地代理，而不是为了追求“零服务器流量”强行开启 302。OpenList Docs
八、OpenList开启WebDAV
如果只是通过浏览器使用夸克网盘，配置到这里基本就够了。
如果想让电脑上的播放器、文件管理器、下载软件等程序直接访问 OpenList 中的夸克文件，则可以开启 WebDAV。
OpenList 的 WebDAV 地址通常为：
http://你的域名:端口/dav/
如果使用 HTTPS，则：
https://你的域名:端口/dav/
官方文档要求 WebDAV 用户具有对应的 WebDAV 读取权限；如果还需要上传、删除、重命名等操作，则需要进一步开启 WebDAV 管理权限以及相应的文件系统操作权限。Oplist Pages+1
例如：
WebDAV地址： https://example.com/dav/ 用户名： admin 密码： 你的OpenList密码
这里的用户名和密码通常使用 OpenList 用户账号，而不是夸克网盘账号。Oplist Pages
九、Windows映射为本地网络驱动器
完成 WebDAV 配置后，可以进一步让 Windows 访问。
Windows 资源管理器中选择：
此电脑 → 右键 → 映射网络驱动器
填写 OpenList WebDAV 地址，例如：
https://example.com/dav/
然后输入 OpenList 用户名和密码。
成功之后，Windows 会显示一个新的网络驱动器。
例如：
Z:
以后打开：
此电脑 → Z:
就可以看到 OpenList 中的文件。
不过需要注意，“映射网络驱动器”与真正的本地硬盘并不完全一样。文件实际上仍然存储在夸克网盘中，Windows 看到的只是远程文件系统。
十、使用RaiDrive进行本地映射
如果 Windows 自带的 WebDAV 映射存在兼容性、稳定性或者性能问题，可以使用第三方 WebDAV 挂载工具。
OpenList 官方 WebDAV 文档将 RaiDrive 列为 Windows 平台推荐的挂载工具之一，同时也列出了 Mountain Duck、Rclone 等方案。OpenList Docs
基本配置逻辑仍然是：
类型：WebDAV 地址： https://example.com/dav/ 账号： OpenList用户名 密码： OpenList密码
挂载成功后，可以为它分配一个盘符，例如：
Z:
这种方式更适合需要频繁访问网盘文件的 Windows 用户。
十一、使用Rclone映射本地目录
对于 Linux、Windows 或 NAS 用户，Rclone 是更灵活的方案。
OpenList 官方也支持通过 Rclone 对 WebDAV 进行本地挂载。OpenList Docs+1
假设 OpenList WebDAV 地址为：
https://example.com/dav/
可以先创建一个 WebDAV 类型的 Rclone remote。
配置完成后，再将它挂载到本地目录。
Linux 示例：
Bashmkdir -p /mnt/quark rclone mount openlist:/quark /mnt/quark --vfs-cache-mode full
这里：
openlist
代表 Rclone 中配置的 remote 名称。
/quark
对应 OpenList 中的挂载路径。
/mnt/quark
则是 Linux 本地目录。
实际参数需要根据服务器性能、文件类型以及使用场景进行调整。
如果主要用于视频播放，可以重点关注缓存策略和读取并发；如果主要用于普通文件管理，则不需要盲目提高并发参数。
十二、OpenList Desktop也可以完成本地挂载
如果不希望手动配置 Rclone，可以考虑 OpenList Desktop。
官方文档显示，OpenList Desktop 支持管理 OpenList，并通过 Rclone 实现本地挂载。其挂载流程包括添加远程存储、填写 WebDAV 地址和账号密码，然后指定本地挂载目录。OpenList Docs
基本流程是：
启动 OpenList Desktop ↓ 启动 OpenList Core ↓ 启动 Rclone Backend ↓ 进入 Mount ↓ Add Remote ↓ 选择 WebDAV ↓ 填写OpenList地址和账号 ↓ 指定本地目录 ↓ Save and Mount
对于不熟悉 Rclone 命令行的用户，这种方式更加直观。
十三、视频播放为什么经常出现问题
如果你的最终目的是使用：
PotPlayer Kodi Infuse IINA
等播放器播放夸克网盘中的视频，需要特别关注 WebDAV 的传输策略。
OpenList 官方 WebDAV 文档列出了 PotPlayer、Kodi、AIMP、Infuse、IINA 等客户端作为可使用 WebDAV 访问文件的客户端。OpenList Docs
但“能够看到文件”和“能够流畅播放”是两个不同的问题。
视频播放通常需要：
Range断点读取 ↓ 持续读取 ↓ 正确返回HTTP状态 ↓ 稳定的数据传输
如果使用 302 后播放器无法播放，可以尝试切换到代理方式。
尤其是夸克网盘，当前官方驱动已经要求使用本地代理，因此播放器出现：
无法播放 无法获取文件 拖动进度条失败 播放几秒后停止
等问题时，优先考虑本地代理模式。
十四、常见问题一：提示Cookie无效
如果 OpenList 报错：
Cookie invalid
或者：
Failed init storage
可以按照以下顺序排查：
第一，确认夸克网页当前仍然登录。
第二，重新通过 F12 → Network 获取 Cookie。
第三，确认复制的是完整 Cookie，而不是某一个 Cookie 字段。
第四，确认没有把：
Cookie:
复制进去。
第五，确认 Cookie 前后没有多余空格、换行或引号。
第六，重新保存 OpenList 存储配置。
Cookie 具有时效性，旧 Cookie 即使格式完全正确，也可能因为登录状态变化而失效。
十五、常见问题二：能看到文件，但是无法下载
这种情况应该把问题拆成两个层面：
认证是否正常？ 传输是否正常？
如果目录能够正常读取，通常说明基础认证已经成功。
接下来重点检查：
Web代理 WebDAV策略 本机代理 302策略
当前夸克驱动官方文档明确要求使用本地代理进行传输，因此不建议继续围绕 Cookie 反复排查。OpenList Docs
十六、常见问题三：WebDAV能看到文件，但是播放器打不开
可以依次尝试：
OpenList网页直接播放 ↓ WebDAV客户端访问 ↓ 播放器打开WebDAV ↓ 切换WebDAV本地代理
如果网页端正常、WebDAV 目录正常，而播放器无法播放，那么重点应该放在 WebDAV 传输方式和播放器兼容性上。
OpenList 官方文档也指出，本机代理属于兼容性最佳的策略，但会消耗 OpenList 所在设备的流量。Oplist Pages
十七、常见问题四：Windows映射WebDAV失败
Windows 映射失败时，可以先确认：
OpenList网页可以正常访问
然后浏览器访问：
https://你的域名/dav/
如果 WebDAV 服务本身正常，再检查：
用户名是否正确 密码是否正确 WebDAV读取权限是否开启 HTTPS证书是否正常 端口是否可以访问
如果仍然不稳定，可以直接使用 RaiDrive 或 Rclone，通常比单纯依赖 Windows 原生 WebDAV 映射更灵活。OpenList 官方文档也将这些工具列为常见客户端。OpenList Docs
十八、Cookie失效后的处理方法
Cookie 不是永久凭证，因此不要把“一次配置成功”理解成永久有效。
如果出现：
之前正常 现在突然无法访问
可以重新登录夸克网页版，然后重新获取 Cookie。
建议保留一套固定的排查流程：
确认夸克网页能登录 ↓ F12 ↓ Network ↓ 刷新页面 ↓ 查找Cookie ↓ 复制完整Cookie ↓ OpenList更新配置 ↓ 重新初始化存储 ↓ 测试目录 ↓ 测试下载
这样比盲目修改大量 OpenList 参数更容易定位问题。
十九、安全方面需要特别注意
OpenList 和 Cookie 都涉及账号访问权限，因此不建议为了方便把管理后台直接暴露到公网。
比较稳妥的做法是：
HTTPS + 强密码 + 最小权限 + 限制后台访问 + 定期检查登录状态
如果 OpenList 只是自己使用，可以给普通用户只开启 WebDAV 读取权限。
如果需要上传、删除、移动文件，再根据实际需求开启相应权限。
OpenList 的用户权限体系支持 WebDAV 读取和 WebDAV 管理等权限，并且文件操作权限可以进一步细分。OpenList Docs
尤其不要给不可信用户开放过高权限。
二十、推荐的稳定架构
如果目标是“夸克网盘 + OpenList + 本地访问”，比较实用的结构是：
┌──────────────┐ │ 夸克网盘 │ └──────┬───────┘ │ Cookie │ ▼ ┌──────────────┐ │ OpenList │ │ Quark Driver │ └──────┬───────┘ │ /quark │ ▼ ┌──────────────┐ │ WebDAV │ └──────┬───────┘ │ ┌───────────┼───────────┐ ▼ ▼ ▼ Windows Linux macOS RaiDrive Rclone Mountain Duck
这种结构最大的优势是将“网盘认证”和“本地访问”分离。
夸克只负责提供云端存储，OpenList负责统一管理，WebDAV负责标准化访问，本地客户端负责将远程文件映射成本地目录。
二十一、实际配置时的建议
如果只是偶尔访问文件：
夸克 ↓ OpenList ↓ 网页访问
已经足够。
如果需要 Windows 文件管理：
夸克 ↓ OpenList ↓ WebDAV ↓ RaiDrive / Windows WebDAV
更加合适。
如果需要 Linux 或 NAS：
夸克 ↓ OpenList ↓ WebDAV ↓ Rclone ↓ 本地目录
更灵活。
如果主要用于视频播放，则建议优先考虑：
夸克 ↓ OpenList ↓ 本机代理 ↓ WebDAV ↓ 播放器
而不是为了节省中转流量直接使用 302。对于当前夸克驱动，官方已经明确要求使用本地代理传输。OpenList Docs
二十二、完整配置流程总结
整个 OpenList 挂载夸克网盘的核心步骤可以浓缩为：
① 登录夸克网盘 ↓ ② F12打开开发者工具 ↓ ③ Network查看网络请求 ↓ ④ 获取Cookie ↓ ⑤ OpenList添加Quark驱动 ↓ ⑥ 填写挂载路径和Cookie ↓ ⑦ 保存并测试目录 ↓ ⑧ 开启WebDAV读取权限 ↓ ⑨ 使用WebDAV访问OpenList ↓ ⑩ RaiDrive / Rclone映射到本地
如果只是为了浏览文件，完成第⑦步即可；如果想让 Windows 直接出现一个类似 Z: 的网络磁盘，则继续配置 WebDAV；如果需要 Linux、NAS 或更复杂的缓存策略，则可以使用 Rclone。
最值得注意的是，夸克网盘驱动并不是传统意义上的官方开放 API 驱动，OpenList 当前文档已经明确提示该接口属于历史逆向接口，并且当前夸克传输受到限速等因素影响。因此，配置过程中应把“Cookie认证”和“文件传输”分开排查：能够列出目录，说明认证大概率正常；能够列出文件但下载、播放异常，则应优先检查本地代理和 WebDAV 策略。OpenList Docs+1
最后，Cookie 属于敏感的登录凭证，切勿为了求助而公开完整 Cookie。实际部署时也建议使用 HTTPS、限制 OpenList 权限，并根据用途选择 WebDAV 读取或管理权限。这样既能实现夸克网盘的统一管理，也能降低账号凭证和文件数据暴露的风险。