受管 Windows 设备上的 TYO Reach
终端防护软件——如 PractiseProtect、Microsoft Defender for Endpoint、Carbon Black 及类似工具——可能会拦截许多安装程序和应用所使用的行为模式。TYO Reach 专为处理这些限制而设计。本页介绍了在每个步骤中可能遇到的情况。
安装
TYOReach-Setup.exe 专为在受限机器上运行而设计：
- 它将应用直接写入
%LOCALAPPDATA%\TYO Lab\TYO Reach\——无需提取临时文件，也不从%TEMP%执行。 - 它使用 Windows COM
IShellLinkAPI 创建桌面和开始菜单快捷方式——不会生成 PowerShell 子进程。 - 它在
HKCU下写入注册表自动运行项——无需管理员权限。
当前用户安装（推荐）：运行 TYOReach-Setup.exe 并选择仅为我安装（Install for me only）。没有 UAC 提示，无需管理员权限。
所有用户安装：选择为所有人安装（Install for everyone）。会出现 UAC 提权提示。如果您的机器策略阻止了 UAC，请改用当前用户安装。
安装完成后，应用会尝试自动启动。如果被终端防护软件拦截，系统会弹出一个显示安装路径的对话框。请在资源管理器中导航至 %LOCALAPPDATA%\TYO Lab\TYO Reach\，然后双击 tyoreach.exe 手动启动。首次运行后，自动运行项会在每次登录时启动它。
登录
当您点击系统托盘菜单中的登录项时，TYO Reach 会依次尝试一系列回退方案，直到其中一个成功。
步骤 1 — 浏览器自动打开
在大多数机器上，登录页面会在您的默认浏览器中打开，您可以正常登录。登录后，浏览器会重定向回本地地址，系统托盘会自动完成后续流程。
步骤 2 — 手动复制登录链接
如果终端防护软件拦截了浏览器启动，系统托盘菜单项会变为：
Copy login link (localhost:PORT) — click to copy
点击它将登录 URL 复制到剪贴板，然后将其粘贴到任何浏览器窗口中进行登录。显示的端口（localhost:PORT）是系统托盘正在监听的本地回调地址——浏览器会在您登录后使用它自动传回授权码。
步骤 3 — 记事本打开并显示链接
如果剪贴板也被拦截，TYO Reach 会将登录 URL 写入 %TEMP%\reach-login.txt 并在记事本中打开它。从记事本中复制 URL 并将其粘贴到您的浏览器中。
步骤 4 — 弹出包含链接的对话框
如果无法启动记事本，系统会弹出一个显示完整 URL 的对话框。在对话框内按 Ctrl+C 复制其内容，然后粘贴到文本编辑器中以提取 URL。
每次尝试登录时，登录 URL 也会被写入日志文件——请参阅下文的查找日志文件。
轮询模式
在默认登录流程中，浏览器会在登录后重定向至 localhost:PORT。如果终端防护软件拦截了浏览器的环回连接，这个重定向将永远无法到达，系统托盘会无限期等待。
轮询模式完全消除了对环回连接的依赖。服务器会存储授权码，系统托盘每两秒轮询一次，而不是使用本地回调——无需 localhost 连接。
**要切换到轮询模式：**在系统托盘菜单中按住 Ctrl+点击 登录项。标签会变为：
| 标签 | 模式 |
|---|---|
| 登录 TYO Reach (Sign in to TYO Reach) | 默认（浏览器 + localhost 回调） |
| 登录 (Sign in) | 轮询模式（仅限复制粘贴，无 localhost） |
再次按住 Ctrl+点击 即可切换回来。该模式会一直保持，直到您更改它。
在轮询模式下，点击登录会立即显示上述的复制/记事本/对话框回退流程——系统托盘绝不会尝试打开浏览器或等待 localhost 连接。
查找日志文件
TYO Reach 会按顺序尝试三个位置，并使用第一个可写入的位置：
%LOCALAPPDATA%\TYOReach\reach.log%APPDATA%\TYOReach\reach.log%TEMP%\TYOReach\reach.log
日志的第一行记录了正在使用的路径，例如：
2026/07/19 09:14:01 [log] file: C:\Users\vicky\AppData\Local\TYOReach\reach.log
每次尝试登录都会记录完整的登录 URL，因此如果所有剪贴板和记事本回退方案都失败了，您可以直接从日志文件中提取 URL。
故障排除
| 症状 | 尝试方法 |
|---|---|
| Setup.exe 无法运行 | 右键点击 → 以管理员身份运行，或请 IT 部门将文件添加到允许名单 |
| 安装后系统托盘图标从未出现 | 导航至 %LOCALAPPDATA%\TYO Lab\TYO Reach\ 并双击 tyoreach.exe |
| 点击登录时浏览器未打开 | 按住 Ctrl+点击 登录项以切换到轮询模式 |
| 粘贴登录链接为空（剪贴板被拦截） | 检查 %TEMP%\reach-login.txt——记事本应该已经自动打开了它 |
| 登录无限期卡住 | 切换到轮询模式；该模式下不需要 localhost 回调 |
| 找不到登录 URL | 打开日志文件（见上文）——每次尝试都会将 URL 写入其中 |
仍然遇到问题？请附上您的日志文件联系我们，我们将帮助诊断被拦截的内容。