連線開關無法開啟:先檢查系統 VPN 設定
點按 Home 的連線開關後立刻返回關閉狀態,與開關維持開啟但網頁無法載入,是兩種不同問題。前者應先確認系統是否接受並啟動 VPN 設定;後者才需要檢查伺服器與流量分流。先記下開關是否跳回、是否伴隨提示、是否出現系統授權視窗,以及離開 App 後連線是否仍維持。尚未確認系統連線狀態前,不要反覆更換伺服器;伺服器位址錯誤通常應從連線記錄判斷,不能只看開關顏色下結論。
首次授權與其他 VPN 設定
首次啟用時,系統可能會要求加入 VPN 設定,請依照系統提示確認並完成裝置密碼或身分驗證。若先前取消授權,請返回 Shadowrocket 再次發起連線,確認提示是否重新出現。接著開啟系統 Settings,前往 General 下的 VPN & Device Management,確認是否已有 Shadowrocket 對應的 VPN 設定。系統版本不同,入口位置與提示文字可能有所差異,請以裝置目前顯示的頁面為準;不要將網路設定與裝置管理描述檔混為一談。
如果裝置也儲存了其他 VPN 設定,請先中斷其他作用中的連線,再測試 Shadowrocket。部分企業管理、內容過濾或安全性設定可能限制個人 VPN 啟用;受管理的裝置應請管理員確認政策,不要自行移除組織設定。個人裝置也不宜直接執行「重置網路設定」:這會影響已儲存的 Wi-Fi 網路等資訊,無法取代檢查授權提示。先確認目前連線由哪項設定建立,通常比一次刪除所有網路設定更能保留線索。
開關跳回、重新連線與重建設定
開關剛關閉又自行開啟時,請檢查 On Demand 是否仍符合連線條件。按需連線可能在發出網路請求時再次啟動通道,這不代表按鈕失效。診斷期間先記下原有條件,暫時關閉 On Demand,再手動控制連線。如果系統顯示正在連線,但 App 尚未更新狀態,請等狀態穩定後再觀察;快速連續點按會讓啟動與停止要求交錯,難以分辨原本問題與操作造成的狀態變化。
授權已完成但仍立即中斷時,先正常關閉並重新開啟 App,再重新啟動裝置測試一次。只有在已備份設定,並確認訂閱可以重新取得後,才考慮移除系統中屬於 Shadowrocket 的失效 VPN 設定並重新授權。移除系統 VPN 設定,與刪除 App 內的訂閱、伺服器或 Config 檔案並非同一項操作,執行前請確認選取的項目。不要為了重建通道而順手清除 App 資料,以免把系統啟動問題變成設定還原問題。
區分啟動失敗與伺服器端錯誤
查看錯誤時段的記錄,分辨設定讀取失敗、系統通道啟動失敗,以及後續連線遠端失敗。只記錄錯誤原文與發生順序;不要因記錄中出現伺服器網域,就認定伺服器一定有問題。若同一裝置在不同網路上都無法建立系統 VPN,而相同訂閱在其他自有裝置上可用,排查重點應放在本機授權、管理政策與設定狀態。若通道已啟動,之後才出現 timeout 或 TLS 錯誤,請前往伺服器逾時章節,避免在錯誤層級反覆操作。
每次重新測試都固定一項已知條件:相同 Wi-Fi、相同 Config、相同伺服器;先手動連線一次,再開啟測試頁面。保留修改前後的結果,才能判斷重新啟動、重新授權或關閉 On Demand 哪一步確實有效。若需要進一步尋求協助,可整理「是否完成首次授權、系統是否顯示已連線、中斷前最後一則錯誤、裝置是否受管理」四項資訊,不必傳送完整設定檔。
已連線但無法上網:依路徑與規則逐層排查
系統顯示 VPN 已連線,只表示通道已建立,不代表所選伺服器可用,也不代表每個請求都會經過代理。先關閉 Shadowrocket,開啟一個原本可直接瀏覽的頁面,確認目前 Wi-Fi 或行動數據本身可用。公共 Wi-Fi 若需要網頁登入,請先完成驗證;若驗證頁無法開啟,請保持通道關閉並重試。基礎網路尚未恢復前,調整規則、DNS 或協定參數通常只會增加變因。
使用 Global Routing 進行對照測試
確認基礎網路正常後,固定同一台伺服器與測試網址,分別檢查 Global Routing 的 Config、Proxy、Direct 三種模式。Direct 用於觀察目前的直連路徑,Proxy 用於檢查代理路徑,Config 則依目前啟用的設定規則決定策略。這項對照測試僅供暫時診斷,不代表必須長期使用特定模式;完成後應恢復原本需要的分流方式。
| 測試結果 | 優先檢查 | 下一步 |
|---|---|---|
| Direct 正常,Proxy 失敗 | 伺服器、協定與代理端解析 | 使用固定伺服器檢查交握錯誤 |
| Proxy 正常,Config 失敗 | 比對命中規則、策略名稱與預設策略 | 查看請求實際命中的項目 |
| 關閉通道後仍然失敗 | 基礎網路或目標服務 | 先恢復一般網路連線 |
| 只有一個 App 失敗 | App 請求、快取與連線重用 | 重新建立該 App 的連線 |
三次測試應使用相同目標,且每次切換後都重新發出請求。已建立的長連線可能繼續沿用先前路徑,瀏覽器快取也可能讓頁面看起來「仍然正常」。可以關閉該頁面後重新開啟,必要時完全結束測試 App,再查看連線記錄。不要一邊切換模式、一邊更換伺服器;否則即使恢復,也無法判斷問題來自哪個項目。
檢查啟用檔案、命中順序與 FINAL
在 Config 中確認目前啟用的檔案,而不只是確認清單中有某個檔案。規則通常由上而下比對,較寬泛的規則若排在前面,可能會遮蔽後續的精確規則。以下僅為規則語法範例:example.com 是教學用網域,不是用來驗證代理效果的服務;PROXY 應對應實際可用的代理策略。不要直接用這段內容覆寫唯一的日常設定,請先建立副本。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,DIRECT
這段設定表示網域後綴符合時使用 PROXY,接著套用地理位置比對規則,其餘交由 FINAL,DIRECT 處理。若預期是所有未命中的連線也經由代理,預設策略就必須符合此目的,例如 FINAL,PROXY;兩種寫法適用於不同需求,不能同時作為最後一條生效規則。GEOIP 取決於目標位址及相關資料,不等同於依網頁語言或網站名稱判斷所在地。指定網站分流的完整範例請參閱DOMAIN-SUFFIX 與 FINAL 說明。
局部失敗時查看實際請求
網頁主網域可以開啟,但圖片、登入或影片失敗時,往往需要檢查資源網域,而不只是看網址列。一個頁面可能會向多個不同網域發出請求,因命中不同策略而走不同路徑。從連線記錄找出失敗的請求,再檢查對應規則與目標策略;不要因為一項資源失敗,就把整個網站的相關網域全數加入 REJECT 或 PROXY。先驗證具體請求,規則才容易理解與維護。
若 Proxy 與 Direct 的結果都不穩定,請暫時改用最精簡的測試設定,停用此次診斷不需要的額外處理,並保留原始檔案。目標是依序確認「基礎網路可用、代理路徑可用、規則命中正確」,而不是靠增加複雜設定碰運氣恢復。確認最精簡設定可用後,再逐項恢復原有規則;每恢復一項就用相同請求重新測試,出現問題的步驟就是下一輪排查起點。
伺服器逾時與交握失敗:先確認連線停在哪一層
timeout 只表示某項操作未能在等待期限內完成,不能直接證明密碼錯誤,也不一定代表伺服器整體離線。首先要分辨失敗發生在網域解析、建立傳輸連線、TLS 交握,還是代理協定驗證階段。先選擇一台已有的伺服器,記下完整錯誤與發生時間,再執行 Connectivity Test 並實際瀏覽頁面。不同測試的目標與方法可能不同,因此測試成功只能證明相應檢查通過,不能保證所有業務請求都正常。
依序核對位址、連接埠與協定類型
在伺服器編輯頁面核對 Address 與 Port,確認位址沒有夾帶空格、中文標點、網頁標題或完整訂閱 URL。位址欄位應依所選類型填入主機名稱或 IP,不要任意加上協定前綴。連接埠必須與伺服器端監聽的入口一致;同一台伺服器上的不同連接埠可能對應完全不同的服務。Type 也應依據你的服務商或自有伺服器設定選擇,不能只看連接埠數字推測協定。
| 錯誤階段 | 常見核對項目 | 驗證方向 |
|---|---|---|
| 網域解析 | Address 拼字、DNS 可連線性 | 確認伺服器網域能否解析 |
| 傳輸連線 | Port、服務監聽、防火牆 | 比較不同基礎網路 |
| TLS 交握 | SNI、憑證、系統時間 | 核對伺服器端 TLS 參數 |
| 協定驗證 | 密碼、使用者識別資訊、加密方式 | 逐項比對目前有效資料 |
Shadowsocks 的加密方式與密碼必須配套;Trojan 需核對密碼及 TLS 相關參數;VMess、VLESS 等類型則應依伺服器端資料檢查使用者識別資訊與傳輸設定。若啟用 WebSocket 等傳輸方式,Path、Host 與伺服器端路由也必須一致。介面允許填寫的欄位不代表每個欄位都必須填寫;未提供的值,不要拿其他伺服器的設定來補。即使協定名稱相同,仍可能使用不同的傳輸組合。
TLS、SNI 與系統時間
遇到 TLS 錯誤,應先確認裝置時間是否設為自動,再核對伺服器端要求的 SNI 與憑證是否相符。連線位址可以與 SNI 不同,但必須依照實際部署設定,不能任意填入常見網域。憑證過期、憑證鏈異常或名稱不符,都應從伺服器設定確認。不要把開啟 Allow Insecure 當成通用修正方式;這會改變憑證驗證條件,可能掩蓋真正的名稱或憑證問題。
若舊連線仍可用、新連線卻失敗,可能只是舊連線尚未重新交握,不能據此排除憑證變更。中斷後重新建立一次連線並比對記錄,避免快取狀態造成干擾。Trojan 欄位詳細說明請參閱位址、連接埠、密碼與 SNI 參數說明。若使用自己的伺服器,也應查看相同時段的伺服器端記錄,確認請求是否抵達,以及在哪個步驟遭到拒絕。
切換網路驗證,不要只憑逾時下結論
保持伺服器與參數不變,分別使用 Wi-Fi 與行動數據測試。只有一種網路失敗時,優先檢查該網路的連線能力、驗證、傳輸限制與 IPv6 條件;兩種網路都失敗時,再核對伺服器監聽、帳戶狀態或資料是否已變更。若同一訂閱中的其他現有伺服器可用,也只能證明用戶端具備建立連線的能力,無法證明故障伺服器的每項參數都正確。
以 UDP 為基礎的協定與以 TCP 為基礎的協定,在同一網路上可能呈現不同結果。不要因為一種協定成功,就推定另一種也應該成功,更不要在缺乏依據時反覆調整 MTU。回報問題時,提供協定類型、錯誤階段、兩種網路的對照結果及已核對的欄位名稱即可,無須公開密碼與完整使用者識別資訊。確認連線能穩定完成後,再返回 Config 檢查業務流量,避免把交握問題與分流問題混在同一輪測試中。
新增或更新訂閱失敗:檢查取得路徑與解析結果
訂閱更新包含下載內容與解析內容兩個步驟。要求無法完成、伺服器傳回錯誤頁面,以及下載成功但內容格式無法辨識,應分別處理。先確認操作的是 Subscribe 更新,而不是把訂閱連結當成單一伺服器位址填入 Add Server。訂閱連結請向你的服務商取得;連結通常包含存取憑證,應視同密碼處理,不要貼到公開討論區、圖片註解或不相關的線上檢測頁面。
先保留原有項目,再檢查連結是否完整
舊項目仍可連線時,不要先刪除整組訂閱。記下訂閱備註、更新時間提示與錯誤原文,備份目前設定,再對原訂閱執行一次更新。複製連結時,留意聊天 App 是否截斷參數、是否混入前後引號或說明文字,以及換行是否被納入連結。包含問號與連接符號的查詢參數通常是完整網址的一部分,不要為了縮短連結而手動刪除。若憑證已重設,舊連結即使看起來相似也可能失效。
若資料中同時提供多種匯入格式,請選擇適用於 Shadowrocket 的內容,並確認取得的是訂閱網址,而不是帳戶網頁。成功開啟登入網頁,不代表該頁面就是訂閱內容。若回傳登入表單、驗證頁或一般 HTML,App 可能顯示解析失敗或沒有新增伺服器;此時應核對入口與權限,而不是重新編碼網頁內容後再匯入。
分辨網路錯誤、權限錯誤與格式錯誤
若提示網域解析失敗,請參閱 DNS 章節;若提示 timeout,先判斷訂閱網址是經由哪條路徑存取。若訂閱網域目前被規則導向已失效的代理,可能陷入「代理失效導致無法更新,無法更新又無法更換代理」的循環。在確認基礎網路允許存取的前提下,可暫時使用 Direct 更新,或改用另一條現有且可用的連線;不要透過關閉憑證檢查來略過 HTTPS 錯誤。
HTTP 狀態可提供排查方向,但不能取代伺服器端說明。401 或 403 通常與驗證、權限或存取政策有關;404 可能代表路徑已變更;429 通常表示應停止連續重試,並等待允許的間隔。伺服器也可能將錯誤訊息包裝成正常回應,因此仍須搭配錯誤本文的類型判斷。反覆點按更新無法修復無效憑證,反而可能觸發更多請求限制;先保存一次明確結果,再核對帳戶中的有效連結。
更新成功但沒有預期的伺服器
顯示更新完成後,請檢查訂閱群組中的實際項目,不要只看伺服器總數。伺服器端可能已移除舊項目、變更名稱或傳回相同清單;篩選條件也可能讓部分項目不顯示。手動新增的伺服器與訂閱產生的伺服器不一定屬於同一群組,操作前請確認來源,避免把手動項目誤認為更新殘留。若有重複名稱,應依協定、位址與訂閱歸屬區分,不要只憑備註刪除。
訂閱更新與 Config 檔案更新不是同一件事。伺服器清單更新成功,不代表目前的分流檔案、規則引用或策略選擇會自動符合預期;更新後還應確認目前選取的伺服器仍然有效。多組訂閱的情況可參閱分組、排序與重複伺服器清理,先整理來源再批次操作。每次只更新一組,較容易確認哪個來源傳回異常內容。
向你的服務商回報問題時,提供失敗時間、錯誤類型、是否能解析網域、使用的存取路徑,以及上次正常更新的大致情況即可。若必須提供完整連結,請使用雙方認可的私人管道;公開記錄中應刪除連結查詢參數與使用者識別資訊。確認更新後,先測試一台伺服器,再清除已失效的舊資料;即使新清單有問題,也能保留可還原的設定。
連線速度慢:分別測量延遲、傳輸速率與頁面載入
「速度慢」至少包含三種情況:開始回應前等待很久、持續傳輸速率偏低,以及頁面只有部分資源遲遲無法載入。Connectivity Test 的結果與檔案下載速率不是同一項指標;連線測試較快的伺服器,也可能因出口負載、目標網站限制或網路封包遺失而下載緩慢。先描述延遲發生在開始階段還是持續傳輸階段,再決定檢查 DNS、伺服器路徑或 App 本身;不應只看一項測試數字排序後反覆切換。
建立可比較的測試條件
固定裝置、網路、伺服器與目標內容,暫停正在執行的大型檔案同步或系統下載。先關閉通道觀察一般網路,再使用 Proxy 觀察相同目標;若目標原本無法直接連線,請改用可供基礎網路對照的合法測試目標,不要把直連失敗當成測速結論。每輪只變更伺服器或網路其中一項,連續觀察幾次趨勢,不要依據一次瞬間峰值判斷優劣。
Wi-Fi 訊號格數無法完整反映實際連線品質。裝置靠近無線基地台後恢復、同一時段其他裝置也變慢,或重新啟動路由器後改善,都表示應先檢查本地網路。行動數據則要留意所在位置、訊號變化、流量狀態與低數據模式。測速會消耗流量,也可能與影片播放爭用頻寬;診斷時不要同時執行多個速度測試,否則測到的是彼此競爭後的結果,而非單一連線的能力。
區分首次等待與持續傳輸
首次開啟等待明顯,之後重新整理卻很快,可能與 DNS、TLS 建立連線或連線重用有關;持續下載都很慢,則應觀察封包遺失、伺服器負載與目標端限制。下載一開始很快,裝置發熱後逐漸變慢,還應檢查溫度與背景工作。保持使用同一台伺服器,比較兩個不同目標:只有一個目標慢,優先考慮目標路徑與伺服器限速;所有目標都慢,才較有理由檢查共用傳輸路徑。
網站頁面會包含指令碼、圖片、API 與媒體等多項請求,主文件先載入不代表整個頁面已完成。開啟連線記錄,找出等待最久的請求並核對其使用的策略;若某個資源網域走到失效路徑,頁面就會呈現「開得起來但很慢」。這類問題更接近規則或 DNS 異常,換用傳輸速率較高的伺服器也可能無濟於事。先修復失敗資源的路徑,再評估整體載入速度。
協定、UDP 與 MTU 的適用範圍
不同協定、傳輸層與加密方式對網路條件的適應性各異,但不能因此斷言某種協定「一定比較快」。以 UDP 為基礎的連線在某些網路中可能受限,以 TCP 為基礎的連線也可能受封包遺失與重傳影響。請使用伺服器實際支援的參數進行比較,不要只更改用戶端 Type 而不調整伺服器端設定;協定不相符造成的失敗不是效能差異。
小型頁面正常,但大型回應或部分連線卡住時,才需要進一步檢查 MTU、路徑分片與中間網路設備。先排除目標服務異常、規則不一致與一般封包遺失,再依伺服器或網路診斷資料調整。沒有適用於所有連線的通用 MTU 數值;盲目調小可能增加負擔,調大也可能造成新的卡頓。修改前先記下原值,驗證時使用相同的大型回應目標,確認穩定改善後再保留。
日常選擇應兼顧穩定性與實際用途,不必頻繁測試整份清單。批次檢測會產生額外連線,在行動網路上尤其容易干擾目前的網路活動。完成排查後,保留一條適合目前網路的既有連線,恢復日常 Config,再檢查資源請求是否依預期分流。若只有背景 App 變慢、前景瀏覽正常,也應搭配耗電章節檢查背景排程與網路切換,避免把系統背景限制誤認為伺服器效能問題。
DNS 解析異常:分辨伺服器網域與目標網域
DNS 問題可能出現在兩個不同位置:用戶端必須先解析伺服器網域,之後業務請求也可能需要解析目標網站網域。前者失敗時,代理連線本身無法建立;後者失敗時,則可能表現為 VPN 已連線但特定網站無法瀏覽。先查看記錄中失敗的是哪個名稱,不要把所有網域錯誤都歸因於同一項 DNS 設定。解析成功只表示取得位址,不保證該位址對應的服務可連線。
確認解析請求經過哪條路徑
檢查目前 Config 中與 DNS 相關的設定,分辨系統提供的解析器、手動指定的解析器,以及透過特定路徑存取的解析服務。設定 DNS 位址不代表目前網路一定能連上它;使用加密傳輸的解析服務同樣需要建立連線,也可能涉及先解析該服務本身的網域。若解析服務必須依賴尚未建立的代理,就要檢查是否形成啟動依賴循環,而不是再加入更多解析器。
記錄若顯示「名稱不存在」與「要求逾時」,排查方向不同。前者可能是網域拼字錯誤、記錄確實不存在,或伺服器回傳結果有問題;後者則可能是解析服務無法連線或請求路徑異常。記下查詢目標與回傳類型,再換用不同基礎網路對照。不要因某個解析器在家中可用,就認定它在公共 Wi-Fi 或行動網路上也同樣能連線。
快取、IPv4 與 IPv6 的影響
變更 DNS 後,App、系統或既有連線可能仍在使用先前的快取結果。先中斷並重新建立測試連線,再關閉測試頁面後重新請求;必要時重新開啟目標 App。不要只依網址列重新整理一次就判定設定無效。若同一網域同時有 IPv4 與 IPv6 位址,不同網路可能選擇不同路徑,造成一台裝置正常、另一台失敗,或切換 Wi-Fi 後結果不同。
IPv6 相關設定應依實際網路測試,不要遇到任何異常就直接關閉。只有在記錄或對照測試顯示 IPv6 路徑失敗、IPv4 路徑正常時,才有依據繼續檢查相關設定。變更後應同時測試原本失敗與正常的網站,確認沒有影響其他網路活動。使用 IP 位址瀏覽網站也不是萬用對照方式,因為 HTTPS 憑證名稱、虛擬主機與 App API 可能都需要正確網域。
為什麼網域規則與 IP 規則可能得出不同結果
DOMAIN 與 DOMAIN-SUFFIX 依賴請求中的網域資訊;IP-CIDR 針對目標位址範圍;GEOIP 則依據位址與相關資料。一個網站可能對應多個位址,也可能在不同網路中回傳不同結果,因此不能把單次解析得到的位址永久視為該網站的固定位址。規則中若填入共用位址範圍,也可能影響其他不相關服務;替網站設定分流時,請先確認能否使用精確的網域條件。
[Rule]
DOMAIN,example.com,PROXY
DOMAIN-SUFFIX,example.org,DIRECT
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
FINAL,PROXY
範例中的 192.0.2.0/24 是文件專用的示例網段,不是可用伺服器。no-resolve 可避免為比對該 IP 規則而額外觸發網域解析,不代表停用所有 DNS。了解其作用後再放入實際檔案;不要將網路上的設定片段整段覆寫到日常設定中。若請求本身已帶有目標 IP,匹配方式也會與僅有網域時不同,應搭配連線記錄判斷,而不要只看規則文字。
局域網裝置名稱解析失敗時,還要分辨一般 DNS、局域網名稱探索與特定服務探索機制。印表機、儲存裝置與家用設備不一定使用相同方式探索;能連上某個 IP,不代表名稱探索也一定可用。恢復診斷時,先使用目前設定中原本正常的 DNS 路徑,再逐項恢復自訂設定。最後記錄應包含失敗名稱、網路類型、實際使用的解析路徑與錯誤結果,方便之後更新或更換網路時重現。
修復完成後,分別使用一個先前失敗的網域與一個先前正常的網域進行驗證,並重新檢查伺服器本身的網域。這樣可避免只修復了業務解析,卻讓下次建立代理連線時仍然失敗。若錯誤已從解析失敗變成連線逾時,請前往伺服器章節繼續排查,不必持續調整已恢復正常的 DNS。
耗電與異常發熱:觀察網路流量與重新連線頻率
系統電池頁面中的 App 耗電比例是相對統計,不直接代表它實際增加了多少耗電。裝置整體使用時間、螢幕亮度、行動網路訊號、影片播放與背景同步的變化,都會影響比例。先在相近使用條件下比較電量下降、溫度與網路活動,再判斷是否與 Shadowrocket 有關。只因比例上升就刪除設定,可能會失去問題發生時的線索,也無法解決持續傳輸資料的 App 工作。
使用相同網路活動建立對照
選擇裝置溫度與網路訊號相近的時段,分別觀察閒置連線與相同的日常活動。不要一組測試時播放影片,另一組卻只鎖定螢幕待機;也不要在系統剛完成更新、照片同步或大量 App 下載時進行比較。記錄螢幕是否開啟、充電狀態及大致流量活動,有助於分辨耗電來自加密轉送負載、基礎網路條件,還是業務本身的消耗增加。
系統可能會把部分網路延伸功能的活動歸在用戶端名稱下,但不代表所有請求都是由用戶端主動發出。某個背景 App 反覆同步、重試失敗的 API,或傳輸媒體時,代理會參與這些連線。查看同一時段的連線記錄,找出持續出現的目標與失敗模式,再回到相關 App 檢查。不要只憑 App 顯示名稱推定請求來源,也不要為降低統計比例而任意封鎖不熟悉的系統網域。
排除反覆重新連線與批次檢測
訊號微弱、Wi-Fi 與行動數據頻繁切換,以及伺服器無法連線,都可能導致連線反覆建立。TLS 交握、解析與驗證不斷重複時,耗電與發熱可能比穩定維持連線更明顯。檢查記錄中是否在短時間內連續出現連線、中斷與重試,再固定一個穩定網路重新測試。若只有通勤時切換網路才特別明顯,應先觀察重新連線的規律,不要直接變更所有協定參數。
也應檢查 On Demand 條件。條件變化過於頻繁,可能使連線隨網路環境反覆啟動與停止;但長期關閉按需連線也未必符合日常需求。診斷期間先暫時關閉自動條件,改為手動控制,確認異常是否消失後,再逐項恢復條件。同時停止不必要的全清單 Connectivity Test,避免批次檢測在背景產生額外請求,影響對實際網路流量的判斷。
記錄與額外處理功能應視需要使用
詳細記錄適合在短時間內重現問題;長期保留大量記錄可能增加寫入與處理負擔。先記下問題發生時間,收集足以定位的片段後,恢復日常記錄層級;不要為了等待偶發問題而無限期保留所有細節。含有額外重寫或指令碼處理的設定,也應在副本中逐項停用並對照;判斷依據是相同請求與相同條件下的差異,而非處理項目數量。
若啟用了需要解密檢查的設定功能,請先確認自己了解其範圍、憑證條件與來源,再決定是否保留。一般連線、訂閱更新與基礎分流排查不需要為此新增憑證。遇到發熱時,先減少非必要處理並停止高負載活動,等裝置溫度恢復後再比較效能。溫度偏高時,系統可能調整運作狀態;此時連續測速會進一步增加負載,測試結果也缺乏可比性。
驗證修復時,應觀察足以涵蓋日常情境的使用過程,不要只看幾分鐘內的電池百分比。系統統計採用時間區間,變更後的結果未必立即反映在舊記錄中。若關閉代理後基礎網路仍持續發熱,應進一步檢查系統背景工作、訊號與裝置本身狀態;若只有某個 Config 導致異常,請保留可用的最精簡副本,再逐項恢復以找出問題處理項目。其他簡短問題可前往常見問題頁查閱,避免在同一輪測試中同時變更電源、網路與規則。
更新後發生異常:分辨 App、系統與設定變更
「更新後不能用」應先確認更新的是什麼:Shadowrocket、裝置系統、訂閱清單,還是遠端 Config 檔案。這些變更可能發生在相近時間,但影響的層級不同。先回想上次正常連線時使用的網路、伺服器與檔案,再核對目前實際狀態。不要因為 App 剛更新就認定所有錯誤都來自 App;伺服器端參數變更、訂閱項目移除或網路切換,也可能同時發生。
先保留現況,再進行最小範圍回歸測試
覆寫檔案或刪除資料前,先備份目前的 Config,並保存能說明問題的記錄片段。訂閱與設定檔未必包含完全相同的資訊;還原前要確認伺服器資料、規則檔案與額外引用都已保存。備份可能包含密碼、訂閱憑證或使用者識別資訊,應存放在自己掌控的位置;匯出只是保存資料,不代表匯出的檔案可以公開分享。
使用原有伺服器進行最小範圍回歸測試:關閉自動條件,手動連線,在 Proxy 模式下瀏覽固定目標。如果此時正常,再切回 Config 檢查規則;若系統開關無法維持,請返回第一章。依照此順序可先判斷受影響的是系統通道、代理連線還是分流檔案。每次只恢復一個處理項目,避免多項變更疊加後無法解釋結果。
設定語法與引用變更
新匯入或更新的 Config 若出現錯誤,請查看錯誤涉及的區段名稱、行內容與引用策略。常見問題包括逗號被換成中文標點、規則被換行拆開、策略名稱已變更,以及複製時混入說明文字。先修復明確的語法錯誤,不要把所有不熟悉的選項逐一刪除。來自不同來源的片段,即使使用相同規則關鍵字,也不保證能直接拼接成完整且符合目前需求的設定。
訂閱更新後,原先選取的伺服器可能已改名或遭移除,但策略引用仍指向舊名稱。應確認目前實際選取的伺服器,以及規則命中的策略是否仍可用,再決定重新選取或調整引用。若舊 Config 副本正常而新檔案異常,請逐段比對規則、DNS 與額外處理項目;不要為了恢復使用而立刻覆寫唯一副本,以免之後無法確認究竟哪一段發生變更。
系統更新後的權限與連線狀態
系統更新後若再次出現授權提示,請依目前裝置頁面重新確認,並檢查 VPN 狀態與 On Demand 條件。先重新啟動一次裝置,再使用固定網路測試;不要連續重置網路、重新安裝 App 並刪除設定。更新剛完成時可能仍有系統背景整理與同步工作;若主要症狀是耗電或速度變化,請等相關活動穩定後再依對應章節重新測試,不要與明確的交握錯誤混為一談。
確實需要重新取得用戶端時,請使用全平台下載頁。iPhone / iPad 請從 App Store 取得,一次性付費 $2.99;Mac(Apple 晶片與 Intel)、Windows、Android、Linux 版免費,安裝檔由下載頁透過本站下載路徑提供。iPhone / iPad 的系統需求請以 App Store 頁面標示為準,並核對開發者 Shadow Launch Technology Limited 與 App ID 932747118,不要只憑相同名稱判斷。
重新安裝桌面版或 Android 版後,若系統提示禁止開啟,請先確認檔案來自本站,再依安裝允許方式一覽處理:Windows 可確認來源後透過 SmartScreen 的「更多資訊」查看「仍要執行」;macOS 可在「隱私權與安全性」中檢查「仍要打開」;Android 依系統提示允許目前來源安裝未知 App;Linux 則依套件格式安裝,AppImage 需要具備執行權限。不要為了處理單一安裝檔而全面關閉系統防護。
還原資料並提交可重現的問題
重新安裝應排在備份與最小範圍測試之後,而不是第一步。iPhone / iPad 請使用原購買帳戶確認已購項目;還原 App 後,仍需檢查訂閱與 Config 是否已恢復。商店購買記錄不等於 App 設定備份。遷移前可參閱iCloud 同步、匯出設定與還原步驟。回報問題時,提供系統環境、更新對象、錯誤原文與最小重現步驟;不要推測版本結論,也不要傳送包含憑證的完整檔案。
iPad 專項檢查:網路切換、局域網與設定遷移
iPad 與 iPhone 使用相近的連線邏輯,但網路來源、背景行為與使用情境可能不同。平板常連接家用 Wi-Fi、學校或辦公室網路,也可能透過手機熱點上網;同一訂閱在手機上正常,不代表平板目前的網路路徑也相同。先確認 iPad 的網路來源、系統 VPN 狀態、所選伺服器與 Config,再與另一台裝置比較;不要只因訂閱備註相同就認為設定完全一致。
Wi-Fi、熱點與網頁驗證
iPad 連上手機熱點時,手機本身的代理狀態不能證明平板已建立代理連線。請在平板上個別檢查 Shadowrocket 開關與實際請求路徑。保持 iPad 的伺服器與 Config 不變,分別在一般 Wi-Fi 與熱點下測試;若只有其中一種網路來源失敗,優先檢查該網路的驗證、DNS 與協定連線能力。切換熱點期間短暫中斷,也不應直接歸因於訂閱失效。
學校、飯店或辦公場所的 Wi-Fi 可能需要透過網頁登入、同意使用條款或重新驗證裝置。先中斷通道,完成該網路要求的驗證後再嘗試連線。驗證狀態可能因離開網路、裝置休眠或有效期限屆滿而改變,所以「昨天可以用」不代表今天已完成驗證。受管理的 iPad 也可能限制個人 VPN 或網路設定,應請裝置管理員確認政策,不要移除不屬於自己的管理設定。
鎖定螢幕、分割畫面與恢復後的舊連線
鎖定螢幕後重新開啟頁面卻失敗時,先分辨是系統 VPN 已中斷,還是業務 App 保留了一條失效連線。查看系統狀態後,關閉失敗頁面並重新發出請求;若新請求正常,問題可能出在舊連線恢復,而非所有伺服器都失效。On Demand 可依條件重新建立連線,但不代表每個背景 App 都能持續執行工作。系統背景排程與用戶端連線狀態應分開觀察,不能只看 App 切到背景後的畫面更新情形。
使用分割畫面或多個視窗時,多個 App 可能同時下載檔案、播放影片或同步文件。排查速度慢時,先暫停其他視窗的傳輸,並固定一個前景測試目標。外接顯示器、持續充電與高亮度也會改變發熱條件;比較耗電時,應盡量維持相近條件。若只有某個 App 恢復後失敗,先重新建立該 App 的連線,再與其他 App 對照,不必立刻重建系統 VPN。
局域網裝置、螢幕投放與探索服務
印表機、家用儲存裝置與投放設備通常需要局域網連線,有些也依賴廣播或服務探索。先在關閉通道時確認能找到裝置,再於連線後觀察變化。確認兩台裝置位於可互相連線的同一網路,並檢查 Wi-Fi 是否啟用訪客隔離;即使 Wi-Fi 名稱相同,也不一定代表裝置之間可以通訊。必要時檢查系統中的本機網路存取權限;具體權限取決於發起存取的 App。
局域網位址分流可使用符合實際網路的 IP-CIDR 規則,但應先查清位址範圍,不要任意加入涵蓋過廣的網段。網域存取與直接使用 IP 存取的結果不同,表示還需檢查名稱解析或探索機制。投放探索正常但播放失敗,也可能是後續媒體連線出了問題,而非探索步驟本身。先找出失敗階段,再修改相應規則;一條 DIRECT 規則無法取代所有探索協定與網路權限檢查。
從 iPhone 遷移後逐項核對
遷移 Config 後,請核對目前啟用的檔案、伺服器選擇、訂閱是否有效,以及檔案引用是否完整。iCloud 同步是否完成,應依實際檔案與項目判斷,不能只憑使用同一帳戶推定。裝置上的系統 VPN 授權仍需個別確認,訂閱連結也可能已變更。先在 iPad 上手動連線並驗證,再恢復 On Demand;不要未經檢查就將手機上的所有自動條件直接套用到平板使用情境。
若依照上述順序仍無法找出問題,請整理簡短記錄:裝置系統、網路來源、是否受管理、Global Routing、錯誤原文、另一種網路的測試結果,以及最精簡設定是否正常。繼續操作前,可回到快速入門流程確認基本步驟,或在常見問題頁查找相關問題。保留可重現的條件,比重複匯入、反覆重新安裝或同時修改多組參數,更有助於縮小問題範圍。