Aria2Desktop
Health Gecti
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Community trust — 10 GitHub stars
Code Gecti
- Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Gecti
- Permissions — No dangerous permissions requested
Bu listing icin henuz AI raporu yok.
集成 aria2 的跨平台下载器(Windows / macOS / Linux),带 Web 控制台、MCP 接口与插件市场
Aria2 Desktop
简介
Aria2 Desktop 是一款基于 Electron + Vue 3 的跨平台桌面下载管理器(Windows / macOS / Linux),
把 Aria2 引擎和图形界面打包在一起:装完打开就能用,不需要命令行,也不需要单独配置引擎。
- 开箱即用:安装包内置 Aria2(Windows / Linux 1.37.0,macOS 1.36.0),不依赖系统环境
- 协议齐全:HTTP/HTTPS、FTP/SFTP、BitTorrent、磁力链接、Metalink
- 扩展协同:浏览器扩展把链接交给 App 处理,你在 App 里设的分类、子目录与下载选项对扩展同样生效
- 省流更新:Windows 支持差量更新,实测相邻版本可复用约 94% 的字节;macOS 与 Linux 也支持应用内检查、下载与安装更新
界面

| 深色主题 | 设置(按组分类 + 全局搜索) |
|---|---|
![]() |
![]() |

功能
下载
- 多线程、断点续传;全局与单任务限速,底部状态栏可直接填写限速值(KB/s 或 MB/s),输入即生效
- 下载队列 2.0:等待队列可视化,支持置顶/上移/下移/置底、最大并发与失败自动重试策略
- 任务模板:把代理、User-Agent、Referer、Cookie、请求头与保存目录保存为模板,新建任务一键复用
- 完成规则:按分类/扩展名/成功或失败状态触发移动、重命名、解压、打开、通知与 Webhook;Webhook 支持 HMAC-SHA256 签名、指数退避重试与失败队列(可在工作流页面手动重试或清空),投递记录重启后仍保留
- 速度调度:按星期/时间段自动切换到不同限速(例如工作日白天限速)
- 定时下载:按时间段自动暂停/恢复全部任务,适合夜间挂机;不会覆盖你手动暂停的任务
- 自动化页面:RSS/Atom 订阅定时抓取,按包含/排除正则过滤后自动创建下载(条目去重、单次上限、可存到指定目录);监听文件夹自动导入新增的
.torrent/.metalink/ 磁力链接文本文件,导入后删除或移入imported/子文件夹,内容哈希去重不重复导入 - 分类下载:按视频/音乐/图片/文档/压缩包/程序自动归入子目录,列表可按分类与来源(HTTP/BT/磁力/流媒体)筛选
- BT:下载前勾选文件并按类型快筛,列表内直接停止/重新做种,Tracker 订阅自动聚合最新列表
- BT 洞察页:独立页面实时查看 Peers(客户端、IP 归属地、速度、做种状态)与 Tracker 分组列表,汇总卡显示做种数、聚合速度与 info hash;页面可见时每 5 秒自动刷新
- 磁力链接与
.torrent/.metalink注册为系统处理器;磁力任务可另存为.torrent;同一磁力重复添加会被识别并提示 - 粘贴浏览器「Copy as cURL」自动提取链接、Referer、User-Agent 与 Cookie;支持批量粘贴、拖拽 URL 或
.torrent/.metalink - 失败任务可按原始来源(链接/种子/磁力信息哈希)重建并重试;未完成任务与完成历史支持脱敏导出/校验导入,换机迁移方便
- 删除任务文件默认移到系统回收站,误删可恢复;完成页可直接打开文件或所在目录,也支持批量打开已选任务
- 速度曲线与重试断点:状态页显示实时速度历史,自动重试时在曲线叠加标记;任务详情含 Peer 客户端与 IP 归属地
- 任务详情可编辑:运行中的任务可改保存目录、限速与请求头,无需删除重建
- 仅看失败 + 批量重试:失败任务可一键筛选并批量重试;批量操作(开始/暂停/删除)结束后弹出结果面板,列出失败项与原因,失败项自动保持选中
界面与系统集成
- 深色/浅色主题(可跟随系统)、21 种语言界面(简体中文 / 繁體中文 / English / 日本語 / 한국어 / Deutsch / Français / Español / Português / Italiano / Русский / العربية / हिन्दी / ไทย / Tiếng Việt / Bahasa Indonesia / Türkçe / Nederlands / Polski / Українська / Čeština);内置「诊断中心」一键检查 RPC、磁盘空间、密钥、UPnP、Tracker 与历史存储并导出脱敏报告
- 任务详情含 Peer、服务器、分片信息与连接数
- 通知中心保留完成/失败记录与未读角标,支持逐条删除
- 托盘常驻、任务栏进度、开机自启;下载完成后可按完成规则打开文件/目录、关机/休眠/关闭应用;托盘提示实时显示总速度与活动任务数,引擎异常退出后托盘菜单可直接「重启引擎」
- 首次启动向导:四步引导配置下载目录、扩展配对、yt-dlp 与远程访问,每步都可跳过,完成后不再打扰
- 下载趋势:完成页提供 7 天 / 30 天完成量与数据量趋势
- 从右到左界面:阿拉伯语等 RTL 语言下整体布局自动镜像
- 复制下载链接后切回应用可自动弹出新建窗口(可在设置中关闭剪贴板监控);全局快捷键(
Ctrl+N新建、Ctrl+F搜索、Ctrl+Shift+P暂停全部…) - 系统代理一键检测填入;应用内检查更新(Windows 差量、macOS / Linux 完整包);Linux AppImage 内嵌更新信息并附带
.zsync文件,可用 AppImageUpdate /appimageupdatetool增量升级
扩展与流媒体
- Edge 加载项商店可直接安装;Chrome 可旁加载(步骤见 extension/README.md);Release 附带 Firefox(AMO)上架变体压缩包
- 扩展弹窗任务页:显示下载/上传速度、活动与等待数量,任务列表可按「进行中 / 失败 / 已完成」筛选并暂停、继续、删除;App 里由「智能解析本页视频」发起的流媒体任务也会出现在列表中(带「流媒体」角标),操作与 App 内一致
- 网络嗅探:监听当前标签页的请求,按视频/音频/图片/其他筛选后批量发送;B 站等 DASH/MSE 页面会识别出分片,并提示改用「智能解析本页视频」下载完整视频
- 右键链接发送到 App、弹窗发送当前页、从页面批量抓取链接;可选接管浏览器下载
- 流媒体:集成 yt-dlp 支持 1000+ 站点,按需下载并校验 SHA-256;支持播放列表勾选条目下载、字幕(含自动生成字幕,转
srt)、Cookie 登录态与画质预设(最佳/1080p/720p/480p/MP3 提取),播放列表进度显示当前条目标题与序号;B 站等音视频分离的站点由 ffmpeg 合并 - 插件系统:插件运行在独立
utilityProcess中,权限声明与白名单 IPC,崩溃隔离并自动重启;入口执行有 3 秒超时保护 - 插件市场:可配置注册表地址、SHA-256 完整性校验与 Ed25519 发布者签名验证,支持安装、更新与问题举报;开发文档见 docs/plugin-development.md
- 内置 Auto Retry 示例插件:下载失败后自动重试最多 3 次(原生界面仅提供手动重试),用于演示事件钩子与
aria2:write权限
进阶
- UPnP 端口映射:自动向路由器申请 BT/DHT 端口映射,让其他 Peer 能主动连上你(做种更有优势)
- AI 助手接入(MCP):支持 MCP 的客户端(Claude Desktop、Cursor 等)可通过本机接口管理任务、队列、全局设置与诊断,提供 22 个工具、4 个资源与 2 个提示模板
- Web 控制台:在设置中开启后,可用浏览器或手机访问任务、队列、统计与审计日志;支持可安装的 PWA、细粒度 API 令牌(只读/写入/控制/审计/管理员)、
/openapi.jsonOpenAPI 3.0.3 文档、IP/CIDR 白名单与操作审计 - 配置备份:设置可整体导出为 JSON(可选含密钥,需二次确认),导入时先预览将要应用/跳过/拒绝的键并保留本机密钥,便于多机同步或留存可用配置
- 多实例管理:保存多个 RPC 连接配置,批量测试延迟与版本,一键切换当前实例
- SQLite 历史库:完成历史改用 SQLite 存储,突破原 10MB JSON 上限,并自动迁移旧数据
- 差量更新(Windows):只下载变化的分块,最终仍强制比对
.sha256 - 无头模式与自动化:
Aria2Desktop --headless不创建主窗口(无图形环境的 Linux 服务器也能直接跑),仅保留下载引擎、浏览器扩展接口与 MCP 服务,适合远程管理/常驻下载机;命令行与 Webhook 用法见 docs/automation-cli-webhook.md,注册为 systemd 服务 / Windows 计划任务见 docs/headless.md
系统要求
| 要求 | |
|---|---|
| Windows | Windows 10/11,x64 或 x86 |
| macOS | Intel 或 Apple Silicon(系统版本需被 Electron 43 支持) |
| Linux | x64 或 arm64,AppImage 或 deb |
| 磁盘 | 安装包约 100 MB,安装后约 300 MB(另需下载目录空间) |
快速开始
1. 安装
到 Releases 下载对应平台的包:Windows 用 Setup.exe(或免安装的 portable.zip),
macOS 用 dmg,Linux 用 AppImage 或 deb。
公开构建均未签名:Windows 可能提示「未知发布者」(SmartScreen),macOS 首次打开需右键 →「打开」(未公证),
Linux 的AppImage需先chmod +x再运行、deb用系统包管理器安装时可能提示未签名。
每个资产都附带同名.sha256,可自行校验。
2. 添加第一个下载
点「新建下载」粘贴链接,或把链接 / 种子文件直接拖进窗口。复制链接后切回应用也会自动弹出新建窗口。
3. 引擎与端口
内置引擎随应用启动,默认 RPC 端口 6800,只监听本机。端口被别的程序占用时,
到「设置 → RPC 与安全」换一个端口;同页的「测试连接」可确认引擎状态。
4. 浏览器扩展(可选但推荐)
Edge 用户:直接从 Edge 加载项商店 安装,
随浏览器自动更新。App 内「设置 → RPC 与安全 → 浏览器扩展」也有直达按钮。
Chrome 用户或需要手动安装时:见 extension/README.md(含旁加载与白名单步骤)。
扩展与 App 通过本机回环接口通信(
http://localhost:6801,需 RPC 密钥鉴权),只监听本机、不对外开放。
App 未运行时扩展回落到内置规则直连 Aria2 RPC(默认http://localhost:6800),功能不受影响。
5. 流媒体(可选)
新建下载 →「流媒体」标签,首次按提示下载 yt-dlp(约 20–40 MB,从官方 Release 下载并校验 SHA-256)。
涉及音视频合并时会提示下载 ffmpeg(macOS 也可 brew install ffmpeg)。
已自行安装并加入 PATH 的 yt-dlp / ffmpeg 会被直接使用。
常见问题
安装时提示「无法关闭 Aria2Desktop」
应用可能驻留在托盘。安装程序会先请求它正常退出(最多等 12 秒,以便保存会话)再结束进程;
若仍失败,从托盘菜单退出后重试。
安装时提示来源未知 / 无法验证开发者
Windows 会提示「未知发布者」,可点「更多信息 → 仍要运行」;macOS 首次打开被拦时右键 →「打开」;
Linux 的 AppImage 需要先 chmod +x Aria2Desktop-*.AppImage。需要校验时比对 Release 页的 .sha256。
扩展连不上 App
先确认 App 在运行、扩展里填的密钥与「设置 → RPC 与安全」一致。
如果电脑开着系统代理,127.0.0.1 可能被代理拦截 —— 把主机改成 localhost 再试。
提示端口 6800 被占用
多半是另一个 Aria2 Desktop 实例或别的下载工具占着。退出多余实例,或在设置里换端口。
自动更新失败 / 校验不通过
应用会比对 Release 的 .sha256,不匹配就拒绝安装并回落完整下载;网络异常时可手动下载安装包覆盖安装。
如何回退到旧版本
直接下载旧版本安装包覆盖安装即可(设置与下载历史保存在用户目录,不随安装包变化);预发布版不会出现在自动更新通道里,需要从 Releases 手动获取。升级到新版本后若要回退,建议先在「设置 → 重置与备份」导出一份配置备份。
卸载后有残留
设置文件不会随卸载删除(含配置与会话),需要彻底清理时手动删除对应目录:
Windows 为 %APPDATA%/aria2-desktop,macOS 为 ~/Library/Application Support/aria2-desktop,
Linux 为 ~/.config/aria2-desktop。
隐私
应用不收集遥测或个人数据,详见 隐私政策。
技术栈
| 桌面框架 | Electron 43 |
| 界面 | Vue 3 + Naive UI 2 + Pinia 3 |
| 语言 / 构建 | TypeScript 6、Vite 8 |
| 图表 | ECharts 6 |
| 国际化 | vue-i18n 11(21 种语言,含简体/繁体中文、English、日本語、한국어、Deutsch、Français、Español、Русский、العربية 等) |
| 下载引擎 | Aria2 1.37.0(Windows、Linux)/ 1.36.0(macOS) |
| 测试 | Vitest 5、CDP 驱动的真实应用端到端 |
开发
npm install
npm run dev # 开发环境(Vue + Electron)
npm run build # 构建生产版本
npm run test:run # 单元测试
npm run typecheck # 类型检查(主进程 + 测试代码 + 渲染层)
npm run test:e2e # 端到端(真启动应用跑一遍下载/解压/设置)
npm run test:e2e:extension # 扩展多浏览器 smoke(自动发现本机 Chrome for Testing / Chromium / Edge)
npm run bump:version -- 1.5.0 # 发版前:一次写全五处版本号(加 --dry-run 只预览)
npm run verify:versions # 发版前:五处版本号(package/lock/注册表 tag/扩展/更新日志)是否自洽
npm run verify:registry # 发版前:插件市场注册表签名口径(空清单免签,加 -- --online 比对已发布内容)
npm run verify:audit # 发版前:生产依赖(dependencies)不得带已知漏洞
npm run dist:win64 # 打包 Windows x64 安装包 + 便携版
npm run dist:mac # 打包 macOS(x64 + arm64)
npm run dist:linux:arm64 # 打包 Linux arm64 安装包
项目结构、开发约定(日志、类型检查、依赖归类、平台差异、发版流程)见 CONTRIBUTING.md。
更新日志
版本变更记录见 CHANGELOG.md;安装包与完整发布说明见 GitHub Releases。
贡献
欢迎 Issue 与 PR。提交前请跑 npm run typecheck && npm run test:run;
提交信息使用 Conventional Commits(feat: / fix: / docs: …)。
- 问题反馈:GitHub Issues
- 邮件:[email protected]
许可证
本项目采用 MIT License。
内置 Aria2 引擎的编译方式与 GPLv2 合规说明见 resources/aria2/README.md。
致谢
Aria2 · AriaNg · yt-dlp ·
Motrix · Electron · Vue.js ·
Naive UI · ECharts · Vite
Star 趋势
如果这个项目对你有帮助,请给个 Star ⭐
Yorumlar (0)
Yorum birakmak icin giris yap.
Yorum birakSonuc bulunamadi

