Docker部署Alist：一站式挂载百度网盘并实现网页直连播放

1. 为什么选择Docker部署Alist管理百度网盘？

每次打开百度网盘客户端都要忍受漫长的启动时间和烦人的广告弹窗？作为常年和网盘打交道的开发者，我完全理解这种痛苦。去年在折腾家庭影音库时，我发现用Docker部署Alist简直是打开新世界的大门——现在所有视频都能直接在浏览器播放，连4K原画都不需要下载到本地。

Alist本质上是个万能文件列表中转站，它最厉害的地方在于能把百度网盘、阿里云盘等20多种存储服务，变成统一管理的Web界面。我实测用Docker部署只要5分钟，之后就能像访问本地文件夹一样操作网盘文件。特别适合这些场景：

• 追剧党：直接网页播放网盘里的蓝光视频，省去下载等待
• 团队协作：共享设计稿/视频素材时不用一个个发链接
• 手机党：Safari或Chrome就能流畅播放，不用装臃肿的APP

相比官方客户端，这套方案有三大杀手锏：

1. 零广告干扰：纯净的Web界面，没有会员推广和限速提示
2. 跨平台通用：Windows/Mac/Linux甚至电视盒子都能用
3. API级速度：通过百度官方接口获取文件，不受客户端限速影响

2. 5分钟快速部署Alist容器

2.1 准备工作

在开始前确保你的系统已经安装：

• Docker Engine（社区版即可）
• Docker Compose（V2版本推荐）
• 约200MB的磁盘空间

用这个命令检查环境是否就绪：

docker --version && docker-compose version

如果看到版本号输出就说明没问题。我习惯用Ubuntu 22.04 LTS，但CentOS或Windows WSL2也完全兼容。

2.2 一键启动容器

官方提供了现成的Docker镜像，直接运行这条命令：

docker run -d \ --name=alist \ -p 5244:5244 \ -v /path/to/alist:/opt/alist/data \ -e PUID=1000 \ -e PGID=1000 \ --restart=unless-stopped \ xhofe/alist:latest

参数说明：

• -p 5244:5244：左边可以改成你喜欢的端口
• /path/to/alist：替换为本地存储配置的真实路径
• PUID/PGID：建议设为当前用户的ID（用id -u查看）

启动后访问http://你的IP:5244就能看到登录页。第一次会提示"未找到管理员"，需要进入容器初始化密码。

2.3 设置管理员账户

执行以下命令进入容器：

docker exec -it alist sh

然后在容器内运行密码设置命令：

./alist admin set 你的密码

成功后会出现包含用户名admin和密码的确认信息。现在刷新网页就能用admin登录了。

3. 深度集成百度网盘

3.1 获取OAuth令牌

这是最关键也最容易出错的步骤，我踩过三次坑才摸清门道：

1. 先在浏览器登录百度网盘网页版（必须！）
2. 访问百度网盘开放平台的OAuth文档页
3. 找到"获取refresh_token"的演示按钮并点击
4. 在弹出的授权页面确认后，会得到三组关键数据：
   • refresh_token：32位的长字符串
   • client_id：以"Qq"开头的字符串
   • client_secret：包含英文数字的组合

重要提示：这些凭证相当于网盘钥匙，千万别泄露！建议复制到密码管理器临时保存。

3.2 配置存储挂载

登录Alist管理后台，点击底部"管理"→"存储"→"添加"：

1. 驱动选择"百度网盘"
2. 挂载路径填/baidu（可自定义）
3. 将刚才获取的三组凭证填入对应字段
4. 其他保持默认，点击"添加"

如果看到绿色成功提示，恭喜！现在访问http://IP:5244/baidu就能看到网盘文件了。我测试挂载了2TB的账号，5秒内就加载出完整目录。

4. 实现网页直连播放

4.1 浏览器插件配置

由于百度对视频流做了权限校验，需要修改请求头才能播放。以Chrome为例：

1. 安装ModHeader插件
2. 点击插件图标，添加以下两个Header：
   • Referer: https://pan.baidu.com
   • User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64)

刷新Alist页面后，双击视频文件就会调用浏览器原生播放器。实测能流畅播放1080P视频，拖动进度条几乎没有延迟。

4.2 常见格式支持情况

经过三个月的使用，这些格式表现最佳：

• 视频：MP4、MKV、AVI（H.264编码）
• 音频：MP3、FLAC、WAV
• 文档：TXT、Word、Zip

需要注意：

• 部分HEVC编码的视频可能卡顿
• PDF预览需要Alist v3.25+版本
• 在线编辑功能暂不可用

5. 高阶技巧与优化方案

5.1 使用Nginx反代

直接暴露5244端口不够安全，建议用Nginx做转发。这是我的配置模板：

server { listen 80; server_name alist.yourdomain.com; location / { proxy_pass http://localhost:5244; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } }

配置后记得：

sudo certbot --nginx -d alist.yourdomain.com

申请免费SSL证书，这样就能用HTTPS安全访问了。

5.2 定时备份配置

Alist的所有配置都存储在/opt/alist/data目录，建议每天自动备份：

crontab -e

添加这行（注意替换路径）：

0 3 * * * tar -czf /backup/alist-$(date +\%Y\%m\%d).tar.gz /path/to/alist/data

5.3 性能调优

如果遇到加载慢的问题，可以调整Docker资源限制：

docker update \ --memory 1G \ --memory-swap -1 \ --cpus 1.5 \ alist

对于大容量网盘，建议把ALIST_DISABLE_HTTP_CACHE环境变量设为false来启用缓存。

6. 你可能遇到的坑

去年帮朋友部署时遇到个典型问题：挂载后显示空白目录。排查发现是百度网盘子目录权限问题。解决方法是在挂载时勾选"启用递归扫描"，并在路径中填写完整目录如/我的资源/电影。

另一个常见错误是"invalid refresh_token"，通常是因为：

1. 获取token时没有先登录网页版
2. 凭证复制时多了空格
3. 百度账号开启了登录保护

建议在Alist的日志里查看具体错误：

docker logs --tail 50 alist

最后提醒：虽然网页播放很方便，但重要文件还是建议定期下载备份。我有次误删了网盘文件，因为Alist的删除操作是直接同步到云端的。可以在挂载时设置"只读模式"避免误操作。