aria2
中文
安装 · macOS

在 macOS 上安装 aria2

aria2 项目不提供 Mac 版下载，但每个 Mac 包管理器都有当前的 1.37.0。Homebrew 最简单。

最后更新: 已用 aria2 1.37.0 测试

一条命令安装

打开“终端”，运行你所用包管理器对应的那一行。

brew install aria2

需要先从 brew.sh 安装 Homebrew。运行当前 macOS 的 Apple 芯片 Mac 有现成的预编译版本；在 Intel Mac 上 Homebrew 会自行编译 aria2，需要几分钟。

确认安装aria2c --versionaria2 version 1.37.0

该用哪种方式？

用你已经在用的包管理器。如果一个都没有，请安装 Homebrew。

方式版本更新适合
Homebrew1.37.0brew upgrade aria2大多数 Mac
MacPorts1.37.0sudo port upgrade aria2MacPorts 用户
conda-forge1.37.0conda update aria2Python 和数据处理

用 Homebrew 逐步安装

从一台没有 Homebrew 的 Mac 到可以正常使用的 aria2。

  1. 安装 Homebrew

    按照 brew.sh 上的一行安装命令操作。如果缺少 Apple 的命令行工具，它也会一并安装。

  2. 安装 aria2

    Homebrew 还会安装 aria2 需要的库：c-ares、libssh2、OpenSSL、SQLite 和 gettext。

    brew install aria2

  3. 测试

    Homebrew 会把 aria2c 放进你的 Path，所以可以立即使用。

    aria2c --versionaria2 version 1.37.0

macOS 上 aria2.conf 的位置

aria2 读取 ~/.aria2/aria2.conf。创建文件夹和文件：

mkdir -p ~/.aria2 && touch ~/.aria2/aria2.sessionopen -e ~/.aria2/aria2.conf

配置生成器 →

登录时启动 aria2

macOS 用 launchd 启动后台程序。把下面的内容保存为 ~/Library/LaunchAgents/org.aria2.plist，把路径改成你自己的（Apple 芯片上的 Homebrew 使用 /opt/homebrew/bin，Intel 上使用 /usr/local/bin），然后加载它：

~/Library/LaunchAgents/org.aria2.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>org.aria2</string>
  <key>ProgramArguments</key><array>
    <string>/opt/homebrew/bin/aria2c</string>
    <string>--conf-path=/Users/you/.aria2/aria2.conf</string>
  </array>
  <key>RunAtLoad</key><true/>
  <key>KeepAlive</key><true/>
</dict></plist>

用 launchctl load ~/Library/LaunchAgents/org.aria2.plist 加载。不要在参数中加 -D：launchd 要求程序保持在前台运行。

更新与卸载

Homebrew
brew upgrade aria2 · brew uninstall aria2
MacPorts
sudo port upgrade aria2 · sudo port uninstall aria2
conda
conda update aria2 · conda remove aria2

macOS 上的不同之处

“无法打开，因为无法验证开发者”

手动下载的程序会出现这个提示。来自 Homebrew、MacPorts 或 conda 的软件包不会触发它。

command not found: aria2c

Homebrew 的文件夹不在你的 Path 中。运行 Homebrew 安装程序在“Next steps”下打印的两行命令，然后打开一个新的“终端”窗口。

下载文件夹的访问权限

aria2 第一次写入“下载”或“桌面”文件夹时，macOS 可能会请求授予“终端”权限。请在 系统设置 → 隐私与安全性 → 文件和文件夹 中允许。

常见问题

aria2 有官方的 Mac 版下载吗？
1.37.0 没有：该版本只发布了源代码、Windows 和 Android 版本。Homebrew、MacPorts 和 conda-forge 都提供 1.37.0。
aria2 能在 Apple 芯片（M1 到 M4）上运行吗？
能。Homebrew 和 conda-forge 都有原生的 Apple 芯片版本。
有带窗口界面的 aria2 Mac 应用吗？
可以使用 AriaNg Native，它能在 macOS 上运行并通过 RPC 控制 aria2，或者使用浏览器 WebUI。Motrix 2 已不再使用 aria2 的 RPC。

装好了？从这里开始