Hiddify User Guide

Hiddify Subscriptions, System Proxy and Node Selection

Hiddify is a cross-platform proxy client based on the sing-box toolchain. Follow the standalone macOS app’s Chinese interface to set it up, import a subscription, connect through the system proxy and select a server.

Guide details
Platforms
Windows / macOS
Core
sing-box
Last updated

Step 01Download and install

Windows: Open this site’s download page and download the Windows EXE. Run the installer, follow the wizard, then launch Hiddify.

EXE package entry on the Hiddify Windows download page

Windows installation note: If User Account Control appears, confirm that it is the Hiddify installer you just downloaded and select 是 (Yes). If Windows 已保护你的电脑 (Windows protected your PC) appears, confirm the source and click 更多信息 (More info). The image below is a generic Windows prompt example.

More info in a generic Chinese Windows SmartScreen prompt

In the expanded prompt, click 仍要运行 (Run anyway) to continue installation.

Run anyway in a generic Chinese Windows SmartScreen prompt; the application name is obscured in the source original

If launch fails with a missing MSVCP140.dll error, download and install the Microsoft Visual C++ x64 Redistributable, then relaunch Hiddify.

macOS: Open our download page and download the universal DMG in the macOS section. Open the DMG, install Hiddify in Applications, then launch it. macOS 12.0 or later is required.

Universal DMG installer entry on the Hiddify macOS download page

If the first launch shows the warning below, click 完成 (Done).

macOS says Hiddify was not opened because Apple cannot verify whether it contains malicious software

After checking the installer source, open 系统设置 (System Settings) → 隐私与安全 (Privacy & Security) → 仍要打开 (Open Anyway) → 打开 (Open), then launch Hiddify. See the macOS opening-alert guide.

Open Anyway in macOS Privacy & Security; the arrow and hidden app name are part of the user’s original

Step 02Set language and region

On first launch, choose Chinese under 语言 (Language) and your actual region under 地区 (Region). Set 开启分析 (Enable analytics) as preferred, then click 开始 (Start). The region affects default routing.

Hiddify First launch

Step 03Get a subscription

Copy the URL for a subscription supported by your current Hiddify app from your provider's dashboard. Using 畅连 as an example, open the subscription import window and click “复制订阅链接” (Copy subscription link).

Subscription-link copy control in the provider's import window

Step 04Add a subscription

On 主页 (Home), click the top-right + → 剪贴板 (Clipboard) to import the copied subscription URL.

Clipboard, File and Manual entries in the Hiddify macOS add-profile menu

Alternatively, choose 手动 (Manual), enter a 名称 (Name), paste the subscription address into URL and click 添加 (Add).

Name, URL and Add in the Hiddify macOS manual profile form

Open 配置文件 (Profiles), click the imported profile to select it, then return to 主页 (Home).

Example profile and its left-hand three-dot menu entry in the Hiddify macOS profile list

Step 05Set the system proxy

Return to 主页 (Home) → click 快速设置 (Quick settings) at the bottom → select 系统代理 (System proxy).

Proxy, System proxy and VPN in Hiddify macOS quick settings, with System proxy selected

Step 06Start the connection

Disconnect other proxies or VPNs. Return to 主页 (Home), check that your imported profile is selected, then click the central 点击连接 (Click to connect) button and wait for the connection.

When the status changes to 已连接 (Connected), continue to server selection and access checks.

Current profile, connected status and bottom proxy card on Hiddify macOS Home

Step 07Select a server and check access

After connecting, click the right arrow on the active proxy card at the bottom of Home → open the 代理 (Proxies) list → select a working server. A blue background marks the selected server.

Hiddify macOS proxy list with the selected server highlighted in blue

In a browser that honors the system proxy, open a site you normally reach directly, then one that needs the proxy. If access fails, try another server. To stop, return Home and click the connection button again.

Step 08Proxy modes explained

Choose traffic capture in 设置 (Settings) → 入站 (Inbound) → 服务模式 (Service mode):

仅代理服务 (Proxy only): Opens a local proxy port. Configure the proxy manually in each app that needs it.

设置系统代理 (Set system proxy): Sets the macOS system proxy; only apps that honor it use it. This is the starting mode in this guide.

VPN: Captures traffic within its scope. On first use, install the requested background service or authorize the network extension, then reconnect. The Mac App Store build has no system-proxy option.

In 路由 (Routing), the 代理 (Proxy), 直连 (Direct) and 拦截 (Block) actions choose the outbound for matched requests. They do not expand the service mode’s capture scope.

Verify the Connection Before Troubleshooting

  • Confirm the profile is active
  • Test the selected node
  • Check the matched rule
Troubleshoot Connection and Setup