> For the complete documentation index, see [llms.txt](https://titannet.gitbook.io/titan-network-cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://titannet.gitbook.io/titan-network-cn/4-ce-jia-li-le-ce-shi-wang/titan-agent-an-zhuang-jiao-cheng/macos-xi-tong/macos-an-zhuang-jiao-cheng.md).

# macOS 安装教程

{% hint style="success" %}
高收益攻略：

1. 新上机的节点有3-7天部署期，请耐心等待，之后收益将逐渐稳定。
2. 请保持设备24小时在线，尤其是晚高峰（18:00-24:00）时段。
3. 请确保节点的Agent状态和服务状态均为正常，若出现异常请及时联系客服。
   {% endhint %}

## 第一步：安装 Multipass

### 方法一: 直接下载安装 <mark style="color:red;">(推荐👍)</mark>

1. 访问 **\[**[**Multipass 下载页面**](https://canonical.com/multipass/install)**]**
2. 点击下载 macOS 安装包
3. 打开下载的 .dmg 文件
4. 按提示点击 Next 安装即可

<br>

### 方法二：通过 Homebrew 安装 Multipass

如果你更喜欢使用 Homebrew（macOS 上的包管理工具）来安装 Multipass，可以按照以下步骤进行：<br>

1. 检查是否安装了 Homebrew

```bash
brew --version
```

* 看到版本号就可以跳到 第3.安装 Multipass 步骤

<figure><img src="/files/FwgPKbzCpHkgfC683iiz" alt=""><figcaption></figcaption></figure>

* 没有安装则继续下一步

<br>

2. 安装 Homebrew

{% code overflow="wrap" %}

```bash
bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

```

{% endcode %}

3. 安装 Multipass

```bash
brew install --cask multipass
```

<figure><img src="/files/QW3XAtbALDlxw10hWwiC" alt=""><figcaption></figcaption></figure>

4. 验证安装

```bash
multipass --version
```

* 看到版本号就代表安装成功啦!<br>

<figure><img src="/files/r6tXXs2IUVdOdHAD68ns" alt=""><figcaption></figcaption></figure>

## 第二步：安装和运行 Titan Agent

### 1.下载安装包

1. 打开浏览器
2. 访问下载地址:&#x20;

{% embed url="<https://pcdn.titannet.io/test4/bin/agent-darwin.zip>" %}

3. 等待下载完成

### 2.解压程序

2. 打开"访达"(Finder)

<figure><img src="/files/adACNwTOeiJPsh6V7OAb" alt=""><figcaption></figcaption></figure>

2. 前往"下载"文件夹
3. 找到 `agent-darwin.zip`

<figure><img src="/files/0phPehil4jpfAFNToZRn" alt=""><figcaption></figcaption></figure>

4. 双击解压

<figure><img src="/files/Rfe064k6U3qWOHmqBid3" alt=""><figcaption></figcaption></figure>

### 3.获取Key

1. 打开浏览器访问：

{% embed url="<https://test4.titannet.io>" %}

2. 登录您的Titan账户
3. 找到并复制您的密钥（Key）

<figure><img src="/files/Fmz2rUv957wNi6EG4Z16" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/IKrfMNb2C7CjXCkMJJ31" alt=""><figcaption></figcaption></figure>

### 4.运行程序

1. 打开终端(Terminal)
   1. 按 Command + 空格键
   2. 输入 "terminal" 并回车

2. 输入运行命令:

* 复制以下命令（注意替换相关信息）：

{% code overflow="wrap" %}

```bash
./agent --working-dir=您的titan-agent文件夹路径 --server-url=https://test4-api.titannet.io --key=您的密钥
```

{% endcode %}

* 将"您的titan-agent文件夹路径"替换为实际的文件夹位置
* 将"您的密钥"替换为之前复制的密钥