# aria

**Repository Path**: jingangshi683/aria

## Basic Information

- **Project Name**: aria
- **Description**: aria 使用入门
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-02-04
- **Last Updated**: 2026-02-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

Aria2 是一款非常强大的开源、轻量级、多协议下载工具。它支持 HTTP/HTTPS、FTP、SFTP、BitTorrent 和 Metalink。因为它运行占用极低，且支持多线程多源下载，常被誉为“下载神器”。

由于它没有原生图形界面（GUI），许多新手会被它的命令行操作劝退。这篇教程将带你快速上手，掌握它的核心用法。

---

## 1. 安装 Aria2

在大多数系统上，安装只需要一行命令：

* **Windows**: 建议使用 [Scoop](https://scoop.sh/) (`scoop install aria2`) 或者直接去 [GitHub Releases](https://github.com/aria2/aria2/releases) 下载二进制文件并将 `aria2c.exe` 所在路径添加到系统环境变量。
* **macOS**: 使用 Homebrew: `brew install aria2`
* **Linux (Ubuntu/Debian)**: `sudo apt install aria2`

安装完成后，在终端输入 `aria2c -v`，看到版本号说明安装成功。

---

## 2. 基础下载命令

Aria2 的基本命令格式是 `aria2c [参数] [URL]`。

### 普通下载

直接下载一个文件到当前目录：

```bash
aria2c https://example.com/file.zip

```

### 多线程下载（最常用）

这是 Aria2 速度快的秘密。`-s` 是连接服务器数，`-x` 是单服务器最大连接数（通常设为 16）：

```bash
aria2c -s 16 -x 16 https://example.com/file.zip

```

### 指定保存文件名和路径

* `-d`: 指定目录
* `-o`: 指定文件名

```bash
aria2c -d ~/Downloads -o my_movie.mp4 https://example.com/file.mp4

```

### 断点续传

如果下载中断，再次执行同样的命令，Aria2 默认会尝试续传。你也可以显式添加 `-c` 参数：

```bash
aria2c -c https://example.com/file.zip

```

---

## 3. BT / 磁力链接下载

Aria2 处理 BT 任务非常简单，直接把 `.torrent` 文件或磁力链接丢给它即可。

* **下载种子文件**:
```bash
aria2c /path/to/seed.torrent

```


* **下载磁力链接**:
```bash
aria2c 'magnet:?xt=urn:btih:xxxxxx'

```


*注意：磁力链接建议加引号，防止终端对特殊字符报错。*

---

## 4. 进阶用法：使用配置文件 (推荐)

每次都输入一长串参数很麻烦。你可以创建一个配置文件 `aria2.conf`，让 Aria2 以后台守护进程（RPC 模式）运行。

### 常用配置示例：

创建一个名为 `aria2.conf` 的文件，填入以下内容：

```ini
# 文件保存路径
dir=/Downloads
# 断点续传
continue=true
# 最大同时下载任务数
max-concurrent-downloads=5
# 这里的参数对应 -s 和 -x
split=16
max-connection-per-server=16
# 启用 RPC 模式（为了配合 Web 界面）
enable-rpc=true
rpc-allow-origin-all=true
rpc-listen-all=true

```

### 启动 RPC 服务：

```bash
aria2c --conf-path=/路径/to/aria2.conf -D

```

`-D` 参数表示以后台模式运行。

---

## 5. 最佳拍档：Web UI 界面

虽然 Aria2 是命令行工具，但你可以通过网页端来控制它。这才是它的“完全体”形态。

1. **AriaNg**: 这是目前最流行的 Web 界面。
* 访问地址：[http://ariang.mayswind.net/](http://ariang.mayswind.net/)


2. **如何连接**:
* 在 AriaNg 的设置里，填写你运行 Aria2 的服务器 IP（本机就是 `127.0.0.1`）。
* 端口默认为 `6800`。
* 连接成功后，你就可以像使用 IDM 或迅雷一样，在网页上点击按钮添加下载任务了。



---

## 常见 FAQ

* **下载没速度？** 下载 BT 或磁力链接时，如果没速度，通常是因为缺乏 Tracker 服务器。你可以在配置文件中添加 `bt-tracker` 列表。
* **权限问题？**
确保 `dir` 设置的路径对于当前用户有写入权限。