Iwara视频批量下载神器IwaraDownloadTool：3步上手，从手动搬运到全自动收藏

Iwara视频批量下载神器IwaraDownloadTool：3步上手，从手动搬运到全自动收藏

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

你是不是也遇到过这种情况：在 Iwara 上刷到一个特别喜欢的作者，翻遍他主页把几十个视频一个个点开、一个个手动保存，半小时过去手指都快抽筋，结果画质还是默认的低清版？又或者评论区里作者明明放了网盘链接，你却压根没注意到，白白错过高清资源？

别慌，今天介绍的这款开源工具IwaraDownloadTool就是来帮你"一键解放双手"的。它是一个运行在浏览器里的用户脚本，专门解决 Iwara 视频下载的三大痛点：批量下载、高清画质、自动识别第三方网盘链接。你不需要懂代码，跟着这篇文章走，5 分钟就能让它跑起来。

为什么是它：3 个不得不爱的理由

先别急着安装，花 30 秒看看这 3 个理由，你就知道它值不值得折腾：

• ✅批量勾选，一次搞定一整页：浏览视频列表时，每个视频卡片左上角都会自动出现一个勾选框，想下载哪个勾哪个，勾完一键加入下载队列，收藏夹、订阅页几百个视频也能批量处理。
• ✅自带"网盘雷达"：它能自动扫描视频简介和评论区，识别 mega.nz、百度网盘、Google Drive、阿里云盘、Mediafire、Rapidgator 等几十种第三方网盘链接，并把带链接的视频单独标记出来，再也不用逐条翻评论了。识别规则就维护在 src/data/downloadLinks.json 里，一眼能看懂。
• ✅四种下载通道任你选：支持 Aria2 加速下载、iwaradl、浏览器直下、外部下载器四种模式，还能自定义保存路径和文件名，下载完的文件夹整整齐齐。入口和下载逻辑见 src/download/download.ts。

功能速览表，扫一眼就懂：

核心入口在 src/main.ts，整个脚本围绕页面注入、下载队列、Aria2 追踪三条主线组织，结构相当清晰，有兴趣的开发者可以直接翻源码。

5 分钟上手：三步让下载按钮出现在页面上

安装过程没有想象中复杂，就三步。

第一步：装好脚本管理器

• Chrome / Edge / 其他 Chromium 内核浏览器（版本 ≥ 110）：安装Tampermonkey（篡改猴）扩展
• Firefox（版本 ≥ 110）：同样安装 Tampermonkey

装好后，浏览器右上角会出现一个带角标的小图标，这就对了。

第二步：安装脚本

有两条路，任选其一：

1. 普通用户推荐：打开脚本发布站搜索 "IwaraDownloadTool"，点安装即可（也就是 GreasyFork/SleazyFork 等脚本管理站，脚本 ID 为 422239）。
2. 开发者模式：如果你更喜欢源码构建，可以这样操作：

git clone https://gitcode.com/gh_mirrors/iw/IwaraDownloadTool npm install npm run build

构建产物就是一个.user.js文件，拖进 Tampermonkey 即可。

第三步：刷新页面，验证安装

• 打开 Iwara 网站（支持 iwara.tv、iwara.ai 两个域名），刷新任意视频页
• 页面右下角会出现工具菜单，视频卡片上出现勾选框
• 首次运行会弹出引导弹窗，勾选"我已了解使用方法"后点确定，就能进配置面板了

✅验证清单：

• 视频卡片左上角出现小勾选框
• 视频页右下角出现悬浮菜单
• 点开视频页能看到"下载"相关按钮
• 右键检查脚本菜单里能看到 IwaraDownloadTool

三项以上打勾，说明你已经装好了，接下来就是真正的实战。

三大实战场景：从入门到进阶一次讲透

场景一：新手入门，下载你的第一个视频

小目标：5 分钟内把一个视频稳稳下到电脑里。

1. 打开任意一个 Iwara 视频页面
2. 找到工具菜单里的下载按钮，点击
3. 首次使用建议选择"浏览器下载"模式（最省事，不需要额外软件）

达成效果：视频直接通过浏览器保存到本地，同时弹出一个命名预览，告诉你文件会叫什么名字。想确认脚本有没有正常运转，翻翻 src/download/download.ts 里browserDownload的实现，它就是浏览器直下的核心逻辑。

场景二：日常高频，批量收藏 + 自定义命名

小目标：把一个作者主页的视频全部按"作者/标题"分类归档。

1. 进入作者主页，视频列表的每张卡片上都会出现勾选框
2. 全选或按需勾选，点"添加到下载队列"
3. 进配置面板，把"保存位置"改成你喜欢的模板

工具默认的路径模板是这样的：

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

也就是说，下载的文件会自动放进Iwara/作者名/标题[视频ID].mp4这样的目录结构。支持的变量不止这几个，完整的变量表在 src/download/downloadPath.ts：

达成效果：勾选→入队→自动下载，文件夹里每个视频都按统一规则命名，不再出现"视频(1).mp4"这种混乱局面。

场景三：进阶玩家，Aria2 加速 + 网盘链接 + 私有视频

小目标：跑满带宽、不错过网盘资源、下载好友限定视频。

先开 Aria2 加速：

1. 下载并启动 Aria2，开启 RPC 服务（默认地址http://127.0.0.1:6800/jsonrpc）
2. 在工具配置里把"下载类型"切到 Aria2，填入同样的地址
3. 工具会自动接管已有任务，检测到下载速度过慢还会自动重启任务，这个机制在 src/download/aria2.ts 和 src/download/aria2TrackManager.ts 里都有实现

再开网盘雷达：

• 在配置里打开"检查下载链接"开关，之后凡是简介或评论里带 mega.nz、百度网盘、阿里云盘等链接的视频，都会被自动标记出来，一眼就能识别

最后解锁私有视频：

• 前提是：你关注的作者、且用已和作者成为好友的账号登录
• 打开"显示不公开/私有视频"开关，这类视频就会强制显示出来

达成效果：下载速度肉眼可见地提升，网盘资源不再错过，收藏的朋友限定内容也能备份到本地。

避坑宝典：新手最容易踩的 4 个坑

• ⚠️坑 1：勾选框不出现。多半是脚本没刷新加载。先确认 Tampermonkey 图标上有脚本生效的角标，再强刷（Ctrl+Shift+R）页面。还不行就禁用广告拦截插件试试。
• ⚠️坑 2：浏览器下载失败。Tampermonkey 默认会拦下载请求，需要在 Tampermonkey 设置里把 iwara 域名加入下载白名单，或者干脆切换到 Aria2 模式，一劳永逸。
• ⚠️坑 3：私有视频下不了。检查你是不是真的已和作者互相关注/成为好友，且用的是这个账号登录。工具只是"解锁入口"，权限本身还是要靠账号关系。
• ⚠️坑 4：文件名乱码或路径非法。Windows 下标题里的\ / : * ?等字符会搞坏路径，好在工具自带路径清洗（pathSanitize）、emoji 替换（pathReplaceEmojis）、超长截断（pathTruncate，默认标题上限 72 字符）这些开关，默认全开，别手痒关掉就行。

效率翻倍的 4 个进阶小技巧

• 🎯用空格键勾选：鼠标悬停在视频卡片上，直接按空格键就能快速勾选，批量操作快到飞起。
• 🎯画质优先级自定义：默认优先级是 Source > 540p > 360p > preview，你可以在配置里调整，比如"永远优先 360p 小文件"，省流量又省硬盘。
• 🎯自动关注 + 自动点赞：在配置里打开"自动关注/自动点赞"开关，勾选过的视频作者会被自动关注，下次更新第一时间发现新作品。
• 🎯元数据一起下载：打开"自动下载元数据"，视频会附带一个同名.json文件，里面是完整的视频信息（标题、作者、上传时间等），做素材库索引特别好用。

最后一步：今天就完成的 3 个动作

工具的价值在于把重复劳动交给脚本，把时间还给你自己。现在，动手做这三件事：

• 装好 Tampermonkey 并安装 IwaraDownloadTool（10 分钟）
• 刷新 Iwara 页面，勾选 3 个视频，完成第一次批量下载（5 分钟）
• 把保存路径改成/Iwara/%#AUTHOR#%/%#TITLE#%[%#ID#%].mp4，体验自动归档（2 分钟）

做完这三步，你就正式告别"手动一个个保存"的时代了。之后想深入了解，可以看看项目里的 README.md、贡献指南 CONTRIBUTING.md，或者直接翻 src/ui/ui.ts 体验界面注入的实现细节。

使用规范提醒

请一定记住：本工具仅用于个人合理使用，请尊重视频作者与创作者的版权和劳动成果，遵守 Iwara 平台用户协议，不进行商业用途传播，不二次分发下载内容。下载内容仅供个人学习、收藏与研究，请遵守当地法律法规。技术是中立的，但使用方式体现素养，做一个尊重创作者的好用户。

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