离线下载对接说明

AaronLiu edited this page 2018-08-30 20:07:02 +08:00

Table of Contents

• 1.使用配置文件启动Aria2
• 2.配置离线下载
• 常见问题及注意事项

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Cloudreve的离线下载功能是基于Aria2实现的，在启用离线下载功能前，请先在服务器上安装Aria2。具体流程可参考网络，在此不再赘述。

1.使用配置文件启动Aria2

新建aria2.conf，在此文件中根据你的需求填写aria2的相关配置，其中需要特别注意的几项是：

#是否启用RPC服务，请设置为true
enable-rpc=true
#RPC服务的端口，默认为6800
rpc-listen-port=6800
#设置PRC服务的密钥，在接下来的步骤中会用到
rpc-secret=SomeThingHardToGuess

保存后使用此配置文件启动aria2服务：

#/home/aria2.conf为配置文件路径
aria2c.exe -conf-path=/home/aria2.conf

2.配置离线下载

转到Cloudreve后台的离线下载配置页，按照提示填写各项配置

常见问题及注意事项

注意：

• 如果需要终止aria2进程，请确保所有离线下载任务已完成或被取消。如果需要强制终止，请不要忘记删除aria2创建的session文件中留下的记录，或者将下载创建的临时文件删除以避免下次启动时发生冲突。
• bt下载可能需要你手动在配置文件中填写tracker服务器以获得更佳的下载速度
• 请添加cron定时任务，系统每隔半分钟会刷新所有进行中任务的状态，你可以在后台-其他-定时任务中更改此间隔

常见问题：

1. 离线下载容量配额如何处理？

   下载开始时系统不会对容量进行检查。当aria2成功获取到文件大小，并且被Cloudreve获取到状态时，系统会检查用户是否可以下载此文件，如果容量不足，系统会强行终止任务；如果任务文件的大小无法被获取，系统会实时检查已下载内容大小，并在任务完成时检查容量；如果正在进行中的任务已经超出容量配额，用户将不能再创建新任务。

2. 无法创建离线下载任务？

   根据错误提示，如果提示为请求失败请检查aria2及其RPC服务是否启动，配置信息是否正确。如果为其他提示，请参阅aria2文档排查原因。

3. 下载完成后文件管理器中未出现文件，日志中提示Permission denied

   请以和php进程相同的用户身份启动aria2，并且确保php拥有对下载文件目录的读写权限。或者使用https://forum.cloudreve.org/d/168 的解决方案