本文适用于准备在 Mac 或 Windows 上安装 Shadowrocket（小火箭）的用户。先核对设备架构和本站下载来源，再区分系统信誉提示、明确风险警告与连接权限请求；安装完成后，用已有配置检查 Global Routing 和连接状态。看到“已安装”不等于已具备可用连接，首次打开放行也不应通过关闭系统安全功能完成。
一、下载前核对平台、芯片与文件来源
Shadowrocket 的 Mac 版提供 Apple 芯片与 Intel 两个选择。芯片类型决定应下载哪个安装包，不能仅根据 Mac 的外观、购买年份或屏幕尺寸判断。Windows 用户则先查看系统类型，再按下载页当时列出的适配说明选择，不把 Mac 的 dmg 文件用于 Windows。
- Mac：打开苹果菜单 →「关于本机」。显示「芯片」且名称为 Apple 芯片时，选择 Apple 芯片版；显示「处理器」且包含 Intel 时，选择 Intel 版。
- Windows：打开「设置」→「系统」→「系统信息」，查看「系统类型」。若是基于 ARM 的设备，不默认认为所有桌面安装包都适用，应先核对下载页说明。
- 获取文件：进入全平台下载页，选择对应平台。Mac 的两个芯片按钮分别对应不同安装包，下载后保留原文件名，避免改名后混淆。
- 核对来源：桌面安装包由本站
/dl/shadowrocket/路径提供。若文件来自聊天附件、重定向后的陌生站点或无法确认来源的旧备份，先停止打开，回下载页重新获取。
二、Mac 安装：先复制到 Applications，再首次打开
dmg 是磁盘映像，双击后会在 Finder 中挂载为一个卷。挂载成功只代表可以查看其中的文件，并不代表应用已经复制到电脑。直接从映像里反复启动，容易在推出映像后找不到原来的启动位置。
- 在 Finder 的下载目录中找到刚获取的 dmg，双击挂载，打开其中的应用。
- 将 Shadowrocket 拖入「应用程序」（Applications）。如果映像提供 Applications 快捷入口，可拖到该入口；没有入口时，拖到 Finder 侧栏的「应用程序」。
- 等待复制完成。若系统询问是否替换同名应用，先确认现有配置已备份，并退出正在运行的 Shadowrocket，再决定是否替换。
- 从「应用程序」打开 Shadowrocket。确认复制成功后，可在 Finder 中推出安装映像，后续均从应用程序目录启动。
若第一次启动出现无法验证开发者或无法检查恶意软件的提示，先阅读完整文本。macOS 的提示措辞随系统版本变化；单纯无法验证身份，与系统明确判定应用会损害电脑，不是同一类情况。
Mac 首次打开：按提示性质分两种处理
身份或信誉尚未确认
- 核对文件确实来自本站，并确认芯片版本正确。
- 尝试打开一次后，进入「系统设置」→「隐私与安全性」。
- 若页面提供该应用的「仍要打开」，核对应用名称后点击，按系统要求验证身份并确认打开。
- 部分系统可在 Finder 中按住 Control 点按应用，再选择「打开」；若没有相应选项，以系统实际提供的操作为准。
明确风险或文件异常
- 出现“将损坏你的电脑”等风险判定时停止操作，不继续强行启动。
- 提示应用损坏、映像无法挂载或复制中断时，先删除异常下载文件，再从本站重新获取。
- 重新获取后仍出现风险提示，保留提示原文，通过站点说明页查看反馈方式。
- 受组织管理的 Mac 若禁止放行，交由管理员确认，不更改管理策略。
只针对已核对来源的单个应用处理；不要关闭 Gatekeeper，也不要执行批量移除隔离属性的命令。
三、Windows 安装：区分 SmartScreen 与恶意软件警报
Windows 的 SmartScreen 会结合下载文件的信誉信息给出提示。“Windows 已保护你的电脑”不等于应用已经被判定为恶意软件，但也不能仅凭这一句话就直接放行。先确认下载来源，再查看提示中的应用名称和发布者信息。
- 从本站下载页获取适合当前系统的 Windows 安装包。等待浏览器显示下载完成后再打开，不运行尚未下载完整的文件。
- 启动安装程序。若出现用户账户控制提示，查看程序名称与发布者，确认这是刚主动打开的安装程序后，再决定是否允许更改设备。
- 若 SmartScreen 显示“Windows 已保护你的电脑”，点击「更多信息」，检查显示的信息。确认来源与文件对应，且没有明确的恶意软件警报时，才使用系统提供的「仍要运行」。
- 按安装向导完成操作，再从开始菜单或已创建的应用入口启动。不要连续重复运行安装程序来代替启动应用。
如果「仍要运行」不存在，可能是组织策略限制，也可能是不同类型的拦截。此时记录完整提示交由管理员确认。Windows 安全中心若明确报告威胁，不关闭实时保护、不添加整个下载目录为排除项，也不反复恢复被隔离的文件。
- 看到 SmartScreen 信誉提示：先检查「更多信息」，判断是否可以对单个文件继续操作。
- 看到安全中心威胁告警：停止启动，保留检测名称与文件来源信息。
- 看到“此应用无法在你的电脑上运行”：回到「系统信息」核对系统类型与下载页适配要求，而不是继续寻找放行按钮。
四、首次启动后：先验证配置，再决定 Global Routing
应用能打开，只能证明安装与启动阶段已通过。联网还需要用户已有自己的服务商与订阅，或自行管理的服务器参数。本站不提供、不销售、不推荐节点或订阅。首次导入前应保留现有配置备份，订阅链接中的令牌也不应出现在截图或公开反馈中。
- 先确认当前普通网络可用，再进入 Home 添加已有连接信息；已有订阅的用户按界面提供的入口导入，并核对服务器地址、端口及协议字段。
- 在 Config 中检查当前配置是否为准备使用的那一份，尤其留意规则引用的策略是否存在。协议、认证信息、TLS 与传输参数应与已有服务端设置一致。
- 查看 Global Routing 的当前选项。排障时一次只改一个变量，不同时更换订阅、协议、DNS 和路由模式。
- 首次启用连接时，系统若请求添加 VPN 配置或其他网络权限，核对请求来自当前应用后再授权。权限请求与安装时的安全放行属于不同环节。
Config：按当前规则处理
推荐依据当前配置中的规则与策略决定连接去向。命中规则后采用对应动作，未命中时由后续规则或 FINAL 决定；不能简单理解成“其余必定直连”。
适合：已有经过核对的配置，需要按域名或目标地址分流。
Proxy：临时检查代理路径
让应用所处理的连接按代理模式运行，用于与 Config 的结果对照。它不能保证电脑上所有程序的每一种流量都自动被接管。
适合：已有可用代理，临时判断故障是否与分流规则有关。
Direct：检查直连结果
让应用所处理的连接采用直连路径。切到 Direct 后能够访问，只能说明该目标在当时网络下可以直连，不能证明代理参数正确。
适合：建立直连对照，区分本地网络故障与代理路径故障。
结论：能启动却不能连接，不再重复安装
当窗口可以正常打开且没有系统拦截时，保留安装结果，转而检查已有连接的地址、端口、认证信息与 Global Routing。若 Proxy 可用而 Config 不可用，下一步检查规则命中与策略引用，而不是再次放行安装包。
五、常见提示与安装后恢复检查
反馈问题时，至少记录平台、芯片或系统类型、失败发生在安装还是连接阶段，以及完整提示文本。只写“打不开”无法区分文件架构不符、系统阻止启动、权限未授权和连接超时。下面的处理顺序用于减少无关改动。
Mac 明明下载完成了，为什么“仍要打开”没有出现？
先从「应用程序」实际尝试启动一次，再查看「系统设置」→「隐私与安全性」。若仍没有入口，确认提示是否属于应用损坏或明确风险警告；受管理设备还需检查组织限制。不要用关闭系统安全检查来补出按钮。
Windows 点开后提示不兼容，需要以管理员身份重试吗？
先打开「设置」→「系统」→「系统信息」核对系统类型，并回下载页核对适配说明。管理员权限不能把错误架构的程序变成适配程序。仅在安装向导或系统明确请求必要权限时按提示处理。
已经看到 Home，为什么连接还是失败？
先核对选中的连接及其地址、端口、认证和协议参数，再查看 Global Routing。若客户端提供连接测试，结合测试结果与日志判断失败阶段；延迟测试有返回并不等于目标网页、DNS 和所有协议流量都已正常。
关掉连接后又自动连上，是安装没完成吗？
这更可能与自动连接设置有关，而不是安装残留。若当前平台提供 Settings → On Demand，先查看并临时停用相应触发规则，再重新测试。桌面端未显示该项时，按当前界面检查自动连接设置及系统 VPN 策略，不套用其他平台的菜单。
六、确认安装完成的检查清单
安装验收应把“应用启动”和“网络连接”分开记录。前者检查系统是否能正常加载应用，后者检查用户已有配置能否按预期工作。重新安装之前，先判断故障是否确实发生在启动阶段，避免覆盖现有配置而又保留原来的连接问题。
- 文件位置：Mac 从「应用程序」启动，不依赖仍挂载的 dmg；Windows 从安装后的应用入口启动，不反复执行下载目录里的安装程序。
- 系统状态：没有尚未处理的明确风险告警，没有为了运行应用而关闭整机安全保护。
- 配置状态：已选择正确的已有连接，Config 使用预期配置，订阅更新没有覆盖尚未备份的手动修改。
- 连接状态：先验证一个已知目标，再恢复日常 Global Routing 设置；记录 Direct、Proxy 与 Config 的差异，便于后续定位。
- 恢复准备：保留必要的配置备份，反馈时遮住密码、私钥和订阅令牌，仅提供定位问题需要的信息。