远程应用 远程访问 Aria2 教程
面向需要在外网控制家中下载任务的用户，本文聚焦 iStoreOS 环境下部署 Aria2，并通过 DDNSTO 远程访问的完整流程。文中涉及 UI 操作的步骤均标注了图片占位，便于后续补图。
1. 准备工作
| 项目 | iStoreOS 场景 |
|---|---|
| 运行环境 | 已刷 iStoreOS 的网关/软路由（ARM/X86 均可） |
| 插件 | Aria2、AriaNg、DDNSTO（均可在软件中心获取） |
| 账号 | DDNSTO 账号 1 个 |
| 端口 | Aria2 RPC 默认 6800，Web 前端（AriaNg）默认 6880/6801，可自定义 |
2. iStoreOS：安装与配置 Aria2
-
安装插件
打开「软件中心 → 下载与多媒体」分类，安装Aria2与AriaNg（如已内置 Web 前端可跳过）。
-
配置 Aria2 服务
- 进入「Aria2 设置 → 基础参数」，确认下载目录、RPC 密钥（
rpc-secret）与监听端口。 - 建议开启
自动启动与AriaNg内部 Web 服务，方便后续通过浏览器控制。
- 进入「Aria2 设置 → 基础参数」，确认下载目录、RPC 密钥（
-
验证本地访问
- 在局域网电脑访问
http://内网IP:6880（或你自定义的端口），确认能加载 AriaNg。 - 在「AriaNg → 设置 → RPC」中输入
http://内网IP:6800/jsonrpc与对应Secret Token，确保状态为 已连接。
- 在局域网电脑访问
3. iStoreOS：通过 DDNSTO 远程应用穿透 Aria2
-
绑定账号
安装DDNSTO插件后，首次打开会提示扫码/登录账号并绑定当前设备。完成绑定后，在 DDNSTO 控制台即可看到该 iStoreOS 主机。 -
添加远程应用
- 打开 DDNSTO 控制台，切换到「远程应用」页签，点击右侧「添加应用」。
- 远程应用相当于云端转发模板，可免去手动配置 HTTP/TCP 通道。
-
选择远程 Aria2 模板
- 在弹窗中输入应用名称，选择
远程Aria2。 - 将本地 Aria2 RPC 地址填写为
http://127.0.0.1:6800/jsonrpc（若 Aria2 部署在同一台主机）或实际内网 IP。 - 密码项填入
rpc-secret，与第 2 节设置一致。
- 在弹窗中输入应用名称，选择
-
保存与验证
- 点击「添加」后，DDNSTO 会生成远程访问入口，控制台列表中可看到状态。
- 在浏览器直接点击该入口，DDNSTO 会启动一个在线版 AriaNg（或自动连回你本地的 AriaNg），并通过云端隧道连接 RPC。
- 若页面显示「Aria2 状态：已连接」，说明远程访问已生效。
-
安全加固建议
- 每个远程应用都会绑定 Token，若需临时分享，可以使用 DDNSTO 控制台的「临时访客」功能。
- 建议定期轮换
rpc-secret，并关闭不使用的远程应用条目。
4. 常见问题排查
| 问题表现 | 可能原因 | 处理建议 |
|---|---|---|
| 外网打开链接报错或超时 | 路由器/软路由上 DDNSTO 插件未运行；本地端口错误 | 检查插件状态并重启，确认端口与服务类型匹配 |
| AriaNg 显示 RPC 连接失败 | Token 不匹配；远程应用 URL/RPC 端口填写错误 | 在 AriaNg 或 DDNSTO 远程应用设置中重新输入 Token，并确认 URL 指向 http://内网IP:6800/jsonrpc |
| 任务可见但速度为 0 | 家中宽带限速或下载源失效 | 切换镜像源、开启 BT/磁力 DHT；检查内网带宽与硬盘状态 |
| 主机负载高 | 同时任务过多或磁盘 IO 瓶颈 | 减少同时下载数，使用外供电硬盘，必要时迁移到性能更好的主机 |
5. 最佳实践
- 统一账号管理：同一 DDNSTO 账号可绑定多台 iStoreOS 设备，建议通过备注区分对应主机。
- HTTPS + Token 双重防护：AriaNg 虽为前端，但 RPC 才是核心接口。务必启用
rpc-secret，必要时自签 HTTPS 并结合 DDNSTO 的访问控制。 - 自动化恢复：使用
crontab或系统的「服务守护」功能定期检测 Aria2/DDNSTO 进程，异常时自动重启。 - 日志留存：Aria2 支持将下载日志写入文件，结合 DDNSTO 日志即可快速排查远程任务问题。
通过以上步骤，便可在无需公网 IP 的前提下，实现对家中 Aria2 下载服务的随时远程管理。如需更多自动化脚本或图文教程，可在仓库中新增章节补充。