# macOS

> 在 macOS 上安装并信任 Proxyman CA 证书，验证 HTTPS 抓包；自动安装失败时，可使用手动 Keychain 设置。

要检查 Mac 上的 HTTPS 流量，请安装并信任 Proxyman CA 证书，然后为要检查的域名启用 [SSL Proxying](https://proxyman.com/docs/zh-cn/basic-features/ssl-proxying)。你可以先使用下面的自动安装方式；如果需要自行在 Keychain Access 中管理信任设置，请使用手动模式。

## 安装并信任 Mac 上的 Proxyman 证书 {#install--trust-proxyman-certificates-on-your-mac}

要拦截加密的 HTTPS 消息（请求或响应），你必须在当前机器上安装 **Proxyman CA 证书**。iOS 设备、Android 设备、iOS 模拟器、Java 虚拟机和 Firefox 也需要此步骤。

> **备注:** Proxyman 证书是在你的机器上生成的自签名证书。Proxyman 从不会将任何个人数据存储或发送到 Proxyman 的服务器或第三方。
>
> 请参阅[隐私声明](https://proxyman.com/privacy)，了解 Proxyman 收集哪些数据以及不收集哪些数据。
>
> 如果你想自行在机器上生成证书并将其添加到 Proxyman 中，请参阅[自定义证书文档](https://proxyman.com/docs/zh-cn/advanced-features/custom-certificates#6-how-to-generate-self-signed-certificates-for-custom-root-certificate-that-comply-with-new-apples-security-requirements)。

> **备注:** Proxyman 的证书存储在本地的 **\~/Library/Application\ Support/com.proxyman.NSProxy/app-data/** 目录中。

## 1. 自动模式（推荐） {#1-automatic-mode-recommended}

Proxyman 可以**自动**在钥匙串中安装并信任证书。请按照以下步骤操作：

1. 打开 **Certificate** 菜单
2. 选择 **Install Certificate on this Mac…**
3. 在 **Automatic** 标签页中，点击 **Install & Trust Certificate**，并输入 Mac 的密码（root 权限）
4. 确认状态：按钮中显示 ✅ `Installed & Trusted`（如果没有显示，请尝试 Manual 标签页，或联系我们获取进一步支持）
5. 完成 :white\_check\_mark:

要验证抓包是否成功，请在 Proxyman 运行且已为该域名启用 SSL Proxying 的情况下，从浏览器发起一个新的 HTTPS 请求，并确认你可以读取请求和响应的内容。如果没有任何内容显示，请使用[无流量排查清单](https://proxyman.com/docs/zh-cn/troubleshooting/i-couldnt-see-any-traffics-on-proxyman)；如果证书安装失败，请继续使用下方的手动模式。

![Proxyman Mac 设置指南，Automatic 标签页，证书显示为已安装并受信任](https://proxyman.com/docs/assets/proxyman-mac-setup-guide-automatic.jpg)

_证书已安装并受信任_

> **备注:** **自动模式**需要 **root 权限**来运行安装脚本。如果你不确定，请考虑使用手动模式。

### 工作原理 {#how-does-it-work}

在自动模式下，Proxyman 会执行两个步骤：

1. 在 `~/Library/Application\ Support/com.proxyman.NSProxy/app-data/proxyman-ca.pem` 生成本地 Proxyman 证书
2. 将证书安装并信任到 System keychain（系统钥匙串）中。运行以下命令需要 root 权限： 

```bash
sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain ~/Library/Application\ Support/com.proxyman.NSProxy/app-data/proxyman-ca.pem
```

## 2. 手动模式（高级） {#2-manual-mode-advanced}

手动模式适合希望自行安装并信任证书的高级用户，可以获得更多控制权。 

1. 打开 **Certificate** 菜单
2. 选择 **Install Certificate on this Mac…** -> 选择 **Manual** 标签页
3. 点击 **Generate and Add…** 按钮（Proxyman 会在本地生成证书并将其添加到钥匙串，但不会信任该证书，无需输入密码）
4. 某些情况下，macOS 会询问使用哪个钥匙串 -> 选择 **System Keychain**
5. 在 Mac 上打开 Keychain Access 应用 -> 搜索 “Proxyman CA” -> 打开它 -> 选择 “Always Trust” -> 关闭窗口并保存

> **备注:** 如果操作正确，Proxyman 会显示 “✅ Installed and Trusted” 状态。

![Proxyman Mac 设置指南，Manual 标签页，包含在 Keychain Access 中将 Proxyman CA 设置为 Always Trust 的步骤](https://proxyman.com/docs/assets/proxyman-mac-setup-guide-manual.jpg)

_手动模式：在钥匙串中信任证书_

> **备注:** 如果你想使用自己的自定义根证书，请参阅[自定义证书文档](https://proxyman.com/docs/zh-cn/advanced-features/custom-certificates#6-how-to-generate-self-signed-certificates-for-custom-root-certificate-that-comply-with-new-apples-security-requirements)。

如果你不确定如何在 Keychain Access 应用中信任证书，请打开“终端”应用并运行以下命令：

```bash
sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain ~/Library/Application\ Support/com.proxyman.NSProxy/app-data/proxyman-ca.pem
```

> **备注:** 如果你不再使用 Proxyman，请务必在 Keychain Access 应用中**删除 Proxyman 证书**。否则，任何持有该 Proxyman 证书的人都可能拦截你 Mac 上的 HTTP/HTTPS 请求。

## 3. 卸载 Proxyman 证书 {#3-uninstall-proxyman-certificate}

1. 打开 **Certificate** 菜单
2. 选择 **Reset all Proxyman Certificates**
3. 输入你的 Mac 密码即可完成

## 视频 {#video}

[Video: 使用 Proxyman 抓取 HTTP 和 HTTPS 流量](https://proxyman.com/videos/capture-http-https-traffic) (25 seconds)