sing-box for Apple platforms

sing-box for Apple platforms is called sing-box VT in Apple Store, a brand new kernel that supports almost all current protocols, and is the only free, open source, ad-free and good tool in App Store.

Get sing-box for Apple platforms

Apple Family Series

macOS iOS iPadOS tvOS can be installed through Apple Store, the only threshold is that you need a non-mainland China Apple ID

• App Store

macOS can also be installed through Github and command line

• GitHub Releases
• Command line: brew install sfm

Additional explanation:

• SFI is the abbreviation of sing-box for iOS;
• SFM is the abbreviation of sing-box for macOS;
• SFT is the abbreviation of sing-box for tvOS.

Add Subscription

In the Jego - Control Panel, click on Subscription Nodes in the left navigation bar, find the Sing-Box subscription address and click Copy.

Jego subscription service mobile panel: https://jego.us

sing-box for macOS /SFM Usage Tutorial

Add Subscription

Open the sing-box client, go to Profiles -> New Profile

1. Fill in Jego in Name
2. Select Remote for Type
3. Paste the sing-box subscription URL copied from Jego in URL
4. Don't change anything else, just click Create

Enable sing-box

Click Dashboard, make sure Profile selects the Jego just created, then click the start button in the red circle.

Overview - Select internet mode

Rule Direct Global

Groups - Switch node servers

sing-box for iOS / SFI Usage Tutorial

Add Subscription

Open the sing-box client, go to Profiles -> New Profile

1. Fill in Jego in Name
2. Select Remote for Type
3. Paste the sing-box subscription URL copied from Jego in URL
4. Don't change anything else, just click Create

Enable sing-box

Click Dashboard, make sure Profile selects the Jego just created, then click the Enabled switch.

The usage logic is similar to macOS above, using the same UI framework.

Overview tab - Select internet mode

Rule Direct Global

Groups tab - Switch node servers

sing-box Common Issues

🚫 Cannot access foreign websites but can access domestic websites?

🟡 Situation 1: Just started

When sing-box just starts, before processing foreign domain name resolution, it will first conduct a URL speed test on all available nodes to select the fastest node to complete subsequent DNS resolution. Therefore, before the speed test is completed, you may temporarily be unable to access foreign websites.

✅ Solution: If you don't want to wait for the speed test process, you can manually select an available node, so you can immediately access foreign websites.

🟡 Situation 2: Same problem occurs during use

If you also suddenly cannot access foreign websites during use, it's likely that the currently selected node is unavailable or has poor connection quality.

✅ Solution: Please check the connectivity of the current node, and manually switch to a stable available node when necessary to restore access.

---

💡 Note: This problem will not affect access to domestic websites, nor will it affect the use of services based on foreign IP (such as Telegram), only affecting access to foreign domain name websites.

⚠️ Report "Service Error", cannot start service

If you encounter the error shown in the image below when starting:

(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

🟡 Problem cause: This is because your network environment cannot access GitHub, causing the rule files to fail to load.

✅ Solution: Please try switching networks, such as:

• Switch to other Wi-Fi
• Switch to mobile network (such as 4G/5G)
• Change network operator (such as from China Telecom to China Unicom, ask friends for hotspot)

💡 Note: Once the rule files are successfully loaded once, this error will not appear again.