视频加载失败

Linux 下用 Alist 挂载百度网盘并下载文件

854 字
4 分钟
Linux 下用 Alist 挂载百度网盘并下载文件
Linux 下用 Alist 挂载百度网盘并下载文件

Linux 下用 Alist 挂载百度网盘并下载文件#

Alist 可以把多个网盘统一到一个文件列表中,再通过网页界面或 WebDAV 访问文件。本文记录在 Linux 环境中配置百度网盘驱动的过程,重点说明刷新令牌、302 重定向和官方下载接口这几个容易混淆的选项。

本文以 Alist 当前的百度网盘驱动界面为例。不同版本的字段名称或页面布局可能略有差异,但配置思路基本一致。

工作原理#

配置完成后,文件访问大致经过下面的链路:

Alist、百度网盘与下载客户端之间的文件请求链路
Alist、百度网盘与下载客户端之间的文件请求链路

当 WebDAV 策略设置为 302 时,Alist 会把文件请求重定向到百度网盘的下载地址,由客户端直接跟随重定向并下载文件。这样可以减少 Alist 服务器中转文件的压力;下载接口选择官方接口,则表示使用百度网盘提供的官方下载接口。

配置步骤#

1. 添加百度网盘存储#

进入 Alist 管理后台的“存储”页面,点击“添加”,选择“百度网盘”驱动。

Alist 管理后台的存储列表与添加按钮
Alist 管理后台的存储列表与添加按钮

2. 获取刷新令牌#

打开百度网盘驱动配置说明,找到“刷新令牌”部分,并打开页面提供的刷新令牌链接。

百度网盘驱动文档中的刷新令牌入口
百度网盘驱动文档中的刷新令牌入口

3. 填写百度网盘配置#

将获取到的刷新令牌填入百度网盘驱动的配置表单中。根文件夹路径可以填写 /,表示从百度网盘根目录开始挂载;如果只需要访问某个目录,也可以填写对应路径。

百度网盘驱动的刷新令牌和根文件夹配置
百度网盘驱动的刷新令牌和根文件夹配置

其余选项先保持默认即可。对于第一次配置,建议先完成最小化设置,确认能够列出文件后再按实际需求调整索引、签名等选项。

4. 设置下载策略#

在配置中修改以下两项:

配置项建议值作用
WebDAV 策略302将文件请求重定向到实际下载地址,避免由 Alist 中转整个文件
下载接口官方接口使用百度网盘的官方下载接口

这两个选项尤其影响 WebDAV 客户端的下载行为。如果客户端不支持自动跟随 302 重定向,可能会出现能看到文件但无法下载的情况。

5. 保存并验证#

点击“保存”,回到存储列表后确认百度网盘条目状态正常,再打开该存储并尝试访问一个较小的文件。

保存后可以在文件列表中看到百度网盘目录
保存后可以在文件列表中看到百度网盘目录

如果网页端可以正常打开或下载文件,再使用支持 WebDAV 的文件管理器进行测试。下载时,客户端应当能够跟随 302 响应并开始传输文件。

文件下载#

下载文件需要请求头,‘User-Agent: pan.baidu.com’

如下为使用wget下载多个链接的示例

wget -c \
-i urls.txt \
--header='User-Agent: pan.baidu.com' \
-P downloads \
--content-disposition

其中urls.txt是同级目录下的下载链接文件,每个链接使用回车隔开。

文章分享

如果这篇文章对你有帮助,欢迎分享给更多人!

Linux 下用 Alist 挂载百度网盘并下载文件
https://chachaprj.top/posts/2026-10-14/
作者
ChaCha
发布于
2026-10-14
许可协议
CC BY-NC-SA 4.0
Profile Image of the Author
ChaCha
Pain Equals Gain
公告
欢迎来到我的博客!
分类
标签
最新动态
站点统计
文章
15
分类
7
标签
19
总字数
21,598
运行时长
0 天
最后活动
0 天前
站点信息
构建平台
Local
博客版本
Firefly v6.16.8
文章许可
CC BY-NC-SA 4.0
文章目录