在 macOS 上安装和配置 Aria2 的详细步骤

时间：2025-04-06 09:24:34

在 macOS 上安装和配置 Aria2 的详细步骤：

1.安装 Aria2

方式一：使用 Homebrew
Homebrew 是 macOS 上的包管理器，可以方便地安装和管理软件包。

• 打开终端。

• 输入以下命令安装 Aria2：

   brew install aria2

• 检查安装是否成功：

   aria2c -v

方式二：下载预编译的二进制文件
如果你不想使用 Homebrew，可以下载预编译的 Aria2 二进制文件。

• 访问Aria2 GitHub Releases 页面。

• 下载适合 macOS 的预编译二进制文件（如aria2-1.37.0-osx-darwin.dmg）。

• 下载完成后，挂载 DMG 文件并安装 Aria2。

2.配置 Aria2

创建配置文件
Aria2 的配置文件通常命名为aria2.conf。你可以根据需要创建和编辑这个文件。

• 在终端中创建配置文件：

   touch aria2.conf
   open -a TextEdit aria2.conf

或者使用命令行编辑器（如nano或vim）：

   nano aria2.conf

• 在配置文件中添加以下内容（根据需要修改路径和参数）：

   # 基本配置
   dir=/Users/yourusername/Downloads
   input-file=/Users/yourusername/.aria2/aria2.session
   save-session=/Users/yourusername/.aria2/aria2.session
   log=/Users/yourusername/.aria2/aria2.log

   # 网络配置
   max-concurrent-downloads=5
   max-connection-per-server=10
   min-split-size=10M
   split=10

   # 其他配置
   continue=true
   file-allocation=none
   disk-cache=32M
   enable-rpc=true
   rpc-listen-all=true
   rpc-allow-origin-all=true

启动 Aria2
在终端中启动 Aria2，并指定配置文件路径：

aria2c --conf-path=/path/to/aria2.conf

3.使用 Aria2

通过命令行下载文件

aria2c http://example.com/file.zip

使用 RPC 功能
Aria2 支持 RPC 功能，可以通过 Web UI 或其他客户端工具进行管理。

• 确保在配置文件中启用了 RPC 功能：

   enable-rpc=true
   rpc-listen-all=true
   rpc-allow-origin-all=true

• 使用 Web UI（如AriaNg）：

• 下载并解压 AriaNg。

• 打开index.html文件。

• 在 AriaNg 中配置 Aria2 的 RPC 地址（默认为`

4.配置开机自启

使用 LaunchAgent
创建一个 LaunchAgent 配置文件，使 Aria2 在开机时自动启动。

• 创建配置文件：

   touch ~/Library/LaunchAgents/com.aria2.aria2c.plist
   open -a TextEdit ~/Library/LaunchAgents/com.aria2.aria2c.plist

• 在配置文件中添加以下内容：

   <?xml version="1.0" encoding="UTF-8"?>
   <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
   <plist version="1.0">
   <dict>
       <key>Label</key>
       <string>com.aria2.aria2c</string>
       <key>ProgramArguments</key>
       <array>
           <string>/usr/local/bin/aria2c</string>
           <string>--conf-path=/path/to/aria2.conf</string>
       </array>
       <key>RunAtLoad</key>
       <true/>
   </dict>
   </plist>

• 加载配置文件：

   launchctl load ~/Library/LaunchAgents/com.aria2.aria2c.plist

5.常见问题

如何检查 Aria2 是否正在运行？

ps aux | grep aria2c

如何停止 Aria2？

killall aria2c

如何更新 Aria2？
如果你使用的是 Homebrew，可以通过以下命令更新：

brew upgrade aria2

使用命令行下载文件
通过命令行使用 Aria2 下载文件非常简单，只需要在命令行中输入 aria2c 命令、命令参数和下载地址即可。

# 下载文件
aria2c http://example.com/file.zip

# 下载文件并设置保存路径
aria2c -d /path/to/save http://example.com/file.zip

# 下载文件并设置下载速度限制
aria2c --max-download-limit=100K http://example.com/file.zip

# 下载文件并设置断点续传
aria2c --continue=true http://example.com/file.zip

# 下载文件并设置多线程下载数量
aria2c --split=5 http://example.com/file.zip

总结
通过以上步骤，你可以在 macOS 上安装和配置 Aria2，实现高效的文件下载和管理。Aria2 的强大功能和灵活配置使其成为理想的下载工具。希望这些信息能帮助你更好地使用 Aria2。

相关文章