CROSS-PLATFORM TUTORIAL
全平台第三方客户端配置与操作指引
面向 Windows、macOS、iOS、Android 与 Linux 的系统化技术教程。包含准备工作、订阅导入、权限配置、连通性核验与常见错误排除。
Windows 10 / 11
支持平台 推荐第三方客户端： ClashParty / Clash Verge Rev / v2rayN
1. 准备工作 确认系统时间与互联网时间同步误差小于 1 分钟；关闭其他第三方杀毒软件的 Web 监控模块。
2. 配置格式 Clash 标准 YAML 订阅配置格式
3. 订阅导入 打开客户端，进入 Profiles / 订阅界面，粘贴 AirTCP 订阅链接并点击 Download / 保存。
4. 系统权限 首次运行若弹出“Windows Defender 防火墙”提示，勾选“专用网络”和“公用网络”放行。
5. 连接检查 开启“系统代理”，在浏览器打开国外测速或搜索网页，检查状态栏是否显示当前节点上下行速率。
6. 配置更新 建议在软件内将自动更新间隔设置为 24 小时或 48 小时。
7. 常见错误处理 如提示 context deadline exceeded，请先检查本地 WiFi 是否连通，并切换节点重试。
8. 安全使用建议 切勿在未开启防火墙的公共网络下开启“允许局域网连接（Allow LAN）”。
macOS (Apple Silicon & Intel)
支持平台 推荐第三方客户端： ClashParty / Clash Verge Rev / sing-box
1. 准备工作 更新 macOS 至最新受支持版本，确保具备安装第三方受信软件的管理员权限。
2. 配置格式 Clash 标准 YAML 配置 / sing-box JSON 格式
3. 订阅导入 打开软件，点击“配置”面板并粘贴订阅 URL，点击下载拉取远程节点列表。
4. 系统权限 在“系统设置 > 隐私与安全性”中，允许客户端安装网络扩展（Network Extension）或辅助工具。
5. 连接检查 状态栏图标亮起后，访问海外网页核实分流状态，国内网站应自动直连。
6. 配置更新 右键点击配置卡片选择“更新”，或开启定时更新。
7. 常见错误处理 若提示无法安装 Helper，需在终端执行 `sudo chown root` 修复权限或重新授权。
8. 安全使用建议 使用完毕前记得关闭系统代理，避免非正常断开引发系统网络偏好设置残留。
iOS / iPadOS
支持平台 推荐第三方客户端： Shadowrocket / sing-box / Loon
1. 准备工作 准备非国区 Apple ID，前往 App Store 获取对应网络客户端软件。
2. 配置格式 Clash YAML / Shadowrocket 标准 Base64 订阅
3. 订阅导入 进入网页端个人中心，点击右上角“+”号选择“扫描二维码”直接导入 AirTCP 订阅。
4. 系统权限 首次启动点击开关时，系统会弹出“添加 VPN 配置”窗口，需验证 Face ID 或输入锁屏密码允许。
5. 连接检查 顶部状态栏出现“VPN”小图标，打开 Safari 浏览器访问海外站点验证连通性。
6. 配置更新 在配置列表中向左滑动手势点击“更新”，或开启“打开应用时自动更新配置”。
7. 常见错误处理 若节点延迟测速显示“Timeout”，可先切换蜂窝网络或在软件内将节点切换为其他专线。
8. 安全使用建议 严禁通过公共社交平台直接向他人发送含有私有 Token 的长链接。
Android 10 - 15
支持平台 推荐第三方客户端： ClashMetaForAndroid (CMFA) / v2rayNG / Hiddify
1. 准备工作 从可靠开源渠道获取 APK 并安装，在系统设置中为软件授予“无限制电量消耗”白名单权限。
2. 配置格式 Clash YAML / Clash.Meta 核心配置
3. 订阅导入 打开应用，点击“配置”，点击右上角“新建配置 > 从 URL 导入”，输入配置名称并粘贴 AirTCP 订阅链接。
4. 系统权限 点击主开关，系统弹出“网络连接请求”提示，点击“确定”允许建立本地 VpnService。
5. 连接检查 通知栏常驻连接图标，在软件主界面点击“节点”进行延迟测试，选取延迟较低的绿色节点。
6. 配置更新 在配置列表长按配置名称，选择“更新订阅”。
7. 常见错误处理 若屏幕关闭后频繁断流，请检查厂商系统（如 MIUI、HyperOS、OriginOS）的后台冻结策略。
8. 安全使用建议 避免使用来源不明的汉化破解版客户端，防止个人凭据被恶意中继抓包。
Linux (Ubuntu / Debian / CentOS / Arch)
支持平台 推荐第三方客户端： Clash Meta Core / sing-box CLI
1. 准备工作 准备拥有 root 或 sudo 权限的终端环境，安装 curl 与 systemd。
2. 配置格式 Standard config.yaml
3. 订阅导入 使用命令 `curl -L -o /etc/clash/config.yaml "https://...订阅链接"` 远程拉取配置。
4. 系统权限 若使用 TUN 模式，需为二进制文件赋予 `setcap cap_net_admin,cap_net_bind_service=+ep` 特权。
5. 连接检查 执行 `curl --socks5 127.0.0.1:7890 https://api.ipify.org`，输出应为对应专线落地 IP。
6. 配置更新 编写简单的 crontab 脚本每周或每日自动 curl 刷新一次订阅配置。
7. 常见错误处理 若内核无法启动，检查 `/var/log/clash.log` 中是否存在 yaml 缩进格式或端口占用报错。
8. 安全使用建议 务必将 `external-controller` 绑定在 127.0.0.1，切勿向公网 0.0.0.0 开放免密控制面板端口。