先判斷：導入失敗，還是導入後連不上？
一次連接通常涉及四步：在帳戶中取得訂閱、用戶端下載配置、讀取節點、啟用連接。記錄哪一步報錯，有助於避免反覆換節點或重裝用戶端。
| 現象 | 先檢查 | 檢查結果 |
|---|---|---|
| 一鍵導入沒有打開用戶端 | 用戶端是否安裝；改用應用內粘貼訂閱 | 應用跳轉失敗，不等於訂閱失效 |
| 下載或更新失敗 | 鏈接是否完整、訂閱是否有效、當前網絡能否獲取配置 | 先解決獲取配置的問題，再檢查格式 |
| 能下載，但提示格式錯誤 | 複製的格式是否匹配用戶端；用戶端版本與日誌 | 返回內容與用戶端預期可能不一致 |
| 能導入，但沒有節點 | 是否激活正確配置；訂閱更新與帳戶狀態 | 配置被保存，不代表有可用線路 |
| 有節點，但網頁打不開 | 節點選擇、連接開關、代理模式與出口 | 進入連接排查，不繼續按格式錯誤處理 |
選對格式：從對應用戶端按鈕複製
HKUVPN 的工作空間按用戶端提供複製與一鍵導入入口。Clash Verge Rev、FlClash 使用 Clash 訂閱；Shadowrocket 使用小火箭 / 通用訂閱。複製顯示給你正在使用的用戶端的鏈接，比自行改寫地址更可靠。
訂閱鏈接、帳戶登入頁面和一鍵打開應用的地址承擔不同工作。需要粘貼訂閱 URL 時，使用工作空間的複製鏈接按鈕；一鍵導入由瀏覽器把配置交給已安裝的應用。二維碼或截圖上被遮住的地址不能代替完整複製結果。
- iPhone / iPad：先查看小火箭教程，複製對應訂閱。
- Windows、Mac 或 Linux 使用 Clash Verge Rev：選擇 Clash 訂閱。
- Android 使用 FlClash：選擇 FlClash 入口，或在應用內導入對應 Clash 鏈接。
更新失敗：核對完整鏈接與當前訂閱
先在帳戶中核對訂閱是否開通、是否到期以及流量是否用盡，再重新複製當前鏈接。聊天軟件換行、截圖遮擋或只複製顯示用的縮短地址，都可能使導入拿到不完整的信息。若你已經重置過訂閱憑據，請重新複製當前鏈接。
打開另一條普通網頁，只能說明某條網頁連接可用，不能證明用戶端能下載訂閱。記錄更新的時間與錯誤；若更換網絡測試，請一次只改變網絡，保留同一個用戶端與鏈接，方便判斷差異。
如果收到的是登入網頁、錯誤頁面或需要重新認證的提示，先處理鏈接與帳戶狀態。把 HTML 頁面當成配置導入，可能表現為格式錯誤。不要把含憑據的鏈接貼到公開轉換網站或搜尋框。
格式錯誤或沒有節點：檢查配置與用戶端
先核對格式與設備教程中的用戶端名稱。Clash Verge Rev 的官方教程分別說明鏈接導入、URL Schemes 與本地配置導入；保存訂閱後，還需要確認正在使用的配置。只看到訂閱卡片，不足以判斷其中的節點已成功讀取。
若用戶端或內核不識別配置中的某項設定，先查閱該用戶端的官方版本說明與日誌。保留報錯文字，按本站設備教程下載匹配設備架構的官方安裝包。不要靠刪掉未知字段來掩蓋錯誤，也不要跳過證書校驗。
更新完成仍看不到節點時，核對是否啟用了剛更新的配置，以及帳戶當前是否有可用線路。服務端返回內容、用戶端解析和帳戶分配是不同檢查點；記錄結果後提交支持工單，能夠減少來回追問。
導入成功以後：確認連接是否真正生效
選中節點並開啟用戶端的連接功能，再使用 IP 檢測頁核對當前瀏覽器的出口。系統代理、TUN 與應用自己的代理設定不是同一件事；一個瀏覽器的結果也不能證明終端或每個應用採用相同路徑。
看到節點延遲，只能說明該項測試得到了結果。繼續檢查網頁請求與實際出口，再記錄當前網絡、用戶端版本和協議。遇到 AI 網頁、API 或帳戶錯誤時，轉到對應排查指南，而不是把每一種報錯都歸為訂閱失效。
提交支持：保留診斷信息，遮住個人憑據
已有帳戶可登入 HKUVPN 工作空間提交工單。寫明設備與系統版本、用戶端與版本、使用的訂閱格式、失敗步驟、報錯文字和測試時間。截圖中遮住完整訂閱 URL、節點密碼、API key、郵箱驗證碼及其他個人資料。
Clash Verge Rev 的官方文檔說明了日誌導出入口。日誌同樣可能包含地址與配置資料，提交前先檢查內容。尚未使用 HKUVPN 的讀者可先比較公開套餐、設備支持和服務範圍；安裝免費用戶端本身不會開通線路。