网盘配置指南

xylplm2025/8/28大约 11 分钟云端存储网盘配置115123网盘阿里云盘百度网盘OneDrive夸克网盘

📦 网盘配置指南

Media Saber 支持多种网盘服务，通过 OpenList 驱动进行接入。本文档将详细介绍如何配置各种网盘服务。

支持的网盘类型

目前支持以下网盘类型：

115 网盘开放平台
115 网盘分享
123 云盘开放平台
中国移动云盘
天翼云盘
阿里云盘（Oauth2）
百度网盘
OneDrive
夸克网盘 Open

通用配置参数

在配置任何网盘之前，需要了解一些通用配置参数：

挂载路径 (Mount Path)

挂载项的唯一标识，对外展示的名称，要挂载到的位置。如果要挂载到根目录，请填写 /。

注意：不能使用重复的挂载路径名称，否则会报错。

DANGER

不能使用重复的挂载路径名称，否则会报错：

Failed create storage in database: UNIQUE constraint failed: x_storages.mount_path

解决方法：使用别名对多个挂载项目进行聚合。

DANGER

挂载路径名称是必填项，不能为空，否则会报错：

Key: 'Storage.MountPath' Error:Field validation for 'MountPath' failed on the 'required' tag

解决方案：如果要挂载到根目录，请填写 /。

序号 (Order)

当挂载多个驱动时，用于排序。数字越小越靠前，可以填写负数。

备注 (Remark)

您可以添加备注，以方便管理。

引用认证

从已挂载的存储中引用认证、令牌等，实现同一个 Token 多个网盘使用。

目前支持如下网盘：

中国移动云盘
阿里云盘（Oauth2）
天翼云盘客户端
123 云盘分享（引用123云盘）
Cloudreve V3 / V4

使用方法：在存储设置中将备注(Remark)的第一行设置为：ref:/挂载路径

注意事项：ref:/ 为小写英文和符号

启用签名 (Enable signing)

对文件进行签名加密(不会需要密码)，仅对本驱动生效。

使用场景：不想开启全部签名，也不想设置元信息加密，只想对某驱动进行签名加密防止被扫。

影响范围：设置-->全局-->签名所有 > 元信息目录加密 > 单驱动签名

禁用索引 (Disable index)

允许用户禁用存储索引。

例如索引选项中的忽略索引，启用禁用索引后不需要再去配置了，这样也更方便一些。

缓存过期 (Cache Expiration)

目录结构的缓存时间。

Web 代理 (Web proxy)

网页预览、下载和直接链接是否通过中转。如果打开此项，建议设置 site_url，以帮助 OpenList 更好的工作。

TIP

Web代理：是使用网页时候的策略，默认为本地代理，如果填写了代理URL并且启用了Web代理使用的是代理URL

WebDAV策略：是在使用WebDAV功能时候的选项，如果有302选项默认为302，如果没有302选项默认为本地代理，如果要使用代理URL请填写并且手动切换到代理URL策略

两者是不同的配置。

WebDAV 策略 (Webdav policy)

WebDAV 功能的选项：

302 重定向：重定向到真实链接（虽然不会消耗流量，但是不建议共享使用，有封禁账户的风险）
使用代理 URL：重定向到代理 URL（会消耗搭建代理URL的流量）
本机代理：直接通过本地中转返回数据（最佳兼容性，会消耗搭建 OpenList 设备的流量）

*** 三种模式说明 ***

以下是三种不同模式的说明图：

下载代理 URL

下载代理 URL 是一个可选配置，用于通过代理服务器下载文件。当启用此功能时，文件下载将通过指定的代理 URL 进行中转。

配置参数：

下载代理 URL：用于文件下载的代理服务器地址

使用场景：

当直接下载受到限制时（如地区限制、IP限制等）
当需要通过特定服务器中转下载以提高速度或稳定性时
当需要隐藏真实下载地址以增强安全性时
当需要统一管理和审计下载流量时

配置方法：

获取可用的下载代理 URL
- 可以使用自建代理服务器
- 可以使用第三方提供的代理服务
- 确保代理服务器支持文件下载中转功能
在网盘配置中填写下载代理 URL 字段
- 在网盘配置页面找到"下载代理 URL"字段
- 输入完整的代理服务器地址，包括协议（如 http:// 或 https://）
- 示例：http://proxy.example.com:8080
保存配置并测试下载功能
- 点击保存按钮保存配置
- 尝试下载一个文件以验证配置是否生效
- 检查下载日志确认流量是否通过代理服务器

详细配置示例：

下载代理 URL: http://download-proxy.yourdomain.com:8080

代理实现方式：

1. Cloudflare Workers

可以使用 Cloudflare Workers 做代理，这里填写您的 Cloudflare Workers 地址即可。

搭建 Workers 代码可以在 OpenList-Proxy 找到，实际使用时需要配置环境变量：

在 OpenList 后台挂载配置时填写下载代理URL时候的链接结尾不可以带 /

更多内容请参考 OpenList Proxy

来自安稳的详细文字教程：使用 Cloudflare Workers 搭建下载代理

2. 通用二进制

您可以使用另一台机器进行代理，在 OpenList-Proxy Releases 下载程序并通过 ./openlist-proxy -help 查看使用方法。

更多内容请参考 OpenList Proxy

来自安稳的详细文字教程：使用通用二进制搭建下载代理

3. 自行开发

你可以开发自己的代理程序，一般步骤是：

下载时会请求 PROXY_URL/path?sign=sign_value

在代理程序中验证 sign，sign 的计算方法为：

const to_sign = `${path}:${expireTimeStamp}`
const _sign = safeBase64(hmac_sha256(to_sign, TOKEN))
const sign = `${_sign}:${expireTimeStamp}`

TOKEN 即管理员账户的 Token，可在 OpenList 管理页面中进入"其他设置"得到。

验证签名正确后，请求 HOST/api/fs/link，可以得到文件的 URL 和要携带的请求头，使用这些信息请求并返回文件内容。

高级配置选项：

代理认证：如果代理服务器需要认证，可以在 URL 中包含用户名和密码
- 格式：http://username:[email protected]:8080
HTTPS 代理：使用 HTTPS 协议以增强安全性
- 格式：https://proxy.example.com:8443

故障排除：

代理服务器无法连接
- 检查代理 URL 是否正确
- 确认代理服务器是否正常运行
- 检查网络连接和防火墙设置
下载速度变慢
- 检查代理服务器的性能和带宽
- 尝试更换其他代理服务器
- 确认代理服务器位置是否合适
下载失败
- 查看 OpenList 日志获取详细错误信息
- 检查代理服务器是否支持大文件传输
- 确认代理服务器是否有文件类型限制

注意事项：

下载代理 URL 必须是有效的代理服务器地址
使用下载代理可能会增加下载时间
代理服务器可能会消耗额外的流量
某些网盘可能不支持通过代理下载，具体取决于网盘的API限制
如果同时配置了 Web 代理和下载代理，下载代理优先级更高

最佳实践：

选择地理位置较近的代理服务器以减少延迟
使用性能稳定的代理服务器以确保下载成功率
定期检查代理服务器的可用性和性能
对于敏感数据，使用支持 HTTPS 的代理服务器

查看官方文档

如果您需要详细了解配置参数和使用方法，可以参考OpenList官方文档。

各网盘详细配置指南

115 网盘开放平台

使用官方 115 开放平台 API 开发，请规范使用帐号，避免用于多人共享、图床、视频外链等不规范用途。

查看官方文档

如果您对配置参数或获取方法不清楚，建议查看OpenList官方文档获取详细说明。

💡 115年费会员优惠推荐

扫码可享115年费会员优惠：

获取刷新令牌

访问令牌获取页面（如：https://alistgo.com/zh/tool/115/token）
手机扫码后点击蓝色按钮即可获取 refresh token
填写时只需要填写 refresh token，不需要填写 access token

注意事项

如果不小心泄漏了 Token，可以前往 115 设备登录管理解除应用授权：

115 APP：【iOS 、Android】版本需要 ≥ 35.11.0
115 网页端：https://115.com/?mode=device_manage

根文件夹 ID

默认根目录 ID 为：0

获取方式：

打开 115 网盘官网
点击进入要设置的文件夹
查看 URL 中 cid 后面的数字

例如：https://115.com/?cid=249163533602609229&offset=0&tab=&mode=wangpan

这个文件夹的根文件夹 ID 即为 249163533602609229

115 网盘分享

115 分享链接存储驱动，用于挂载他人分享的 115 文件。

查看官方文档

如果您对配置参数不清楚，建议查看OpenList官方文档获取详细说明。

配置参数：

分享链接 ID：分享链接的唯一标识
分享密码：如果分享有密码保护，则需要填写密码

123 云盘开放平台

123 云盘开放平台 API 驱动。

查看官方文档

如果您对配置参数不清楚，建议查看OpenList官方文档获取详细说明。

配置参数：

用户名：123 云盘账号
密码：123 云盘密码
根文件夹 ID：默认为空，表示根目录

中国移动云盘

中国移动云盘（139 云盘）驱动，支持个人云和家庭云。

查看官方文档

如果您对配置参数不清楚，建议查看OpenList官方文档获取详细说明。

配置参数：

用户名：中国移动云盘账号（手机号）
密码：中国移动云盘密码
根文件夹 ID：默认为空，表示根目录

天翼云盘

天翼云盘驱动。

查看官方文档

如果您对配置参数不清楚，建议查看OpenList官方文档获取详细说明。

配置参数：

用户名：天翼云盘账号（手机号）
密码：天翼云盘密码
根文件夹 ID：默认为空，表示根目录

阿里云盘（Oauth2）

阿里云盘开放平台 API 驱动。

查看官方文档

如果您对配置参数或获取方法不清楚，建议查看OpenList官方文档获取详细说明。

配置参数：

Refresh Token：刷新令牌
Root Folder ID：根文件夹 ID
Order By：排序字段
Order Direction：排序方向

获取 Refresh Token 的方法：

登录阿里云盘官网
打开浏览器开发者工具（F12）
在 Console 中执行 JavaScript 代码获取 token

百度网盘

百度网盘驱动。

查看官方文档

如果您对配置参数或获取方法不清楚，建议查看OpenList官方文档获取详细说明。

配置参数：

Access Token：访问令牌
Refresh Token：刷新令牌
根文件夹 ID：默认为空，表示根目录

获取 Token 的方法：

创建百度开发者应用
获取授权码
使用授权码换取 Access Token 和 Refresh Token

OneDrive

微软 OneDrive 驱动。

查看官方文档

如果您对配置参数或获取方法不清楚，建议查看OpenList官方文档获取详细说明。

配置参数：

Region：区域（global/cn/de/us）
Tenant ID：租户 ID
Client ID：客户端 ID
Client Secret：客户端密钥
Refresh Token：刷新令牌
Root Folder Path：根文件夹路径
Internal Upload：是否启用内部上传

获取配置参数的方法：

注册 Azure 应用
配置 API 权限
获取客户端凭据
获取用户授权并获取刷新令牌

夸克网盘 Open

夸克网盘开放平台 API 驱动。

查看官方文档

如果您对配置参数或获取方法不清楚，建议查看OpenList官方文档获取详细说明。

配置参数：

Cookie：夸克网盘的 Cookie 信息
根文件夹 ID：默认为空，表示根目录

获取 Cookie 的方法：

登录夸克网盘网页版
打开浏览器开发者工具
在 Network 标签中找到请求头中的 Cookie 信息