Iwara 视频批量下载工具保姆级上手指南：从单条收藏到整页打包，只差这一步

Iwara 视频批量下载工具保姆级上手指南：从单条收藏到整页打包，只差这一步

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

Iwara 视频批量下载工具（IwaraDownloadTool）是一款免费开源的浏览器脚本，专门解决 Iwara 站点"看得到却拿不走"的难题。它的招牌能力是一键批量勾选视频、自由挑选清晰度，以及把任务直接转交给 Aria2 加速下载，几分钟就能把一整个页面的内容搬回硬盘。全程不需要写一行代码，跟着这篇指南走完，你也能轻松驾驭。

这篇指南是写给谁的

如果你属于下面任何一种情况，这篇内容就是为你准备的：

• 看到喜欢的作者发了新作，想整页收下，而不是一个个右键另存为
• 想要最高清的那一档画质，而不是默认的低分辨率版本
• 面对私有视频、隐藏视频、评论区里的网盘链接，完全不知道从何下手
• 囤了一堆视频在浏览器里，下载完文件名乱七八糟，根本不想整理

哪怕你之前从没装过任何浏览器脚本，也完全没关系。下面所有操作都按新手能照做的粒度展开，你只需要跟着点。

动手之前，先备齐这两样东西

装这个脚本的门槛极低，只要求两件事：

1. 一款符合版本要求的浏览器。Chrome 或基于 Chromium 内核的浏览器（比如 Edge）需要 110 及以上版本；Firefox 同样要求 110 及以上。太老的浏览器可能跑不动。
2. 一个脚本管理器插件。推荐使用 Tampermonkey（篡改猴），它相当于浏览器里的"脚本运行容器"，几乎所有用户脚本都要靠它运行。

这两样装好后，刷新一下 Iwara 页面，准备工作就算完成。

把脚本装进浏览器的两条路线

获取脚本的方式很灵活，按你的习惯选一条即可。

路线一：在线安装（适合大多数用户）

在脚本分发站点（如 Sleazyfork）搜索项目名 IwaraDownloadTool，点进详情页后，Tampermonkey 会自动弹出安装确认窗口，点"安装"就完成了。整个过程不到半分钟。

路线二：本地文件安装（适合喜欢手动掌控的用户）

把编译好的 .user.js 文件下载到本地，然后打开 Tampermonkey 的管理面板，选择"实用工具"→"导入"，把文件拖进去即可。这种方式的好处是你可以固定使用某个特定版本，不受自动更新影响。

📌 如果你对项目源码感兴趣，想自己研究或二次开发，可以通过 git 克隆仓库：https://gitcode.com/gh_mirrors/iw/IwaraDownloadTool ，按 README 里的构建说明自行编译出脚本文件。

第一次打开页面，会发生什么

安装并刷新 Iwara 后，页面会弹出一个首次安装引导窗，大致说明了几件事：如何勾选视频、如何触发下载、去哪里反馈问题。把"我已了解"勾上并确认，配置面板就会自动打开。

接下来你会发现页面上多了不少东西：每个视频卡片左上角出现一个对勾按钮，页面角落出现一个浮动的菜单，这就是脚本的主入口。所有设置都集中在这个菜单里，改完即时生效，不用刷新页面。

把招牌功能逐个过一遍

1. 批量勾选：整页视频一键收进清单

这是整个工具最常用的一招。每个视频卡片上都有一颗选择按钮，点一下即可加入待下载清单。更快的操作是：鼠标悬停在视频上，直接按空格键就能勾选或取消，连续点几下手都不累。

被勾选的视频会实时汇总到页面角落的计数里，方便你随时确认"已经挑了几个"。选完后，从菜单里点"下载选中项"，脚本会逐个解析视频信息并自动加入下载流程。

2. 画质优先级：默认就要最好的那一档

很多人下载 Iwara 视频时最头疼的就是画质——平台默认给的往往不是最高清版本。这个工具内置了画质优先级机制，你可以给不同清晰度设置权重，比如把"Source"（原片）设为最高、540P 次之、360P 垫底。这样脚本在解析时会优先找权重高的画质，找不到才依次降级。想要 4K、原片级别的素材，就在这里配置。

3. 四种下载通道，按你的设备选一种

下载方式的选择非常自由，在配置里切换即可：

其中 Aria2 通道是多数进阶玩家最爱，相关实现可以看源码 src/download/aria2.ts。

4. Aria2 配置与"任务自动接管"

如果选择 Aria2 通道，只需要在设置里填上 RPC 地址（默认是 http://127.0.0.1:6800/jsonrpc）和 token 即可。更省心的是它的任务自动追踪机制：

• 脚本启动时会自动接管 Aria2 里已有的相关任务，不需要你手动核对
• 下载过程中如果速度过慢，会自动帮你重启任务
• 下载完成的文件会自动同步到媒体中心，方便统一管理

这个机制在 src/download/aria2TrackManager.ts 中实现，属于"开了就能躺平"的功能。

5. 文件名模板：从此告别乱码文件

默认的文件名规则长这样：/Iwara/%#AUTHOR#%/%#TITLE#%[%#ID#%].mp4。这套模板会按"作者/标题[视频ID]"的结构自动归档。你可以自由替换变量：

• %#AUTHOR#%作者名
• %#TITLE#%视频标题
• %#ID#%视频 ID
• %#QUALITY#%实际下载的画质
• %#NowTime#%下载时间
• %#UploadTime#%上传时间

更贴心的是，文件名还内置了清洗逻辑：自动把 emoji 换成下划线、去掉系统不支持的字符、超长标题自动截断，避免保存时报错。这套规则在 src/download/downloadPath.ts 里，想微调随时可以看。

6. 网盘链接嗅探：简介和评论里的资源也逃不掉

很多创作者会在视频简介或评论区放出第三方网盘的下载链接。打开"检查下载链接"开关后，脚本会自动扫描视频简介与评论内容，一旦命中预设的特征词（规则清单在 src/data/downloadLinks.json），就会弹窗提醒你"这里可能有外部资源"，点击即可前往视频页查看。

7. 私有视频与隐藏视频

对于权限受限的内容，工具也留了后路：

• 私有视频：使用已经和作者互为好友的账号登录，即可正常下载
• 隐藏视频：只要你手里有视频 ID，手动输入即可添加任务
• 另外还有两个互斥的开关：一个是把订阅页里的私有视频强制显示出来（需要关注作者），另一个是把它们从订阅页里过滤掉，让列表更干净。二选一，别同时开

三个拿来即用的真实场景

场景一：把心仪作者的全部作品搬回家

打开作者主页，逐条空格勾选（或借助筛选功能），确认数量后统一加入下载。脚本会依次解析每个视频的信息并排队下载，中途你可以去忙别的。

场景二：订阅页去噪，只留想看的

订阅页里混着一堆不公开、私有的视频很烦人。开启"过滤不公开和私有视频"后，页面瞬间清爽，配合画质优先级，收藏效率直接翻倍。

场景三：深夜挂机，利用 Aria2 跑满带宽

把下载通道切到 Aria2，设好并发数，睡前勾选一批视频，第二天醒来就都在硬盘里了。中途网络抖动导致速度骤降，任务自动重启功能会帮你兜底。

卡壳了？对照这份排查清单

• 勾选框不显示？先确认脚本管理器处于启用状态，再确认脚本已更新到最新版本，必要时禁用广告拦截插件后刷新页面重试。
• 下载任务一直失败？检查网络是否稳定，看配置里的超时与重试参数是否合理，磁盘是否有写入权限。
• Aria2 连不上？确认 RPC 服务已启动、地址和 token 填写无误，再回到设置里点一次连接测试。
• 文件保存名报错？多半是模板里用了当前系统不支持的字符，改回默认模板或开启文件名清洗开关即可。

让整个流程再顺滑一点的几个小细节

• 把"自动关注作者""自动点赞"打开，下载的同时顺手完成互动，方便以后追更（注意默认是关闭的，需要手动开启）
• 开启"自动下载元数据"，每个视频会附带一份包含标题、作者、上传时间等信息的 JSON 文件，配合文件归档特别好用
• 需要大量添加任务时，可以用菜单里的"手动输入"直接粘贴一串用|分隔的视频 ID，省去逐个搜索

最后，照着这份清单行动起来

1. 确认浏览器版本 ≥110，装好 Tampermonkey
2. 在线或本地安装 IwaraDownloadTool 脚本并刷新页面
3. 走完首次引导，先下载一个视频验证功能正常
4. 按自己的偏好配置画质优先级与文件名模板
5. 需要高速下载时，接入 Aria2 并开启任务自动接管
6. 批量勾选收藏，建立你自己的下载工作流

最后想提醒一句：下载内容请仅用于个人学习与收藏，尊重每一位创作者的劳动成果，遵守平台的使用条款。工具本身只是把"下载"这件事变得高效，怎么用得体，始终在你手里。

祝你的收藏夹早日满满当当，下载一路顺风。

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