受管 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 寫入其中 |
仍然遇到問題？請附上您的日誌檔案聯絡我們，我們將幫助診斷被攔截的內容。