Shadowrocket 扫码添加节点完全指南：从入门到精通
前言：为什么选择扫码配置？
在 Shadowrocket（小火箭）的多种配置方式中，扫码添加是最快捷、最不易出错的方案，相比手动输入冗长的服务器地址、端口、密码和加密协议，二维码配置能在 3 秒内完成节点导入，且完全规避了手动输入可能导致的字符错误（如混淆数字 0 与字母 O、数字 1 与字母 l 等）。
本指南将系统讲解 iOS 环境下通过二维码添加节点的完整流程,涵盖从基础操作到高阶排错的全链路知识。
准备工作：环境检查清单
在扫码前,请确认满足以下条件：
-
软件环境
- 已购买并安装 Shadowrocket（美区 App Store，$2.99）
- iOS 系统版本 ≥ 12.0（建议升级至最新版以获得最佳兼容性）
-
硬件权限
- 已授予 Shadowrocket 相机权限（设置 → 隐私与安全性 → 相机 → Shadowrocket）
- 设备具备可用的网络连接（Wi-Fi 或蜂窝数据）
-
节点来源
获取到有效的节点二维码（来自机场服务商、自建服务器或好友分享）
核心操作流程详解
步骤 1：启动扫码模块
打开 Shadowrocket，点击底部导航栏的 「首页」（Home 图标），在右上角找到 按钮，选择 「扫描二维码」（Scan QR Code）。
技术细节：Shadowrocket 支持识别标准 URI Scheme 格式的二维码，包括 ss://、ssr://、vmess://、trojan://、vless:// 等主流协议。
步骤 2：扫码识别与解析
将相机对准二维码，保持 10-15cm 距离，确保二维码完整出现在取景框内，识别成功后,应用会自动解析出节点配置信息。
常见二维码内容格式示例：
vmess://eyJhZGQiOiIxOTIuMTY4LjEuMSIsInBvcnQiOiI0NDMiL...（Base64 编码）步骤 3：配置确认与保存
解析完成后，系统会弹出节点详情页,显示以下关键信息：
- 节点名称（Remarks）：可自定义修改，建议按地区/运营商命名（如「香港-CN2」）
- 服务器地址（Server）：IP 或域名
- 端口（Port）：通常为 443、8080 或自定义高端口
- 加密方式（Encryption）：如 AES-256-GCM、Auto 等
- 协议插件（Plugin）：如 obfs、v2ray-plugin（如有）
关键操作：
- 点击 「保存」（Save）完成添加
- 若需测试延迟，点击右上角 「连通性测试」（Connectivity Test）
步骤 4：启用代理
返回首页，点击刚添加节点右侧的 开关按钮，或点击全局路由选择 「代理」 模式，状态栏出现 「VPN」 图标即表示连接成功。
二维码来源与生成方案
方案 A：机场服务商直接提供
大多数商业机场（V2Ray、Trojan、Shadowsocks 服务商）在「用户中心」提供「一键导入」功能：
- 登录机场官网
- 找到「iOS 导入」或「二维码订阅」
- 选择具体节点生成二维码
- 截图保存或直接扫码
方案 B：订阅链接转二维码
若只有订阅链接（URL）,可通过以下方式转换：
- 在线转换工具：使用订阅转换前端（如 SubConverter Web），粘贴订阅链接后选择「生成二维码」
- 快捷指令（Shortcuts）：安装「订阅转二维码」快捷指令，自动转换剪贴板内容
方案 C：手动生成（自建服务器用户）
使用 Base64 编码工具手动生成：
高阶排错与优化
故障 1：扫码无反应或解析失败
诊断：
- 二维码模糊或反光（尝试调整光线角度）
- 二维码包含不支持的协议（如 hysteria、tuic 等需特定客户端）
- 二维码已过期（部分机场设置单次有效二维码）
解决：
- 手动截图后，使用「从相册导入」功能（部分版本支持）
- 检查二维码内容，确认协议类型在 Shadowrocket 支持列表内
故障 2：添加后无法连接
排查流程：
- 检查时间同步：V2Ray/Vmess 协议对时间敏感，确保 iOS 开启「自动设置时间」
- 验证端口连通性：使用「延迟测试」功能，若显示 timeout，可能是端口被封或防火墙拦截
- TLS 证书问题：Trojan/VLESS 节点若使用自签名证书，需在「设置 → 证书」中安装并信任
故障 3：扫码后节点信息乱码
原因：二维码编码使用了非 UTF-8 字符集（如中文节点名未正确编码） 修复：手动编辑节点，重新输入备注名称
安全与隐私最佳实践
二维码来源验证
- 风险：恶意二维码可能包含钓鱼服务器地址，拦截流量
- 对策：仅扫描可信来源（官网、官方 Telegram 频道）的二维码，避免使用第三方「免费节点分享」网站的二维码
订阅链接安全
- 若通过二维码导入的是订阅链接（而非单个节点），建议开启「自动更新」但设置 「更新时验证证书」，防止中间人攻击替换节点列表
日志审计
定期查看 「设置 → 日志」，检查是否有异常出站连接，若发现未配置的 IP 地址频繁连接,立即删除该节点并更换密码。
批量管理与自动化
对于拥有多个节点的用户：
批量扫码技巧：
- 连续扫描多个二维码，Shadowrocket 会自动追加到节点列表
- 使用「分组」功能（Group）将扫码导入的节点归类，便于管理
订阅二维码 vs 单节点二维码：
- 订阅二维码为
sub://或https://链接，导入后自动包含全部节点，支持自动更新 - 单节点二维码：仅包含单个服务器配置，需手动更新
扫码添加节点是 Shadowrocket 最高效的配置方式，其核心在于确保二维码来源可信与协议兼容性，掌握本文所述的故障排查方法后，您可以在 30 秒内完成从扫码到翻墙的完整流程。
最后提醒：定期备份节点配置（设置 → 导出），防止误删或应用重装后丢失配置，对于重要节点，建议同时保存二维码截图和文本格式的分享链接（ss:// 或 vmess:// 完整链接）,实现双重保险。
本文基于 Shadowrocket v2.2.45 版本撰写，不同版本界面可能略有差异，核心逻辑保持一致。
