Reaparr 下载队列实战暂停、恢复、自动重试的10个实用技巧【免费下载链接】ReaparrPlex downloader that brings content from any server to yours!项目地址: https://gitcode.com/gh_mirrors/pl/ReaparrReaparr 是一款开源的 Plex 下载器能把任意 Plex 服务器上的电影和剧集直接下载到你自己的服务器。它的下载队列支持手动暂停、断点式恢复、关机自动保存进度、崩溃后自动归位以及失败后的干净重试。本文面向新手整理了 10 个实用技巧帮你快速掌握 Reaparr 下载队列的完整玩法。1️⃣ 读懂下载状态Queued、Paused 与 AutoPaused 的区别Reaparr 中每个下载任务都有清晰的状态机定义在 DownloadStatus.cs 中。常见状态如下状态含义能否直接恢复Queued排队中等待队列轮到它开跑无需操作Downloading下载中正在从源服务器拉取数据—Moving转移中下载完成正在移动到最终目录—Paused已暂停你手动暂停的可无损恢复✅AutoPaused自动暂停系统暂停关机/崩溃可恢复✅Stopped已停止被显式取消需 Restart 重来❌ 需重试SourceUnavailable源不可用源服务器上的媒体已被删除❌ 需检查源记住一个原则带 Paused 字样的状态都能安全恢复带 Error/Stopped 的则需要重试或重建任务。2️⃣ 手动暂停单个下载任务随时可以安全叫停在下载队列页面对任意任务点暂停即可。实现见 PauseDownloadTaskCommand.cs它的行为比想象中更细致任务正在下载中 → 立即停止底层下载作业状态置为Paused任务正在移动文件→ 先停掉移动作业再置为MovePaused任务已下载完但还没开始移动 → 直接标记暂停不会被误当成可执行任务⚠️ 已移动到一半的文件进度会被保留暂停不会把已完成的移动重置掉。3️⃣ 恢复下载任务Resume 只会续上可恢复的进度点恢复时StartDownloadTaskCommand.cs 会按以下逻辑找下一个要跑的任务优先找处于Paused / AutoPaused / MovePaused / AutoMovePaused的子任务——无损续传找不到就找第一个未完成的任务如果该服务器被你整体暂停了恢复请求会被直接拒绝防误触也就是说恢复操作对电影、剧集、整季任务都能正确续上且剧集任务会把后面排队的兄弟任务一并标记为 Queued保持顺序不乱。4️⃣ 一键暂停整台 Plex 服务器的所有下载换设备、省流量或源服务器维护时不必逐个暂停。服务器级暂停命令见 PausePlexServerDownloadsCommand.cs立即暂停该服务器上所有正在下载/移动的任务给服务器打上IsDownloadsPausedByUser标记排队中的任务也不会开跑想恢复时使用 ServerResume 下的对应命令一键恢复整服5️⃣ 关机自动保存AutoPause 帮你留住进度正常关闭 Reaparr 前AutoPauseActiveDownloadsCommand.cs 会扫描所有服务器把正在下载和移动的任务全部自动暂停标记为AutoPaused / AutoMovePaused而且会扫两轮防止第一轮暂停过程中新启动的任务漏网。下次启动后这些任务可以直接续传而不是从头下。6️⃣ 崩溃恢复重启后僵尸任务自动归位如果 Reaparr 被强制杀死、断电或崩溃数据库里可能残留状态还停留在Downloading / Moving的僵尸任务。启动时 RecoverInterruptedDownloadsCommand.cs 会自动把它们重置为AutoPaused / AutoMovePaused下载中的任务 →AutoPaused保留已下载进度可续传移动中的任务 →AutoMovePaused保留已移动进度你不需要手动修复数据库重启后到队列里点恢复即可。7️⃣ 下载失败怎么重试Restart 干净地从头再来遇到IntegrityError校验失败、ServerUnreachable源服务器离线、DownloadClientError等状态时用Restart重试。RestartDownloadTaskCommand.cs 的流程是停止该任务组下所有子任务从源服务器重新拉取媒体元数据文件名、质量、路径进度清零、状态回到Queued重新入队如果源媒体已不存在会明确标记SourceUnavailable避免无限空转 小提示Stopped状态的任务不能直接 Resume必须走 Restart 重新入队。8️⃣ 队列排队规则同一服务器上的任务如何依次开跑队列调度由 DownloadTaskScheduler.cs 基于定时任务框架实现每个任务对应一个独立的下载作业。关键规则新任务启动后同一服务器上的其他活动下载会被自动暂停保证带宽和任务顺序可控每次启动/停止/重启操作后都会发布CheckDownloadQueueEvent队列监听器随即检查并拉起下一个Queued任务已完成的任务可以通过 Clear Completed 按任务或按服务器一键清理保持队列清爽9️⃣ 移动大文件也能暂停文件转移阶段的断点恢复下载完成后还有一段文件转移Moving阶段把文件从临时下载目录搬到最终媒体库目录。这个阶段同样支持暂停/恢复暂停时置为MovePaused恢复时置为Queued继续移动断点恢复的移动逻辑见 MoveFileWithResumeCommand.cs如果移动失败会标记MoveError此时建议 Restart 或直接重试恢复对于几十 GB 的大文件跨磁盘移动这个特性能避免中断后整个文件重新搬运。 善用下载日志排查失败原因的第一现场每个任务都带完整日志流由CreateDownloadClientLog写入可通过 GetDownloadTaskLogsByDownloadTaskIdEndpoint.cs 查询记录从排队、开始、暂停到重启的每一步看状态变化时间线判断卡在哪一步搜索Restart workflow关键字确认重试流程是否完整跑完SourceUnavailable的日志会直接告诉你找不到源媒体省去猜测新手最佳实践总结平时多用暂停/恢复保护进度关机交给 AutoPause 自动处理失败别慌先看日志再 Restart大批量操作前先用服务器级暂停兜底。掌握这 10 个技巧Reaparr 的下载队列就再也不会让你措手不及。想进一步了解代码结构可以看看整体架构说明 AGENTS.md 与项目文档 plans/。【免费下载链接】ReaparrPlex downloader that brings content from any server to yours!项目地址: https://gitcode.com/gh_mirrors/pl/Reaparr创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Reaparr 下载队列实战：暂停、恢复、自动重试的10个实用技巧
Reaparr 下载队列实战暂停、恢复、自动重试的10个实用技巧【免费下载链接】ReaparrPlex downloader that brings content from any server to yours!项目地址: https://gitcode.com/gh_mirrors/pl/ReaparrReaparr 是一款开源的 Plex 下载器能把任意 Plex 服务器上的电影和剧集直接下载到你自己的服务器。它的下载队列支持手动暂停、断点式恢复、关机自动保存进度、崩溃后自动归位以及失败后的干净重试。本文面向新手整理了 10 个实用技巧帮你快速掌握 Reaparr 下载队列的完整玩法。1️⃣ 读懂下载状态Queued、Paused 与 AutoPaused 的区别Reaparr 中每个下载任务都有清晰的状态机定义在 DownloadStatus.cs 中。常见状态如下状态含义能否直接恢复Queued排队中等待队列轮到它开跑无需操作Downloading下载中正在从源服务器拉取数据—Moving转移中下载完成正在移动到最终目录—Paused已暂停你手动暂停的可无损恢复✅AutoPaused自动暂停系统暂停关机/崩溃可恢复✅Stopped已停止被显式取消需 Restart 重来❌ 需重试SourceUnavailable源不可用源服务器上的媒体已被删除❌ 需检查源记住一个原则带 Paused 字样的状态都能安全恢复带 Error/Stopped 的则需要重试或重建任务。2️⃣ 手动暂停单个下载任务随时可以安全叫停在下载队列页面对任意任务点暂停即可。实现见 PauseDownloadTaskCommand.cs它的行为比想象中更细致任务正在下载中 → 立即停止底层下载作业状态置为Paused任务正在移动文件→ 先停掉移动作业再置为MovePaused任务已下载完但还没开始移动 → 直接标记暂停不会被误当成可执行任务⚠️ 已移动到一半的文件进度会被保留暂停不会把已完成的移动重置掉。3️⃣ 恢复下载任务Resume 只会续上可恢复的进度点恢复时StartDownloadTaskCommand.cs 会按以下逻辑找下一个要跑的任务优先找处于Paused / AutoPaused / MovePaused / AutoMovePaused的子任务——无损续传找不到就找第一个未完成的任务如果该服务器被你整体暂停了恢复请求会被直接拒绝防误触也就是说恢复操作对电影、剧集、整季任务都能正确续上且剧集任务会把后面排队的兄弟任务一并标记为 Queued保持顺序不乱。4️⃣ 一键暂停整台 Plex 服务器的所有下载换设备、省流量或源服务器维护时不必逐个暂停。服务器级暂停命令见 PausePlexServerDownloadsCommand.cs立即暂停该服务器上所有正在下载/移动的任务给服务器打上IsDownloadsPausedByUser标记排队中的任务也不会开跑想恢复时使用 ServerResume 下的对应命令一键恢复整服5️⃣ 关机自动保存AutoPause 帮你留住进度正常关闭 Reaparr 前AutoPauseActiveDownloadsCommand.cs 会扫描所有服务器把正在下载和移动的任务全部自动暂停标记为AutoPaused / AutoMovePaused而且会扫两轮防止第一轮暂停过程中新启动的任务漏网。下次启动后这些任务可以直接续传而不是从头下。6️⃣ 崩溃恢复重启后僵尸任务自动归位如果 Reaparr 被强制杀死、断电或崩溃数据库里可能残留状态还停留在Downloading / Moving的僵尸任务。启动时 RecoverInterruptedDownloadsCommand.cs 会自动把它们重置为AutoPaused / AutoMovePaused下载中的任务 →AutoPaused保留已下载进度可续传移动中的任务 →AutoMovePaused保留已移动进度你不需要手动修复数据库重启后到队列里点恢复即可。7️⃣ 下载失败怎么重试Restart 干净地从头再来遇到IntegrityError校验失败、ServerUnreachable源服务器离线、DownloadClientError等状态时用Restart重试。RestartDownloadTaskCommand.cs 的流程是停止该任务组下所有子任务从源服务器重新拉取媒体元数据文件名、质量、路径进度清零、状态回到Queued重新入队如果源媒体已不存在会明确标记SourceUnavailable避免无限空转 小提示Stopped状态的任务不能直接 Resume必须走 Restart 重新入队。8️⃣ 队列排队规则同一服务器上的任务如何依次开跑队列调度由 DownloadTaskScheduler.cs 基于定时任务框架实现每个任务对应一个独立的下载作业。关键规则新任务启动后同一服务器上的其他活动下载会被自动暂停保证带宽和任务顺序可控每次启动/停止/重启操作后都会发布CheckDownloadQueueEvent队列监听器随即检查并拉起下一个Queued任务已完成的任务可以通过 Clear Completed 按任务或按服务器一键清理保持队列清爽9️⃣ 移动大文件也能暂停文件转移阶段的断点恢复下载完成后还有一段文件转移Moving阶段把文件从临时下载目录搬到最终媒体库目录。这个阶段同样支持暂停/恢复暂停时置为MovePaused恢复时置为Queued继续移动断点恢复的移动逻辑见 MoveFileWithResumeCommand.cs如果移动失败会标记MoveError此时建议 Restart 或直接重试恢复对于几十 GB 的大文件跨磁盘移动这个特性能避免中断后整个文件重新搬运。 善用下载日志排查失败原因的第一现场每个任务都带完整日志流由CreateDownloadClientLog写入可通过 GetDownloadTaskLogsByDownloadTaskIdEndpoint.cs 查询记录从排队、开始、暂停到重启的每一步看状态变化时间线判断卡在哪一步搜索Restart workflow关键字确认重试流程是否完整跑完SourceUnavailable的日志会直接告诉你找不到源媒体省去猜测新手最佳实践总结平时多用暂停/恢复保护进度关机交给 AutoPause 自动处理失败别慌先看日志再 Restart大批量操作前先用服务器级暂停兜底。掌握这 10 个技巧Reaparr 的下载队列就再也不会让你措手不及。想进一步了解代码结构可以看看整体架构说明 AGENTS.md 与项目文档 plans/。【免费下载链接】ReaparrPlex downloader that brings content from any server to yours!项目地址: https://gitcode.com/gh_mirrors/pl/Reaparr创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考