快速上手

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

Chute iOS

1. 获得一份配置

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

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

• 空白配置 —— 打开内置编辑器，从一份空配置开始（内容可参考下文的最小配置示例）。
• 添加订阅 —— 从订阅 URL 下载并保持更新：文件会存为托管配置，每 24 小时自动重新获取。
• 从本地文件导入 —— 导入 Chute（.conf）、sing-box（.json）或 Clash/mihomo（.yaml）文件；非原生格式会被自动转换。
• 从 iCloud 同步、从 URL 下载、通过 Wi-Fi 上传文件、从二维码下载 —— 同一件事的其他传输方式。

2. 选中它

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

3. 启动并授权

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

4. 验证

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

Chute Mac

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

1. 导入配置 —— 导入配置... 导入磁盘上的文件，或用设置助手... 一步步创建。主窗口的配置文件标签页还支持从订阅 URL 或分享链接（ss://、vmess:// 等）导入。订阅与转换生成的配置存放在 ~/Library/Application Support/<bundle id>/Profiles/；从磁盘导入的文件则原地引用。
2. 选中它 —— 选择配置文件；运行中可用切换配置。
3. 打开开关 —— 两个独立开关各有用途：
   • 系统代理 —— 菜单顶部的开关。把 Chute 注册为系统 HTTP/SOCKS 代理；遵循系统代理设置的应用会经由 Chute。
   • 增强模式（⌘E）—— 在网络层接管全部流量，包括无视系统代理的应用。首次开启需要批准 Chute 的网络扩展或 VPN 配置；类型选择与授权流程见增强模式。
4. 验证 —— 菜单顶部显示「系统代理：已启用」，主窗口的流量与日志标签页能看到流量的去向和原因。

Chute tvOS

Apple TV 上的 Chute 通过 iPhone 或 iPad 配置：Chute iOS 的远程配置导入界面——可经 chute://tv URL Scheme 唤起——负责把配置投送到 TV。

最小配置

一份完整可用的单 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）。
• 疑难解答 —— 出问题时看这里。