# 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="https://3822791205-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrZQtAKIIsvAQP0E9RumD%2Fuploads%2FYXCyoumeehx1Ga1zISr9%2Fimage.png?alt=media&#x26;token=4f5af3f6-86b6-45d7-9f7c-d36e718b240f" 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="https://3822791205-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrZQtAKIIsvAQP0E9RumD%2Fuploads%2F8OE2OAOCWX2mogDJjbKy%2Fimage.png?alt=media&#x26;token=a31502a1-3cd3-4a84-b407-a013650d6bf2" alt=""><figcaption></figcaption></figure>

4. 验证安装

```bash
multipass --version
```

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

<figure><img src="https://3822791205-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrZQtAKIIsvAQP0E9RumD%2Fuploads%2F0kHaPLkV10F0EFYaCeTW%2Fimage.png?alt=media&#x26;token=bef60ce6-6d35-46e7-aa08-26f6b326caf1" alt=""><figcaption></figcaption></figure>

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

### 1.下载安装包

1. 打开浏览器
2. 访问下载地址: <https://pcdn.titannet.io/filpcdn/bin/filagent/filagent-darwin.zip>
3. 等待下载完成

### 2.解压程序

2. 打开"访达"(Finder)

<figure><img src="https://3822791205-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrZQtAKIIsvAQP0E9RumD%2Fuploads%2FD0QBzU4hZo7HoM4Nx8dy%2Fimage.png?alt=media&#x26;token=c9524df8-8fc6-4eb2-b512-f79cfe98c085" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3822791205-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrZQtAKIIsvAQP0E9RumD%2Fuploads%2FPPXHoEeA9yYfwFLBgdds%2Fimage.png?alt=media&#x26;token=e96e9073-6c01-4053-afe5-21b5596aafb4" alt=""><figcaption></figcaption></figure>

4. 双击解压

<figure><img src="https://3822791205-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrZQtAKIIsvAQP0E9RumD%2Fuploads%2FePnRqq6vXCwr6j4gCp6K%2Fimage.png?alt=media&#x26;token=6832fd34-e573-45e6-a550-51d1ac319f0c" alt=""><figcaption></figcaption></figure>

### 3.获取Key

1. 打开浏览器访问：<https://filecoin.titannet.io/>
2. 登录您的Titan账户
3. 找到并复制您的密钥（Key）

<figure><img src="https://3822791205-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrZQtAKIIsvAQP0E9RumD%2Fuploads%2FOUd7mpGJG2sBXns1UIEC%2Fimage.png?alt=media&#x26;token=470f4ff5-38d3-4422-a2b5-2a3802a6f80c" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3822791205-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrZQtAKIIsvAQP0E9RumD%2Fuploads%2FPeRccf0C0ujPkYTGBxft%2Fimage.png?alt=media&#x26;token=b95a117d-2fee-47e9-b60e-88a125f5b61f" alt=""><figcaption></figcaption></figure>

### 4.运行程序

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

2. 输入运行命令:

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

{% code overflow="wrap" %}

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

{% endcode %}

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