# 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. 访问下载地址:&#x20;

{% embed url="<https://pcdn.titannet.io/test4/bin/agent-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. 打开浏览器访问：

{% embed url="<https://test4.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
./agent --working-dir=您的titan-agent文件夹路径 --server-url=https://test4-api.titannet.io --key=您的密钥
```

{% endcode %}

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET 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?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
