Shadowrocket 故障排除完整指南

確認開關在哪個步驟失敗

在 iPhone / iPad 上，Home 顯示 Not Connected 代表尚未建立連線，不表示訂閱一定有問題。先關閉自動重新連線條件，手動操作一次開關，觀察系統是否要求加入 VPN 設定檔。若尚未確認權限提示，請返回系統提示並完成驗證；若開關短暫啟用後又復原，記下維持時間及隨後出現的錯誤，不要連續反覆點按。

接著中斷用戶端連線，在瀏覽器開啟平常可瀏覽的網頁。若基本網路也無法使用，先完成 Wi-Fi 登入、檢查行動數據或重新連線。需要網頁認證的公共 Wi-Fi，應先在中斷連線時完成認證，再測試連線。裝置能連上無線基地台，只代表區域網路連線正常，不能證明已能存取網際網路。

檢查 VPN 設定檔與系統管理限制

iPhone / iPad 可在系統設定中搜尋 VPN，確認是否存在對應設定檔，以及是否有其他 VPN 正在連線。先停止可能衝突的連線，再返回 Shadowrocket 重試。不要只憑名稱刪除公司、學校或裝置管理機構安裝的設定檔；受管理裝置可能禁止新增 VPN，需由裝置管理員確認允許的連線方式。重新匯入伺服器資料無法解除系統限制。

若先前拒絕過授權，請重新發起連線並留意系統提示；若系統中有失效的 Shadowrocket VPN 設定檔，可先備份應用程式內的資料，再移除確認屬於本應用程式的舊設定檔，並由應用程式重新提出申請。系統設定檔與伺服器項目不是同一份資料，刪除前應確認對象，避免一併清除訂閱和規則。完成後先測試手動連線，不必急著恢復自動連線條件。

分別處理權限不足與設定錯誤

在 Mac、Windows、Android 和 Linux 上，先確認應用程式能否正常啟動，以及建立網路通道所需的系統授權是否已完成。Android 請檢查 VPN 連線確認及應用程式的電池限制；桌面系統請檢查目前帳戶權限與安全軟體的封鎖紀錄。只調整 Shadowrocket 對應的授權，不要為了排查而長期關閉系統防護或放寬所有應用程式的權限。

若系統已允許連線，但開關仍立即復原，請改用已備份的最小設定檔，只保留一個既有且參數完整的伺服器項目。暫時停用自訂指令碼、Rewrite 和複雜策略群組，再重新連線。這是為了確認錯誤是否來自設定載入，並不能證明伺服器可用。若最小設定檔可維持連線，再逐項恢復擴充內容，找出導致連線復原的項目。

檢查 On Demand 與競爭中的連線

On Demand 會依系統條件發起連線，可能讓手動關閉後的狀態看起來像是「自動彈回」。排查時先記下原有條件，再暫時關閉 On Demand，確保只發出一次手動連線要求。同時停止其他 VPN、網路過濾或通道功能，測試結束後再分別恢復；多個元件同時接管網路，會讓權限與路由歸屬難以判斷。

若只有鎖定螢幕後或切換網路時中斷，請查看耗電與 iPad 章節，不必繼續刪除伺服器。若每次啟動都出現明確的設定解析錯誤，請檢查設定中的區段名稱、標點及策略引用。比起重新安裝應用程式，對照錯誤原文與上一次成功連線時使用的設定，更能保留線索，也可避免重複輸入敏感的認證資料。

建立可重複的存取比對

所有平台遇到「已連線但無法開啟網頁」時，先固定一個測試頁面和一個瀏覽器。依序記錄中斷連線時、連線後及切換伺服器後的結果，不要同時更換網路和設定。若中斷連線後也無法開啟，可能是目標本身或基本網路有問題；若只有特定應用程式異常，應另行檢查該應用程式的快取、登入狀態與系統網路權限，不能直接歸因於所有流量。

在 Home 確認實際選取的 SERVER，不要只看訂閱清單是否已更新。訂閱包含多個項目時，清單更新不一定代表目前選取的項目也已變更。接著查看 Global Routing，確認目前使用 Config、Proxy 還是 Direct。連線按鈕只表示網路延伸功能已啟動，不代表每個請求都會經過同一台伺服器，也不代表規則已套用預期策略。

透過 Global Routing 隔離規則的影響

暫時切換至 Proxy，以相同目標重新測試。若 Proxy 成功而 Config 失敗，請優先檢查設定、比對順序與策略引用；若兩者都失敗，接著檢查伺服器參數、DNS 和目標服務。Direct 可用來觀察直連路徑，但仍是用戶端中的路由狀態，不等於完全停用用戶端，因此必要時還應中斷連線，再比對基本網路狀況。

核對規則順序與末尾策略

在 Config 下應由上而下檢查規則，先符合的規則會影響後續處理。範圍較廣的 DOMAIN-KEYWORD 或提前出現的兜底規則，可能讓預期的精確規則無法執行。檢查規則引用的策略是否確實存在，並確認目前啟用的是剛編輯的設定檔，而非同名副本。修改後重新建立連線，再發出新請求，以免舊連線繼續沿用原有路徑。

以下片段僅示範規則分段與順序，不能直接取代既有的完整設定。PROXY 是策略引用，必須對應目前設定中可用的策略；本機網段範例請依實際網路調整。FINAL 應放在末尾處理其餘請求，不要放在仍需繼續比對的細項規則之前。測試時一次只調整一條規則，並保留原有順序。

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

從紀錄判斷故障停在哪一層

若應用程式提供連線紀錄，先確認是否出現請求，再查看比對到的策略、目標及錯誤。沒有紀錄可能是請求未進入目前路徑、應用程式沿用既有連線，或紀錄功能未啟用；不能只憑清單空白就認定軟體沒有運作。關閉測試頁面後重新開啟，再發出一次新請求。分享前請隱藏紀錄中的網域名稱與認證資訊，只需保留錯誤類別及時間。

若紀錄顯示已與伺服器建立連線，但目標仍回傳錯誤，應檢查目標服務、帳戶限制或目標端回應，而不是繼續修改本機 VPN 權限。若只有一個網域失敗，請查看 DNS 章節；若所有經代理的請求都逾時，請查看伺服器逾時章節。恢復日常使用前，將暫時使用的 Proxy 狀態改回原先規劃，並再次確認 Config 下的實際行為。

分辨逾時、拒絕連線與認證錯誤

所有平台遇到伺服器逾時，先保留錯誤原文。逾時代表在等待時間內未收到預期回應，問題可能出在網域解析、建立連線、交握或存取目標；拒絕連線通常表示目標位址已有回應，但連接埠不接受此連線；認證失敗則應優先核對使用者欄位。三者的處理順序不同，不能遇到錯誤就一律重填密碼，更不能把每次失敗都解讀為網路速度不足。

先確認伺服器位址沒有協定前綴、空格或複製時帶入的換行，連接埠則應以訂閱或伺服器設定提供的值為準。不要因名稱相似，就把另一個項目的連接埠和認證資料拼在一起。訂閱顯示名稱只是備註，不參與協定判斷；變更項目名稱不會自動改變實際使用的協定、位址和傳輸參數，仍需在詳細資料中逐項核對。

依協定核對成組參數

Shadowsocks 請核對加密方式與密碼；VMess、VLESS 請核對使用者識別碼及伺服器要求的附加參數；Trojan 請核對密碼與 TLS 相關設定。WireGuard 的金鑰、位址和對端資訊也不能與其他協定的欄位互換。請以自己已有的伺服器資料為準，不要把不同教學中的「常用值」當成通用設定，覆蓋現有項目。

區分 TLS 名稱與連線位址

啟用 TLS 的項目中，連線位址、交握時使用的伺服器名稱和傳輸層 Host 可能各有不同用途。將網域名稱改成 IP 後，即使連接埠可連線，也可能因憑證名稱不符而失敗。請先還原伺服器要求的名稱，再確認裝置日期與時間正確；時間明顯錯誤會影響憑證有效期判斷，表現可能與參數錯誤相似。

不要把關閉憑證驗證當成長期解決方式。遇到憑證錯誤時，應優先確認位址、名稱、系統時間及伺服器憑證狀態。若資料只提供訂閱，請先更新並重新匯入一個獨立測試項目，比較欄位差異；不要在原項目上連續嘗試多個猜測值。無法確認的伺服器端參數應向既有服務的管理方查證，不要靠隨機組合尋找可連線的設定。

透過交叉測試定位網路與伺服器問題

固定同一個項目，分別透過 Wi-Fi 和行動數據測試；再固定同一個網路，改用另一個既有且可用的項目。只有一種網路失敗時，應檢查該網路的認證、連接埠或 UDP 可達性；多種網路都只有同一項目失敗時，則應優先檢查伺服器狀態和參數。測試 Hysteria2 等使用 UDP 的路徑時，能瀏覽一般網頁不代表相應傳輸也可用。

Connectivity Test 的結果取決於測試方式，顯示可連通不等於實際服務已成功。建立連接埠連線、完成交握及開啟目標頁面，分別驗證不同階段，因此仍應補做一次實際請求。若伺服器端可查看紀錄，可依測試時間確認是否收到連線、是否拒絕認證，以及是否成功存取目標，避免只憑用戶端統一顯示的逾時訊息判斷所有原因。

先判斷是網址問題還是網路問題

所有平台更新既有訂閱失敗時，先檢查連結是否完整，尤其是問號後面的查詢參數。通訊軟體、電子郵件換行或手動選取文字，都可能截斷網址。不要依訂閱備註名稱重新拼接連結，也不要把服務商登入頁面當成訂閱入口。複製後只在本機核對；訂閱網址通常包含存取憑證，不應放進公開截圖或錯誤回報標題。

記錄更新時的網路和連線狀態。若目前選取的伺服器已失效，而訂閱更新又必須經過該伺服器，就可能陷入無法取得新項目的循環。先在基本網路可用時嘗試更新，必要時改用另一條既有且可用的連線路徑。不要短時間內連續點按，遠端可能限制請求頻率；稍候後在相同條件下重試，才能判斷是否只是暫時沒有回應。

檢查回傳內容，不要只看成功提示

成功取得回應，不代表取得了可解析的伺服器清單。遠端可能回傳帳戶登入頁面、到期通知、存取驗證頁面或錯誤文字。若應用程式顯示格式錯誤，請依回應狀態和錯誤說明確認內容類型，不要直接把整段回應複製到 Add Server。連結能在瀏覽器中顯示文字，也不代表文字格式符合目前匯入入口的要求。

若回傳未授權或拒絕存取，先確認自己的帳戶狀態、連結是否已重設，以及查詢參數是否遺漏。若顯示位址不存在，請檢查是否複製了舊入口；若是遠端伺服器錯誤，可稍後重試並聯絡既有服務的管理方。更新用戶端無法修復遠端帳戶限制，反覆刪除本機設定也不會改變伺服器對該訂閱請求的授權結果。

選擇符合資料格式的匯入入口

Subscribe 用於訂閱網址，Add Server 用於逐項填寫伺服器資料；Scan QR Code 和剪貼簿辨識則取決於實際內容。QR Code 可能包含單一項目，也可能只是網頁網址；掃描成功不代表已匯入可連線的設定。Import from Cloud JSON 也不是所有連結都適用的通用入口，必須符合所提供的資料格式，不能只因名稱相似就互換使用。

訂閱、伺服器清單與完整設定檔用途不同：訂閱主要用來更新項目，設定檔還可能定義規則、DNS 和策略。把規則檔當成節點訂閱，可能會得到空清單；匯入伺服器項目，也不代表已啟用新的分流設定。入口比較請參閱Subscribe、Add Server、掃描 QR Code 與剪貼簿說明，再依實際資料選擇匯入方式。

# 僅示範訂閱網址結構，不可用於連線
https://example.com/sub?token=xxxx

保留原有項目並驗證更新結果

修改訂閱前，先保留舊設定及仍可用的項目，另建測試群組或副本觀察更新結果。更新後核對項目數量變化、所選 SERVER 是否仍存在，以及先前手動調整的參數是否被覆蓋。部分更新會重新產生項目；本機編輯應另外記錄，不要假定每次遠端更新都會保留這些變更，也不要在未備份時清除全部資料。

匯入後清單空白時，也要檢查搜尋條件、群組是否摺疊，以及篩選器是否隱藏項目。若只有部分項目不見，請比較它們的協定與欄位完整性，判斷是來源沒有回傳，還是解析時略過。先開啟一個新項目的詳細資料並發出實際請求，確認匯入、選取與連線三個步驟都已完成，再將測試結果套用到日常設定。

把「慢」轉換成可觀察的現象

所有平台排查速度問題時，先描述具體情況：網頁開始載入前等待很久、下載速度一直很慢、影片播放中斷，還是只有首次存取較慢。開始前的等待可能與 DNS、交握和伺服器連線有關；持續傳輸則更受路徑容量和目標回應影響。不同現象不能用同一個測試數字解釋，也不應只憑伺服器名稱或地理備註推測連線品質。

固定同一個目標及相近的內容大小，先記錄中斷連線時的基本網路表現，再測試同一個項目。避免一邊下載大型檔案一邊測試網頁，也要留意系統更新、雲端同步及其他裝置是否占用網路。記錄測試所用的網路、時段和伺服器；單次偶然變快或變慢，不足以證明某項參數長期有效，也不適合作為頻繁調整所有設定的依據。

了解延遲與傳輸量並不相同

Connectivity Test 反映指定測試程序的結果，不能直接等同下載速度。回應較快的項目，持續傳輸時仍可能受容量或壅塞影響；首次回應稍慢的連線，也可能在建立後維持穩定傳輸量。應補做實際網頁與持續傳輸兩類測試，再判斷問題出在首個封包等待還是傳輸階段，不要只依清單中的數字排序。

若只有個別目標速度慢，先比較同一台伺服器存取其他目標的情況。目標網站負載、內容傳遞路徑、登入狀態和應用程式本身的重試，也會影響使用體驗。若所有目標都同時變慢，再檢查本機網路與伺服器端資源。不要只為了單一目標就把所有規則改成相同策略，這可能改變原本正常的請求路徑，造成新故障卻無法解釋舊問題。

檢查 Wi-Fi、行動網路與傳輸路徑

使用 Wi-Fi 時，可先靠近無線基地台並停止大量傳輸工作，觀察卡頓是否隨訊號和區域網路壅塞而改變；使用行動網路時，則留意訊號變化及移動狀況。用同一個項目更換網路，比在同一個網路中不斷切換項目，更有助判斷本機路徑。公共網路可能以不同方式處理部分連接埠或 UDP；一般網頁可瀏覽，不代表所有協定的持續傳輸都同樣穩定。

若只有使用 UDP 的協定或應用程式異常，請依網路切換結果檢查 UDP 路徑，不要盲目調高頻寬參數。伺服器設定與用戶端參數應成對相符，填入更大的數值不會增加實際容量。調整 MTU 應有分片或特定大小請求失敗等證據，並保留原值；若沒有可重現的症狀，不建議直接套用網路上流傳的固定數值至所有網路。

降低規則、重試與診斷功能的額外負擔

若簡單設定正常、複雜設定明顯變慢，請逐項恢復策略群組、DNS、自訂指令碼和 Rewrite，觀察從哪一步開始出現變化。頻繁健康檢查、失敗重試和大量診斷紀錄可能增加額外請求，也可能影響短時間測試結果。先保留業務所需的內容，暫停高頻測試，再以相同目標驗證；刪除規則前應確認其他功能是否依賴該規則。

若長時間使用後才開始卡頓，也應觀察裝置溫度、剩餘儲存空間和背景工作，不要只判斷連線品質。裝置過熱可能同時影響瀏覽器、解碼和網路處理；暫停高負載工作，等裝置恢復正常溫度後再測試。問題解決後，恢復原本的診斷層級並記錄確實有效的變更；若無法穩定重現，請保留紀錄與條件，不要把巧合當成可靠的修復方式。

釐清網域解析與連線失敗的界線

所有平台遇到只有網域無法開啟、首次存取明顯等待，或紀錄出現解析錯誤時，請先檢查 DNS。網域解析會將名稱轉換成位址，接著才使用該位址建立連線。解析成功不代表目標連接埠可用，連線逾時也不一定是 DNS 錯誤；應從紀錄判斷故障發生在解析前、連線期間或 TLS 交握階段，避免把所有問題歸為同一類。

不要只用「改成 IP 就能開啟」作為唯一證據。許多 HTTPS 服務依賴網域名稱驗證憑證及選擇網站，直接在瀏覽器輸入 IP 可能會顯示不同頁面或憑證錯誤。較可靠的方式是比對應用程式紀錄中的查詢結果與後續連線錯誤，並檢查同一網域在基本網路和目前設定下是否表現不同；測試期間始終保留原本的目標名稱。

從系統 DNS 基準逐項恢復設定

先儲存目前的 DNS 設定，檢查設定是否同時指定多個來源、是否有自訂 Host，以及是否存在舊的網域對應。以下片段僅示範以系統 DNS 作為排查基準，不保證適用於所有網路，也不能取代既有完整設定。若切回基準後問題消失，再逐項恢復自訂解析項目，找出造成異常的項目，不要一次替換所有位址。

[General]
bypass-system = true
dns-server = system

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,PROXY

使用加密 DNS 時，也要考慮解析服務本身如何建立連線：它的網域可能先依賴其他解析路徑，而其請求也可能受路由策略影響。若解析必須經過尚未建立的伺服器，而伺服器網域又依賴該解析，就可能形成相依循環。先恢復可啟動的最小連線路徑，再依目前應用程式支援的設定，明確指定解析與連線的關係；不宜隨意疊加多個備援設定。

檢查規則類型與解析時機

DOMAIN、DOMAIN-SUFFIX、IP-CIDR 和 GEOIP 的比對對象不同。網域規則直接比對名稱；IP 類規則則可能需要先取得解析結果才能判斷。使用 no-resolve 的 IP 規則可避免為了該條規則主動解析，但不代表後續實際連線永遠不需要 DNS。排查時既要檢查規則內容，也要確認請求當下是否已有目標位址，不能只憑網域推測比對結果。

處理快取、IPv6 與區域網路名稱

變更 DNS 後，舊請求可能繼續使用快取或既有連線。請關閉測試頁面、重新建立用戶端連線，再發出新請求；只有在應用程式提供明確的快取清除功能時才使用，勿為了更新 DNS 而清除所有設定。若 IPv4 正常但 IPv6 異常，應確認伺服器、系統和實際網路是否都有一致的 IPv6 路徑，而不是只在規則中新增一個名稱。

印表機、區域網路服務和內部網域可能依賴目前 Wi-Fi 提供的 DNS；統一改用遠端解析後，不一定還能找到它們。若外部網域恢復正常，但內部名稱失效，請分別檢查區域網路位址、系統權限與內部解析路徑。保留只在本機網路生效的條件，不要將內部名稱送往無關的解析路徑；問題排除後，同時驗證外部網頁與實際需要的本機服務。

正確解讀系統電池統計

iPhone / iPad 和 Android 出現耗電疑問時，先查看系統電池頁面的統計時間範圍、螢幕使用時間和背景活動。電池用量比例是該時段各應用程式相對耗電量的比例，不代表用戶端持續消耗了相同比例的總電量。若前後兩次分別使用 Wi-Fi 和訊號微弱的行動網路，或其中一個時段傳輸量較大，就不能只憑比例判定設定異常。

網路通道會處理經過它的資料，系統統計可能將部分網路處理耗電歸到相關程序，但無法藉此精確拆分各應用程式的流量成本。先選擇兩個使用習慣相近的時段，記錄網路、連線時間和主要工作，再比較差異。排查時不要同時更改協定、更換網路並關閉背景權限，否則即使耗電改善，也難以找出真正有效的因素。

檢查是否持續失敗並重試

反覆連線失敗比穩定的閒置連線更值得檢查。開啟應用程式觀察連線是否頻繁切換、訂閱是否在短時間內反覆更新，以及策略群組是否頻繁測試無法使用的項目。若連線紀錄持續出現相同錯誤，先修復基本網路、認證或解析問題，再評估耗電情況。單純降低診斷紀錄的詳細程度，無法解決底層不斷失敗的請求，還可能隱藏重要線索。

On Demand 條件應符合實際需求。移動時頻繁切換 Wi-Fi 和行動網路，或處於訊號涵蓋邊緣反覆重新連線，都可能讓系統一再建立連線。先暫時關閉自動條件，在穩定網路中手動維持一次連線，觀察錯誤是否停止；測試結束後依需求恢復條件，不要長期取消所有自動行為。若只有特定無線網路異常，應優先檢查該網路本身。

處理背景限制，不要一律強制常駐

若 Android 只有在鎖定螢幕後中斷，請檢查系統是否限制 Shadowrocket 的背景網路及電池使用。依系統提供的應用程式個別選項調整，不必將所有應用程式都設為不受限制。iPhone / iPad 的 VPN 連線由系統網路機制管理，不能簡單認為主應用程式切到背景就應該中斷；應搭配系統 VPN 狀態、紀錄與網路切換時間判斷。

在 Mac、Windows 和 Linux 上，應區分螢幕關閉、睡眠與系統喚醒。裝置進入睡眠後，網路路徑可能中斷；喚醒後的舊連線也未必能繼續使用。先確認系統已恢復正常網路，再重新建立用戶端連線；不要為了維持測試而長期關閉整台裝置的省電功能。若只在使用電池時發生異常，請檢查系統電源模式，以及網路介面卡的省電設定是否有所變更。

隔離指令碼、紀錄與其他背景工作

複雜指令碼、Rewrite、頻繁檢查和長時間的詳細紀錄會增加處理負擔，但沒有比對就不能認定某項功能一定是原因。複製設定後暫停非必要部分，再以相同使用情境測試，接著逐項恢復。同時檢查雲端同步、大型檔案上傳、系統更新和媒體處理；這些工作既會增加流量，也會讓用戶端處理更多網路資料，造成裝置同時發熱與耗電。

若裝置溫度明顯升高，先暫停高負載工作，等溫度恢復正常後再測試。若過熱與網路中斷同時發生，不要持續執行壓力測試或在充電時維持高負載，試圖取得穩定結果。若使用最小設定檔時，在相近條件下仍持續異常，請整理電池頁面、系統狀態和已遮蔽敏感資訊的紀錄，並記下發生時間；重新安裝前，先確認能否透過另一個網路重現相同情況。

區分應用程式、系統與訂閱更新

所有平台遇到「更新後無法連線」，先確認更新的是 Shadowrocket、作業系統、訂閱還是設定檔。它們可能剛好在同一時段更新，但影響的層次不同。記下最後一次正常使用時的網路和設定，再列出之後的變更，不要立刻把所有問題都歸因於應用程式。訂閱項目遭替換、系統權限重設和規則內容變更，都可能在應用程式更新後才首次顯現。

先重新啟動一次應用程式並重新建立連線，確認系統基本網路可用；若系統更新尚未完成必要的重新啟動，應先完成系統程序。若只有舊連線失效，但新請求正常，可能是網路狀態尚未恢復。若每次連線都穩定出現相同錯誤，請保留紀錄繼續排查，不要反覆重新啟動來掩蓋可重現的線索，也不要在未備份時清除應用程式資料。

使用設定副本檢查相容性界線

儲存目前設定與仍可使用的舊副本，比較區段、策略名稱、DNS 和附加功能。設定解析變得更嚴格時，過去未發現的拼字或引用錯誤可能會顯示明確提示；請依實際錯誤逐項修正，不要以來源不明的整份設定覆蓋現有資料。先使用單一既有伺服器和最小規則建立連線，確認基本功能正常後，再恢復策略群組與擴充設定。

訂閱更新也可能變更項目的識別碼、名稱或參數，導致原有策略引用找不到目標。請確認目前的 SERVER 是否仍存在、策略群組是否為空，以及引用的名稱是否完全相符。若有多個同名項目，請確認目前選取的是哪一個。復原舊設定不一定能恢復遠端已變更的伺服器狀態，因此必須同時驗證實際請求，不能只看設定檔是否成功載入。

重新取得應用程式時保留系統安全防護

需要重新安裝時，請從取得應用程式選擇對應平台。iPhone / iPad 請從 App Store 取得，系統需求以 App Store 頁面標示為準；Mac、Windows、Android 和 Linux 安裝檔由本網站的 /dl/ 路徑提供。Mac 使用者應先在「關於這台 Mac」確認是 Apple 晶片或 Intel，不能只憑裝置外觀選擇安裝檔；平台或架構不符不代表伺服器設定有誤。

桌面與 Android 安裝檔未經程式碼簽署，首次開啟時可能遭系統封鎖。Windows 的 SmartScreen 可在確認來源後選擇「其他資訊」，再按「仍要執行」；Mac 若顯示無法驗證開發者，請在「隱私權與安全性」中檢查該應用程式的「仍要打開」選項。只針對確認下載的 Shadowrocket 操作，不要為了安裝而關閉全域安全檢查或長期降低防護設定。

Android 使用者應在系統設定中允許執行安裝的瀏覽器或檔案管理工具「安裝未知應用程式」，完成後可視需要撤銷權限；若無法在微信內下載，請改用系統瀏覽器。Linux 請依發行版選擇 deb、rpm 或 AppImage，並依安裝說明處理權限。詳細步驟請參閱Mac 與 Windows 安裝說明及Android 安裝說明。

逐項復原並保留可追溯紀錄

重新安裝前，確認備份能還原伺服器、規則和必要設定；敏感欄位只能儲存在自己的安全位置。不要假設解除安裝後所有資料都會保留，也不要把系統 VPN 設定檔當成完整的應用程式備份。復原時先匯入一個項目並完成連線，再恢復訂閱與規則，最後恢復自動連線條件；每個步驟都以相同目標驗證，方便準確找出異常從何時開始。

若問題只在新系統或特定設定組合下重現，請整理最精簡的重現步驟、系統資訊、錯誤原文及已移除敏感資訊的最小設定檔。回報時不必附上完整訂閱或真實密碼，公開這些欄位反而會增加風險。問題尚未定位時，保留已驗證可用的設定副本，避免繼續疊加變更；復原的目標是以可理解的方式恢復功能，而不是讓每項設定都變得不同。

iPhone 正常但 iPad 失敗時如何比對

iPad 使用同一份訂閱時，若 iPhone 可以使用但 iPad 無法連線，先讓兩台裝置連上同一個 Wi-Fi、選取同一個伺服器項目，並核對 Global Routing 和已啟用的設定檔。只有訂閱名稱相同並不足以構成有效比對；兩台裝置可能選取不同項目，或其中一台仍使用舊規則。完成核對後，對同一個目標發出請求，記錄實際結果，而非只比較連線圖示。

接著檢查 iPad 的日期、時間、VPN 授權和基本網路。Wi-Fi 版 iPad 沒有行動網路可切換，不能照搬手機的切換步驟；可在獲得授權的情況下，使用另一個可用網路或個人熱點進行比對。行動網路版則應額外確認系統是否允許應用程式使用行動數據。每次只更換網路來源並維持設定不變，才能判斷故障是否隨網路改變。

公共 Wi-Fi、熱點與區域網路存取

公共 Wi-Fi 需要認證時，先中斷 Shadowrocket 連線並完成網頁登入，再建立連線。若認證頁面未自動出現，可在系統 Wi-Fi 頁面確認連線狀態，並依網路提供的正常方式完成驗證。熱點有獨立的上游網路條件；手機本身能存取某個目標，不代表分享給 iPad 的路徑與手機應用程式完全相同，應在 iPad 上另外檢查基本連線。

若無法存取印表機、投影裝置或區域網路服務，先確認系統中的區域網路權限、兩台裝置是否位於同一網段，以及無線網路是否啟用了用戶端隔離。接著檢查設定中是否錯誤地將本機位址交由代理處理。以下片段只是常見私有位址的規則範例，實際網段請以目前網路為準；使用本機服務也可能需要該網路提供的網域解析。

[Rule]
IP-CIDR,10.0.0.0/8,DIRECT,no-resolve
IP-CIDR,172.16.0.0/12,DIRECT,no-resolve
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
FINAL,PROXY

鎖定螢幕後恢復連線與多工情境的判斷

iPad 鎖定螢幕後再次使用時，先確認系統是否已重新連上 Wi-Fi，再查看用戶端狀態。網路恢復期間短暫失敗，不代表訂閱失效；等基本網路正常後重新建立連線，並以新請求測試。若每次解鎖都能穩定重現，請記錄鎖定前後的網路、On Demand 條件和錯誤時間，再依耗電章節檢查背景活動與重新連線；不要反覆匯入同一份訂閱。

分割畫面、幕前調度或外接鍵盤會改變操作方式，但不會自動同步另一台裝置選取的伺服器。排查時依序開啟 Shadowrocket 和測試應用程式，確認變更已儲存並套用；不要在多個設定編輯視窗之間混淆副本。若某個應用程式在多工操作時保留舊連線，可先結束該請求再重試，以免誤以為新規則仍未生效。

同步資料、裝置限制與回報方式

將設定從 iPhone 移至 iPad 後，應分別核對伺服器詳細資料、策略引用和系統權限。複製檔案只能移轉檔案內容，無法代替另一台裝置確認 VPN 授權；依賴目前網路的本地域名與位址，也未必適用於新裝置。若既有服務限制同時連線的裝置數量，請先中斷另一台裝置以進行比對，再向原服務管理方確認規定；用戶端無法變更遠端帳戶限制。

若應用程式發生異常，但同一台裝置上的瀏覽器正常，應進一步檢查該應用程式的網路權限和存取目標，不能由瀏覽器成功推斷所有服務都應正常。若裝置受學校或企業管理，請保留管理設定並詢問管理員，不要自行移除限制。回報時請註明 iPad 的網路類型、是否在解除鎖定後恢復、選取的設定檔及錯誤原文，並隱藏訂閱、使用者識別碼與密碼。