# sing-box for Apple platforms

## &#x20;<img src="/files/tdY6Y2ia0lzfvDueb9Lv" alt="" data-size="line"> 获取sing-box for Apple platforms

### 苹果全家桶系列

macOS iOS iPadOS tvOS 可通过Apple Store安装，唯一门槛是需要[非中国大陆地区的Apple ID](/ding-yue-jie-dian/mei-qu-apple-id-zhu-ce-jiao-cheng.md)

* [App Store](https://apps.apple.com/app/sing-box-vt/id6673731168)

macOS还可以通过Github和命令行安装

* [GitHub Releases](https://github.com/SagerNet/sing-box/releases)
* 命令行：`brew install sfm`

额外科普一下：

* SFI是sing-box for iOS的简称；
* SFM是sing-box for macOS的简称；
* SFT是sing-box for tvOS的简称。

## 添加订阅

在**无忧行 - 控制面板**里点击左侧导航栏**订阅节点**  ，找到**Sing-Box**订阅地址并点击**复制**。

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

{% hint style="success" %}
无忧行订阅服务手机面板：[https://jego.us](https://jego.us/)
{% endhint %}

## sing-box for macOS /SFM 使用教程

### 添加订阅

打开sing-box客户端，进入`Profiles -> New Profile`

1. Name处填`Jego`
2. Type选`Remote`
3. URL黏贴从无忧行复制的`sing-box的订阅URL`
4. 其他不动，直接点击`Create`

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

### 开启sing-box

点击Dashboard，确保Profile选中刚才创建的Jego，然后点击红色圈里的`开始按钮`。

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

#### Overview - 选择上网模式

<kbd>Rule</kbd> <kbd>Direct</kbd> <kbd>Global</kbd>

提醒：第一次使用可能三个模式都没选中，建议点一下`Rule`。

`Rule` - 智能分流模式，根据规则自动选择直连或代理\
`Direct` - 直连模式，所有流量都不走代理\
`Global` - 全局代理模式，所有流量都走代理

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

#### Groups - 更换节点服务器

在这个页面里可以手动选择自己想使用的节点服务器。

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

## sing-box for iOS / SFI 使用教程

### 添加订阅

打开sing-box客户端，进入`Profiles -> New Profile`

1. Name处填`Jego`
2. Type选`Remote`
3. URL黏贴从无忧行复制的`sing-box的订阅URL`
4. 其他不动，直接点击`Create`

<div align="left"><figure><img src="/files/NcdJxHRhL1siiD42OEyA" alt="" width="188"><figcaption></figcaption></figure> <figure><img src="/files/mDkzZIEMSt2FSNjOnmAn" alt="" width="188"><figcaption></figcaption></figure></div>

### 开启sing-box

点击`Dashboard`，确保Profile选中刚才创建的Jego，然后点击的`Enabled`开关。

<div align="left"><figure><img src="/files/W4ORHiVH9FiGkOK7NoNt" alt="" width="188"><figcaption></figcaption></figure></div>

使用上的逻辑和上面macOS大同小异，同一套UI框架。

#### Overview 标签 - 选择上网模式

<div align="left"><figure><img src="/files/YeVPZa1abeljHt6bBUEi" alt="" width="188"><figcaption></figcaption></figure></div>

<kbd>Rule</kbd> <kbd>Direct</kbd> <kbd>Global</kbd>

提醒：第一次使用可能三个模式都没选中，建议点一下`Rule`。

`Rule` - 智能分流模式，根据规则自动选择直连或代理\
`Direct` - 直连模式，所有流量都不走代理\
`Global` - 全局代理模式，所有流量都走代理

#### Groups 标签 - 更换节点服务器

<div align="left"><figure><img src="/files/mcWyVCzmT8ReA4zN1RHO" alt="" width="188"><figcaption></figcaption></figure></div>

在这个页面里可以手动选择自己想使用的节点服务器。

## sing-box 常见问题

### 🚫 无法访问境外网站但可访问境内网站？

**🟡 情况一：刚启动时**

刚启动 sing-box 时，程序在处理境外域名解析前，会先对所有可用节点进行一次 URL 测速，目的是选出最快的节点来完成后续的 DNS 解析。因此，在测速完成前，可能暂时无法访问境外网站。

> ✅ 解决方法：如果不想等待测速过程，可以手动选择一个可用节点，这样就能立即访问境外网站。

**🟡 情况二：使用过程中出现相同问题**

如果在使用过程中也突然无法访问境外网站，很可能是当前所选节点不可用或连接质量差。

> ✅ 解决方法：请检查当前节点的连通性，必要时手动切换到一个稳定可用的节点，即可恢复访问。

***

**💡** 注意：此问题不会影响境内网站的访问，也不影响基于境外 IP 的服务（如 Telegram）的使用，只影响访问境外域名的网站。

### ⚠️ 报“服务错误”，无法启动服务

启动时如果遇到下图这个错误：

{% columns %}
{% column width="25%" %}

<figure><img src="/files/qOKpILzwCEDQEF6n5K9E" alt="" width="188"><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}
{% code overflow="wrap" %}

```xml
(packet-tunnel) error: start service: initialize rule-set[2]: initial rule-set: geosite-geolocation-cn: Get "https://raw.githubusercontent.com/SagerNet/sing-geosite/rule-set/geosite-geolocation-cn.srs": context deadline exceeded | initialize rule-set[2]: initial rule-set: geoip-cn: Get "https://raw.githubusercontent.com/SagerNet/sing-geoip/rule-set/geoip-cn.srs": initialize rule-set[2]: initial rule-set: geosite-geolocation-cn: Get "https://raw.githubusercontent.com/SagerNet/sing-geosite/rule-set/geosite-geolocation-cn.srs": context deadline exceeded | initialize rule-set[2]: initial rule-set: geosite-geolocation-!cn: Get "https://raw.githubusercontent.com/SagerNet/sing-geosite/rule-set/geosite-geolocation-!cn.srs": initialize rule-set[2]: initial rule-set: geosite-geolocation-cn: Get "https://raw.githubusercontent.com/SagerNet/sing-geosite/rule-set/geosite-geolocation-cn.srs": context deadline exceeded
```

{% endcode %}
{% endcolumn %}
{% endcolumns %}

**🟡 问题原因：**&#x8FD9;是因为你的网络环境无法访问 GitHub，导致无法加载规则文件。

✅ **解决方法：**&#x8BF7;尝试切换网络，比如：

* 改用其他 Wi-Fi
* 切换为移动网络（如 4G/5G）
* 更换网络运营商（如从电信换联通、找朋友要热点）

**💡 注意：**&#x53EA;要成功加载一次规则文件，之后就不会再报这个错。


---

# 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://zh.jego.pro/fan-qiang-gong-ju/sing-box-for-apple-platforms.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.