Official Manual · Troubleshooting

Shadowrocket
故障排除指南

先確認故障發生在哪個環節，再調整設定。本頁是依症狀查閱的官方手冊；首次設定請先完成使用手冊中的快速入門流程，再回到對應章節處理問題。本頁假設您已有自己的訂閱或伺服器資訊，不提供、不銷售、不推薦節點或訂閱。

客戶端一次買斷 ≠ 連線方案。應用程式購買、伺服器服務與設定檔是三件不同的事。購買與重新安裝問題請參閱App Store 正版取得說明；簡短問答請見疑難解答。系統需求以 App Store 頁面標示為準。

Routing

開關已開啟，但網頁或 App 無法連線

先確認基礎網路，再比較 Global Routing。系統顯示 VPN 已連線，只能代表本機連線狀態，不能證明每個請求都已完成解析、驗證與傳輸。選一個平時可正常瀏覽的頁面作為固定測試目標，記錄是所有頁面都失敗，還是只有某個網域或 App 失敗。兩種情況的排查方向不同，請勿直接判定為伺服器失效。

建立基礎網路對照

正常中斷 Shadowrocket，在相同網路中開啟測試頁面。若仍無法連線，先檢查 Wi-Fi 是否需要網頁認證、行動數據是否可用，以及目前 App 是否有網路使用權限。公共 Wi-Fi 即使顯示已連線，也可能尚未完成登入確認。先完成該網路的登入或授權，再回到 App 測試；客戶端設定無法取代基礎網路的登入或授權流程。

若中斷連線後恢復，重新開啟 Shadowrocket，並再次瀏覽同一頁面。請勿同時切換網路和更換伺服器，否則對照測試會失去意義。若只有某個 App 連線失敗，先確認它使用的目標網域、是否有自身的網路限制，以及問題發生在登入、載入內容或背景重新整理階段。瀏覽器可用，不代表該 App 的所有請求都走相同路徑。

比較 Global Routing 的三種模式

若 Proxy 可用、Config 不可用，請優先檢查目前設定是否選對、命中策略是否指向預期伺服器，以及是否有 REJECT 規則。若 Direct 可用、Proxy 不可用，請繼續檢查伺服器參數或伺服器至目標的路徑。此比較只能縮小排查範圍，不能作為完整證明：DNS、設定中的其他處理，以及目標服務狀態也會影響結果，須搭配請求記錄判斷。

檢查規則順序，不要只搜尋關鍵字

進入 Config 確認目前實際使用的檔案，不要只檢查清單中名稱相近的其他檔案。規則通常依排列順序判斷，命中後便套用相應策略；若範圍較廣的規則排在具體規則前面，後者可能就沒有機會比對。以下片段僅用於說明順序；example.com 是語法示例網域，不代表您需要連線的服務，也不可直接取代整份設定。

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

此片段先檢查 example.com 後綴，再進行 GEOIP 判斷，最後由 FINAL 作為預設規則。PROXY 與 DIRECT 的意義不同；若實際設定使用自訂策略名稱，也要確認名稱存在且引用正確。看到 FINAL 不代表所有請求都會套用它，前面的規則可能已經命中。IP 類規則還須考量網域解析發生的階段，不能只憑網頁名稱推斷最後命中的規則。

區分規則問題與目標服務問題

使用可用的連線記錄或診斷資訊，核對失敗請求的網域、策略與錯誤類型。若同一網域在不同路徑下都回傳相同的服務錯誤，問題可能出在目標服務、帳號工作階段或區域性服務條件，而非通道建立失敗。若只有 Config 模式下失敗，且記錄顯示套用了非預期策略，請優先修正該規則，不要長期改用 Proxy 來掩蓋問題。

修改前先備份原檔，只調整能解釋目前症狀的一項設定，再連線至同一目標測試。驗證後恢復日常所需的 Config 模式，並確認其他常用頁面是否受到影響。設定檔段落可參閱.conf 結構說明；若路由結果符合預期但仍顯示解析失敗，請前往DNS 章節，不要再新增重複規則。

Subscribe

Subscribe 更新失敗、匯入清單為空或內容不符

先保留目前仍可用的項目，再檢查訂閱取得與內容解析。Subscribe 更新至少涉及位址連線、身分驗證、回應內容及客戶端辨識等環節。若出現更新失敗提示，原有伺服器可能仍可使用；不要立刻刪除整個群組。客戶端連線正常與訂閱更新正常是兩回事，訂閱位址可能位於不同主機，也可能需要不同的存取條件。

確認位址仍有效且完整

從您原有的資訊來源重新核對訂閱位址，留意複製時是否漏掉查詢參數，或多帶句號、空格與換行。位址中的身分資訊可能會影響回傳內容，不要只為了讓連結看起來整齊就刪除這些內容。若先前重新產生過訂閱位址，舊位址可能已失效；請使用目前有效的資料，不要在舊位址上隨意修改字元。

訂閱位址應視為憑證保護。不要貼到公開問答、截圖或共用文件，也不要傳送給不必要的對象。需要回報時，只需描述主機連線錯誤與狀態資訊；若位址已公開，請透過原有服務的管理方式更換相關憑證。瀏覽器網址列和系統分享預覽也可能顯示完整內容，排查前請留意是否會留下額外紀錄。

分開檢查連線失敗與內容錯誤

更新時若出現連線逾時、解析失敗或憑證錯誤，請先依網路與 DNS 章節檢查訂閱主機。若出現明確的身分或存取權限錯誤，請回到原有資料確認訂閱是否仍有效。能連上某個網頁，不代表能連上訂閱主機；訂閱主機連線成功，也不代表它會回傳客戶端需要的內容。

回傳內容可能是登入頁面、錯誤說明或其他格式，而非伺服器清單。若更新完成後沒有出現項目，先確認原有服務提供的格式是否適用於 Shadowrocket，並檢查回應內容是否為空。不要修改協定類型，試圖把網頁文字當成伺服器資訊匯入。位址重新導向、帳戶狀態變更或格式調整，都可能讓同一個入口回傳不同內容。

釐清 Subscribe 與 Config 的用途

伺服器訂閱主要用於提供或更新伺服器項目；Config 中的設定檔則用於規則及相關設定。兩者有所關聯，但不能互相取代。匯入伺服器清單不代表已建立正確的分流規則；載入 .conf 檔也不代表身分憑證有效。若您已有的資料同時包含兩種位址，請依各自用途操作，不要把設定檔位址填入 Subscribe 後反覆嘗試。

更新後若項目名稱或數量有變化，先與原有服務目前提供的資訊比對。伺服器可能已重新命名或替換，先前選取的項目也可能已不存在；請檢查 Home 中目前實際選取的記錄。自訂策略若引用固定名稱，也要確認目標仍存在。不要只因清單看起來變短就認定解析錯誤，先確認來源回傳的內容。

檢查更新請求使用的連線路徑

若一般網頁可正常瀏覽，只有 Subscribe 更新失敗，請留意更新時是否已連線，以及訂閱主機使用的連線路徑。不同設定與設定檔可能會影響請求的連線方式。先正常中斷連線，在基礎網路中試一次；再恢復原本的連線條件進行對照。每次都使用相同位址，不要同時切換網路、更換位址和修改規則。

若只有一種連線路徑能取得內容，應針對訂閱主機的存取條件修正，而不是更動所有伺服器參數。若兩種路徑都回傳相同的權限錯誤，則較可能需要確認來源帳戶或位址是否有效。若遇到重新導向或憑證問題，請保留錯誤原文並請原資訊提供者確認，不要自行降低驗證要求來掩蓋錯誤。

更新後的復原檢查

成功更新一次後，重新選取預期項目，核對 Global Routing 與設定中的策略引用，再進行實際連線測試。訂閱更新成功只代表清單已更新，之後的驗證仍可能失敗。若清單問題已排除，但連線仍逾時，請前往伺服器章節；若不清楚如何匯入，請參閱使用手冊，不要以刪除群組取代問題定位。

DNS

DNS 解析失敗、網域無法開啟或回傳異常位址

先區分名稱解析與後續連線。瀏覽網頁通常會先將網域轉換成位址，再建立傳輸與應用程式工作階段；任何一步失敗都可能導致頁面無法開啟。Connectivity Test 成功，不代表 DNS 一定有問題。只有錯誤訊息、請求記錄或可重現的對照結果指向解析階段時，才檢查 DNS 設定，避免以更換解析伺服器掩蓋驗證或規則問題。

確認失敗目標與錯誤階段

記下無法開啟的網域，並確認它是目標網站、代理伺服器主機名稱，還是訂閱主機名稱。三者可能使用不同的處理路徑。若伺服器主機名稱無法解析，通道本身就可能無法建立；若通道正常但目標網域失敗，應檢查該請求的解析與路由。不要把所有網域問題都概括為「DNS 無法連線」，否則後續測試很難對應。

在相同網路中試開另一個常用網域，再切回基礎網路進行對照。若只有一個網域失敗，可能與該網域的記錄、快取、Host 對應或特定規則有關；若多個無關網域都失敗，則更應檢查解析服務是否可連線。直接輸入位址瀏覽網站並非可靠的通用測試，因為憑證、Host 與伺服器虛擬主機仍可能要求正確的網域。

檢查目前設定中的 DNS 與 Host

先確認實際使用的 Config 檔案，再檢查 General 中既有的 DNS 相關設定與 Host 區段。不要只在 Settings 修改一個選項，就以為檔案中的設定不再影響行為。各選項的適用範圍請以 App 目前的說明為準；記下相關設定的原始值，並標明哪些來自檔案、哪些來自 App，才能在測試後復原。

Host 中的固定對應可能會讓網域長期指向某個位址。若對應已過期，更換 DNS 服務也不會改變這個固定結果。先確認對應用途，再暫時移除相關項目進行比較，不要清空整個 Host 區段。若既有資料提供了必要對應，請保留復原方式，尤其不要依搜尋到的位址任意覆寫。

解析服務本身也需要可用的連線路徑

DNS 服務位址填入設定後，不代表一定可用。傳統查詢、加密查詢與透過代理連線的查詢，各自需要相應的網路路徑。若設定要求透過代理連線至解析服務，而代理伺服器主機名稱又仰賴同一條尚未建立的路徑解析，就可能形成依賴問題。排查時應先確認最早需要解析的對象，不要強迫所有查詢都走無法啟動的路徑。

選擇解析設定時，使用自己已有且了解用途的資訊，先確認它在目前網路中可連線。不要認為加入許多伺服器就一定更可靠：不同的回應結果與等待順序可能讓問題更難重現。修改前記下原始值，每次只替換一項條件；若結果改善，仍須確認日常分流與本地網路存取是否受到影響。

分別檢查 IPv4、IPv6 與快取

網域可能同時回傳 IPv4 與 IPv6 位址。若解析成功，但其中一種位址類型無法連線，可能會先等待較長時間才改用另一種，或造成部分資源載入失敗。這是位址可達性問題，不代表解析服務沒有回應。請先查看錯誤與目前網路的支援情況，再進行相應比較；不要為了單一目標長期停用裝置上的相關功能。

修改 DNS 或 Host 後，舊連線與快取可能仍使用先前的結果。請結束目前的測試請求，正常中斷後重新連線，再測試同一目標；必要時重新開啟目標 App。不要連續修改多項設定後，立刻以舊頁面判斷結果。若重新連線後短暫恢復又再次失敗，記錄發生問題的網域與時機，並檢查設定切換或網路變化。

規則命中也會受解析結果影響

DOMAIN 類規則依網域條件判斷，IP-CIDR、IP-CIDR6 與 GEOIP 則涉及位址條件；實際行為也會受到規則參數與解析階段影響。請求可能因解析到不同位址而套用不同策略。排查時先確認實際命中的規則，不要為了「修好 DNS」就把所有 IP 類規則移到網域規則前面。FINAL 只負責未命中時的預設處理，無法修復錯誤的解析結果。

修復後，至少測試目標網域、一個日常常用網域，以及必要的本地網路服務。若解析錯誤消失但仍無法連線，請返回路由章節檢查後續連線，不要繼續修改 DNS。更多症狀判斷方式請參閱DNS 解析失敗排查說明；回報時請提供錯誤原文與設定類別，並隱藏內部網域和私人位址資訊。

iPad

iPad 已購項目復原、介面與網路專項排查

在 iPad 上，先將已購 App 復原與設定遷移分開處理。使用自己原先購買 App 的 Apple ID，在 App Store 的已購項目中重新取得 App；購買適用性與系統需求以 App Store 頁面標示為準。重新取得 App 不代表另一台裝置上的伺服器、Subscribe 或 Config 會自動完整出現。若開啟後清單為空，先確認資料遷移情況，不要直接判定為購買失效。

已購 App 仍顯示價格時的確認方式

確認目前用於 App Store 購買的帳號是否為原購買帳號，不要只看系統其他服務顯示的帳號。接著核對產品名稱、開發者 Shadow Launch Technology Limited 與 App ID 932747118。確認帳號與產品前，請勿重複購買。相關確認方式請參閱正版三要素說明；App 唯一取得管道為 App Store。

若目前商店暫時無法顯示已購項目，先檢查網路、帳號購買記錄與目前商店狀態，再依 App Store 實際提示處理。是否適用家人共享，請以商店頁面與自己的家庭設定為準，不能假設他人的購買一定可以復原。購買問題與伺服器服務狀態彼此獨立；復原 App 後，仍須使用您已有且有效的連線資料。

橫向、分割畫面與窄視窗中的操作定位

iPad 橫向顯示或使用分割畫面時，清單與詳細資料的位置可能不同。請依 Home、Config、Data、Settings 等英文介面用詞定位，不要只依賴「左下角第三個按鈕」這類位置描述。編輯面板可能仍顯示上次選取的內容，修改前請確認項目名稱與內部位址，儲存後返回目前選取的項目再次檢查，避免誤改名稱相近的記錄。

旋轉螢幕或變更視窗寬度，不代表路由狀態也隨之改變。若介面看起來不同，先查看 Global Routing 目前的模式及 Config 實際選取的檔案。輸入伺服器資料時，外接鍵盤、自動取代或貼上的內容也可能帶入空格；儲存後逐項核對位址、連接埠與身分欄位，不要因輸入時沒有報錯就認定資料有效。

兩台裝置使用相同資料卻有不同結果

先在相同 Wi-Fi、相同目標與相同伺服器資料下比較結果。不要直接拿 iPhone 的行動網路與 iPad 的 Wi-Fi 比較客戶端表現。即使兩台裝置使用相同的項目名稱，實際密碼、傳輸設定、選取策略與設定檔仍可能不同。請依欄位類別核對差異，不要將完整憑證傳給第三方比較。

若設定完全一致，但只有一台裝置連線失敗，請繼續檢查該裝置的網路權限、其他 VPN、管理限制、系統時間與 DNS 環境。僅支援 Wi-Fi 的 iPad 可改用自己能控制的其他網路進行對照。若使用個人熱點測試，也要記錄熱點裝置的網路變化。更換網路後恢復，只能說明網路環境與問題有關，不能證明某項 App 設定已修復。

休眠、喚醒與網路切換

記錄問題是在長時間鎖定螢幕後、剛喚醒時，還是切換 Wi-Fi 後發生。剛喚醒時，基礎網路可能尚未恢復，App 請求失敗與 VPN 重新連線也可能同時發生。先確認網路已穩定，再手動測試一次。若每次喚醒都需要重新連線，請檢查 On Demand 條件、系統 VPN 狀態與伺服器工作階段行為，並依前述連線章節逐層排查。

不要以 App 在背景停留多久推斷連線一定持續，也不要認為畫面上的舊狀態代表目前請求仍可用。請對照實際連線、系統狀態與錯誤記錄。若問題只在分割畫面中發生，確認目標 App 是否有自己的工作階段或網路限制；切回全螢幕後重複相同操作，並維持其他條件不變，才能判斷視窗變化是否只是同時發生的因素。

遷移設定後逐項復原並驗證

從自己保管的備份復原資料後，先確認 Subscribe 是否有效及目前選取的伺服器，再檢查 Config 檔案與策略引用。若檔案引用固定名稱，另一台裝置上的名稱差異可能導致規則命中錯誤。復原順序應為：確認資料完整、建立連線、完成實際請求、確認規則符合用途，最後再恢復按需連線與附加處理。不要一次啟用所有複雜設定。

驗證至少應包含一次日常網頁瀏覽、一次需要代理路徑的既有服務請求，以及一次正常中斷連線後的基礎網路檢查。若只有某個階段失敗，請返回對應章節，不必重新完成整套購買流程。帳號復原與介面細節可參閱iPad 已購項目與使用要點；介面定位方式請見英文介面用詞說明。