快速上手

本页带你完成第一次运行：把配置放进 Chute、选中它、开启代理并验证流量正常。本手册的其余内容都建立在一套可用的环境之上。

Chute iOS

1. 获得一份配置

首次启动且没有任何配置时，Chute 会打开引导流程（「欢迎使用 Chute」），提供三条路径：订阅链接（服务商提供的 URL）、扫描二维码，以及手动设置——依次填入服务器信息、需要代理的网站和 DNS 选择后，会自动生成一份名为「默认」的配置并连接。

之后要再添加配置，点主界面顶部的配置栏，然后选择从...添加配置：

• 空白配置 —— 打开内置编辑器，从一份空配置开始（内容可参考下文的最小配置示例）。
• 添加订阅 —— 从订阅 URL 下载并保持更新：原生配置会存为托管配置，每 24 小时自动重新获取；如果配置自己的 #!MANAGED-CONFIG 行指定了间隔，则按那个间隔。Clash 或 sing-box 订阅在进来时会被转换，并存为没有更新头的静态快照，因此它永远不会自己刷新——要更新请重新导入。
• 从本地文件导入 —— 导入 Chute（.conf）、sing-box（.json）或 Clash/mihomo（.yaml）文件；非原生格式会被自动转换。
• 从 iCloud 同步、从 URL 下载、通过 Wi-Fi 上传文件、从二维码下载 —— 同一件事的其他传输方式。

没有许可证时，iPhone 或 iPad 上只能存一份配置。已经有一份之后，上面每一条渠道都会弹出购买提示，选中另一份配置也一样——见许可证与激活。

2. 选中它

在配置列表中点按某份配置使其出现对勾，然后点完成。Chute 始终运行被选中的那份配置——没有选中任何配置时，主开关会拒绝启动（「请先选择配置」）。

3. 启动并授权

点按主界面上的圆形开关。首次启动时 iOS 会请求添加 VPN 配置——允许它，并用 Face ID / Touch ID / 密码确认。如果拒绝了该提示，再拨一次开关即可重新弹出；如果 VPN 描述文件卡住了，可在应用设置里用重置 VPN 配置移除它，下次启动会重新创建。

4. 验证

开关打开后，出站模式保持在规则模式（直连 / 全局分别是整体绕过和整体强制代理），然后打开一个网站。仪表盘按钮可以看到实时流量和每条连接的详情——这是确认配置行为符合预期的最快方式。

Chute Mac

Chute Mac 常驻菜单栏（默认没有 Dock 图标）。点击菜单栏图标：

1. 导入配置 —— 导入配置...打开主窗口的配置文件标签页，那里有从文件导入…（磁盘上的文件）和从 URL 或分享链接导入…（订阅 URL 或 ss://、vmess:// 等分享链接；四个应用中只有 Chute Mac 能导入分享链接）。设置助手...则是一步步创建一份。这两个菜单项只在代理停止时出现。订阅与转换生成的配置存放在 ~/Library/Application Support/<bundle id>/Profiles/；从磁盘导入的文件则原地引用。
2. 选中它 —— 选择配置文件；运行中可用切换配置。引擎第一次启动时，Chute 会安装特权 Helper，由它设置系统代理、创建增强模式的接口：Chute 先说明原因（Chute 需要安装 Helper），然后 macOS 会请你授权。在 macOS 13 及更新版本上，可能还需要在系统设置 > 通用 > 登录项与扩展中放行这个 Helper；Chute 会用需要批准或在登录项中允许 Chute提示你。
3. 打开开关 —— 两个独立开关各有用途：
   • 系统代理 —— 菜单顶部的开关。把 Chute 注册为系统 HTTP/SOCKS 代理；遵循系统代理设置的应用会经由 Chute。
   • 增强模式（⌘E）—— 在网络层接管全部流量，包括无视系统代理的应用。它的默认类型Helper utun（旧版）开启前会显示一条提示，此外无需任何批准；只有PacketTunnel（推荐）类型会请你批准 Chute 的网络扩展和 VPN 配置。类型选择与授权流程见增强模式。
4. 验证 —— 菜单顶部显示「系统代理：已启用」，主窗口的流量与日志标签页能看到流量的去向和原因。

注意：以上步骤描述的是新版主窗口。Chute Mac 只会为还没有任何配置的安装自动启用它；已经有配置的安装仍保持旧界面：菜单里提供的是偏好设置...而不是打开仪表盘...，那个窗口也没有流量或日志标签页。在菜单里勾选使用新版主界面（代理运行时才会列出）即可切换。

Chute tvOS

Chute tvOS 自己就能添加配置。在配置列表上，从...添加配置提供空白配置、通过 Wi-Fi 或 Chute iOS 上传文件和从 URL 下载。Wi-Fi 上传会在 TV 的地址上放一个纯 HTTP 页面，同一网络里任何浏览器都能向它提交文件；从 iPhone 打开时，这个页面会经 chute://tv URL 方案 交给 Chute iOS，远程配置导入界面就是在这里出场的。单配置限制与 iOS 相同。

Chute Android

Android 上的首次运行——添加配置、VPN 授权、服务模式与分应用模式、在哪里验证——有单独一页：Android 快速上手。下面的最小配置在 Android 上原样可用。

最小配置

一份完整可用的单 Shadowsocks 服务器配置——局域网与中国大陆流量直连，其余走代理：

[General]
loglevel = notify
dns-server = 1.1.1.1, 8.8.8.8
skip-proxy = 127.0.0.1, 192.168.0.0/16, 10.0.0.0/8, 172.16.0.0/12, 100.64.0.0/10, localhost, *.local

[Proxy]
MyProxy = ss, example.com, 8388, aes-256-gcm, "password"

[Proxy Group]
MainGroup = select, MyProxy, DIRECT

[Rule]
IP-CIDR,192.168.0.0/16,DIRECT
IP-CIDR,10.0.0.0/8,DIRECT
IP-CIDR,172.16.0.0/12,DIRECT
IP-CIDR,127.0.0.0/8,DIRECT
GEOIP,CN,DIRECT
FINAL,MainGroup

把 [Proxy] 行换成你的服务器所用的协议和参数——所有受支持的协议都记录在代理服务器中。接下来可以阅读：

• 配置 —— 配置文件格式与全部配置段。
• 规则 —— 规则的匹配顺序与完整的规则类型目录。
• 策略组 —— 自动选择（url-test、fallback、load-balance）。
• 疑难解答 —— 出问题时看这里。