跳转到主要内容

把浏览器的每个下载都交给 aria2

让 Chrome、Edge、Firefox、Brave 变成瘦客户端：浏览器扩展拦截下载，并通过 JSON-RPC 交给本地（或远程）aria2 守护进程。更快、真正的断点续传，以及关闭笔记本也能继续的下载。完整的设置、安全与故障排查指南。

最后核对 2026-09 · aria2 v1.37.0

开始之前

浏览器为什么处理大文件很慢

单套接字、单上限

浏览器下载只用一条连接。若 CDN 限制该流，你就卡在它的上限。aria2 最多开启 16 条连接。

续传能力弱

Wi-Fi 抖动或浏览器崩溃常导致从头开始。aria2 依靠 continue 与控制文件按字节精确续传。

绑定标签页生命周期

关闭浏览器下载即终止。aria2 作为守护进程运行，让下载在你的电脑或家庭服务器上 24 小时持续。

拦截原理

扩展监听浏览器的下载接口。当下载开始时，它读取真实 URL 以及当前标签页的 Cookie、Referer、User-Agent，并向你的守护进程发送一个 aria2.addUri JSON-RPC 调用（或 magnet/种子任务）。真正的传输由 aria2 完成。数据不经过第三方，请求直接发往你自己的机器。

正是这种请求头转发，使得在浏览器已登录时，受保护站点（对裸下载器返回 403）也能正常工作。

第 1 步：以 RPC 服务器运行 aria2

用密钥令牌启动 aria2 并启用 RPC。加上 --rpc-allow-origin-all=true 让浏览器客户端能够调用，并将其绑定在本机网络。

启动守护进程 
aria2c --enable-rpc --rpc-allow-origin-all=true \
  --rpc-listen-all=true --rpc-secret=CHANGE_ME_STRONG_SECRET \
  --continue=true --daemon=true

要长期使用，请写入 ~/.aria2/aria2.conf（Linux/macOS）或 %USERPROFILE%\.aria2\aria2.conf（Windows），并在登录时启动（systemd 服务、任务计划程序，或使用Docker 指南）。

安全： 切勿在没有 TLS 与认证的情况下将 6800 端口暴露到公网。见远程与 NAS。

第 2 步：选择扩展

常用的 aria2 集成扩展
扩展浏览器说明链接
Aria2 ExplorerChrome, Edge, Firefox, Brave内置 AriaNg 弹窗、Cookie 捕获、大小阈值。使用广泛。Chrome 应用商店
CamtdChrome, Edge轻量后台监视、右键捕获、多 RPC 配置。GitHub
用户脚本（如云盘导出器）任意 + Tampermonkey站点专用：把云盘页面转为直接 aria2 RPC 任务。Tampermonkey

各扩展的设置界面不同，但都会询问同样的四项：RPC URL、密钥、捕获开关与最小文件大小。

第 3 步：配置

  1. RPC URL： 本地为 http://localhost:6800/jsonrpc（部分扩展偏好 ws://localhost:6800/jsonrpc）。
  2. 密钥令牌： 与 --rpc-secret 相同。
  3. 自动捕获下载： 启用。
  4. 最小文件大小： 设为 20–50 MB，让小图片/PDF 留在浏览器。
  5. Cookie / 请求头： 启用 Cookie 与 Referer 转发（解决 403 与登录限定链接）。
  6. 下载目录： 可选，按需覆盖 aria2 的 dir。
  7. 用扩展的测试/连接按钮（或下方检查器）确认连接。

测试 RPC 连接

在怪罪扩展之前，先确认这个浏览器能连到你的 aria2：

此页面直接从浏览器调用你的守护进程，因此需要 rpc-allow-origin-all=true（或扩展的调用方式）。若在 HTTPS 页面失败，就是混合内容规则 – 见下。

远程与 NAS

# Nginx：认证 + TLS + 转发 RPC（与 WebSocket）
location /jsonrpc {
    proxy_pass http://127.0.0.1:6800/jsonrpc;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
    proxy_read_timeout 86400;
}

然后在扩展中使用 https://aria2.example.com/jsonrpc。始终保留强 rpc-secret。

故障排查

在 aria2 中开始的下载返回 HTTP 403 / 401

站点需要浏览器会话。请启用扩展的 Cookie/Referer 转发，或给 aria2 传入 Cookie（--load-cookies）并配上匹配的 --user-agent/--referer。

HTTPS 页面出现“混合内容”/ 请求被阻止

HTTPS 页面无法调用明文 http:// RPC。请使用 TLS 反向代理（https:///wss://）、VPN，或通过局域网访问的本地页面。

aria2 在运行，但扩展显示未连接

检查主机、端口与密钥；确认 aria2c --enable-rpc 正在运行；确认 rpc-allow-origin-all=true；用上方检查器测试。密钥错误会返回 RPC 错误而非连接错误。

连小图片和 PDF 都被拦截

把扩展的最小文件大小提高到 20–50 MB，或把该站点加入排除列表。

下载出现两次

浏览器启动了自身下载，扩展同时也捕获了它。确保“自动捕获”会替换下载（多数扩展会取消浏览器副本），并且不要同时运行两个捕获型扩展。

从未被拦截

部分站点使用私有下载器、blob: URL 或流媒体协议，扩展看不到。媒体请改用 yt-dlp + aria2。

常见问题

能把工作电脑的下载发送到家里 NAS 吗？

可以。通过安全隧道/反向代理公开 RPC，把该 URL 填入扩展，之后所有下载都会在 NAS 上以全速运行，而你的笔记本保持空闲。

启用 rpc-allow-origin-all 安全吗？

只有在端口不对外可达时才安全。它允许你访问的任意网页调用 RPC，因此强密钥与私有网络（或带认证的代理）必不可少。

Firefox 上能用吗？

可以 – Aria2 Explorer 提供 Firefox 版，也有其他集成。RPC 设置完全相同。