官方手冊 · 疑難排解

Shadowrocket 疑難排解大全

先確認問題發生在哪個環節，再調整相應設定。本頁依症狀提供系統化檢查流程；若尚未完成首次連線，請先依快速入門指南操作，再根據實際結果查看相關章節。以下內容以使用者已有自己的訂閱或伺服器資料為前提，不提供、不販售或推薦節點與訂閱。

適用於 iPhone / iPad。系統需求請以 App Store 頁面標示為準。介面用語保留英文，位置與可用選項以裝置實際顯示為準；本頁測試結果僅供縮小問題範圍，並不代表線路一定可用。

[General]

開關無法開啟、立即關閉或反覆連線

先分辨系統授權與伺服器問題

在 Home 開啟連線開關後，如果系統詢問是否允許加入 VPN 設定，請先閱讀提示，再依個人意願允許並完成裝置驗證。這個步驟是在系統中建立連線所需的設定，不是購買確認，也不是匯入訂閱。若先前取消了提示，請返回 App 再次嘗試連線；若裝置受管理，系統可能限制加入 VPN，此時應向裝置管理者確認，無法靠反覆修改伺服器位址解決。

觀察開關的實際狀況：完全沒有進入連線狀態，優先檢查授權與裝置限制；短暫進入連線狀態後關閉，可能與設定內容、網路可達性或連線過程中的錯誤有關；開關保持開啟但網頁無法使用，則繼續查看下一章。系統狀態列圖示只能反映部分連線狀態，無法證明請求已抵達目標。分開記錄這些現象，比籠統描述「打不開」更有助於找出問題。

檢查系統連線與自動觸發條件

前往系統 Settings，搜尋 VPN，查看是否有 Shadowrocket 對應的設定，以及是否有其他 VPN 連線正在使用。先手動中斷不需要的連線，再回到 Home 測試。不要一次刪除所有系統網路設定，其中可能包含工作或學校所需的設定。若 VPN 項目無法編輯、顯示受管理，或系統拒絕加入設定，應先處理裝置管理限制，而不是繼續調整 Config。

如果關閉開關後又自行開啟，請檢查是否啟用 On Demand，以及目前網路是否符合其中的連線條件。為建立手動測試基準，可暫時關閉 On Demand，再自行控制連線；測試結束後依原先記錄還原。自動觸發與手動開關同時作用時，看到「反覆開啟」不一定是 App 故障。也請留意系統是否設有自動連線條件，避免只調整 App 內的單一設定。

以最小幅度變更建立可重現的測試

先確認未連線時裝置能正常上網；需要網頁認證的 Wi-Fi，請先完成該網路的認證頁面。接著回到 Home，明確選取一個已有且參數完整的伺服器，再嘗試連線。若出現設定載入錯誤，先查看提示內容與目前的 Config，不要反覆切換開關來掩蓋錯誤。可暫時使用已確認可用的簡化設定作為對照，但要保留原始設定檔，並記下切換前後的名稱與 Global Routing 狀態。

若只在 Wi-Fi 下失敗，請在允許使用行動網路且留意流量的前提下，以同一伺服器再測一次；反之亦然。伺服器、設定與目標維持不變，只更換網路後結果也改變，表示應優先檢查接入網路。若兩種網路都在相同階段失敗，再確認伺服器參數及服務狀態。不要同時更新訂閱、切換設定和更換網路，否則即使恢復，也無法判斷是哪個步驟起作用。

何時重建系統設定

完成上述檢查後仍無法建立連線，可先中斷連線，正常關閉再重新開啟 App，必要時重新啟動裝置後再測。只有在確認系統 VPN 設定異常、已完成備份且清楚還原方式時，才考慮移除 Shadowrocket 對應設定，並讓 App 重新要求加入。移除系統設定不代表伺服器、訂閱與規則已完成備份；不要把重新授權誤當成設定還原。重新授權後仍須再次確認 Home 中的選取項目。

[Rule]

顯示已連線，但全部或部分請求失敗

先確認基本網路，再檢查請求路徑

先中斷 Shadowrocket，使用同一裝置與同一網路開啟平常可存取的頁面。若仍無法使用，應先處理 Wi-Fi 認證、行動網路權限、路由器或接入網路問題。基本網路恢復後再開啟連線，避免把接入問題誤認為規則故障。若只有某個 App 異常，也請用瀏覽器開啟另一個目標作比較；單一 App 可能有自己的工作階段快取、網域集合或連線方式，不宜直接推斷整體網路失效。

回到 Home，確認目前選取的伺服器，而不只是查看清單中是否有可用項目。清單更新後，原先選取的項目可能已變動，名稱相似也不代表參數相同。接著確認 Global Routing：設定對應 Config，代理對應 Proxy，直連對應 Direct。這三種模式會決定主要請求的處理方式，但不能把任何一種模式視為所有 DNS、系統行為或目標網站狀態的完整證明。

模式	排查用途	結果限制
設定 / Config	依目前設定檢查規則與策略。	也須確認實際啟用的 Config 與比對記錄。
代理 / Proxy	與 Config 對照，檢查伺服器路徑。	成功不代表原設定中的所有規則都正確。
直連 / Direct	比較不經代理伺服器時的請求狀況。	不代表完全退出 VPN 或還原所有 DNS 設定。

透過模式對照縮小問題範圍

固定使用同一個測試頁面與伺服器，先記錄 Config 的結果，再暫時切換至 Proxy 重試。若 Proxy 可用而 Config 不可用，優先檢查該請求比對到的規則與最終策略，而不是立即更換伺服器。若兩種模式都失敗，再檢查伺服器連線、DNS 與目標本身的狀態。測試後還原原本模式，並重新開啟頁面；舊連線可能持續沿用，單次重新整理未必已改走新的路徑。

若 Direct 可存取而 Proxy 失敗，應優先檢查伺服器路徑，但仍須排除網域解析差異與協定參數錯誤。若 Direct 與 Proxy 都無法存取同一個目標，而其他目標正常，可能是目標網站問題，也可能是該目標的共用依賴項失效。請改用另一個獨立目標驗證；不要連續使用幾個實際上依賴同一登入服務或同一資源網域的頁面，並把它們誤當成獨立樣本。

從實際比對到的規則回查 Config

確認 Config 目前啟用的是預期檔案，再查看失敗請求對應的網域、比對規則與處理策略。規則通常依序判斷，前面的比對可能讓後面的精確規則無法生效。特別留意範圍較廣的 DOMAIN-KEYWORD、範圍較大的 IP-CIDR，以及意外指向 REJECT 的項目。以下片段僅用來說明規則順序，不包含可用的伺服器資料，不應直接取代使用者目前使用的完整設定。

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

依此順序，api.example.com 會先由 DOMAIN 指定為 DIRECT；其他符合 example.com 後綴的網域則接著比對 PROXY。區域網路位址與 GEOIP 項目用來說明不同的比對類型，FINAL 則處理前面都未比對到的請求。實際結果也會受到請求可提供的網域資訊、解析結果及設定其他部分影響。不要只憑目標名稱就認定某條規則一定會比對到，應以目前的請求記錄為依據。

只有部分頁面圖片無法顯示或登入失敗

一個頁面通常會涉及多個網域。若首頁文字正常顯示，但圖片、驗證或登入失敗，應分別查看失敗的資源請求，不能只替首頁網域新增規則。先確認是否明確比對到 REJECT，再檢查相關網域是否套用了不同策略。只為已確認的依賴項新增必要規則，避免使用範圍過廣的關鍵字影響其他請求。若無法判斷規則詞的含義，可查閱術語表；首次連線驗證則請返回快速入門指南。

[General]

伺服器逾時、測試失敗與協定參數不相符

分開解讀測試結果與實際存取狀況

Connectivity Test 結果會受到測試方式、測試目標、目前網路與伺服器狀態影響。測試失敗不能單獨證明所有請求都會失敗；測試成功也不能證明所有網頁或傳輸方式都可用。先確認選取的項目，再以明確目標實際存取，並記錄測試結果是否與實際狀況一致。若測試目標本身無法連線，可能出現測試失敗但部分服務正常的情況；應先確認測試設定，而不是只因結果不佳就刪除伺服器。

分辨連線逾時、連線遭拒、驗證失敗與憑證相關提示。逾時通常表示在等待時間內未收到所需回應，但僅憑「逾時」無法判斷是伺服器離線、連接埠無法連線、解析錯誤或中間網路封包遺失。連線遭拒與驗證失敗代表不同線索，請保留原始提示文字。若介面沒有詳細錯誤，也可記錄失敗是立即出現，還是等待一段時間後才發生，供後續比較。

先確認共通欄位，再檢查協定專屬欄位

開啟該項目的編輯頁面或 Add Server，對照既有服務商提供的原始資料，先檢查類型、Address 與 Port。位址欄不應混入不必要的路徑、前後空格或其他協定連結的內容；連接埠必須符合該服務的設定。伺服器顯示名稱只是辨識標籤，修改名稱無法修正位址或驗證資訊。自動匯入的項目也應檢查匯入後的欄位，不能因掃描或訂閱匯入成功，就認定參數組合一定可用。

協定	重點確認	常見誤解
Shadowsocks	Address、Port、Password 與 Method。	密碼正確但 Method 不一致，仍可能連線失敗。
VMess / VLESS	UUID、傳輸方式、TLS 與伺服器要求的附加欄位。	沿用其他項目的傳輸參數，無法構成完整相符的設定。
Trojan	驗證資訊、TLS、伺服器名稱與傳輸設定。	把連線位址與憑證驗證名稱混為一談。
Hysteria2	驗證資訊、TLS，以及目前網路的 UDP 可達性。	一般網頁可用，不代表相關 UDP 路徑可用。

UUID、Password、Method、Host、Path 和伺服器名稱等欄位，都應來自同一份有效設定，不能從不同項目拼湊。某些傳輸方式需要特定路徑或主機名稱，這些值不是任意備註；大小寫、斜線以及是否啟用 TLS 都可能影響連線。VMess 與 VLESS 的欄位差異可參閱協定欄位對照文章，但最終仍應以既有伺服器端的設定要求為準。

遇到憑證與時間錯誤時不要略過驗證

出現 TLS 相關錯誤時，先確認裝置日期與時間是否正確，再核對伺服器名稱是否與憑證相符。連線位址、TLS 驗證名稱與傳輸層 Host 可能各有不同用途，不要為了讓欄位看起來一致，就全部改成同一個值。若憑證已過期或名稱不符，應請既有服務商確認伺服器狀態；關閉憑證驗證會改變安全邊界，不能當成通用修復方式，更不能據此判斷原設定正確。

交叉比對網路與項目，不要反覆重測

保持同一項目不變，在兩個可用網路上各測一次；接著在同一網路中選另一個已有且已確認可用的項目作比較。若所有項目只在一個網路失敗，優先考慮該接入網路的傳輸限制或品質；若只有一個項目在不同網路都失敗，則優先檢查該項目的參數與服務狀態。使用 UDP 的協定還應單獨確認相應的網路條件，不能以一般網頁可開啟來證明其傳輸路徑正常。

向既有服務商反映問題時，提供協定類型、失敗階段、網路類別與已遮蔽敏感資訊的錯誤文字即可。不要公開完整訂閱、UUID、密碼、QR Code 或含驗證資訊的連結。若問題從一次訂閱更新後開始，先比較欄位變化，再決定還原原項目或等待伺服器端修復。測試結果穩定後就停止頻繁重試，保留一個可重現案例；重複測試本身無法修正遠端驗證或連接埠設定。

[General]

訂閱匯入失敗、更新後清空與伺服器重複

分清訂閱網址、伺服器連結與 Config

訂閱通常用來取得或更新伺服器項目，Config 則用於規則及相關設定；不能只因兩者內容都是文字，就從同一個匯入入口匯入。先確認手上的資料是訂閱網址、單一伺服器連結、QR Code 還是設定檔，再使用 App 實際提供的相應入口。匯入成功只代表內容在目前步驟獲得接受，不表示網路連線與伺服器驗證都已通過。若不熟悉首次新增流程，請先依快速入門指南完成其中一種匯入方式。

向服務商重新複製完整網址，留意是否夾帶換行、中文標點、空格或說明文字。連結中的驗證資料屬於敏感資訊，不應透過公開截圖或公用文字處理工具檢查。只確認網址是否完整，不要任意刪除問號後的參數；這些參數可能是訂閱身分驗證的一部分。若網址已失效，請至既有服務商的帳號頁面確認狀態，不要猜測或改寫驗證內容。

分辨請求失敗與內容無法解析

若無法連線至訂閱網址，先確認目前網路能否連到訂閱所在的服務；若請求成功但提示解析失敗，則應重點檢查回傳內容。登入頁面、錯誤說明與帳號狀態提示都可能以網頁形式回傳，網路請求成功不代表收到的是訂閱資料。即使回應狀態看似正常，也應根據錯誤文字判斷。不要把 HTML 頁面存成設定檔繼續匯入，這只會讓取得失敗變成格式錯誤，掩蓋最初的問題。

若訂閱只能透過某個既有可用連線取得，請先確認目前使用的路徑，再單獨更新一份訂閱；若目前清單仍有可用項目，先不要刪除。反之，若訂閱請求錯誤地經過已失效的伺服器，更新可能一直無法完成。確認規則與網路條件後，可改用可用路徑作比較，但不要在 Direct 與 Proxy 之間盲目反覆切換。每次測試都要記錄實際模式與選取的項目。

更新後清空時先保留舊資料

若一次更新後項目數量明顯減少或清單變空，先檢查提示、訂閱來源與帳號狀態，再決定是否繼續操作。訂閱可能暫時回傳空內容，也可能因服務方調整而變更項目。反覆重新整理會讓排查線索被覆蓋；較穩妥的做法是保留現有可用項目與設定副本，並向既有服務商確認此次回傳是否符合預期。若訂閱內容有效但項目參數已變更，應重新確認 Home 中的選取項目，不要只憑舊名稱判斷。

訂閱名稱與伺服器名稱都不能證明服務有效。名稱相同的項目可能有不同連接埠、協定或驗證資訊；名稱不同的項目也可能指向相同服務。更新後首次連線時，請開啟實際項目檢查欄位，尤其是協定類型、TLS 與傳輸相關參數。若 App 提示無法處理某種類型或欄位，應依目前 App 支援範圍與服務方提供的格式確認，不能把所有解析失敗都歸咎於網路品質。

重複項目與多份訂閱管理

同一份訂閱重複新增、手動項目與訂閱項目並存，或多份訂閱包含相同伺服器，都可能導致項目重複顯示。先辨認來源再處理重複項目；不要只依名稱批次刪除，以免一併移除唯一可用的設定。刪除單一項目也不一定會影響遠端訂閱，下次更新時仍可能再次出現。若要長期整理，應明確保留要使用的訂閱來源，再依來源管理更新與移除，避免在多個位置反覆維護同一份資料。

管理多份訂閱時，建議使用能區分來源與用途的本機名稱，分別更新並確認結果後，再處理下一份。一次更新所有訂閱雖然方便，卻不利於判斷哪一份回傳異常。詳細整理方式請參閱多份訂閱管理文章。若訂閱可以更新，但所有項目都無法連線，請前往參數檢查章節；訂閱更新路徑與伺服器連線路徑是兩個不同問題，前者成功不能取代後者的驗證。

[Rule]

速度慢、首次開啟等待久與間歇性斷線

先釐清慢在哪個階段

將「慢」分成幾種狀況：首次開啟前等待較久、頁面主體出現但資源載入緩慢、持續傳輸速度不足、使用一段時間後停頓，以及切換網路後短暫無法使用。這些狀況可能分別與解析、建立連線、目標資源、傳輸品質或舊連線恢復有關。先記錄一種最容易重現的現象，不要只比較單一測試數值。Connectivity Test 的耗時不能直接換算成持續傳輸能力，也不能代表所有目標的存取狀況。

先在中斷連線的狀態下檢查基本網路，並以相同的可正常存取目標、相同內容及相近時間進行比較。避免一邊傳輸大型檔案一邊測試，也不要把不同畫質的影片或不同大小的頁面視為相同負載。測試行動網路時請留意流量與訊號變化；使用 Wi-Fi 則觀察距離、干擾與其他裝置的使用情況。若基本網路本身不穩定，調整規則通常無法解決接入線路的波動。

固定變數比較伺服器與網路

選擇一個已有且確認參數正確的伺服器，在同一網路上存取兩個獨立目標。若只有一個目標較慢，先考慮目標服務或前往該目標的路徑；若多個目標都慢，再換另一個已有伺服器比較。接著保持伺服器不變，更換網路重新測試。這樣有助於區分伺服器、目標與接入網路相關的差異。每組只測必要次數，避免頻繁測速產生額外負載，也避免把短暫壅塞誤認為固定現象。

若只有 Config 模式較慢而 Proxy 正常，請回查規則比對結果與使用的策略，不要立刻修改協定。部分資源可能被分配到不同路徑，造成頁面主體載入快，但登入或圖片載入慢。若 Direct 較快而 Proxy 較慢，也只能表示目前比較中代理路徑存在額外因素，不能證明用戶端本身處理異常。請繼續確認該項目的服務狀態、傳輸方式與網路條件，再決定是否改用其他既有項目。

分辨 DNS 等待、建立連線與持續傳輸

首次存取等待較久，但同一頁面隨後明顯變快，可能與 DNS 快取、連線重用或目標快取有關。請在下一章分別驗證解析與路由，不要把清除快取後的一次存取當成穩定速度。若每次建立新連線都很慢，應檢查 TLS 與傳輸參數；若只有持續傳輸時中斷，則觀察網路是否切換、伺服器是否中斷，以及問題是否只影響某類流量。應依現象分類記錄，不要一律寫成逾時。

不同傳輸方式對網路條件的要求不同，尤其使用 UDP 時，接入網路的可達性與穩定性可能影響結果。但不能只看協定名稱就判斷速度，必須與既有伺服器端設定相符。不要自行改用其他類型，或任意調整頻寬、連線相關參數來追求數值；錯誤設定可能讓原本可用的項目失效。只有服務方明確提供相應設定時，才依其完整欄位建立獨立的比較項目。

切換網路、背景 App 與長連線

從 Wi-Fi 切換至行動網路後，舊連線可能需要重新建立。請等網路狀態穩定後，再重新開啟測試頁面或重新發出 App 請求；舊頁面仍然失敗，不代表新路徑也失敗。若所有新請求都無法恢復，請記錄 On Demand 條件是否有變化，再中斷並重新連線一次確認。不要快速反覆切換網路與開關，否則連線建立、取消與系統網路變化會交錯，難以得到明確結論。

若速度問題只在特定時段出現，記錄當時的網路、伺服器與目標，再於其他時段重複相同測試即可，不必長時間連續測速。若只有某個 App 發生問題，請檢查該 App 是否正在同步或沿用舊工作階段；切換模式後應重新發出請求。保留一組能重現差異的比較結果，比提供大量彼此無關的資料更有用。確認問題來自既有伺服器端或目標路徑後，請將已遮蔽敏感資訊的結果交由相應服務方檢查。

[Host]

DNS 解析異常、區域網路無法連線與規則未比對

先確認是否真的發生解析失敗

網頁提示找不到伺服器、App 在建立連線前失敗，或記錄中出現解析錯誤時，可以從 DNS 方向排查；但 TLS 錯誤、驗證失敗與目標回傳錯誤都不等於 DNS 故障。先用多個獨立網域比較，觀察問題是否只影響單一網域或某類內部名稱。直接把網域換成 IP 存取通常不是有效的驗證方式：HTTPS 憑證、伺服器名稱與虛擬主機仍可能依賴網域，換成 IP 後失敗也不能證明原本解析正常。

先確認基本網路正常，再檢查目前 Config 中與 DNS 相關的設定、[Host] 內容，以及系統是否另有 DNS 設定。若有多處設定，先記錄各自來源，不要同時刪除。App、系統與特定 App 自己的解析行為可能不同；單次請求記錄中沒有顯示網域，也不一定代表完全沒有進行解析。應結合請求類型、實際目標與連線結果判斷，避免只因缺少一個欄位就大幅調整設定。

檢查 DNS 服務的可達路徑

自訂 DNS 位址必須能在目前網路與連線狀態下連線。如果解析伺服器只能透過某條代理路徑存取，而建立該路徑又依賴一個尚未解析的伺服器網域，就可能形成依賴問題。排查時先以已確認可達的原設定為基準，每次只調整一個解析相關選項。不要把多個來源不明的 DNS 位址堆在一起；數量增加不代表每個請求都有可靠的處理路徑。

若切換網路後才出現問題，請檢查是否仍在使用原網路專用的解析服務。例如，內部名稱可能只在特定 Wi-Fi 的 DNS 環境中有意義，行動網路無法解析出相同結果。也請確認是否誤將伺服器端要求的 Host 或伺服器名稱填成 DNS 位址。修改後重新建立相關請求，必要時先中斷再連線，以排除舊工作階段影響；但不要把反覆重新連線當成已清除所有快取的保證。

規則依序檢查，網域與位址分開判斷

DOMAIN 用於比對完整網域，DOMAIN-SUFFIX 用於比對網域後綴，IP-CIDR 與 IP-CIDR6 用於比對位址範圍，FINAL 則處理前面未比對到的請求。它們依據的資訊不同，因此網域規則未比對到時，應先確認請求是否包含可供比對的網域，以及前面是否已有規則先行處理。不要把所有網域規則都改成 IP 範圍；同一網域可能解析到多個位址，同一位址也可能由多個服務共用，範圍過廣會影響其他目標。

[Rule]
DOMAIN,api.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN,blocked.example.com,REJECT
IP-CIDR,192.168.0.0/16,DIRECT
IP-CIDR6,fc00::/7,DIRECT
FINAL,PROXY

此片段刻意示範規則順序問題：blocked.example.com 已在前面的 DOMAIN-SUFFIX 規則比對到 PROXY，因此後面的同名 REJECT 不會達到預期效果。若要單獨處理該網域，應將更精確的 DOMAIN 項目放在後綴規則之前。請先在設定副本中修改，再以實際請求確認比對結果。此處網域僅為語法範例，並非測試服務；位址範圍項目是否適用，也須依使用者的實際網路與現有策略判斷。

區域網路裝置與內部網域專項排查

印表機、家用儲存裝置或內部服務在連線後無法使用時，先中斷連線並確認裝置本身是否可達，再判斷目標是直接位址還是內部網域。位址可達但名稱無法使用，優先檢查解析；兩者都無法連線，則檢查區域網路位址的處理策略、網路隔離與 App 權限。廣播或多點傳播探索與一般單播請求並不相同，新增 DIRECT 規則不一定能恢復自動探索；請分別測試已知位址的存取與裝置探索功能。

在系統 Settings 中查看相關 App 的區域網路權限，並確認裝置是否連接至同一個區域網路；訪客 Wi-Fi 或網路隔離也會讓裝置彼此無法看見。若使用 [Host] 固定對應，請確認該位址仍屬於預期裝置，尤其是在切換網路或路由器重新分配位址之後。不要為了暫時恢復存取，就永久寫入未確認的位址。修正後逐項還原原有 DNS 設定，以找出真正有效的變更，避免長期保留彼此重疊的臨時設定。

[General]

耗電增加、發熱與背景頻繁重新連線

在相近使用負載下比較，不要只看百分比

系統電池頁面中的占比，是所選時間範圍內的相對結果，不是某個 App 固定消耗的電量。裝置總使用量、螢幕亮度、訊號、背景同步與其他 App 活動都可能改變占比。先在系統 Settings 的電池資訊中查看活動時段，再對照問題發生時的實際操作。不能只因 Shadowrocket 出現在清單中就認定有異常，也不能直接比較使用負載完全不同的兩個時段。

建立短時間比較時，盡量維持網路、螢幕狀態、前景 App 與使用內容相近，並記錄是否正在傳輸大量資料、更新訂閱或執行診斷。若中斷連線後仍明顯發熱，應先檢查其他持續活動與基本網路，而不是只修改規則。電池健康度、裝置溫度與充電狀態也會影響使用體驗；排查目的是找出可重現的變化，不是根據一次觀察推算用戶端應有的固定耗電量。

先檢查訊號弱與反覆重新連線

訊號弱、Wi-Fi 邊緣涵蓋範圍或頻繁切換網路，都可能使連線不斷重建。若裝置在不同網路間來回切換，先固定使用一個穩定網路觀察；若特定伺服器反覆失敗，可改用另一個已有且確認可用的項目比較。連線無法建立時，持續嘗試可能造成額外網路活動，應先處理失敗原因。不要為了維持表面上的連線狀態而縮短重試間隔，也不要讓無人使用的測試長時間重複執行。

檢查 On Demand 是否因目前網路條件而持續觸發，以及是否出現手動關閉後又自動連線的情況。可暫時關閉 On Demand 建立基準，再手動連線測試；測試結束後恢復需要的條件。自動連線規則應符合實際使用需求，不要為了排查而把所有網路都設為持續觸發後忘記還原。若系統另有其他自動 VPN 連線條件，也應一併記錄，避免把兩種來源的行為誤認為同一個 App 在反覆重新連線。

觀察實際請求，別把背景流量誤當故障

前景 App 關閉後，系統同步、訊息連線或其他背景請求仍可能繼續。若可用的連線記錄顯示活動持續發生，先辨認請求來源與時間，確認是否和照片、檔案或其他同步工作同時進行。持續有流量不代表連線元件異常；只有請求反覆失敗並持續重試，才需要追查相關網域、規則與伺服器路徑。不要為了減少可見請求而批次加入 REJECT，誤擋依賴項反而可能增加重試。

某些診斷設定會增加記錄量。排查時可視需要短暫啟用，重現一次並儲存已遮蔽敏感資訊的資料後，再恢復日常設定；不要長期維持詳細記錄、連續測試與頻繁手動更新訂閱。記錄檔也可能包含網域、位址等個人網路資訊，分享前應先檢查內容。若問題只在啟用某項診斷功能後出現，可單獨關閉該功能作比較，同時保持其他變數不變，以免失去判斷依據。

規則、使用負載與還原順序

若只有使用某個 App 時耗電明顯增加，先確認該 App 是否正在執行高負載工作，再檢查相關請求是否持續失敗。Config 中不合適的 REJECT 或路徑選擇可能使 App 反覆連線，但不能因此斷定規則越少就越省電。請針對已確認的失敗請求調整單一規則，並觀察功能與請求是否恢復。不要任意移除整份規則檔或關閉必要的 TLS 驗證，這些操作會大幅改變設定範圍，超出目前耗電問題所需。

有效的比較應包含開始狀態、使用內容、是否連線、目前網路與結束時的現象，不必公開完整使用記錄。若在穩定網路、已確認可用的伺服器與一般設定下仍能重現異常，可再使用簡化設定副本測試，並記錄問題是否只發生於特定服務。若裝置持續異常發熱，應先停止高負載與連續診斷，依照系統提示處理裝置溫度；狀態恢復正常後再繼續，避免讓測試本身成為額外負載。

[General]

更新後異常、設定還原與 iPad 專項檢查

先確認變更來自 App、系統還是設定

問題在更新後發生，不代表原因一定是更新本身。先回想同一時間是否也更新了訂閱、切換了 Config、更換網路或修改系統權限。分別記錄 App 更新、系統變更與設定內容變動，再依前文流程建立最小測試。不要臆測無法確認的原因，也不要在未備份時連續重新安裝。若錯誤與特定 Config 直接相關，應先比較設定內容，而不是從購買狀態開始排查。

App 的取得與更新一律透過 App Store。若要確認產品，請使用正版核驗說明檢查官方圖示、開發者 Shadow Launch Technology Limited 與 App ID 932747118。系統需求請以 App Store 頁面標示為準。若 App 已能正常開啟但伺服器連線失敗，通常還需要檢查連線參數與服務狀態；購買紀錄正常不代表訂閱仍有效，也不代表遠端伺服器維持可用。

先備份，再執行可還原的復原操作

修改或復原前，分別確認伺服器項目、訂閱來源與 Config 是否各自有可用副本。匯出 Config 不代表已備份所有伺服器驗證資訊；是否啟用同步、同步哪些內容，也應以實際介面與還原結果為準。備份可能包含敏感欄位，請存放在自己可控的位置。操作順序可參考設定備份與移轉文章，但執行前仍須確認目前裝置上的實際選項。

復原時，先建立一個參數明確的既有伺服器項目，完成系統授權並確認基本連線，再還原 Config，最後逐項還原其他設定。若一開始就匯回所有舊資料，發生問題後仍無法分辨來源。每還原一類內容，就用同一個測試目標重新測試並記錄結果；故障再次出現時，從最近還原的範圍開始檢查。這比刪除所有資料後憑記憶重新輸入更容易復原，也能保留仍可用的資訊。

不能只依 iPhone 的結果推斷 iPad 狀況

同一份資料在 iPhone 可用、在 iPad 卻失敗時，先確認兩部裝置是否真的連上相同網路。iPhone 可能正在使用行動網路，iPad 卻仍連著需要認證的 Wi-Fi；具備行動網路功能的 iPad 也應確認實際連線狀態與權限。確認網路條件一致後，再比較 Home 中選取的項目、Global Routing 與正在使用的 Config。不要只比較項目名稱，也應檢查位址、連接埠、驗證資訊與傳輸相關欄位。

iPad 的橫向／直向畫面、分割檢視或視窗配置，可能使入口位置與 iPhone 不同，但不代表功能不存在。請依 Home、Config、Settings 等實際介面用語尋找相應項目，不要照著截圖座標逐一點選。首次新增 VPN 所需的系統授權，必須在該裝置上個別完成；另一部裝置已允許，不代表目前的 iPad 也已授權。系統 Settings 中的區域網路權限與受管理限制，也應在 iPad 上逐項確認。

分別處理換機後的購買還原與設定還原

更換裝置後，請在 App Store 使用原購買帳號查看已購項目，並依頁面指示重新取得；可用性、相容性與購買權益請以商店頁面標示為準。App 重新出現，不代表原有伺服器、訂閱與 Config 都會自動完整還原。購買還原方式請參閱已購項目還原說明；設定則依自己保存的副本逐項確認。不要為了修復連線問題而重複付費，先確認目前缺少的是 App 購買權益還是使用資料。

若 iPad 只有在存取印表機或內部裝置時失敗，請回到 DNS 與區域網路章節檢查權限、網路隔離及內部名稱解析；若只有在鎖定畫面或切換網路後異常，請回到耗電與 On Demand 檢查流程。最後整理一份已遮蔽敏感資訊的記錄：裝置類型、網路類別、是否建立連線、使用的模式、故障階段與單一變數比較結果。保留錯誤文字，移除密碼、UUID、完整訂閱與 QR Code，即可整理成可重現且不會洩露驗證資訊的問題說明。