适用于首次在 Mac 或 Windows 安装 Shadowrocket 的用户。先核对芯片与安装包来源，再区分系统信誉提示和明确的安全阻止，最后完成首次启动与连接检查。安装提示不等于连接故障，不需要为了打开应用而关闭系统整体防护。
安装前：核对设备与获取渠道
Shadowrocket（小火箭）的 Mac 版提供 Apple 芯片与 Intel 两种选择，Windows 版使用对应的 Windows 安装入口。先到全平台下载指南选择设备，不要仅凭文件名里的“Mac”判断是否适合本机，也不要把搜索结果中的转载附件当作本站安装包。
获取价格分两档：iPhone / iPad 在 App Store $2.99 一次性购买；Mac（Apple 芯片与 Intel）、Windows、安卓、Linux 版免费。iPhone / iPad 的开发者为 Shadow Launch Technology Limited，系统要求以 App Store 页面标注为准。客户端获取费用与服务商线路费用是两件事，客户端买断不等于线路套餐。
桌面安装包由本站下载指南提供，文件通过本站 /dl/shadowrocket/ 路径获取。若浏览器报告下载未完成，先等待完成再打开；重复点击未完成的文件不能解决系统拦截。安装前保存正在编辑的配置，更新已有安装时尤其如此。
Mac 安装包：Apple 芯片还是 Intel
在屏幕左上角打开 Apple 菜单 → About This Mac（关于本机）。这里显示的 Chip 或 Processor 字段比购买年份更可靠：同一产品系列可能跨越不同芯片平台。不要根据笔记本外观、内存大小或是否装过其他软件作判断。
按 About This Mac 的字段选择
Apple 芯片
- Chip 字段显示 Apple 芯片型号。
- 在下载指南选择 Mac Apple 芯片版。
- 优先使用匹配芯片的安装包，不把兼容转换当作默认安装步骤。
Intel
- Processor 字段显示 Intel 处理器名称。
- 在下载指南选择 Mac Intel 版。
- 若提示架构不适用，重新核对下载按钮与本机处理器。
以本机字段为准；两类 Mac 都有对应入口，不需要根据年份猜测。
下载后按文件内的安装说明完成安装。若打开的是包含应用的磁盘映像，将应用放入 Applications 后，再从 Applications 启动；若出现安装向导，则按向导指定的位置安装。不要在尚未完成复制时反复启动，也不要把磁盘映像窗口与已经安装的应用混为一谈。
macOS「无法验证开发者」：单独允许打开
“无法验证开发者”属于 macOS 对应用来源与签名验证的提示，不能直接推导为安装包损坏，也不能据此认定文件安全。先确认文件确实来自本站下载指南，且选择了正确芯片，再使用系统提供的单个应用放行入口。不同 macOS 版本的提示文字与按钮位置可能略有差异。
-
尝试启动
从 Applications 打开 Shadowrocket，阅读系统弹窗。若属于无法验证开发者的提示，先关闭弹窗，记住其中显示的应用名称。
-
打开设置
进入 System Settings → Privacy & Security（系统设置 → 隐私与安全性），向下查看 Security 区域。较早的系统可在 System Preferences → Security & Privacy → General 中检查。
-
核对项目
确认被阻止的应用确为刚才启动的 Shadowrocket，再点击 Open Anyway（仍要打开）。不要替名称不符或来源不明的项目执行此操作。
-
确认打开
按系统要求使用本机账户认证，并在后续确认框选择 Open。等待应用窗口出现，确认不是仍停留在安装文件窗口。
Open Anyway 通常与最近一次被阻止的启动有关。找不到入口时，先确认刚才是否真的尝试打开了已安装的应用，再返回安全设置查看。公司或学校管理的 Mac 可能限制此项权限，应交由设备管理员处理，不要修改组织策略。
Windows SmartScreen：查看信息后再决定
SmartScreen 的“Windows 已保护你的电脑”提示可能与文件信誉有关，它与 Microsoft Defender 明确报告威胁不是同一种情况。只有在确认下载来源、文件用途及提示详情后，才考虑对当前文件执行一次运行操作。安装向导需要管理员权限时，系统还可能单独显示 UAC 确认框。
-
完成下载
从本站下载指南取得 Windows 版，等待浏览器下载完成。在 File Explorer 的 Downloads 中找到该文件，避免误开同名的旧副本。
-
查看详情
打开文件，若出现 SmartScreen 提示，点击 More info（更多信息），查看应用名称与发布者信息。名称不符或来源无法确认时，选择不运行。
-
单次运行
确认文件来源且没有明确的恶意软件告警后，若界面提供 Run anyway（仍要运行），可选择该按钮。此操作针对当前文件，不要求关闭 SmartScreen。
-
完成安装
按安装向导操作；若出现 UAC，核对其中的程序信息后再确认。安装结束后，从 Start 菜单或安装位置启动 Shadowrocket。
如果没有 More info 或 Run anyway，可能是拦截类型不同，或设备受组织策略管理。不要反复更改扩展名、关闭实时防护或使用管理员身份强行尝试。先记录完整提示；若 Windows Security → Virus & threat protection → Protection history 中存在明确威胁记录，应停止运行并核实，而不是把该记录当作普通信誉提示忽略。
首次打开：分清权限、配置与连接
应用窗口能够正常出现，说明安装与首次启动已经推进到下一阶段，但不代表服务器或规则已经配置完成。用户已有自己的服务商与订阅时，订阅链接应从你的服务商处获取。本站不提供、不销售、不推荐节点、订阅或相关服务。
启动与系统权限
- 应用窗口
- 先确认 Home、Config、Settings 等主要入口能够显示。
- 权限触发
- 首次启用连接时，按实际弹窗核对网络组件或 VPN 配置请求。
- 处理原则
- 只确认由当前 Shadowrocket 操作触发、用途明确的系统请求。
- 验收标准
- 关闭后能再次正常启动，不重复落回安装或安全拦截流程。
不同系统使用的网络接入机制可能不同，以当前客户端和系统提示为准。
配置与连接检查
- Home
- 核对已有服务器条目；手动填写时使用 Add Server。
- Config
- 检查当前使用的配置文件；添加订阅时按 Subscribe 入口填写服务商提供的链接。
- Global Routing
- 检查当前选择；Direct 走直连，Config 按当前配置规则处理。
- Settings
- 先保留已知设置，基础连接正常后再评估 On Demand 等自动连接选项。
先验证手动连接，再增加自动连接条件，便于区分安装问题与配置问题。
需要手填服务器时，协议、主机、端口和认证信息必须与服务商给出的内容一致。端口是服务商指定的数值，不能因为使用 Trojan 就一律填成 443，也不能把订阅地址当成服务器主机填写。若应用能打开但网页不能访问，排查方向应转向服务器可用性、订阅更新结果和 Global Routing，而不是重复安装。
安装与放行常见问题
Mac 提示架构不适用，点“仍要打开”有用吗？
没有。安全放行不能把错误架构转换成正确架构。重新打开 Apple 菜单 → About This Mac，核对 Chip 或 Processor，再到下载指南选择对应的 Apple 芯片版或 Intel 版。
Windows 没有“仍要运行”，该在哪里开启？
先读取完整提示，确认是否确为 SmartScreen，以及设备是否由组织管理。没有按钮时，不应为了安装而关闭系统防护；明确威胁告警和组织限制需要分别处理，不能套用单次放行步骤。
应用能打开，但连接失败，还要重新安装吗？
先在 Home 核对服务器，再检查 Config 中的配置与订阅更新结果，并查看 Global Routing 是否符合预期。安装问题通常发生在应用无法启动或组件无法加载阶段，服务商凭据错误不会因重装自动修复。
更新后又出现安全提示，能沿用上次判断吗？
不能仅凭上次成功就直接允许。先保存当前配置，从下载指南重新确认更新文件的来源与架构，再根据这次的提示类型处理。新文件可能重新触发信誉检查，但明确的安全阻止仍需停止运行并核实。
排查时记录三个信息即可形成有效线索：系统显示的完整提示、下载时选择的平台与芯片、问题发生在安装前还是连接后。记录中不要附上订阅完整链接、密码或认证令牌。这样既能定位流程阶段，也能避免把凭据随截图或日志传播。