Shadowrocket 扫码导入失败怎么办？按识别、权限与订阅排查
简答：Shadowrocket 扫码导入失败，先不要反复扫码：先确认相机入口和权限，再判断二维码里是单节点链接、订阅地址还是普通网页。若相机识别无响应，可在扫描界面点击右上角相册图标选择清晰截图；若导入后没有节点，进入 Subscribe 检查订阅是否保存并手动更新；若节点已经出现但连不上，那已经不是扫码问题，需要单独检查节点参数、VPN 授权和网络。
定义：Shadowrocket 扫码导入，是把二维码中的单节点分享链接或订阅地址读取到 App 中；识别成功只代表内容被读取，不代表订阅已更新或节点已经能够连接。
先看你卡在哪一环：按现象快速分流
Shadowrocket 扫码导入失败，常见的卡点并不只有一个。二维码没有被读出、读出后没有保存、订阅保存后没有节点，以及节点出现后无法连接，分别对应不同的检查方法。先按下面的结果判断，避免把“扫码失败”和“服务器连接失败”混在一起。
| 现象 | 先检查什么 | 判断与处理 |
|---|---|---|
| 扫码入口打不开或相机黑屏 | iPhone 的相机权限 | 到“设置 → 隐私与安全性 → 相机”，确认 Shadowrocket 有相机权限；菜单名称可能随 iOS 版本变化，以当前版本界面为准。 |
| 相机能打开，但二维码一直无反应 | 完整二维码、亮度、反光和距离 | 让二维码四边完整进入取景框，避免裁切、反光和画面中出现多个二维码；仍失败时改用相册识别或剪贴板。 |
| 提示格式不支持 | 二维码实际内容 | 它可能是普通网页、登录页、失效地址或 App 不支持的配置格式，不应继续随机更改 Type。 |
| 识别成功，但 Home 没有节点 | 保存位置和导入类型 | 检查是否进入了 Subscribe、是否保存成功，并到订阅列表手动更新。 |
| 节点出现，但无法连接 | 节点参数、VPN 授权和网络 | 这不是单纯的扫码故障。先选中正确节点，再检查地址、端口、协议参数和系统 VPN 授权。 |
二维码只是承载信息的方式，里面可能是单个服务器分享链接，也可能是可更新的订阅地址。公开的使用说明也提醒，扫码成功并不等于服务器一定可用，仍需检查导入后的类型和连接状态。可参考 Shadowrocket 扫码与订阅导入说明。
扫码无反应：正确打开扫描入口并检查相机权限
- 打开 Shadowrocket，在 Home 页面寻找添加服务器的入口，通常是“+”或“Add Server”；不同版本的按钮名称和位置可能不同，以当前版本界面为准。
- 进入添加服务器页面后，选择“Scan QR Code”或含义相近的扫码入口。公开使用说明将它放在 Add Server 页面中，而不是直接假设 Home 页面一定显示相机按钮。
- 首次使用时，如果 iOS 弹出相机权限请求，选择允许。Apple 说明，App 访问相机前必须获得用户授权，之后也可以在系统隐私设置中修改。
- 如果相机黑屏、入口点击后立即返回，打开“设置 → 隐私与安全性 → 相机”，查找 Shadowrocket 并开启权限；部分 iOS 版本可能采用“设置 → App → Shadowrocket → 相机”的路径，以当前版本界面为准。可参考 Apple 关于 iPhone 相机权限的说明。
如果设置中没有相机开关，先确认 App 确实尝试过调用相机，并检查“屏幕使用时间”或设备管理限制是否阻止了相机。不要把相机权限问题误判成二维码失效。
相机能打开但识别不了：用相册截图替代扫码
二维码清晰不代表一定能被识别。屏幕反光、截图压缩、二维码被裁掉边缘、距离过近或过远，都可能让识别失败。先把二维码放大到完整可见，保持四周留白，避免画面中出现第二个二维码。
- 在 Shadowrocket 中打开扫码入口，进入扫描界面。
- 在扫描界面寻找右上角的相册图标，再选择保存到照片中的二维码截图。具体图标位置可能随当前版本变化，不要把“进入扫码界面”和“选择相册图片”当成同一个按钮。
- 选择原始、清晰、未被聊天软件二次压缩的图片，等待识别。
- 识别后先查看弹出的类型、地址和端口，再决定是否保存。若显示的是网页地址或登录页，不要直接当作节点配置使用。
如果相册识别仍失败，建议让另一台设备显示原始二维码，再用 iPhone 相机扫描；不要使用包含多个二维码、被裁切或带大面积反光的图片。二维码中可能包含服务器凭据，截图和原始链接不要公开发布。
提示格式不支持：先判断二维码到底是什么内容
“扫码”不等于“任何二维码都能导入”。先判断二维码承载的内容，再选择对应方式：
| 二维码内容 | 可能表现 | 处理方式 |
|---|---|---|
| 单节点分享链接 | 识别后进入服务器添加或节点确认页面 | 检查协议、地址、端口和认证字段，保存后回到 Home。 |
| 订阅地址 | 识别结果是一条远程 URL，可能以 HTTPS 开头 | 进入 Add Server，选择 Type → Subscribe，粘贴完整 URL 和备注后保存，再到订阅列表更新。 |
| 普通网页或登录页 | 打开后是网页、账号登录页面或说明文字 | 这不是可直接导入的节点配置。向提供者索取完整订阅地址或单节点分享链接。 |
| 被截断或过期的链接 | 识别成功但保存报错、更新失败或列表为空 | 重新获取完整二维码或完整链接，避免从图片文字识别结果中手动删改字符。 |
需要特别注意：HTTPS 只说明链接使用了加密网页传输，并不能据此判断它一定不能导入。关键是打开后返回的是登录页面、网页内容，还是订阅配置数据。公开说明也将“单节点 URI”和“订阅 URL”分为两种导入方式，可参考 Shadowrocket 分享链接与订阅地址说明。
识别成功但 Home 没有节点：检查保存、Subscribe 与更新
- 扫码完成后，先观察 App 是否打开了服务器编辑页、订阅编辑页或确认页面。不要在没有点击保存的情况下直接返回 Home。
- 如果识别结果是一条订阅 URL，在 Add Server 中选择 Type → Subscribe，粘贴完整地址，填写容易辨认的备注，然后保存。菜单名称可能随版本变化，以当前版本界面为准。
- 返回 Home，确认条目是否出现在服务器或订阅列表中。若只保存了订阅地址，列表可能不会立即显示可用节点，需要执行订阅更新。
- 进入 Subscribe 或订阅管理区域，选择对应条目执行更新或刷新。下拉刷新通常用于更新订阅内容，不应当被当作测速操作。
- 如果更新失败，先复制完整订阅地址到浏览器测试是否能打开；若浏览器显示登录页、权限错误、链接过期或无法访问，问题可能在地址、账户状态或网络，而不是扫码入口。
订阅 URL、节点链接和二维码都可能含有访问凭据。排查时不要把完整链接、二维码原图或包含密码的日志发到公开平台；如需反馈，只保留错误提示并打码域名参数、用户名和密钥。
剪贴板导入也没反应：检查 iOS 的粘贴权限
扫码失败后，可以复制完整的单节点链接或订阅地址，再回到 Shadowrocket 触发导入。但 iOS 可能要求 App 读取其他 App 的剪贴板内容前获得许可。Apple 说明，App 访问其他 App 的剪贴板需要得到用户同意。
- 复制完整链接，确认从协议开头到末尾都被选中，不要混入说明文字、空格或换行。
- 回到 Shadowrocket，进入添加服务器或订阅添加页面，尝试粘贴。若系统出现“允许粘贴”或类似提示，只有在确认内容来自你刚刚复制的链接时才允许。
- 如果此前选择了“不允许”，到“设置 → Shadowrocket”或“设置 → App → Shadowrocket”查看“从其他 App 粘贴”一类的选项；名称和位置可能随 iOS 版本变化，以当前版本界面为准。
- 若没有出现自动导入提示，改为手动进入 Add Server，选择与内容匹配的 Type。订阅地址应选择 Subscribe，单节点分享链接则使用剪贴板导入或对应的服务器类型。
不要为了让导入成功而随意打开其他权限，也不要把包含凭据的链接长期留在剪贴板中。导入完成后可以复制一段普通文本覆盖剪贴板。
节点已经出现但无法连接：把问题从扫码环节分离出来
如果节点已经出现在 Home 或服务器列表，说明二维码内容至少被读取并保存了。接下来应按连接问题处理：
- 确认 Home 中选中了刚导入的节点，而不是旧条目或空配置。
- 核对协议类型、服务器地址、端口、认证信息，以及 TLS、SNI、Host 或传输路径等字段。不要只修改 Type 后保留其他参数，因为不同协议所需字段可能不同。
- 首次连接时，接受 iOS 的 VPN 配置授权；没有完成系统授权，App 内保存节点也不等于已经建立 VPN 连接。
- 使用 App 内的 Connectivity Test 或同类连通性测试，再用实际网页或业务访问验证。测试按钮名称和位置以当前版本界面为准。
- 如果所有节点都超时，先切换 Wi-Fi 与蜂窝网络，确认本地网络没有拦截；如果只有一个节点失败，优先核对该节点的地址、端口和有效期。
公开帮助资料也明确区分“扫码导入成功”和“服务器可连接”：前者只代表配置被读取，后者还取决于节点参数、VPN 授权和服务端状态。更多连接故障可参阅站内的 Shadowrocket 无法连接排查。
最短决策树：从扫码失败到恢复使用
- 入口打不开：查 Add Server 中的扫码入口，确认相机权限。
- 相机黑屏：查 iOS 相机权限和系统限制，再重启 App。
- 相机能开但不识别：调整二维码亮度、距离、留白和完整度，进入扫描界面后点击右上角相册图标选择原图。
- 提示格式不支持：判断是单节点链接、订阅 URL、普通网页还是截断链接。
- 识别成功但无节点：确认已保存；订阅类型进入 Subscribe 手动更新。
- 剪贴板无提示：检查“从其他 App 粘贴”权限，并粘贴完整链接。
- 节点出现但连不上：停止重复扫码，检查选中节点、协议参数、VPN 授权和网络。
如果订阅条目已经保存但更新失败，可以继续查看站内的 Shadowrocket 订阅更新排查；如果还不熟悉节点、订阅和连接状态的区别，可先阅读 Shadowrocket 使用与连接排查。
常见问题
Shadowrocket 扫码时应该从哪里打开相机？
通常从 Home 页面进入添加服务器，再选择“Scan QR Code”或含义相近的入口。不同版本按钮名称和位置可能变化，以当前版本界面为准。进入扫描界面后，如果要识别截图，应寻找右上角的相册图标，而不是假设打开扫码入口就会直接弹出系统相册。
Shadowrocket 扫码识别成功，为什么 Home 里没有节点？
可能只完成了读取，还没有保存；也可能二维码内容是订阅地址，需要在 Add Server 中选择 Subscribe 并保存，再进入订阅列表执行更新。检查条目是否出现、订阅是否能访问，以及更新后是否返回节点列表。
二维码是 HTTPS 链接，就不能导入 Shadowrocket 吗？
不能仅凭 HTTPS 判断。HTTPS 可能是订阅地址，也可能打开后只是登录页或普通网页。应检查链接打开后的实际内容：如果是完整订阅地址，可按 Subscribe 添加；如果是网页或登录页，则需要获取可导入的订阅地址或单节点分享链接。
Shadowrocket 复制链接后没有导入提示怎么办？
先确认复制的是完整链接，并检查 iOS 是否拒绝了 Shadowrocket 从其他 App 粘贴。在“设置 → Shadowrocket”或“设置 → App → Shadowrocket”中寻找“从其他 App 粘贴”一类选项，名称和位置以当前版本为准。也可以直接进入 Add Server 手动选择 Subscribe 或对应节点类型。
扫码成功后节点仍然连不上，是二维码失效了吗？
不一定。扫码成功只说明二维码内容被读取并保存，不能证明节点服务端可用。先确认选中了正确节点，再检查协议、地址、端口、认证字段、TLS 或 SNI 等参数，并完成 iOS 的 VPN 配置授权；随后使用连通性测试和实际访问分别验证。
相关阅读
参考资料
- Apple：控制 iPhone 对相机等硬件功能的访问权限
- Apple：隐私控制与跨 App 粘贴权限说明（apple.com）
- Shadowrocket 公开使用说明：扫码、服务器添加与订阅导入（shadow-official.com）
- Shadowrocket 公开说明：分享链接、订阅 URL 与导入方式（shadow-official.com）
- Shadowrocket 公开帮助页：导入成功、VPN 授权与连接排查（shadowrocketofficial.com）