半天上手Iwara批量下载工具：从装上脚本到让Aria2全自动接管的实操记录

半天上手Iwara批量下载工具：从装上脚本到让Aria2全自动接管的实操记录

【免费下载链接】IwaraDownloadToolIwara 下载工具 | Iwara Downloader项目地址: https://gitcode.com/gh_mirrors/iw/IwaraDownloadTool

周五晚上，你想把某位作者最近发布的几部片子都存下来。打开视频页，右键、另存、找画质、改文件名，一部搞定后你抬头一看，已经过去了二十分钟——而这只是开始。收藏夹里还躺着几十个这样的视频，一个个点下去，今晚基本就交代了。

如果你也有过这种时刻，那这篇记录就是为你写的。我们要聊的 IwaraDownloadTool（Iwara 视频下载工具）是一款跑在浏览器里的用户脚本，它做的事情不是"多一个下载按钮"这么简单，而是把"勾选视频、挑画质、排队、命名、落盘"这一整条链路接管过去，让批量这件事变得跟点一下一样轻。下文按我实际使用的顺序展开，你可以照着一步步来。

先弄明白：这个脚本到底替你包办了哪几件事

动手安装之前，值得先弄清楚它的边界。它不是下载器本身，而是下载流程的调度中枢，核心能力大致可以分成六块：

• 批量勾选与排队：在视频卡片上注入选择框，支持空格键快速勾选、本页全选/反选，然后一键把选中的视频推入下载队列。
• 画质优先级：按 Source、540P、360P、预览画质的顺序自动挑选，找不到指定画质时按配置降级，而不是直接报错。
• 第三方网盘链接嗅探：下载前自动扫一遍视频简介和评论区，发现疑似网盘下载地址会弹窗提醒你，避免你费半天劲下回一个低清版本。
• 权限视频处理：可以强制显示"不公开"和私有视频，支持下载私有视频和仅靠 ID 定位的隐藏视频。
• 文件命名自动化：用变量模板自动生成目录和文件名，并做 Emoji、非法字符、长度等规范化清理。
• Aria2 任务接管：把任务丢给 Aria2 后还会盯着它——自动接管已存在的任务，速度过慢时自动重启。

一句话总结它的设计思路：下载按钮只是入口，脚本真正管的是"从选中到落盘"的每一环。这也是它和那些只会触发一次下载的简单脚本的本质区别。

装上之前，先把这三个前提确认好

安装本身不难，但漏掉任何一条，之后都会以奇怪的方式报错。请按顺序核对：

1. 浏览器版本：需要 Chrome 或 Edge 110 及以上，或 Firefox 110 及以上。太老的版本会直接跑不起来。
2. 脚本管理器：推荐 Tampermonkey（篡改猴）。装上之后，在扩展栏里确认它是启用状态——这一步看似废话，却是"脚本装上没反应"的第一大原因。
3. 脚本来源：从脚本发布页（Sleazyfork 或 Release 页）安装正式版即可。如果你愿意尝鲜，Release 的预览版也可以装，但遇到问题先别急着怪工具。

另外要提醒一句：装好后刷新一下 Iwara 页面再使用。脚本是在页面加载时注入的，旧页面不会自动获得新功能。

装完别急着点下载，先花两分钟把设置理顺

很多人装上脚本就直奔下载按钮，结果文件不知道存到哪、画质不对、文件名乱成一团，然后回头骂工具不好用。其实设置面板里只需要理顺四件事，五分钟之内就能搞定。

在网页侧边展开脚本菜单，点"设置"，配置面板是按标签页分类的。按下面的顺序走一遍：

第一件事：确认画质优先级（"下载"页签）

默认顺序是 Source > 540 > 360 > preview，也就是"原画优先"。如果你主要想要高清素材，保持默认就行；如果网络一般想省流量，把 540 提到最前面。这里有个小经验：画质检查开关（checkPriority）建议保持开启，否则遇到没有对应画质的视频时，脚本可能直接跳过而不是降级处理。

第二件事：设置下载路径模板

默认模板是这样的：

/Iwara/%#AUTHOR#%/%#TITLE#%[%#ID#%].mp4

含义是按"作者 / 标题[视频ID].mp4"的方式自动建目录、起文件名。你可以把作者改成年份、把标题改成别名，变量清单后面会专门讲。注意：路径模板只有在 Aria2 和 iwaradl 两种下载方式下才完全生效，浏览器下载只能自定义文件名部分。

第三件事：决定是否开启路径规范化

这一组开关是处理"文件名里那些不能出现的字符"的：NFKC 规范化（统一全半角）、替换 Emoji、折叠组合变音标记、清理非法字符、截断超长标题。默认全开，建议保持默认——尤其"清理非法字符"这一项，关了它，一个带:的标题就可能让整个下载任务失败。

第四件事：选下载方式

下载方式有四种：浏览器下载、Aria2、iwaradl、其他。初次使用先选浏览器下载验证链路是否通；要追求速度和稳定性，再切到 Aria2（下面单独说）。

想让下载又快又稳？把任务交给Aria2

浏览器下载的局限很明显：单线程、断点续传靠浏览器心情、一关标签页就前功尽弃。而 Aria2 是独立跑在本地的下载引擎，多线程分片、断点续传、失败重试都是它看家的本事，两者配合起来才是这套工具的正确打开方式。

配置起来只需要两步：

1. 本地装好 Aria2 并启动 RPC 服务（默认端口 6800）。
2. 在脚本设置的"Aria2"页签填入 RPC 地址和密钥。

默认 RPC 地址是http://127.0.0.1:6800/jsonrpc，如果你没改端口就不用动它；Aria2 开了 RPC 密钥的话，把 token 填进"密钥"一栏。填完点"连接测试"，显示成功就说明握手完成。

Aria2 端可以参考这样一份参数，配合脚本的自动追踪机制使用：

{ "max-concurrent-downloads": 5, "split": 8, "max-connection-per-server": 16, "min-split-size": "1M" }

我自己的经验是：并发 5、每任务 8 线程已经能跑满家用带宽，再往上加收益很小，反而容易触发站点限速。真正值得开的是脚本的"任务自动追踪"——它会扫描 Aria2 里已存在的同名任务，避免重复下载；下载速度掉到阈值以下时自动重启任务。这意味着你批量丢进去 20 个视频之后，基本可以放着不管了。

三种下载方式怎么选，我整理成了一张对照表：

批量操作的几个正确姿势

设置搞定后，真正爽的部分才开始。批量场景下有几个操作细节值得记住：

1. 勾选：鼠标悬停在视频卡片上按空格键即可选中，不用精确点那个小复选框；菜单里还有"本页全部选中""本页反向选中""取消本页选中"三个按钮，配合使用效率极高。
2. 下载所选：勾完后点"下载所选"，脚本会逐个解析视频源、按画质优先级排队入队。解析进度会实时显示，全部完成会提示"全部解析完成"。
3. 手动 ID 下载：如果你只知道视频 ID，可以在"手动下载"里直接粘贴，多个 ID 用竖线|分隔，例如：

AeGUIRO2D5vQ6F|qQsUMJa19LcK3L

4. 去重是自动的：Aria2 追踪机制会识别已存在或已下载的任务，你不用操心重复提交。

一个小坑提醒：批量入队时如果网络波动，个别任务可能解析失败。别慌，点提示里的"重新解析"就能把这个任务单独拉回来，不需要整批重来。

面对"看不见"的视频：私有、隐藏与不公开内容

这部分是很多人来问的"高阶玩法"，其实配置里都有对应的开关，只是默认关闭：

• 强制显示不公开和私有视频：开启"不公开和私有视频强制显示"后，订阅页和时间线里原本看不到的视频会强制显示出来。注意前提是你已关注该作者，而且这个开关和"过滤订阅页中的不公开和私有视频"互斥，二选一。
• 下载私有视频：需要用与作者已成为好友的账号来下载，这是平台侧的硬限制，脚本没法绕过。
• 下载隐藏视频：不需要任何关系，但你必须知道视频 ID，通过手动下载入口输入即可。

另外还有两个自动化小开关：自动关注选中的视频作者和自动点赞选中的视频，都默认关闭，需要时在设置里手动打开。我个人会顺手打开自动关注——批量下载完一个作者，顺手把关注关系建立起来，下次更新就都进订阅页了。

第三方网盘链接这块也值得一提：开启"第三方网盘下载地址检查"后，下载前脚本会检查简介和评论里是否有疑似网盘分享链接。如果命中，它会弹提示而不是闷头下载——很多场景下，作者在评论区放的网盘资源反而比平台直链更完整，这个提醒能帮你省下不少重新下载的时间。

把文件夹理得井井有条：命名变量一览

下载多了之后，命名规则就是你的"整理系统"。脚本支持在路径模板里使用以下变量：

举个例子，如果你想按"年份 / 作者 / 标题"归档，可以这样写：

/Iwara/%#UploadTime#%/%#AUTHOR#%/%#TITLE#%[%#ID#%].mp4

配合路径规范化里的"标题最大长度"（默认 72 字符），再长的标题也会被截到可接受的范围，不会踩到文件系统 255 字符的红线。

真出状况了，按这张清单自查

用脚本下载遇到问题，先别急着重装。绝大多数问题跑不出下面这几类，按顺序查一遍通常就能解决：

如果上面都查过还是不行，把设置里的"调试模式"打开，把日志内容连同你的配置一起反馈给项目方，比一句"下载不了"有效十倍。

装好它之后，你的下载节奏会变成什么样

说实话，这个脚本带来的根本改变不是"下得更多"，而是你终于可以不用盯着下载这件事——勾选、入队、Aria2 接管、自动去重、自动重启，剩下的时间你该干嘛干嘛。对我来说，它把"周五晚上的批量保存"从半小时的重复劳动变成了两分钟的操作。

接下来的动作，按顺序做就行：

1. 装好 Tampermonkey，从脚本发布页装上 IwaraDownloadTool，刷新 Iwara 页面确认侧边菜单出现。
2. 打开设置，按上文顺序确认画质优先级、下载路径和路径规范化四项开关。
3. 下载方式先选浏览器下载，随便挑一个视频验证全链路通畅。
4. 配置好 Aria2，点"连接测试"通过后，把下载方式切到 Aria2。
5. 去订阅页批量勾选一批视频，点"下载所选"，然后看着它自己跑完。

最后一句实话：工具能替你省下的是重复劳动，但下载任何内容之前，记得确认你自己有这份权限、尊重作者的分享意愿。用得顺手，也请用得克制。

想从源码自己构建或研究实现细节，可以 clone 仓库：https://gitcode.com/gh_mirrors/iw/IwaraDownloadTool，源码用 TypeScript 编写，入口在src/main.ts。

【免费下载链接】IwaraDownloadToolIwara 下载工具 | Iwara Downloader项目地址: https://gitcode.com/gh_mirrors/iw/IwaraDownloadTool