Aria2 Extensions 安装与配置指南

1. 项目基础介绍

Aria2 Extensions 是一个开源项目，它允许用户将下载任务重定向到 Aria2 服务器。通过浏览器扩展，用户可以直接从网页上发送下载链接到 Aria2，实现方便快捷的下载管理。该项目支持多种浏览器，包括 Chrome、Firefox、Edge 以及 Safari。主要使用的编程语言是 JavaScript。

2. 项目使用的关键技术和框架

• JavaScript: 主要编程语言，用于开发浏览器扩展。
• HTML/CSS: 用于构建扩展的用户界面。
• Chrome/Firefox/Edge/Safari APIs: 利用浏览器提供的API来实现扩展功能。

3. 项目安装和配置的准备工作及详细步骤

准备工作

• 确保你的操作系统支持 Node.js 和 npm。
• 安装最新版本的 Node.js。
• 准备好你的浏览器（Chrome、Firefox、Edge 或 Safari）。

安装步骤

步骤 1: 克隆项目

打开终端（或命令提示符），使用以下命令克隆项目到本地：

git clone https://github.com/baptistecdr/aria2-extensions.git
cd aria2-extensions

步骤 2: 安装依赖

在项目根目录下运行以下命令安装项目依赖：

npm install

步骤 3: 配置 Aria2 服务器

确保你的 Aria2 服务器已经安装并运行，然后获取 RPC 密钥（如果设置了的话）和服务器地址。

步骤 4: 配置浏览器扩展

打开扩展的配置文件，通常是 manifest.json，填写你的 Aria2 服务器信息：

{
  "background": {
    "scripts": ["background.js"],
    "persistent": false
  },
  "browser_action": {
    "default_popup": "popup.html",
    "default_icon": "icons/icon48.png"
  },
  // 其他配置...
  "permissions": [
    "downloadURLs",
    "storage",
    "<all_urls>"
  ],
  "content_scripts": [
    {
      // 其他配置...
    }
  ],
  "options_page": "options.html",
  // 其他配置...
}

确保在 options.html 或相关配置文件中设置正确的 Aria2 服务器地址和密钥。

步骤 5: 加载扩展到浏览器

• 对于 Chrome 或 Edge：打开浏览器的扩展页面（chrome://extensions/ 或 edge://extensions/），开启开发者模式，然后拖动 manifest.json 文件到扩展页面。
• 对于 Firefox：打开 about:addons，选择开发者选项，然后点击“加载临时扩展”，选择 manifest.json 文件。

步骤 6: 测试扩展

在浏览器中打开一个带有下载链接的页面，右键点击链接，选择相应的“Download with Aria2”选项，检查下载任务是否已正确发送到 Aria2 服务器。

完成以上步骤后，你应该能够成功安装并使用 Aria2 Extensions 扩展了。如果遇到任何问题，请检查你的 Aria2 服务器配置和浏览器扩展设置是否正确。