01 設定基準
初始值與 Global Routing
先區分初始值、繼承值與目前值
開啟 Shadowrocket 後,先記下 Home 顯示的連線狀態、目前選取的伺服器與 Global Routing 模式,再前往 Config 確認實際啟用的設定檔。在清單中看得到某個檔案,只代表它已儲存,不代表目前連線正在使用它。同樣地,伺服器出現在 SERVER 清單中,也不代表每條規則都會將流量導向該伺服器。排查時分別記下這些項目,比只記錄「已連線」更有幫助。
本手冊所說的「初始值」,是指尚未變更時介面顯示的狀態,或欄位未填寫時由系統與有效設定決定的行為,並非所有裝置都相同的一組固定數值。訂閱更新、切換檔案或從舊裝置還原,都可能將既有參數帶入目前環境。介面未明確顯示預設值時,請保留空白或原有狀態,不要為了符合範例而填入特定數字。若要比較,先記下原值是否為空白:手動填入看似相同的數值,不一定等同於沿用預設行為。
三種模式如何選擇
| 介面與模式 | 適用情境 | 不能單憑此項判斷的事 |
|---|---|---|
Config(設定) | 確認目前生效的檔案,日常依規則分流。 | 不能只看伺服器清單,就判斷個別請求的去向。 |
Proxy(代理) | 短暫切換作為對照,確認目前代理能否連線至同一目標。 | 不能據此證明原本的分流規則有誤。 |
Direct(直連) | 短暫切換作為對照,確認目前網路直連目標是否正常。 | 不代表已關閉系統 VPN 連線。 |
日常需要分流時,建議使用 Config,並確認已有可用的設定檔。單一網站無法連線時,先在原模式下重現問題,再保持網路、伺服器與目標不變,只切換模式重新測試。若 Proxy 可用但 Config 不通,先檢查規則命中情況與策略指向;若兩種模式都無法使用,先確認代理路徑是否正常,不要急著修改規則。若 Direct 也失敗,則應另外檢查目標服務、網路連線或解析結果。測試完成後請還原原本模式,避免暫時切換影響後續連線。
最精簡規則片段與還原方式
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
以下片段僅用來說明規則順序,並非完整設定檔。第一條規則會將符合 example.com 及其子網域的請求交給 PROXY,第二條則讓未符合前面規則的請求走 DIRECT。規則會由上而下比對;適用範圍較小的規則應放在可能涵蓋它的通用規則之前,並以 FINAL 作為最後兜底。網頁也可能向其他網域要求圖片、登入或 API 資源。主網域符合預期,不代表整個頁面只使用這一條規則;請以實際失敗的請求為準。
編輯前先保留一份可還原的設定檔,再於副本中只修改一條規則。儲存後確認副本確實已啟用,並分別使用一個應符合該規則的目標,以及一個不應符合的目標進行驗證。若兩者的結果都改變,請優先確認是否切錯目前使用的檔案,或是否將通用規則放得太前面。遠端設定檔更新時可能會取代檔案內容;打算長期保留的本機修改,請記錄在獨立副本中,不要只靠記憶在更新後重新拼湊。其他設定檔區段請參閱設定檔 .conf 分段說明。
要判斷變更是否有效,至少應確認同一問題在變更前出現、變更後消失。若切換模式時也更換了網路,就無法分辨結果是分流改變所致,還是原本的網路已恢復。必要時切回原值,確認相同現象是否再次出現。問題無法穩定重現時,先保留現場資訊,不要把偶然成功當成新的預設設定。
02 網域解析
DNS:解析來源、適用範圍與回退
先確認由誰解析,再決定使用哪個位址
DNS 會將網域名稱轉換為連線所需的位址。成功解析網域只代表取得了解析結果,不代表該位址可連線,也不代表流量依照預期策略傳送。反過來說,伺服器可用,但某個服務網域解析逾時,也可能造成網頁無法開啟。遇到這類情況,先在相同網路下比較一個已知正常的網站與一個無法連線的目標,再確認問題出在解析、連線還是應用程式回應階段。
先檢查目前啟用設定檔中的 [General] 與 [Host]。前者可能指定 DNS 參數,後者可能為特定網域設定本機對應。若問題只出現在某個網域,而該網域剛好有對應設定,請優先確認對應是否仍有效;更換 DNS 不一定會改變由對應設定決定的結果。若沒有明顯的覆寫項目,建議先保留系統或設定檔目前採用的解析方式。留空不代表停止解析,也不能據此推定一定使用某個固定的公共 DNS 服務。
系統解析、自訂解析與加密解析
若網路已提供可用的解析服務,建議使用系統解析,這也是還原基本狀態時的優先選擇。公司或校園網路可能只會在自有解析服務中提供內部網域名稱;為了修復一個公共網域而將所有請求改用外部 DNS,可能導致內部網站也無法使用。同樣地,連線至需要登入的 Wi-Fi 時,請先完成系統網路認證,再判斷是否需要調整 DNS。認證前後的解析與連線條件不同,不應以其中一次測試取代另一次。
需要自訂 DNS 時,請使用你清楚了解用途、且目前網路能連線的服務。加密 DNS(例如 DoH 或 DoT)保護的是裝置與 DNS 服務之間的查詢傳輸,不會替所有應用程式設定代理,也不保證解析出的每個位址都能連線。若 DNS 服務本身以網域名稱表示,還必須能先解析並連線至該服務。請勿同時修改解析位址、加密方式與分流規則;若發生問題,這三個環節都變了,就難以判斷是哪一項造成逾時。
依故障範圍選擇排查方式
只有單一應用程式無法使用時,可用同一裝置上的另一個應用程式連線至相同目標,確認差異是否來自應用程式本身的快取或解析方式。瀏覽器可能使用自己的加密解析,也可能沿用已建立的連線,因此「另一個應用程式正常」不足以證明系統 DNS 沒問題。測試前先發出新的請求,記下網域與時間;不要把舊頁面的快取內容當成目前仍可連線的證據。
同一網域在 Wi-Fi 下無法連線、使用行動網路時卻正常,請先維持設定不變,只切換網路觀察。若目標已回傳位址,卻遲遲無法連線,接著應檢查該位址的連線路徑,而不是直接判定為 DNS 錯誤。同一目標可能同時提供 IPv4 與 IPv6 位址;其中一種路徑異常時,因應用程式使用的位址類型與連線回退方式不同,結果也可能不一樣。先記下實際觀察到的位址類型與錯誤訊息,不要把關閉某個位址類型當成所有裝置的通用設定。
若大範圍故障是在變更 DNS 後發生,請先還原變更前的解析設定,並保持相同模式與網路,再以一個公共網域和一個原本可用的內部名稱重新測試。移除暫時的覆寫項目,與將它改成另一個位址並不相同;還原時應恢復原本的繼承狀態。切換網路後短暫恢復,也不能證明問題已排除,原因可能只是重新建立了連線。請至少等到同類請求再次發生,確認測試未受舊快取結果或既有連線影響。
最後記下變更是寫在設定檔中,還是透過裝置端操作完成。前者可能在檔案被取代時消失,後者也不一定會隨設定檔移至其他裝置。若日後在訂閱更新後再次遇到類似問題,先比對生效檔案中的解析設定,不必從重新選擇伺服器開始排查。
03 連線觸發條件
On Demand:觸發條件與持續連線
按需連線決定何時啟動,不決定流量去向
On Demand 讓系統依據可用條件決定是否發起 VPN 連線。它與 Global Routing 是兩個不同層面的設定:前者決定何時連線,後者影響連線建立後如何處理流量。將某個網路設為觸發條件,不會讓指定網域自動走 PROXY;新增代理規則,也不能取代系統的按需連線條件。開始診斷前,先確認問題是「連線未啟動」,還是「啟動後目標無法連線」。
初次使用時,建議先保留手動連線:在 Home 啟動連線,確認一般目標與需要特定策略的目標都符合預期,再前往 Settings 查看 On Demand。還原過系統設定或複製過設定檔的裝置,可能已經有觸發條件;不要因為「看起來像新安裝」就認定此功能一定關閉。請核對目前的開關與系統 VPN 狀態;若手動中斷後又自動連線,先檢查觸發條件是否仍成立,不要一再關閉主開關。
從可明確驗證的單一情境開始
建議先設定一個明確目標,例如只在某種網路環境下自動連線。介面若提供相應條件,先只設定一項,其他條件保持原狀。記下應觸發與不應觸發的情境,再分別切換網路測試。每次進入新環境後,先確認系統已完成網路連線,再查看是否發起 VPN 連線。剛切換網路時,系統可能仍在取得位址,這幾秒的延遲不能直接視為觸發失敗。
若觸發條件與 Wi-Fi 名稱有關,請確認裝置目前連線的網路名稱,不要根據路由器所在位置或俗稱判斷。不同設備提供的網路可能使用相同名稱;名稱只能用於符合連線條件,不能作為判斷網路是否可信的依據。若同一地點涵蓋多種連線方式,測試時請確認裝置最後使用的是預期網路,避免將行動網路切換誤認為符合 Wi-Fi 條件。
也請另外測試一次排除條件。若測試時 VPN 已連線,進入該網路後仍顯示連線中,不足以證明系統會在此處自動啟動;應在可控制的環境中從明確的初始狀態開始,區分「原連線仍在」與「系統新建連線」。若條件清單確實支援多個項目,再逐一新增,並在每次新增後重新測試先前的兩種情境。這樣能及早發現新條件與既有條件重疊,而不是等全部設定完成後才發現難以還原。
自動重新連線、公共網路與耗電
使用公共 Wi-Fi 時,若系統需要先開啟認證頁面,自動連線可能讓「尚未完成認證」與「代理連線失敗」同時發生。為了找出問題,可暫時停用按需觸發並手動中斷連線,先完成網路認證,再手動建立連線;確認服務正常後,恢復原有設定並重新測試。測試結束後請恢復原本開關狀態,尤其不要為了臨時網路而永久刪除其他有效條件。
是否使用持續連線或按需連線,應依實際切換網路的頻率與使用習慣判斷。按需連線不一定更省電:若條件界線導致反覆重新連線,建立連線的過程也會增加耗電。比較時請維持設定與主要使用情境相同,在可比較的觀察時段內,參考系統電池用量與重新連線次數,不要只憑短時間觀察下結論。詳細比較方式請參閱On Demand 與耗電排查。
On Demand 條件是否仍成立,再判斷是開關操作、網路切換還是連線故障。若只有在裝置從睡眠喚醒或切換網路後才發生問題,請記下離開前與返回後的網路類型,以及系統顯示的 VPN 狀態。以相同情境改用手動模式重試:手動連線也失敗時,優先檢查新網路與代理路徑;只有按需連線失敗時,再將排查範圍縮小至觸發時機與條件。
04 連線測試
Ping 與 Connectivity Test:解讀測試結果
先確認數值對應的目標與測試方式
Ping 與 Connectivity Test 都可用來診斷連線狀況,但一次測試涵蓋哪一段路徑,取決於測試類型與目標。測試伺服器位址的結果,不等於建立代理連線後就能存取目標網站;透過某條路徑成功連線至測試位址,也不代表這條路徑能開啟所有服務。尤其當測試只顯示延遲時,不要光看名稱就認定使用了 ICMP。請先確認介面實際提供的測試方式、目標與目前網路,再解讀數值。
建議先保留應用程式目前的測試方式與目標,在相同條件下取得一組結果,不必照抄他人提供的測試位址或逾時秒數。若目標服務本身經常逾時,或只能在特定網路下連線,跨伺服器比較就會受到目標差異影響。確實需要更換時,請選擇你有權限存取、且能透過預期路徑正常回應的目標。若測試位址也需要經由 DNS 解析,解析異常同樣會影響結果;不能只因測試名稱與延遲有關,就排除 DNS 問題。
在相同條件下比較,不要依單次讀數排名
實際測試時,先固定使用 Wi-Fi 或行動網路其中一種,暫停明顯占用網路的大型檔案傳輸,並記下所選伺服器與模式。對同一目標分隔測試幾次,區分持續失敗、偶發逾時與普遍偏慢。若要比較兩個已有伺服器,請使用相同目標、相同方式,並選擇相近時段。單次速度較快,可能只是沿用了既有連線;單次較慢,也可能是 Wi-Fi 訊號變動。測試數值可協助縮小範圍,但不是選擇設定檔的唯一依據。
若介面允許調整逾時,建議先保留目前數值。只有當記錄或實際請求顯示稍後仍能完成,且這些完成時間對服務確實可接受時,才小幅延長後重試。延長逾時只會改變等待多久才回報失敗,無法修復無法連線的目標;逾時設得太短,也可能將正常波動誤判為斷線。請分開記錄變更前後的結果,避免直接比較不同逾時門檻下的成功率。
延遲與傳輸量也應分開判斷。延遲測試通常只發出少量請求,不能代表長時間傳輸是否穩定。若問題是大型頁面載入到一半停住,或短請求成功但長連線頻繁中斷,應保留延遲結果作為參考,並在相同的實際使用情境下重新測試。請勿將包含個人業務資訊或存取參數的完整連結設為測試目標;大部分連線測試使用不含隱私資訊的位址即可完成。
依測試結果追查實際故障
若測試失敗但實際服務正常,先確認是否只有測試目標無法連線;若是,就不必只因一筆診斷數值而更換目前可用的設定。若測試正常但服務仍無法使用,請回頭檢查該服務的實際請求:網域能否解析、是否符合預期規則、是否使用預期策略。網頁主文件可能正常載入,真正失敗的卻是登入 API 或靜態資源;此時應追查後者,不要只反覆測試首頁。
若所有現有伺服器在同一網路下測試都失敗,先用已知正常的直連目標確認本機網路,再於條件允許時維持伺服器與設定不變,改用另一種網路重新測試。若只有一台伺服器異常,先確認從服務商取得的位址、連接埠與協定參數是否仍適用。不要自行填入不明參數;記錄問題發生在哪個階段,比只寫「逾時」更有助於後續求助。
過去沒有測試基準的裝置,可先保留一次正常時的測試紀錄。日後出現間歇性故障時,用這份紀錄判斷變化來自網路、目標還是應用程式設定;不必為了追求更低的延遲數值而頻繁調整正常設定。
05 請求記錄
Log:依時間定位解析、規則與連線問題
短時間記錄,只重現一個操作
Log 適合用來查明單次請求在哪個步驟失敗,不適合用來判斷整份設定檔是否一切正常。日常建議保留目前的記錄等級;發生問題且現有資訊不足時,再依介面提供的選項暫時提高詳細程度。診斷前先記下原本的等級,完成後還原,不要長期以詳細記錄作為預設。不同裝置顯示的欄位可能不同;介面未顯示某個欄位,不代表對應步驟沒有發生。
開始前記下目前時間、網路類型、啟用的設定檔與 Global Routing 模式。關閉會產生大量無關請求的前景頁面,再只執行一個容易重現的操作,例如重新開啟一個公開網頁。記下操作時間,再查看記錄中的前後項目。重現問題時不要同時更新訂閱、切換伺服器或重新整理其他應用程式,否則同一時段會混入多項變更,難以判斷哪些記錄與問題直接相關。
依故障階段解讀,不要只看最後一行
先確認是否能辨認目標,再查看是否有解析結果、規則命中、策略選擇或連線錯誤等線索。若記錄顯示目標無法解析,先檢查 DNS 與本機對應。若能辨認目標,但策略不符,請回到 Config 檢查啟用的設定檔與規則順序。若請求已依預期進入代理路徑但連線失敗,先檢查路徑是否可達、協定參數是否相符,不要繼續新增規則來掩蓋問題。
同一個操作通常會產生多筆請求,包括主文件、圖片、登入狀態查詢與其他資源。看到某筆 DIRECT 或 REJECT,不能直接認定它就是失敗原因。先確認該筆記錄的目標確實對應到失敗資源,再以相同操作重新測試。若只有部分頁面功能異常,先找出缺少的是哪項資源,不要把所有時間接近主網域的記錄都當成異常。
重現問題後若沒有看到新記錄,先確認操作是否真的產生了新請求,例如應用程式是否直接顯示快取內容,或沿用了舊連線。接著檢查連線狀態、目前模式與可用的記錄範圍。記錄空白本身無法區分未建立連線、未記錄或應用程式沒有發出新請求。用一個能穩定觸發的新操作作為對照,通常比清空所有記錄並盲目提高詳細程度更容易找到問題。
比較兩次記錄時,請保留時間順序與對應條件。若第一次顯示解析失敗,第二次變成連線逾時,不必斷定問題變嚴重;可能是解析已恢復,測試才首次進入連線階段。反過來說,新記錄不再出現錯誤,也不足以證明問題已解決;若應用程式仍未完成預期操作,就應確認它是否真的送出了請求。
分享前只保留診斷所需資訊
記錄可能包含網域、完整 URL、查詢參數與內部網路位址,有時也會顯示伺服器名稱或帳戶相關資訊。向他人說明問題時,只摘錄能說明發生時間、模式與錯誤類型的最少內容。請遮蔽帳戶識別資訊、憑證、訂閱連結與不必要的位址;不要直接貼出完整原始設定檔。分享截圖前也請檢查畫面周邊,避免一併顯示伺服器名稱或其他請求。
提交問題時,可以寫明:「在同一個 Wi-Fi 網路使用相同伺服器,Config 模式失敗、Proxy 模式正常;已確認失敗請求符合某類規則。」這樣既交代了可重現的結果,也比只貼一行錯誤訊息更有幫助。排查完成後請還原記錄等級;若要保留資料供後續比對,只留下必要且已去識別化的摘要。常見情境與術語可分別參閱常見問題和名詞解釋。
若問題只發生一次,短期內無法重現,請勿依據不完整記錄大量修改設定。先記下原有狀態與已知資訊,等問題再次發生時補上網路類型與實際目標,日後才能確認兩次是否屬於同一問題。
06 快速操作
Widget:顯示狀態與快速操作
先在 Home 建立可靠的操作基準
Widget 適合用來查看連線狀態或執行介面提供的快速操作,但不是設定分流、編輯檔案或檢查個別請求的入口。尚未確認手動連線可正常運作時,不必急著加入小工具。先在 Home 確認伺服器、模式與連線結果,並測試一項實際服務,再決定是否要將快速操作加入系統提供的位置。小工具能否加入、顯示哪些資訊及是否能直接操作,請以目前裝置的系統介面為準。
建議先在應用程式內操作,視需要再加入小工具,不要把小工具當成使用用戶端的必要條件。加入前先確認用途:若只是偶爾查看連線狀態,優先選擇資訊較少的版面;若要簡化切換操作,則在系統允許的範圍內選擇支援相應操作的版面。新增小工具不會變更應用程式目前的設定,也不代表小工具暫時未顯示就是代理連線失敗。
新增後驗證一次操作與一次更新
先在系統的小工具清單中尋找 Shadowrocket,選擇實際可用的版面,並放到需要的位置。若系統清單暫時找不到,請確認是否已開啟過應用程式、目標位置是否支援該版面,再重新進入系統的小工具加入介面確認。不要因為找不到小工具就重設 DNS、訂閱或設定檔。小工具入口與應用程式發出的網路請求屬於不同層面;前者不存在,不代表後者無法運作。
驗證時先從明確的狀態開始,例如確認 Home 顯示未連線,再執行一次可用的小工具操作。若該操作只是開啟應用程式,請在應用程式內確認結果;若會直接變更連線,請等系統狀態更新後再測試實際服務。狀態更新前不要連續點按;重複執行相同操作後,最終狀態可能又回到起點,難以分辨是更新較慢還是操作未生效。
接著反向驗證一次:在 Home 變更連線狀態,再返回查看小工具是否同步更新。若顯示前後不一致,請交叉核對應用程式內的目前狀態、系統 VPN 狀態與實際存取結果。小工具內容可能受系統更新時機影響;狀態變更不代表所有服務都能即時連線。例如顯示已連線,但某個網站仍無法開啟,此時應檢查分流與請求記錄,而不是移除小工具後重新安裝。
不要混淆自動連線與手動操作
小工具看起來無法中斷連線時,請確認是否啟用了 On Demand。若手動中斷後,系統因符合條件而再次連線,最後看到的仍可能是已連線狀態。若要確認小工具的操作結果,可記錄並暫時停用按需條件,再於穩定網路下重現一次;測試完成後還原原值,並重新測試日常情境。這樣可分辨操作未生效、連線被自動重新啟動,或狀態顯示延遲。
若只是小工具顯示更新較慢,先觀察重新開啟前景畫面後是否有變化,再考慮移除並重新加入小工具。此操作只需處理系統端的小工具,不必刪除應用程式內的設定或帳戶資料。更換版面後,請再次確認是否保留所需入口;特別是原本用於切換連線的版面與僅顯示摘要的版面,不能只因位置相同就視為可以互換。
共用裝置或經常展示畫面時,請先檢查預覽是否會顯示伺服器備註等不宜公開的資訊。有合適的簡潔版面就使用簡潔版面;若沒有,請直接在 Home 查看。移轉至新裝置時,也應分別確認設定檔已就緒,以及小工具是否需要重新加入;兩者不能互相證明。只要應用程式內的手動連線正常,快速操作入口可稍後再處理。
Home 狀態 → 系統 VPN 狀態 → 實際存取 → Widget 顯示。先找出哪個環節不一致,再決定要調整什麼。07 跨裝置資料
iCloud:同步、還原與覆寫範圍
先確認同步範圍,不要將同步當成備份
在 iPhone 與 iPad 之間整理設定時,請先區分三件事:還原 App Store 已購項目、從 iCloud 或檔案匯入資料,以及在應用程式中選取並啟用設定檔。已購項目紀錄用於取得用戶端,不會自動將同一份使用中的設定移至新裝置。將檔案存入 iCloud,也不代表應用程式的本機伺服器清單、使用中狀態、快速操作入口與裝置端開關都會一併移轉。請分別確認每個環節。
使用既有設定時,可先在 Settings 查看目前可用的 iCloud 相關選項,再檢查系統帳戶、iCloud 權限與網路狀態。不要預設新裝置一定已啟用同步,也不要因為看不到檔案就認定資料已遺失。啟用前先確認介面說明涵蓋哪些資料;若未明確指出某個項目會同步,就應在目標裝置上重新核對。尤其是與網路環境相關的按需條件、系統權限與小工具,不要只因雲端有檔案就認定已完整還原。
建議設定取決於使用需求:只在一台裝置使用時,可維持目前狀態;需要移轉時,先確認哪台裝置上有要保留的完整版本,再使用介面提供的匯出、匯入或同步功能。重要資料請先另外保存一份可獨立還原的副本。持續同步也可能同步刪除或覆寫操作,因此「另一台裝置看得到」不等於「誤刪後一定找得回來」。
依來源、內容與啟用狀態逐項移轉
先在來源裝置記錄目前使用的檔案、伺服器選擇與模式,並區分本機編輯的設定檔和從服務商取得的訂閱。若原設定中另有獨立儲存的規則檔或遠端參照,請確認目標裝置具備存取這些項目的條件;主檔案就緒,不代表所有相依項目都可用。移轉前不要在兩台裝置上同時編輯同名項目。名稱可以完全相同,但檔案內容與匯入時間可能不同。
在目標裝置看到匯入項目後,先開啟並確認少量容易辨認的內容,例如自行新增的規則、明確的兜底策略或正確的伺服器備註。介面若顯示 Import from Cloud JSON,請使用該入口支援的資料格式,不要將任意 .conf 檔案改副檔名後當成 JSON 匯入。不同入口處理的資料範圍可能不同;先確認匯入結果,再選取要啟用的檔案,最後返回 Home 手動測試連線。
同名檔案發生衝突時,先保留兩份副本,不要用「最近顯示的那份」覆蓋來源檔案。逐項比對使用中的規則、解析覆寫與相依來源,確認需要哪一份後,再於目標裝置啟用。連線尚未確認正常前,不要急著啟用自動觸發。等必要的公共或內部目標都能如預期存取後,再依新裝置的使用情境調整按需條件,避免將舊裝置上的暫時排除條件原樣帶過去。
以單一測試項目確認同步是否正常
若不確定同步方向或所需時間,可先使用不含憑證的測試設定檔,在一台裝置上做一項容易辨認的小修改,並記錄另一台裝置是否看得到。若沒有變化,先確認兩端是否使用同一帳戶、應用程式權限是否允許、檔案是否屬於實際同步範圍,以及網路是否正常。不要反覆登入登出、刪除正式設定檔,或在兩台裝置上同時修改來催促同步。
包含伺服器憑證或私人訂閱位址的資料,應視為敏感檔案保存。只在你掌控的帳戶與裝置之間處理,不要將設定檔放進公開共用資料夾。匯出前請確認會一併匯出哪些內容;匯入完成後,若留下暫存副本,請決定是否保留以及存放位置。移轉結果穩定前不要急著清理來源裝置,這樣若發生規則遺失或同步覆寫,仍有原始檔可供比對。
若目標裝置已顯示伺服器但連線失敗,先確認憑證、目前網路與必要權限,再判斷是否為 iCloud 同步遺漏資料。分別記錄「檔案可見」、「內容正確」與「實際可用」,就能確認應回到哪個步驟修正。
08 本機監聽
Proxy 連接埠:監聽位址、協定與使用範圍
區分遠端服務連接埠、本機連接埠與分流模式
在 Add Server 或伺服器詳細資料中填寫的連接埠,是遠端伺服器接收連線的位置,應與協定參數一併向服務商取得。若設定中提供 Proxy 監聽項目,該處的連接埠則是本機接收代理請求的位置,供需要連線至此的應用程式或裝置使用。Global Routing 中的 Proxy 指的是流量處理模式,不是連接埠設定,也不會將遠端連接埠變成本機連接埠。三者都與代理有關,排查時請依照設定入口區分。
若只在本機使用系統 VPN 連線,建議保留本機監聽項目的原狀,不要額外啟用供其他裝置使用的入口。沒有明確需求時,不要指定固定連接埠,也不要照抄其他地方範例中的數字。目前值應以介面顯示與實際監聽狀態為準;若應用程式未顯示某種監聽類型,就不要假設它有對應位址或預設連接埠。只有輔助應用程式必須明確設定代理時,才確認所需的監聽協定、位址與連接埠。
成套確認位址、協定與連接埠
若監聽只綁定回送位址,例如 127.0.0.1,只有同一台裝置能透過該位址連線。另一台裝置若填入自己的 127.0.0.1,連到的是該裝置本身,不會連到執行 Shadowrocket 的裝置。這類錯誤常會立即遭拒,或一直等待。遇到問題時,先確認兩端是否為同一台裝置,再判斷是否需要調整監聽範圍;不要只為了修正位址填錯,就將服務開放給所有網路。
連接埠號碼相同,不代表使用相同協定。需要 HTTP 的應用程式,不能只憑連接埠號碼連線至只接受 SOCKS5 的入口;同樣地,本機連接埠可連線,也不代表遠端伺服器或實際目標正常。請先確認發出請求的一端能使用介面提供的協定,再以不含私人參數的目標進行驗證。若本機可連線至連接埠,但服務請求仍不通,接著應檢查協定交涉與出站策略,而不是不斷更換連接埠號碼。
同一裝置上已有其他程序使用相同監聽位址與連接埠時,常會發生連接埠衝突。若介面提示無法監聽,或儲存設定後新的入口始終無法連線,請先確認該位置是否已被其他服務占用。確實需要更換時,選擇目前可用且獲准使用的連接埠,記下舊值,並同步更新所有相依應用程式。只修改提供連線的一端,會讓其他端仍使用舊設定;表面上像是代理故障,實際上可能只是連線端仍指向舊位置。
只在可信任的範圍內啟用跨裝置存取
確實需要跨裝置存取時,先確認應用程式明確支援相應的監聽方式、系統權限允許,且網路允許同一區域網路中的裝置互相存取。請勿將本機監聽入口暴露於公共網路,也不要設定路由器連接埠轉送。公共 Wi-Fi 與訪客網路可能會隔離裝置;即使兩台裝置顯示相同網路名稱,也不代表彼此能連線。若網路政策明確禁止互訪,請改用獲准的環境,不要嘗試繞過隔離。
裝置切換至其他網路後,區域網路位址可能改變;舊位址即使格式正確,也可能已不再指向本機。若只有跨裝置請求失敗、本機仍可使用,先確認連線端指向的是不是目前位址,再檢查監聽範圍與網路互訪權限。若應用程式無法依需求限制存取來源,寧可保留本機監聽或關閉共用功能,不要將暫時測試設定用於日常運作。
使用其他裝置測試完成後,請關閉暫時啟用的監聽或共用項目,並清除連線端儲存的舊設定。保留一份不含私人位址的簡短紀錄,註明當時使用的協定、連線範圍與失敗階段。日後若只有桌面或行動裝置上的單一應用程式發生問題,可先依這份紀錄確認它是否依賴該入口,再決定要檢查設定還是服務請求本身。