打造个人云下载中心：Docker一键部署Alist与Aria2全攻略

1. 为什么你需要个人云下载中心？

想象一下这样的场景：你收藏的电影散落在不同网盘，每次想看都得先转存到本地；好不容易找到的资源链接，却因为下载工具不稳定而频频中断；深夜想下载大文件又担心电脑不能关机...这些问题，一个整合Alist和Aria2的Docker化下载中心都能解决。

我花了三个月测试各种方案，最终发现这套组合最稳定。Alist就像个万能网盘聚合器，能把百度网盘、阿里云盘等20+存储服务统一成WebDAV挂载；Aria2则是下载界的瑞士军刀，支持多线程、断点续传，实测下载速度比浏览器直接下载快3倍。用Docker Compose编排后，所有组件自动协同工作，我的NAS现在7x24小时待命下载。

2. 十分钟快速部署指南

2.1 环境准备三件套

首先确保你的设备满足：

• 任意x86/ARM架构主机（树莓派也行）
• 已安装Docker和Docker Compose
• 至少10GB可用存储空间

推荐使用1Panel管理面板（非必须），它集成了可视化容器管理：

bash复制# 一键安装命令
curl -sSL https://resource.fit2cloud.com/1panel/package/quick_start.sh -o quick_start.sh && sudo bash quick_start.sh

2.2 编写魔法配方：docker-compose.yml

这个配置文件是整套系统的核心，我优化过的版本解决了常见权限问题：

yaml复制version: "3.8"
services:
  alist:
    image: xhofe/alist:latest
    ports: ["5244:5244"]
    volumes:
      - ./alist_data:/opt/alist/data
      - ./downloads:/downloads
    restart: unless-stopped

  aria2:
    image: p3terx/aria2-pro
    environment:
      - RPC_SECRET=my_secure_key
      - DISK_CACHE=128M
    ports:
      - "6800:6800"
      - "6888:6888/tcp"
      - "6888:6888/udp" 
    volumes:
      - ./aria2_config:/config
      - ./downloads:/downloads
    restart: always

  ariang:
    image: p3terx/ariang
    ports: ["6880:6880"]
    depends_on: [aria2]

关键点说明：

1. /downloads目录要确保所有容器可读写
2. RPC_SECRET相当于Aria2的API密钥
3. DISK_CACHE提升大文件下载稳定性

2.3 一键启动与验证

执行部署命令：

bash复制docker-compose up -d

等待约2分钟后，打开浏览器访问：

• Alist管理界面：http://你的IP:5244
• AriaNg控制台：http://你的IP:6880

首次登录Alist需要获取管理员密码：

bash复制docker exec -it alist ./alist admin

3. 深度配置技巧

3.1 Alist网盘挂载实战

以百度网盘为例：

1. 在Alist后台点击"存储"-"添加"
2. 选择"百度网盘"驱动类型
3. 获取refresh_token：
   • 登录百度网盘网页版
   • 按F12打开开发者工具
   • 在Application→Cookies中找到BDUSS和STOKEN

实测挂载后，可以直接在线播放4K视频而不需要下载。有个坑要注意：部分网盘需要配置自定义User-Agent，建议在Alist的"全局设置"中添加：

code复制User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64)

3.2 Aria2性能调优

修改aria2_config/aria2.conf：

code复制# 最大同时下载数
max-concurrent-downloads=5
# 单个文件连接数
split=16
# 下载速度限制（0表示不限速）
max-overall-download-limit=0
# 做种设置（PT用户需修改）
seed-ratio=1.0
seed-time=60

我常用的速度优化组合：

• 启用BT tracker自动更新
• 设置disk-cache=64M
• 对于海外服务器，添加--bt-force-encryption=true

4. 高阶玩法与自动化

4.1 三种下载姿势对比

推荐工作流：

1. 通过Alist浏览网盘文件
2. 右键大文件选择"发送到Aria2"
3. 在AriaNg查看实时进度

4.2 自动化脚本示例

创建自动导入下载任务的脚本：

bash复制#!/bin/bash
# 监控Alist生成的任务队列
inotifywait -m /path/to/download_links.txt -e create |
while read path action file; do
  aria2c --rpc-secret=my_secure_key \
         --input-file="$path/$file" \
         --dir=/downloads
done

配合Alist的Webhook功能，可以实现网盘新增文件自动下载。我常用这个方案自动同步工作文档，实测延迟在30秒以内。

5. 避坑指南

5.1 权限问题终极解决方案

遇到文件无法写入时，按这个顺序检查：

1. 主机目录权限：chmod 777 -R /path/to/downloads
2. Docker容器用户ID：确保PUID/PGID与主机用户一致
3. SELinux状态：setenforce 0临时关闭测试

5.2 下载速度慢排查

我的诊断 checklist：

• [ ] 测试直连速度：wget http://example.com/1GB.bin
• [ ] 检查Aria2连接数：split值建议10-20
• [ ] 更新BT tracker列表
• [ ] 更换下载端口（某些ISP限制6881-6889）

有个冷知识：Aria2的UDP端口（6888）对BT下载速度影响很大，务必在路由器做端口转发。

这套系统已经稳定运行半年，期间经历过三次大版本升级。最让我惊喜的是Alist的更新机制，只需要docker-compose pull && docker-compose up -d就能无缝升级，数据完全保留。现在我的私人影库所有影片都是通过这个方案自动获取，手机上的Infuse播放器直接连接WebDAV，体验比付费网盘会员还流畅。