Shadowrocket 故障排查
連線、訂閱與規則

開關無法啟用：先檢查授權與系統限制

開關立即跳回關閉、長時間停留在連線中，以及 App 直接關閉，是三種不同情況。先記下問題發生在哪個步驟：是否尚未出現系統授權提示、剛允許加入 VPN 設定，或是選定某個伺服器後才失敗。此時不要刪除所有訂閱，也不要連續點選連線。先中斷連線，等待系統狀態穩定，再確認一般瀏覽器能否透過目前網路開啟原本可存取的頁面。基礎網路尚未恢復前，伺服器測試和規則調整都缺乏可比較的條件。

確認 VPN 授權已完成

首次連線時，系統可能會要求允許加入 VPN 設定，並以裝置密碼或系統驗證確認。取消提示不會完成授權；App 內開關短暫變化也不能取代系統確認。返回 Home 再發起一次連線，仔細閱讀整個提示視窗。接著在系統 Settings 中尋找 VPN，確認是否已有對應設定。不同系統版本的選單名稱與層級可能不同，可使用設定搜尋功能定位。若設定已存在但始終無法啟用，先中斷連線，再考慮只移除該 VPN 設定並重新授權；保留 App 內的伺服器與 Config。

裝置受公司或學校管理時，管理政策可能限制新增 VPN、網路延伸功能或背景連線。這類限制需要向管理單位確認，重新匯入訂閱無法改變系統政策。不要移除用途不明的管理描述檔。若同一裝置還有其他 VPN 連線，或使用依賴本機 VPN 的網路過濾功能，先暫停其中一項，再單獨啟動 Shadowrocket；同時變更多個網路工具的狀態，會讓失敗原因難以判斷。

排除自動重新連線與設定錯誤

On Demand 可能會在手動關閉後重新建立連線，也可能在網路變更時再次嘗試。若要觀察完整的手動連線流程，先暫時關閉 On Demand 並記下原本的條件，測試結束後再還原。若開關只在選取某筆伺服器資料時跳回關閉，請檢查 Add Server 是否缺少位址、連接埠或協定的必要參數。訂閱名稱正常顯示，不代表每筆資料都完整；匯入時未識別的欄位，仍須逐項比對使用者原有資料。

若 App 可以正常開啟，但系統遲遲沒有授權結果，先關閉連線並結束 App，再重新開啟；仍未改善時，重新啟動裝置。重新啟動是為了清除暫時的延伸功能狀態，不代表設定一定正確。重新啟動後只測試原本那筆資料，不要同時更新訂閱或更換規則。若恢復正常，觀察下次鎖定螢幕或切換網路時是否再次發生；若仍然失敗，繼續檢查儲存空間、系統限制和目前設定，不要反覆重新安裝。

區分安裝遭封鎖與連線故障

若 App 完全無法開啟，應先處理安裝問題，不必繼續排查網路。Shadowrocket 支援 iPhone、iPad、Mac、Windows、Android 與 Linux。iPhone / iPad 版在 App Store 售價 $2.99，一次性付費；Mac（Apple 晶片與 Intel）、Windows、Android、Linux 版免費。iPhone / iPad 的系統需求以 App Store 頁面標示為準；其他平台的安裝檔請從本站下載頁取得，實際檔案由本站 /dl/ 提供。

桌面版與 Android 安裝檔沒有程式碼簽章，首次開啟時可能遭系統封鎖。確認檔案來自本站後，Windows 可在 SmartScreen 的「更多資訊」中選擇「仍要執行」；Mac 可在「隱私權與安全性」中允許這次開啟；Android 則依系統提示，允許目前使用的瀏覽器或檔案管理工具安裝未知應用程式。Linux 也需確認檔案權限與套件格式。詳細安裝步驟請參閱安裝封鎖處理說明，不要試圖靠反覆修改規則解決安裝問題。

連線後無法上網：分別檢查隧道、伺服器與分流

連線狀態正常但頁面無法開啟時，先確認是所有請求都失敗，還是只有部分網域無法使用。先關閉 Shadowrocket，再開啟平時可直接瀏覽的頁面；若仍無法使用，優先檢查路由器、行動數據、無線網路認證或系統代理設定。飯店、訪客網路等環境通常需要先在瀏覽器完成網路認證；若過早建立隧道，認證頁面可能無法顯示。完成認證後再開啟連線，避免把網路入口尚未通過認證誤判為伺服器故障。

使用 Global Routing 進行短時間對照

確認基礎網路正常後，選取一筆使用者已有且資料完整的伺服器紀錄，並在相同目標、相同網路下進行對照。Global Routing 的 Config、Proxy、Direct 分別代表依設定處理、經代理連線及直接連線。切換模式是為了縮小問題範圍，不是長期修復方式。每次切換後都要重新發出請求；舊頁面可能沿用既有連線或快取，僅憑畫面是否顯示舊內容並不可靠。

若 Direct 下的一般頁面正常、Proxy 下同一頁面失敗，請優先檢查伺服器參數，以及伺服器通往目標的路徑。若 Proxy 正常但 Config 失敗，則檢查目前啟用的 Config、規則順序與策略名稱。若三種模式都失敗，不能立刻認定是規則問題，應回頭檢查基礎網路、DNS 與系統連線狀態。有些網站對不同網路路徑本來就有不同的存取條件，因此至少選兩個用途不同的測試目標，避免根據單一網站的結果推論所有流量。

確認選取項目與實際比對結果一致

Home 中選取的伺服器，不一定是 Config 內每項策略最後使用的伺服器。設定可能引用策略群組，也可能讓部分請求走 DIRECT 或 REJECT。開啟請求紀錄，搜尋剛才測試的網域，核對比對到的規則和最終策略。若完全沒有新紀錄，請確認是否重新發出請求、系統是否仍連線至目前隧道，以及測試中的 App 是否確實使用網路。若有紀錄但策略不符，先修正規則，不要繼續更換伺服器。

檢查 Config 時，先確認目前使用哪個檔案，再編輯副本。規則通常由上而下比對，明確的網域規則應放在較廣泛的規則前面，FINAL 則用於兜底。以下僅示範規則順序；example.com 是範例網域，PROXY 必須能在實際設定中解析為有效策略。不要用這段規則覆蓋現有設定檔，也不要為了測試加入不了解用途的大範圍放行規則。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

依錯誤發生階段決定下一步

若頁面顯示網域解析錯誤，請參閱 DNS 章節；若等待很久後連線逾時，請參閱伺服器逾時章節；若建立連線後出現憑證警告，則核對系統時間、目標網域及伺服器提供的 TLS 參數。不要關閉憑證驗證來掩蓋錯誤。若只有某個 App 失敗，先確認其網路權限、登入狀態與服務是否正常，再用瀏覽器存取同類目標進行比較。

恢復後將 Global Routing 調回原定模式，再檢查一個預期直接連線及一個預期經代理的請求。記下正常結果所對應的網路、伺服器與設定名稱。若只能暫時透過 Proxy 使用，也應保留「Proxy 正常、Config 異常」的判斷，繼續排查分流問題；全域變更請求路徑或許能繞過問題，但並未消除問題。規則比對的詳細說明請參閱自訂規則與 FINAL。

伺服器逾時：依序檢查位址、連接埠與交握階段

逾時表示某個階段未能在等待期限內完成，不代表伺服器一定離線。Connectivity Test 的結果取決於測試方式、目標與當下網路。某種探測成功，只能證明該探測路徑正常；實際瀏覽網頁還涉及 DNS、協定驗證、TLS 與目標網站回應。先分開記錄「完全無法連上伺服器」與「已連線但網頁失敗」，不要把單一測試數值當成所有 App 都可正常使用的結論。

先確認位址與連接埠未被改動

在 Add Server 中核對伺服器位址、連接埠與協定。位址欄通常只需填入伺服器主機名稱或位址，不要連同網頁路徑或說明文字一起貼上；連接埠應與既有資料一致，不要依協定名稱自行猜測。留意複製時帶入的空格、換行與全形標點。若原始位址是網域，還需確認是否能解析；若是 IPv6 位址，則目前網路必須具備相應的連線能力，不能只因其他網頁可開啟就認定此位址也能連線。

同一筆紀錄在無線網路下失敗、行動網路下正常，表示問題與接取網路或路徑有關，應檢查無線網路認證、路由器規則及上游連線。兩種網路都失敗，但使用者已有的另一筆紀錄正常時，優先檢查原伺服器及其參數。若所有紀錄突然同時失敗，先確認基礎網路與共用的 DNS，不要逐筆修改密碼。每輪測試只更換網路或伺服器其中一項，讓結果能明確判讀。

協定參數必須來自同一份資料

不同協定的欄位不可混用。Shadowsocks 請核對加密方式與密碼；VMess、VLESS 請核對使用者識別碼與傳輸選項；Trojan 請核對密碼及 TLS 相關設定。使用者識別碼或密碼即使只差一個字元，也可能導致驗證失敗。匯入連結後仍應檢查重要欄位是否正確辨識，尤其是連結含有跳脫字元或額外傳輸參數時。不要混合其他紀錄的參數，拼出看似完整的新紀錄。

TLS 的 Server Name 可能與連線位址不同，Host、Path 也可能各有用途，不能因名稱相似就全部填入同一個網域。確認系統日期與時間正確；時間偏差可能讓原本有效的憑證看起來尚未生效或已過期。遇到憑證錯誤，應記錄錯誤類別並核對資料，不要任意接受不相符的憑證。協定設定正確與憑證可信是兩個獨立條件，繞過其中一項並不能證明另一項成立。

辨別 UDP 與路徑差異

部分協定或功能仰賴 UDP。Hysteria2 的連線表現可能受目前網路的 UDP 條件影響；WireGuard 也需要正確的金鑰、位址、端點與路由範圍。其他紀錄能正常瀏覽網頁，不代表 UDP 路徑也正常。若只有某種協定失敗，先核對該協定的必要參數與網路條件，不要大幅修改所有伺服器。除非問題能穩定重現且已排除其他因素，否則不要任意調整 MTU 等底層參數。

持續逾時且確認原始參數無誤時，請向使用者既有服務的管理方提供測試時間、接取網路、失敗階段及已去識別化的錯誤文字。不要傳送完整訂閱連結、密碼或金鑰。若連線曾經成功但之後失效，也要確認伺服器端是否變更位址、連接埠或驗證資料。待對方確認後再更新紀錄，避免用舊參數反覆嘗試。最後以實際請求驗證是否恢復，並保留一組可重複的測試步驟，方便下次區分偶發壅塞與持續故障。

訂閱失敗或清單空白：分開檢查取得內容與解析

訂閱更新分為兩個階段：先取得伺服器傳回的內容，再將內容解析為伺服器紀錄。更新錯誤可能發生在任一階段；更新成功但清單空白，也不一定代表網路無法使用。先保留原有紀錄，記下訂閱群組名稱、更新前後項目變化及錯誤提示。App 一次性買斷 ≠ 連線服務方案；安裝或購買 App 不會自動產生伺服器資訊。本站不提供、不販售也不推薦伺服器節點或訂閱，本文僅說明如何檢查使用者已有的資料。

確認複製的內容是否為訂閱網址

向使用者已有的服務提供者重新取得訂閱連結，確認複製的是完整網址，而不是登入頁、管理頁或遭截斷的顯示文字。訂閱網址可能含有查詢參數，刪除末尾部分或將特殊字元改成全形，都可能改變其用途。貼上後檢查前後是否有空格或換行，但不要任意改寫參數順序或解碼內容。若提供的是單筆分享連結，應依單筆伺服器方式匯入，不要誤當成需要定期更新的訂閱。

不要將真實訂閱網址貼到搜尋欄、公開討論區或線上解析網站。網址中可能包含可直接使用的存取憑證。需要記錄錯誤時，只保留協定類型、已去識別化的網域表示方式及錯誤類別。分享截圖前，遮住 QR Code、完整 URL、使用者名稱與可識別伺服器的備註。QR Code 與文字連結可能帶有相同權限，只遮住其中一項並不足以保護資料。

確認網路請求是否確實取得內容

若更新提示逾時，先檢查訂閱網域能否在目前網路解析，再確認取得訂閱時使用的連線路徑。有些情況下，原有伺服器已無法使用，而更新訂閱又依賴目前的代理路徑，形成無法更新的循環。若基礎網路可用且服務位址允許，可比較中斷連線後的更新結果；也可使用使用者已有的另一筆可用紀錄進行對照。不要預設訂閱一定要經代理或一定要直接連線，實際方式應視網址可達性而定。

若錯誤提示包含狀態碼，請區分其意義：驗證或拒絕存取類回應通常需要核對連結權限；請求過於頻繁時應停止連續重新整理；伺服器錯誤則應交由既有服務的管理方處理。即使回應狀態顯示成功，取得的也可能是登入頁、驗證頁或一般說明頁，而不是訂閱資料。因此，瀏覽器能顯示頁面不代表訂閱內容正確，更不應將整段頁面文字貼入伺服器位址欄。

清單空白時檢查解析與顯示條件

內容已取得但沒有項目時，先清除 Home 中的搜尋條件、展開對應群組，確認清單不是因篩選或收合而顯示為空。接著檢查錯誤訊息是否提到格式不支援、欄位缺漏或內容無法辨識。不同訂閱格式封裝的欄位各異，不能只更改網址副檔名來轉換格式。若需要更換格式，請依使用者既有服務提供的相容格式說明處理，不要把私密連結交給不明工具。

更新後只少了部分紀錄時，應比較缺少項目的協定與參數，確認是服務端移除、名稱變更，還是單筆紀錄解析失敗。不要只根據顯示名稱判斷是否為同一台伺服器，名稱可能重複或變更。若訂閱更新覆蓋了手動編輯的欄位，請停止反覆修改訂閱紀錄，改以可管理的本機副本進行診斷，並留意副本不會自動套用後續變更。具體保存方式依目前介面提供的功能為準。

恢復後確認原本的問題是否已解決

訂閱重新顯示，只能證明內容已取得並完成解析，仍需選取一筆紀錄實際連線。先確認群組中有項目，再核對重要參數，最後存取測試目標。不要同時更新 Config 與所有訂閱，否則無法判斷是哪個步驟恢復正常。若新連結可更新、舊連結不行，確認恢復後應停用舊網址，並向原服務管理方確認舊憑證是否已撤銷。更多故障分支請參閱訂閱更新失敗與清單空白自我檢查；連結類型請參閱分享連結與訂閱連結的差異。

速度慢或間歇性中斷：建立可比較的測試條件

延遲低不代表傳輸量大，傳輸量正常也不表示互動請求回應快。開啟網頁涉及解析、建立連線與等待第一個位元組；下載大型檔案則更受持續頻寬、封包遺失與伺服器負載影響。先描述慢的狀況：開始前等待很久、傳輸一直很慢、播放一段時間後停頓，還是只在鎖定螢幕後中斷。釐清現象後再測試，避免把不同問題都歸結為「速度慢」，接著同時更換協定、DNS 與規則。

固定測試目標、網路與時間區間

選擇大小適中的合法測試資源，在同一接取網路、同一裝置及相近時段進行比較。先暫停系統更新、雲端同步與其他大量傳輸工作，並確認裝置沒有明顯發熱。每次只更換一筆使用者已有的紀錄，或只切換一次 Global Routing，其餘條件保持不變。測速會消耗流量，使用行動數據時應控制測試次數；長時間進行大量流量測試本身可能造成壅塞與發熱，讓後續結果持續變差。

若直接連線的一般頁面也變慢，先觀察無線訊號、路由器負載及上游網路。靠近路由器後有所改善，表示應優先處理區域無線網路狀況；改用其他接取網路後改善，則應留意原網路路徑。若同一台伺服器在不同網路下都很慢，但使用者已有的其他紀錄正常，問題可能出在該伺服器或其出口路徑。此時修改本機規則只能改變路徑選擇，無法提升遠端實際可用頻寬。

區分首次請求慢與持續傳輸慢

首次瀏覽很慢、再次瀏覽明顯加快，可能與 DNS 快取、連線重用或目標內容快取有關，不應只憑這個現象就認定伺服器不穩定。查看請求紀錄中的網域、比對到的策略及錯誤階段。若請求被錯誤導向較迂迴的路徑，修正規則後再測試；若已比對到預期策略，就繼續比較解析時間、連線階段與目標回應。紀錄資訊不足時，應保留「無法判定」的結論，不要猜測耗時。

持續下載時週期性停頓，可能與封包遺失、網路切換、無線干擾、服務端限速或 App 自身的緩衝策略有關。先在裝置保持靜止且不切換網路的條件下重現，再與另一筆既有紀錄比較。若只有某個目標速度慢，也可能是目標網站或其內容傳遞路徑的問題。不要用單一影片或下載網站代表所有存取情況，更不要為了追求某次測試數值而頻繁更改長期設定。

連線中斷時保留連線狀態與時間順序

發生連線中斷時，先確認系統 VPN 狀態是否改變，再檢查 Shadowrocket 是否仍顯示已連線。狀態維持不變但新請求失敗，與系統隧道已中斷，應採取不同的排查方式。前者檢查伺服器、DNS 與既有連線；後者檢查網路切換、On Demand、系統限制與 App 異常。記下中斷是否緊接著鎖定螢幕、從無線網路切換至行動網路、啟用熱點或進入低耗電模式；時間上的關聯往往比單次測速更有參考價值。

部分連線切換網路後不會自動恢復，需要由 App 重新建立。此時先重新發出一個小型請求，確認新連線能否成功，再決定是否中斷後重新連線。若只有舊下載工作停住，但新頁面可以開啟，表示舊工作階段可能已失效，不一定是整個隧道無法使用。強制重新連線會中斷其他正常工作階段，因此應先判斷影響範圍，再採取行動。

用 Data 輔助判讀，不把統計資料當成診斷結論

Data 的流量數據可協助發現背景大量傳輸，但統計方式、時間範圍與重設時間都會影響判讀。某台伺服器累積流量高，不代表目前速度快；某個 App 流量低，也不代表沒有連線失敗。先確認統計口徑，再對照實際測試時段。依伺服器及 App 查看資料時的注意事項，請參閱Data 頁面流量統計說明。若要重設統計，先保存原始數值，避免清除用於比較的線索。

DNS 或規則比對異常：區分網域、位址與策略

DNS 負責將網域解析為位址，規則則決定請求採用哪條路徑；兩者彼此相關，但不能互相取代。網域無法開啟，可能是解析失敗，也可能是解析正常但目標連線失敗。某個位址可以連線，也不代表網域路徑完全正常，因為 HTTPS 通常需要正確的網域與憑證。不要直接把網頁網域改成位址來判斷所有問題，也不要一看到解析錯誤，就同時加入多個不熟悉的 DNS 位址。

先確認問題發生在哪個層級

重新瀏覽目標並查看請求紀錄：是否顯示網域、是否取得位址、最後使用哪項策略，以及錯誤發生在解析前還是連線後。若多個不相關網域都解析失敗，應檢查目前的 DNS 設定及其可連線路徑；若只有一個網域失敗，則考慮該網域本身、快取或對應規則。測試目標最好包含平時可正常開啟的一般網域，作為比較基準，而不是只檢查原本就有存取條件差異的目標。

加密 DNS 也必須能連線至對應的服務端；某些情況下，還需要先解析該服務端的網域。若 DNS 請求的出口依賴一條無法使用的代理路徑，可能會造成所有網域同時解析失敗。檢查時應分開記錄「使用哪台解析伺服器」和「如何連線至解析伺服器」。不要只依協定名稱推斷一定可用，也不要為了暫時排查而永久關閉系統或設定中必要的保護。

檢查規則順序與策略引用

規則由上而下比對，通常會先執行第一個符合項目。DOMAIN 用於完整網域，DOMAIN-SUFFIX 用於網域後綴，IP-CIDR 用於位址範圍，FINAL 則處理前面規則都未比對到的請求。網域規則與位址規則的判斷依據不同；涉及位址判斷時，還需考量是否已取得位址，以及設定選項如何處理解析。排查時先以明確網域進行小範圍測試，不要直接加入範圍過大的關鍵字規則。

[Rule]
DOMAIN,intranet.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
GEOIP,CN,DIRECT
FINAL,PROXY

此片段示範具體規則要放在較廣泛的規則前面：intranet.example.com 會先符合第一條，而不是後面的相同後綴規則。GEOIP 使用位址歸屬資料，不等於判斷網站使用語言、營運地區或內容類型，而且資料可能與實際出口情況不同。PROXY、DIRECT 與 REJECT 分別代表不同策略；實際設定中的代理策略也必須能正確引用可用伺服器。即使規則正確，若策略指向失效的紀錄，仍然無法存取。

分別檢查 IPv4、IPv6 與區域網路網域

有些網域會同時回傳 IPv4 與 IPv6 位址，但目前網路或伺服器可能只有其中一種位址類型運作正常。若情況會隨接取網路改變，請檢查位址類型的差異，避免直接斷定「DNS 回傳錯誤」。區域網路裝置也可能依賴路由器的本機解析或特定搜尋網域；改用外部解析後，一般網站正常，但印表機、檔案服務或內部網域可能無法使用。這是解析範圍改變，不應透過將所有請求改走代理來處理。

修改 DNS 或規則後，必須重新建立連線並發出請求；舊連線與快取可能持續影響結果。先等待相關狀態更新，再以相同目標測試，必要時重新啟動測試中的 App。清除快取只能用來排除舊狀態，並非長期解決方式。確認恢復後，保存修改前後的差異、移除為測試加入的暫時規則，並檢查區域網路存取是否受影響。若仍無法判斷原因，提供已去識別化的比對規則、位址類型與錯誤階段，比只說「網域打不開」更有助於後續排查。

耗電與更新後異常：先恢復穩定基準

耗電量突然增加時，應配合網路活動與觀察時段判斷。系統可能會將隧道承載的網路活動歸類至相關 App，耗電排名較高本身不足以證明發生故障。先在使用強度相近的情況下比較電量變化、螢幕使用時間、行動訊號、裝置溫度與流量，再檢查是否持續重新連線。更新後出現異常時，也應先確認設定是否改變，不要只因時間先後就認定兩者有因果關係。保留原有設定，有助於判斷是網路環境還是本機狀態改變。

找出持續活動，不要只看耗電排名

暫停下載、雲端備份、媒體上傳與連續測速，等待裝置降溫後，再觀察一段時間的一般使用情況。行動訊號微弱、分享熱點及頻繁切換網路都會增加系統負載，應與用戶端行為分開考量。若關閉其他大量傳輸活動後明顯改善，繼續檢查產生流量的 App；若閒置時仍明顯發熱，則留意是否持續連線失敗、反覆更新訂閱或重複發出請求。沒有明確證據時，不要刪除所有伺服器來嘗試「清理」。

若 On Demand 的條件會隨目前網路頻繁變動，可能反覆觸發連線。先記下原有條件，暫時關閉自動連線並維持手動連線進行觀察。若情況改善，再逐項還原條件，找出與異常相關的設定。不要把永久關閉連線當成修復方式，也不要同時關閉所有系統網路功能。若需要全天候連線，應在穩定條件下重新驗證鎖定螢幕、喚醒與網路切換情況，不要只完成前景短暫測試就結束排查。

減少診斷過程額外造成的負擔

長時間記錄詳細日誌、頻繁探測大量伺服器與不斷重新整理訂閱，都可能產生額外活動。只在重現問題的時段保留必要診斷資料，定位後還原一般設定。日誌可能包含瀏覽網域與連線資料，匯出前請先檢查並去識別化。記錄應涵蓋「開始測試、觸發問題、結束測試」的短時間範圍；記錄過長會增加處理負擔，也容易淹沒真正有用的錯誤資訊。

若裝置儲存空間不足，系統與 App 更新、快取寫入及設定儲存也可能受到影響。先透過系統儲存空間管理，釋出已確認可刪除的內容，再重新啟動 App。不要手動刪除用途不明的內部檔案。測試耗電時尤其應避免邊充電邊比較溫度，因為充電過程本身會改變熱狀態。每輪測試應維持相近的亮度、網路與 App 使用情況，才能判斷調整是否持續有效，而不是偶然波動。

分開比較更新前後的 App 與設定

App 更新、訂閱更新與 Config 更新是不同操作。回想異常發生前實際進行了哪一種：只有 App 改變，還是伺服器參數與規則也同時變更。先確認目前選取的伺服器及啟用的 Config，並檢查 Global Routing 是否符合原本預期。若 Proxy 正常但 Config 異常，優先比較設定差異；若所有模式都失敗，則回頭檢查基礎網路與伺服器參數。不要為了確認更新問題而反覆解除安裝，因為解除安裝可能一併移除尚未備份的資料。

iPhone / iPad 的 App 更新由 App Store 管理；Mac、Windows、Android 與 Linux 的新版安裝檔請從客户端下载頁取得。若重新安裝時遇到系統封鎖，先確認檔案來自本站，再依下載頁的安裝封鎖處理步驟操作。安裝前請保存現有 Config、手動新增的伺服器及必要備註。備份檔包含敏感資料，應存放在自己能妥善管理的位置，不要上傳至公開空間。

復原順序與重現紀錄

需要重新建立測試環境時，先完成系統授權，只匯入一筆使用者已有且參數明確的紀錄，確認實際存取正常後，再加入原有 Config，最後還原訂閱與 On Demand。每一步都檢查同一個目標，並記錄從哪一步開始失敗。如此可區分 App 基本連線、伺服器資料與複雜設定三個層次。若匯入完整備份後立即重現問題，但單筆紀錄正常，應檢查備份中的設定，不要繼續反覆安裝。

回報更新後異常時，請說明裝置型號、系統環境、網路類型、失敗步驟與已去識別化的錯誤文字；App 資訊應從目前介面查看，不要憑印象填寫。尤其要說明「是否能穩定重現」及「使用最小設定時是否仍會發生」。恢復後保留一份已驗證的設定，並在下次調整前建立副本。日常維護不必頻繁重設，重點是每次變更都有紀錄、可以復原，並確認原有使用情境仍正常。

iPad 專項檢查：設定同步不代表使用環境相同

同一份資料在 iPhone 正常、iPad 失敗時，先比較兩台裝置的網路與系統授權，不要直接認定平板需要另一種協定。即使連線至同名無線網路，也可能位於不同的訪客網路，或採用不同的位址類型與管理政策。先讓兩台裝置使用盡可能一致的接取條件，分別中斷連線以驗證基礎網路，再選取同一筆使用者已有的伺服器進行短時間測試。比較時保持 Global Routing 設定一致，避免把設定差異誤判為裝置差異。

確認 iPad 已自行完成首次授權

另一台裝置曾完成的 VPN 授權，不能取代這台 iPad 的系統確認。首次啟動連線時，應在 iPad 上完整允許加入 VPN 設定並完成系統驗證。若沒有出現提示視窗，請檢查系統中是否已有對應設定，以及是否受到裝置管理限制。學校或公司配發的裝置可能套用特定網路政策，不能藉由重複匯入訂閱繞過。若不清楚管理限制內容，應先聯絡管理單位確認可用條件。

螢幕較大、視窗可並排，不會改變連線的系統層級性質。將 App 切到背景或移出目前視窗，不代表 VPN 已中斷；反過來，前景顯示 Home 也不能證明系統仍有有效隧道。觀察時應同時核對系統 VPN 狀態與 App 內的連線狀態，再重新發出請求。若只有切換視窗後舊頁面停住，先嘗試新請求，區分舊工作階段失效與整體連線中斷。

逐項比較伺服器與 Config

匯入相同訂閱後，兩台裝置可能選取不同紀錄，或其中一台尚未更新。先比較伺服器名稱以外的協定、位址、連接埠與重要傳輸參數；憑證只在本機核對。接著比較啟用的 Config、Global Routing 與策略群組選擇。檔名相同不代表檔案內容一致，手動修改或後續更新都可能造成差異。只看清單外觀一致，無法證明實際請求路徑相同。

若透過 Scan QR Code 匯入，請確認掃描的是伺服器資料還是訂閱連結，兩者後續更新方式不同。透過分享功能傳送資料時，也要確認內容完整。匯入成功後，在 Add Server 中檢查必要欄位，再實際測試存取；不要把「清單中已出現一筆紀錄」當成設定完全正確。分享 QR Code 時請留意周遭環境，QR Code 中可能含有與文字憑證相同的敏感資訊。

檢查區域網路與網路切換情境

iPad 常搭配印表機、檔案服務及其他區域網路裝置使用。一般網頁可用但區域網路資源無法存取時，請檢查目標位址範圍是否走 DIRECT，以及本地域名是否仍以原方式解析。區域網路網段不一定是 192.168.0.0/16，應以實際網路為準，不要直接複製範例規則。若 App 要求區域網路權限，請依實際用途決定是否允許；VPN 狀態正常不能取代 App 所需的系統權限。

具備行動網路的 iPad 從無線網路切換至行動數據後，原有連線可能需要重新建立；僅支援無線網路的裝置則可能在喚醒後重新接入網路。觀察故障是否固定在切換或喚醒後發生，並在網路穩定後發出新請求。若重新連線後恢復正常，接著檢查 On Demand 條件及伺服器對路徑變化的反應。不要在切換過程中同時更新訂閱，否則兩個事件重疊，難以判斷真正的觸發因素。

已購項目復原與可執行的回報清單

更換裝置或重新安裝時，先確認 App Store 使用原購買帳號，再到已購項目中尋找 App。商店購買復原與 App 內伺服器資料復原是兩回事：前者處理 App 的取得，後者需要使用者自行保存的設定或訂閱。iPhone / iPad 版在 App Store 售價 $2.99，一次性付費，兩種裝置通用；Mac、Windows、Android、Linux 版免費。商店顯示資訊與系統需求以 App Store 頁面標示為準，復原步驟請參閱已購項目說明。

回報 iPad 專項問題時，請依序說明基礎網路是否正常、VPN 授權是否完成、同一筆紀錄在另一台裝置是否可用、三種模式的對照結果，以及問題是否只在鎖定螢幕或切換網路後發生。附上已去識別化的比對規則與錯誤類別，不要附上完整訂閱或 QR Code。這些資訊足以讓後續排查從已知範圍繼續，不必從頭猜測。若尚未完成首次匯入，請先回到快速入門流程；若已能連線但部分請求失敗，請回到本頁的連線與分流檢查繼續排查。