AriaNg完整指南：5分钟把aria2变成好用的网页下载面板
【免费下载链接】AriaNgAriaNg, a modern web frontend making aria2 easier to use.项目地址: https://gitcode.com/gh_mirrors/ar/AriaNg
AriaNg 是一个免费的现代化网页前端，负责把命令行下载工具 aria2 变成浏览器里就能操作的下载管理面板，适合想长期用 aria2 但不想天天敲命令的新手和普通用户。它本身是纯 HTML + JavaScript 写的，不需要额外运行时，部署到任意静态 Web 服务器即可使用。
为什么你需要一个网页来管 aria2
aria2 支持 HTTP、HTTPS、FTP、SFTP、BitTorrent、Metalink 共 6 类下载协议，多连接、断点续传、BT 做种样样能做，但它的原身是个命令行程序：想看进度要盯终端，想加任务要记aria2c参数。
AriaNg 解决的就是这个断层。你在浏览器里粘贴链接、拖种子文件、勾选想下载的文件，背后的下载工作仍然由 aria2 完成，两者之间走 JSON-RPC 通信。它只获取增量数据刷新界面，远程管理一台跑在服务器上的 aria2 时也不会浪费带宽。
三步跑通：安装、启动、下第一个文件
安装前端并构建
从仓库拿到源码后构建即可，构建配置见 gulpfile.js：
git clone https://gitcode.com/gh_mirrors/ar/AriaNg cd AriaNg npm install再执行gulp clean build生成标准版，产物在dist目录，拷到 Nginx 或 Apache 下就完事。如果只想在本地单机用，执行gulp clean build-bundle生成一体版，下载一个 HTML 文件双击打开就能跑。
启动 aria2 并开启 RPC
AriaNg 自己不下东西，它需要一台开着 RPC 接口的 aria2。用下面这行启动并记下密钥：
aria2c --enable-rpc=true --rpc-secret=your_token打开 AriaNg 后，按提示填入 RPC 地址http://127.0.0.1:6800和密钥，页面就能列出任务了。连接支持 http、https、ws、wss 四种协议，走 HTTPS 部署时会自动禁用明文协议。
加第一个下载任务
进入 New 页面，粘贴下载链接（支持多行，每行一个），选择保存目录后点 Download Now，回到列表页就能看到进度条和实时速度。到这里你已经跑通了完整链路。
按场景看它有哪些核心能力
管理上百个任务。任务列表支持按文件名、大小、进度、剩余时间、下载/上传速度、做种状态等维度排序，顶部有搜索框直接过滤；队列顺序还能直接拖拽调整，比在终端里改 priority 直观得多。
盯下载状态。状态页用 ECharts 画出全局或单个任务的上下行速度曲线，配合下载完成浏览器通知（可设"每 5 分钟最多 1 条"到"不限量"共 4 档），长任务下完不用一直守着页面。
只下种子里想要的那部分。打开 BT 任务详情，文件列表能按视频、音频、图片、文档、应用、压缩包 6 类一键筛选（分类规则定义在 src/scripts/config/fileTypes.js），多目录任务还有树形视图，不用在一堆文件里肉眼翻找。
3 个进阶玩法
用 URL 直接加任务
AriaNg 内置了 URL 命令行 API（实现见 src/scripts/controllers/command.js）：把下载链接做 base64 编码后拼在/new/后面，浏览器一访问就自动创建任务，还能带pause=true参数先入队。脚本化加任务、做下载页按钮都很方便，设置页里可以直接导出带当前密钥的 API 地址。
切换多台 aria2
一台 NAS、一台 VPS 各跑着 aria2？在 AriaNg 设置里为每个 RPC 加个别名，任务列表顶部就能来回切，配置历史自动保存，来回切不丢参数。
自定义标签页标题
设置里支持用占位符定制浏览器标签标题，比如显示当前下载数和实时速度，多个浏览器标签开 AriaNg 时一眼区分谁在下东西。
值得了解的高级配置
- 导出/导入设置：全部配置可导出为 JSON 文件，换机、重装或想给朋友发一份自己的配置时直接导入，不用一项项重填。
- 明暗主题：内置 Light 和 Dark 两套主题（样式在
src/styles/theme/），还支持跟随系统设置自动切换。 - 语言：内置简体中文、繁体中文、英语、日语、德语、法语、西班牙语等 11 种语言，翻译文件独立放在 src/langs/ 目录，界面语言可随时切换。
- 增量刷新间隔：全局统计和任务信息各有独立的刷新周期设置，弱网环境调大间隔可以进一步省流量。
常见问题与解法
页面提示 Unauthorized / 连接失败。九成是 RPC 密钥没填对，或者 aria2 启动时用了默认--rpc-listen-all=false只听本地回环。远程访问需要给 aria2 加--rpc-listen-all=true，并把防火墙端口放通。
一体版和标准版怎么选。标准版靠 Web 服务器按需加载资源，不能直接双击index.html打开；个人电脑本地使用选一体版（build-bundle 产物）即可。
任务显示 "Error Occurred"。点进任务详情看错误描述，错误码到人类可读原因的映射逻辑在 src/scripts/config/aria2Errors.js 里，对照着查原因（磁盘满、无法续传、校验失败等），多数情况下点 Retry 就能恢复。
手机访问很慢。优先用 ws/wss 协议连接而不是 http 轮询，并在设置里调大任务信息刷新间隔。
写在最后
AriaNg 做的事很聚焦：让你彻底离开终端，用网页完成 aria2 的加任务、看进度、管设置这一整套流程，而且部署成本几乎为零。建议先把"安装 → 连 RPC → 下第一个文件"跑通，再按需启用多 RPC 切换和通知功能，基本就能覆盖日常绝大多数下载场景。
【免费下载链接】AriaNgAriaNg, a modern web frontend making aria2 easier to use.项目地址: https://gitcode.com/gh_mirrors/ar/AriaNg
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
