零基础学会 IwaraDownloadTool：批量下载、Aria2 加速与避坑全攻略

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

收藏夹越攒越多、手动下载越来越烦，这几乎是每个 Iwara 用户的共同记忆。直到我装上IwaraDownloadTool——一个专为 Iwara 批量下载视频而生的开源油猴脚本，才真正告别了逐个右键保存的苦日子。如果你也存了成百上千个视频却不知道从哪下手，这篇文章就是写给你的。

它到底帮你省了什么

一句话概括：在浏览器里装一个"下载管家"。

你平时遇到的那些麻烦，它基本都替你想到了：

• 一个视频一个视频地手动存？它支持批量勾选、排队下载；
• 默认只能拿到低清版本？它把画质选择权交给你，默认优先原画；
• 想整理成自己的资料库？它支持自定义保存路径和文件名；
• 简介或评论区里的网盘链接？它能自动识别并提示，不用你再大海捞针。

底层它是一个油猴脚本，跑在 Tampermonkey 这类脚本管理器里。你不需要懂代码，装完刷新页面，下载按钮自然就出现了。

我上手后的真实感受是：最直观的变化，就是"页面上的每个视频都能勾选了"。

三分钟装好它

安装步骤简单到不需要动脑子：

1. 给浏览器装上Tampermonkey（Chrome 110+、Edge 110+ 或 Firefox 110+ 都支持）；
2. 从 GreasyFork 等脚本市场搜索 IwaraDownloadTool，点"安装"；
3. 回到 Iwara 页面刷新一次，看到下载按钮出现，就算成功了。

如果你是开发者，也可以把仓库克隆到本地自行构建（仓库地址：https://gitcode.com/gh_mirrors/iw/IwaraDownloadTool）。脚本入口在src/main.ts，逻辑按模块拆开放在src/core、src/download、src/network等目录里，顺着读并不费劲。

装好后记得先看一眼语言设置——它内置了简体中文、英文、日文三种界面，默认跟随浏览器自动切换，基本不用手动管。

第一次下载：别怕，点就完了

打开任意一个视频页，你会看到和画质、格式、分辨率相关的下载选项。挑一个你想要的画质，点下载即可。

第一次用，记住两个要点就够：

• 画质优先级默认是Source > 540 > 360 > preview，也就是优先拿最高清的源文件，不用每次手动去切；
• 勾选多个视频后，它们会进入同一个下载队列自动排队处理，你不用守在屏幕前。

下载完成后，脚本会把视频信息缓存到本地数据库里。以后做去重、查历史记录都靠它，同一个视频也不会被反复下载。

让它按你的规矩存文件

默认的保存路径长这样：

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

翻译过来就是"按作者建文件夹，文件名是标题加 ID"。你完全可以在设置里自由组合这些变量：

• %#AUTHOR#%— 作者名
• %#TITLE#%— 视频标题
• %#ID#%— 视频 ID
• %#QUALITY#%— 画质等级
• %#NowTime#%/%#UploadTime#%— 下载时间 / 上传时间

另外，脚本内置了一套"文件名洁癖"处理：自动做 Unicode 归一化、把 emoji 替换成下划线、清理非法字符、超长自动截断。哪怕标题里塞满奇怪符号，落盘的文件名也不会让 Windows 报错。

建议一开始就定好命名规则，后面整理资料库能省下大量时间。

进阶三连：让下载真正自动化

用顺手之后，下面三个功能值得专门打开。

第一，Aria2 加速。Aria2 是支持多线程和断点续传的下载器，配合它下载速度能明显提升。在设置里填上 Aria2 的 RPC 地址（默认http://127.0.0.1:6800/jsonrpc）即可。更贴心的是，脚本会自动追踪 Aria2 里的任务：接管你已存在的下载、轮询任务状态，遇到速度掉到 64KiB/s 以下还会自动重启任务。这块逻辑在src/download/aria2TrackManager.ts，跨页面共享一个队列，多开标签页也不会打架。

第二，第三方链接识别。很多作者会在简介或评论区放网盘下载链接。开启"检查下载链接"后，脚本会用内置的链接特征库（见src/data/downloadLinks.json）自动帮你标出来，一眼就能看到哪里有资源。

第三，私有与隐藏视频。对好友可见的私有视频，用已和作者成为好友的账号就能下载；隐藏视频只要知道视频 ID 也能处理。订阅页里不想看到不公开内容，还有过滤选项可以一键屏蔽。

这几个开关默认都是关的，去设置里按需打开就行。

常见问题快问快答

Q：下载按钮不出现怎么办？先确认脚本管理器启用了、页面刷新过，再检查浏览器版本是否 ≥110。有时是广告拦截插件误伤，暂时禁用再试。

Q：为什么下载到一半失败了？先看网络稳不稳定，再调大超时时间和重试次数。如果用的是 Aria2 模式，多半是 RPC 服务没启动或地址填错，重点检查aria2Path这一项。

Q：可以下载需要关注的视频吗？可以。私有视频的下载需要你关注作者，并使用已与其成为好友的账号来操作。

Q：下载出来的文件名太乱？去设置里调整downloadPath的变量组合，并确认"路径规范化"相关的开关是打开的。

Q：会重复下载看过的视频吗？不会。脚本本地有数据库记录，同一视频会被自动去重。

用得久，也要用得稳

脚本更新频率不低，建议隔段时间去发布页看看有没有新版本。日常维护其实就两件事：定期清理下载记录，以及给重要配置做个备份。

最后说几句正经的：下载类工具请务必仅供个人学习使用。收藏和备份自己的内容没问题，但不要搬运他人作品、不要用于商业用途，也请尊重创作者的版权和平台规则。工具本身是中立的，怎么用，取决于我们。

现在，打开你的收藏夹，从第一个视频开始试试吧。学会 IwaraDownloadTool 的批量下载之后你会发现——真正省下来的不是时间，而是刷收藏夹时的那口气。

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