本文重點

本文適合已持有自己的服務資訊,並在 Shadowrocket(小火箭)中遇到 timeout 的使用者。先確認取得方式:iPhone / iPad 於 App Store 一次性付費 $2.99,系統需求以 App Store 頁面標示為準;Mac(Apple 晶片 / Intel)、Windows、Android、Linux 版免費,請前往全平台下載頁選擇。以下依序檢查網路是否可連通、協定參數、系統時間與實際請求;不要只憑單次延遲數值判斷服務是否可用。

一、先分辨延遲逾時與實際請求失敗

timeout 表示某項操作未能在等待期限內完成,不代表已確認是伺服器故障。名稱解析、建立傳輸連線、協定交握,以及向目標網站發出請求,都可能發生等待逾時。排查時,先記下錯誤出現的位置,不要直接修改 DNS 或重新安裝 App。

Home 中的測試結果與瀏覽器連線並非同一回事。TCP 類測試主要確認能否建立傳輸連線;HTTP 測試還取決於測試網址、協定交握及後續請求。實際涵蓋範圍依目前選用的測試方式而異。出現有限的毫秒數,不代表認證參數正確,也不保證所有目標網站都能連線。

觀察位置可判斷的狀況下一步檢查
Home 測試顯示 timeout這次測試未能在期限內完成記下測試方式,切換網路後重測同一項目
TCP 測試回傳毫秒數這次 TCP 連線建立有回應核對認證與 TLS 參數,再測試實際請求
連線已開啟,但網頁載入失敗連線開關狀態不代表請求成功檢查 Global Routing 與目標請求的處理路徑
只有訂閱更新逾時無法取得訂閱網址單獨檢查訂閱網址及其連線路徑

建議在同一網路下連續測試三次並記錄結果,包含時間、網路類型、測試方式與錯誤原文。三次只是方便比對的取樣方式,不是 App 的預設次數,也不是判斷線路品質的標準。

二、依固定步驟建立可重現的測試條件

開始前先儲存目前設定,並記下 Home 選取的項目及 Global Routing 模式。每次只變更一項,測試後記錄結果。若同時切換網路、更新訂閱並修改協定參數,即使問題恢復,也難以判斷是哪項變更生效。

  1. 確認基本網路連線

    在 Home 關閉連線開關,使用瀏覽器確認目前的 Wi-Fi 或行動網路可正常連線。若網路要求登入認證頁面,請先完成認證,再返回 Shadowrocket。

  2. 記錄目前項目

    在 Home 記下所選項目的名稱、Type、伺服器位址與連接埠。名稱只是標籤;核對時應以項目編輯頁中的實際欄位為準,不要只憑名稱判斷協定。

  3. 執行延遲測試

    在 Home 對同一項目執行介面提供的延遲測試,記下所選測試方式與結果。不同測試方式的數值不可直接互相比較。

  4. 切換網路

    在 Wi-Fi 與行動網路之間切換,並保持項目及測試方式不變。若只有其中一種網路失敗,優先檢查該網路的認證、存取限制及 UDP 是否可連通。

  5. 驗證實際請求

    返回 Home 選取待測項目,確認 Global Routing 後再開啟連線。使用同一個測試網頁重複連線並記錄錯誤;臨時測試結束後,請恢復原模式。

三、核對位址、連接埠與協定參數

請依照自己持有的服務商資料逐項核對,不要憑經驗套用其他項目的參數。伺服器位址欄應填入對應的主機名稱或 IP,不要貼上整段分享連結,也不要在主機名稱後另外加上連接埠。連接埠以服務端提供的資訊為準:例如服務端指定 443,就應填入 443;但使用這個連接埠本身不代表已啟用 TLS。

Type優先核對欄位常見誤判
Shadowsocks位址、連接埠、加密方式、密碼及服務端要求的其他參數TCP 可連線,不代表密碼與加密方式相符
VMess / VLESSUUID、傳輸方式、TLS,以及適用時的 Host、Path、SNI只核對 UUID,漏掉傳輸層設定
Trojan密碼、TLS、SNI 與憑證對應的名稱以為連接埠正確就能完成 TLS 交握
Hysteria2認證資訊、TLS、SNI,以及適用時的混淆參數以 TCP 測試結果判斷 UDP/QUIC 是否可用
WireGuard金鑰、Peer 公鑰、Endpoint、介面位址與路由範圍把 UDP Endpoint 沒有回應直接歸因於網頁 DNS

Host、Path 與 SNI 的用途不同,不能互相取代。Path 須保留開頭的斜線與大小寫;SNI 應符合服務端要求。若暫時將伺服器網域改成 IP,可能影響憑證名稱驗證與連線目標,因此不能只因「改成 IP 後有回應」就認定問題已徹底解決。

若項目來自訂閱,請先保留目前資訊,再更新自己的訂閱並核對變更內容。手動修改可能在下次更新時被覆蓋。不要重複匯入多個同名項目後隨意測試,以免實際選到舊位址。本文不提供、販售或推薦節點或訂閱;所有核對皆以使用者已有的服務資訊為準。

結論:傳輸連通後再檢查認證

若 TCP 測試有回應,但實際請求失敗,下一步應核對協定認證、傳輸方式與 TLS 欄位;若使用 Hysteria2 或 WireGuard,還須另外確認 UDP 路徑,不可只憑 TCP 結果排除網路限制。

四、依錯誤原文縮小檢查範圍

以下列出可能出現在診斷資訊中的錯誤文字。實際大小寫與前後綴可能隨系統及連線階段而異,請保留自己看到的完整原文。這些錯誤只能縮小排查範圍,不能單憑其中一個詞判定服務端狀態。

錯誤:timeout

原因:這次操作未能在等待期限內完成,可能與名稱解析、傳輸或後續請求有關。

處理方式:先記下錯誤出現的位置,再使用相同項目與測試方式切換網路重測,避免立刻同時修改多個參數。

錯誤:connection refused

原因:連線收到明確拒絕,常見原因包括目標連接埠沒有監聽,或路徑中的設備主動拒絕連線。

處理方式:核對伺服器位址與連接埠,再向自己的服務商確認對應服務是否正在運作;不要隨意更換連接埠嘗試修復。

錯誤:TLS handshake timeout

原因:TLS 交握未能及時完成,可能與連線路徑、服務端回應或 TLS 設定有關。

處理方式:核對 TLS、SNI 與傳輸參數,切換網路重測,並進一步檢查系統時間;不要直接關閉憑證驗證。

若錯誤明確指向名稱解析,先分辨無法解析的是伺服器網域還是目標網站網域。前者可能導致服務連線無法建立;後者則可能發生在連線建立之後。此時再前往 Settings 查看 DNS 相關設定,並搭配 Config 中目前的設定一起檢查,不要將所有 timeout 都歸因於 DNS 故障。

五、檢查系統時間,再核對 Global Routing

系統時間會影響憑證有效期限的判斷;VMess 等認證機制也可能依賴時間範圍。時間明顯不準時,即使伺服器位址與連接埠無誤,認證或 TLS 仍可能失敗。不過時間正確不代表其他參數也正確;校時應是有明確目的的檢查步驟,而非保證能修復問題的通用方法。

請確認實際日期與時間是否正確,而不只是時區名稱。修正後,請中斷並重新建立 Shadowrocket 連線,再以相同方式重新測試。若錯誤仍存在,請保留原文,不要把之後所有失敗都歸因於時間。

接著返回 Home 檢查 Global Routing。Proxy、Direct、Config、Scene 決定整體流量處理方式,並非四種延遲測試方式。在 Direct 模式下網頁連線成功,不代表待測代理項目正常;在 Config 模式下,則須依據 Config 中目前啟用的規則,判斷請求的處理路徑。

模式排查時的重點
Proxy若要排除規則因素,請確認已選取待測項目;測試完成後恢復原模式。
Direct主要用於觀察直連路徑,不能用來證明待測代理項目可正常運作。
Config檢查目前設定中的規則與比對順序,確認請求採用的策略。
Scene核對目前符合條件的情境,以及實際採用的設定或策略。

例如,Config 中的 DOMAIN-SUFFIX,example.com,DIRECT 會讓符合條件的網域走 DIRECT,而不是待測代理。規則通常依序比對;GEOIP、IP-CIDR 涉及目標 IP 條件,末尾的 FINAL 則處理未符合前面規則的請求。請先確認命中的策略,再判斷節點是否故障;不要把繞過待測項目的請求當作判斷依據。

六、常見問題與提供給服務商的資訊

為什麼有延遲數值,開啟網頁仍然逾時?

先確認 Home 使用的測試方式。TCP 連線建立成功不代表完整的協定認證已通過;接著檢查 Global Routing、項目的認證資訊與 TLS 欄位。若只有特定網域失敗,再檢查該網域的解析狀況及規則比對結果。

Wi-Fi 逾時、行動網路正常,需要重新匯入嗎?

先不要重新匯入。維持相同項目與測試方式,確認 Wi-Fi 已完成認證;若使用 Hysteria2 或 WireGuard,請優先確認該網路是否允許所需的 UDP 通訊,再將比對結果提供給自己的服務商。

只有訂閱更新逾時,代表所有節點都無法使用嗎?

不能這樣判斷。取得訂閱與連線至項目是兩個不同過程。先在 Home 測試已有項目,再向自己的服務商確認訂閱網址是否有效及其存取要求;不要先刪除所有現有項目才嘗試更新,也不要公開含有 token 的網址。

關閉憑證驗證可以解決 TLS 逾時嗎?

不要將關閉憑證驗證當作一般排查步驟。先核對系統時間、SNI、憑證對應網域及服務端設定;若憑證有問題,應由服務提供方修正。關閉驗證也無法修復網路層沒有回應的情況。

若仍無法找出原因,請將可重現問題的資訊提供給自己的服務商。說明「在某網路、使用某種測試方式時,連續出現某項錯誤」,比只說「無法連線」更有幫助。完整訂閱網址、密碼、UUID 與私鑰不應放進公開截圖或討論區。

Shadowrocket 下載與使用教學

iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費。Mac 提供 Apple 晶片與 Intel 兩種下載選項;iPhone / iPad 的系統需求以 App Store 頁面標示為準。請依裝置前往下載頁,初次設定請參閱使用教學。