官方手冊 · 設定項目參考
Shadowrocket 設定手冊
本手冊以 iPhone / iPad 介面為操作基準。若尚未匯入自己的訂閱或伺服器資料,請先依使用說明完成首次連線;若要查詢某項設定何時生效、變更後如何驗證或還原,請依本頁目錄查閱。其他平台請以各自介面提供的選項為準。
- 設定基準
- 先記下原值,再確認生效範圍
- 調整與驗證
- 一次只改一項,使用相同請求複測
- 還原
- 先還原這次變更,再擴大排查範圍
Settings 與生效範圍
調整前先釐清三件事:連線是否已建立、新請求應採用哪種轉送方式,以及設定是套用於目前的 Config,還是整個用戶端。先從 Home 確認連線和 Global Routing,再到 Config 確認目前啟用的檔案,最後才在 Settings 查找相關項目。檔案名稱出現在清單中,不代表它已啟用;編輯過檔案,也不代表目前的請求一定會使用它。若能登入但某項內容載入失敗,先記下具體失敗的操作,不要把整個頁面的狀況當成單一請求的結果。
記錄預設來源與還原依據
本手冊會區分出廠預設值、檔案指定值和裝置目前值。首次使用時看到的值,可能已受匯入的設定、系統權限或還原資料影響;清空輸入欄位,也可能代表沿用其他來源,而非關閉該功能。對於沒有可查證統一預設值的項目,以下各章會提供可重複測試的起點,不會將建議值說成預設值。請保留修改前實際顯示的狀態,包括空白、自動取得或明確填入的值,而不只是看起來可用的數字。
Global Routing 的三種模式
| 模式 | 處理原則 | 適合用來驗證 |
|---|---|---|
| Config(設定) | 依照已啟用的設定檔比對規則。 | 確認某個目標是否符合預期的規則。 |
| Proxy(代理) | 由代理處理進入用戶端轉送範圍的流量。 | 在相同網路下確認透過代理是否能連線。 |
| Direct(直連) | 直接連線至進入用戶端轉送範圍的流量所要存取的目標。 | 確認相同目標透過直連路徑是否可用。 |
Direct 不代表中斷連線。進行比較時,先讓用戶端保持連線,分別在兩種模式下送出新請求;若要確認用戶端介入前後的差異,再另外測試中斷連線。有些 App 會沿用既有連線,也可能直接顯示快取內容。切換模式後,請用新分頁或重新開啟相關功能,並在 Log 確認確實出現新紀錄。排查完成後,記得切回日常使用的模式,否則即使規則檔內容正確,也可能因測試後未切換回來而無法比對。
使用副本驗證規則與最終規則
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY
請將測試規則加到可還原的副本中,先確認它上方是否有比對範圍更廣的規則,再確認它沒有放在兜底項目之後。若面板顯示的動作是 PROXY,還要確認實際使用的伺服器;符合規則只代表選定了出口,不代表伺服器已成功建立連線。若 Log 中顯示的目標不是網址列中的網域,先判斷失敗的是主要請求、登入轉址,還是頁面附帶的資源,避免對錯誤的目標新增例外。各段檔案的用途請參閱設定檔結構說明。
排查時先記下操作時間、網路類型、啟用的檔案和模式。暫時變更設定值後立即複測;若沒有出現可解釋的差異,就還原原值再測下一項。即使問題在切換網路後消失,也能藉此分辨是設定變更生效,還是原本的網路狀況已不復存在。若相同結果無法再次重現,請保留當時的測試條件,不要把偶然恢復視為長期修復。
DNS:來源、回退與驗證
DNS 會將網域名稱解析為用戶端或下一個節點可使用的位址。即使連線開關已開啟,或 Ping 已有結果,也不能證明特定網站的網域解析正常。遇到解析失敗,先確認是所有目標都失敗,還是只有特定網域、某類內部網路名稱或最近變更位址的服務失敗。記下具體網域及發生時的網路,再確認目前使用的 Config 是否指定了解析方式;只看 Settings 中的一項選擇,不足以判斷每個請求使用哪個解析來源。
先確認來源,不要從空白推斷結果
檢查已啟用檔案中的 [General] 與 [Host]。前者可能指定解析服務,後者可能將部分名稱對應到固定位址。對應設定不是備用解析器,也不會隨目標自動更新位址;網站遷移後若只有少數名稱仍連到舊位址,應先檢查對應設定與快取。匯入的檔案也可能帶入原本沒有的指定值。若系統提供的解析設定、設定檔指定值和 App 內顯示值同時存在,請勿依填寫順序推斷最終優先順序;應根據實際請求紀錄、網域回應結果及單項變更比較來確認。
日常使用建議先沿用原有的解析設定。在家用或辦公室網路存取本機裝置時,先保留該網路提供的解析方式,因為公共 DNS 通常無法解析內部網路名稱。若要改用自己已確認的解析服務,請確認目前網路能連到該服務,並依用戶端實際支援的格式輸入。若選用加密 DNS,服務位址、加密方式與憑證使用的名稱必須相符;有些服務位址本身也需要先完成解析。改用加密 DNS 不等於修復連線問題,也不要透過忽略憑證錯誤來測試常用設定。
使用兩個目標測試,每次只更換一項條件
- 保持目前的網路、伺服器和 Global Routing 不變。選一個可正常存取的一般目標作為對照,再選一個失敗的目標,分別送出新請求。記錄是否取得位址、之後是否出現連線錯誤,以及解析錯誤和連線錯誤各自對應的目標。
- 只在設定副本中變更解析設定,不要同時刪除
[Host]項目或修改分流規則。依原本順序重新測試兩個目標;若結果走上不同的轉送路徑,先釐清路徑差異,再評估解析結果。若只有內部網路目標受到影響,先還原原解析設定,再回到能重現問題的網路測試。 - 看起來仍在使用舊位址時,先確認 App 是否沿用了舊連線。重新建立測試工作階段;必要時等名稱快取到期後再比較一次。測試完成後還原已啟用的檔案與原值,避免下次誤把測試設定當成日常基準。
分辨回退成功與後續連線失敗
設定多個解析服務,不代表它們只會依輸入順序運作。不同設定可能允許重試、回退或並行查詢;解析成功也可能來自另一個服務。若要判斷單一服務是否可用,請在可還原的測試副本中單獨檢查,不要只以最終頁面能否開啟作為依據。更換解析服務後,若網域已取得結果但仍無法連線,應改查規則動作、位址類型、連線或憑證;繼續更換 DNS 往往會錯失更有價值的線索。
若網域首頁能開啟,但登入或圖片載入失敗,請檢查轉址後的網域及資源網域。它們可能使用不同解析方式,也可能走上不同路徑。直接改用 IP 位址存取,往往會改變憑證驗證和伺服器識別條件,不能據此斷定「只有 DNS 出問題」。若問題時好時壞,可記錄是否總在切換網路後發生,以及能否在相同條件下再次觀察;這些資訊比零星的成功截圖更適合與 On Demand 觸發紀錄一併比對。
On Demand:觸發條件與退出
On Demand 負責讓系統依條件嘗試建立連線,不會決定特定請求應走 PROXY 還是 DIRECT,也不會驗證伺服器是否可用。先在 Home 手動連線並實際存取內容,再開啟 On Demand 進行測試。若手動連線本身就失敗,自動觸發只會反覆嘗試同一條無法連通的路徑,容易讓人誤以為是觸發條件設定錯誤。
分開記錄目前開關狀態與觸發條件
建議以關閉 On Demand、手動連線作為測試起點,而非把關閉視為所有裝置的預設狀態。系統還原、裝置管理設定和既有選項,都可能使目前狀態與另一台裝置不同。開啟前先記下開關狀態、介面列出的網路條件和例外。確認系統已允許 Shadowrocket 使用相應的 VPN 設定;若裝置由組織管理,部分設定可能受到限制,請依管理規範確認,不要移除其他設定來試圖取得相同介面。
將使用情境寫成可驗證的描述,例如:「在指定的 Wi-Fi 上手動操作,不自動連線;離開該網路後再確認是否依條件嘗試連線。」先從確實需要的單一網路情境開始,規則盡量精簡;若介面提供網路類型或 Wi-Fi 名稱條件,依實際選項設定。系統判斷的是目前的連線條件,而不是路由器外觀或實際所在位置。名稱相似、不同地點使用相同名稱,或裝置自動切換到其他網路,都可能使實際觸發結果與預期不同。
分別驗證符合條件、不符合條件及還原
- 在已確認可手動連線的網路上啟用所需條件。切換至符合條件的環境,送出一次新請求,比較切換前後的連線狀態。記下狀態開始變化的時間和當時實際使用的網路,避免將尚未切換完成的狀態當成最終結果。
- 接著換到不符合條件的網路進行反向測試。查看是否出現新的自動連線嘗試,同時分辨既有連線持續存在與系統發起新連線的差異:條件未觸發,不一定代表系統會主動中斷先前建立的連線。
- 測試結束後先關閉 On Demand,再到 Home 手動中斷連線,接著送出相同的請求。若中斷後又出現連線,請確認觸發設定是否確實關閉,以及系統顯示的活動連線是否屬於 Shadowrocket。只操作這次測試涉及的設定。
已自動嘗試連線,但服務仍無法使用
若介面顯示已有連線嘗試,先確認請求發生時是否能連到伺服器,不要急著擴大觸發範圍。公共 Wi-Fi 可能需要先在瀏覽器完成連線確認;行動網路剛恢復時,系統顯示有訊號也不一定代表能連到目標。可暫時關閉 On Demand,依目前網路的正常流程完成連線,再手動連線確認。成功後重新測試相同的觸發條件;若手動連線仍無法使用,優先排查網路、DNS 和既有伺服器參數。
若問題只在鎖定螢幕後、返回前景後或切換網路途中出現,請分開測試這些動作,避免把時間上的先後誤認為設定造成的因果。記錄是否有新請求、舊連線是否已結束,以及介面恢復顯示時的狀態是否與系統一致。若不同裝置在相同條件下結果不同,先比對系統連線設定和管理限制,不要直接複製整份設定。若要將自動連線設為日常使用方式,先在常用網路各驗證一次連線觸發和退出條件,再逐項加入例外;每次驗證只新增一項變更。
Ping:測試方式、逾時與結果判讀
Ping 或 Connectivity Test 的結果只反映本次測試在所選條件下的狀況,不代表所有 App 都能透過這條路徑存取,也不等於日常下載速度。先確認裝置實際提供的測試方式,再解讀結果。不同測試可能檢查伺服器位址是否回應、連接埠是否可連,或針對指定目標送出一次應用層請求。即使結果都以毫秒顯示,測試起點和終點不同,數值也不能直接排列比較。
分辨測試方式、目標與等待時間
| 觀察結果 | 可以得出的結論 | 無法據此判斷 |
|---|---|---|
| 可連線至連接埠 | 本次至少能與目標建立相應的傳輸連線。 | 代理協定參數正確,或業務網站可正常存取。 |
| 測試請求收到回應 | 該目標在本次測試條件下有回應。 | 其他網域、協定或較長時間的連線也正常。 |
| 本次逾時 | 在等待時間截止前,未收到此項測試預期的回應。 | 伺服器已停用,或問題必然發生在伺服器端。 |
判讀時以裝置實際顯示的測試方式、測試位址和逾時設定為準。有些介面只提供測試入口,沒有提供個別參數,不能據此推測底層測試方式。若可編輯測試位址,請選擇自己有權使用、回應穩定且不需要登入的目標。需要登入驗證、會跳轉至連線確認頁或需要工作階段資訊的位址,不適合作為長期基準。沒有特殊需求時保留原逾時設定;若網路確實不穩且介面允許調整,可暫時延長一次,確認原結果是否受到等待時間影響。等待更久不代表連線更快。
建立可比較的測試紀錄
- 使用同一台裝置,固定目前的網路、測試方式和目標。選一台既有伺服器單獨測試,記錄成功、逾時或明確錯誤,不要只記下成功時的最低數值。變更設定前先標記原始結果,方便還原後判斷變化是否持續。
- 在相同條件下複測數次,分別記錄持續失敗、偶發失敗及成功所需時間的波動。大量測試伺服器時,裝置的網路負載和伺服器端回應都可能改變;若要分析單一問題,先停止批次測試,再針對可疑項目複測。
- 回到 Home 進行一次實際存取,並查看對應的 Global Routing 和 Log。若測試正常但實際服務失敗,請繼續分辨規則選路、網域解析、協定交握和服務回應,不要以測試結果否定服務故障。
何時不該繼續調整 Ping
若連接埠很快就能連上,但服務始終無法使用,先確認既有伺服器資料中的位址、連接埠、協定和對應的驗證參數。連接埠開啟不代表其提供的服務符合所選協定;直連測試與透過代理存取目標,也可能走不同路徑。若從 Wi-Fi 切換到行動網路後才恢復,應將結果記為網路條件比較,而不是認定延遲設定修復了故障;回到原網路並以相同條件複測,才能確認差異是否穩定。
若服務運作正常,只有測試失敗,先確認測試位址是否適用於目前的網路和測試方式。有些網路允許實際服務正常運作,卻不回應另一種測試;反過來,簡單測試有回應,也可能掩蓋長時間連線中的中斷。遇到間歇性問題時,記錄重現所需的網路、操作和時間,比不斷提高逾時值更有幫助。若要比較兩次設定變更,只比較使用相同方式、相同目標及相近網路條件取得的結果;若無法符合這些條件,就分開記錄,不要直接比較數字。
Log:依時間定位失敗階段
Log 可用來確認某次操作存取了哪裡、選了哪條路徑,以及在哪個階段停止。開始前,先將問題縮小為一個可重複的動作,例如開啟特定頁面,或點選 App 中相同的功能。記下大約時間,停止與測試無關的重新整理,再送出一次請求。單一操作可能同時連線至登入服務、資源服務和業務服務;直接把 Log 最後出現的錯誤等同於主要請求失敗,往往會把偶發的背景請求誤認為故障原因。
先從目前的 Log 詳細程度開始
預設先以目前顯示的紀錄詳細程度為準。只有在現有紀錄不足以分辨解析、比對和連線階段,而且介面提供更詳細的選項時,才短暫提高詳細程度。測試前記下原本的設定,完成後還原,避免長期累積與排查無關的內容。若要保留前後比較,可記下測試時間以界定觀察區間,不必先清除全部歷史紀錄;只有確定舊紀錄已無保留需要時,才考慮使用介面提供的清除功能。
依階段閱讀,不要把前一階段成功當成全程成功
- 先定位目標。以時間和網域縮小範圍,確認 Log 中的實際目標是否符合發生問題的功能。若只有資源請求出錯而主要請求成功,就針對該資源檢查;若找不到預期項目,先確認 App 是否真的送出了新請求,而不是讀取本機快取。
- 接著查看路徑。若看到
DIRECT或PROXY,請配合目前的 Global Routing 和已啟用檔案理解結果。若依規則比對進入某條路徑,確認目標是否已被前面的項目提前比對,或是否符合FINAL;不要只根據檔案最後一行推斷實際路徑。 - 最後確認停止的位置。解析錯誤、連線遭拒、連線逾時、協定驗證失敗和服務回應異常,各自需要檢查不同項目。部分路徑可能在另一端進行解析,本機紀錄不一定呈現完整過程;若缺少資訊,請註明未觀察到,不要補上不存在的證據。
例如,頁面文字可以顯示,但圖片始終載入失敗。先比對兩者實際使用的網域、選擇的路徑和停止位置。若圖片請求符合了範圍比預期更廣的規則,可在副本中只調整這項比對關係,再比較變更前後的結果;若它原本就選中預期路徑,卻顯示目標拒絕連線,就應檢查連接埠和實際服務。只有確認問題發生在解析階段,才需要回頭調整 DNS,不要順手一起變更代理、解析和規則。
沒有紀錄與需要分享時的處理方式
完全找不到目標紀錄時,先確認查看的時間範圍正確,且裝置時鐘與紀錄時間沒有偏差。接著比對 Home 的連線狀態和本次操作所屬的 App,確認它是否真的產生網路請求。有些紀錄可能因詳細程度、篩選條件或流量處理範圍而未出現在目前畫面。可先用已知能重現問題的目標確認觀察方式有效,再比對故障目標。沒有看到項目,只表示目前畫面沒有顯示相關資訊,不能單獨證明請求未曾送出。
若要交由同事協助確認,可將重現步驟寫成:「固定網路,維持相同檔案和模式,送出一個新請求」,並附上預期結果與實際結果。說明期間只變更了哪一項,以及還原原值後能否再次重現。這樣才能分辨偶發異常和可重複的設定差異。完成後還原 Log 詳細程度、中斷僅為排查而暫時建立的連線,並確認沒有留下為查看 Log 而開啟的額外設定。
Widget:顯示狀態與操作範圍
Widget 是用來查看資訊或觸發操作的系統入口,不是另一套設定。實際可用的尺寸、位置和操作方式,取決於裝置、系統,以及 Shadowrocket 在該裝置上提供的功能。確認目前連線和 Global Routing 時,應回到 Home 查看;Widget 顯示可能受系統更新時機影響,不能將它視為即時 Log,或 App 內狀態逐畫面的同步呈現。
以尚未加入 Widget 作為測試起點
Widget 是否已加入取決於系統版面;裝置還原後也可能帶回先前的版面設定。不需要快捷入口時,維持系統目前的版面即可,不影響在 App 內連線。若要使用,先確認 Shadowrocket 可正常開啟,並完成首次連線所需的系統確認;接著進入系統支援的 Widget 新增介面,搜尋 Shadowrocket,依系統畫面選擇尺寸和位置。不要根據其他裝置的截圖推斷本機一定有相同選項,也不要把在系統中新增或移除 Widget 當成修改 Config。
選擇版面前先確認用途:只需在主畫面查看日常連線狀態,還是需要從系統支援的位置執行快捷操作。不同尺寸可能顯示不同資訊;若只需要查看狀態,就不必為了額外欄位占用更大的空間。若裝置會由他人使用,或螢幕容易在公共場所被看見,請先確認實際顯示的資訊,再決定是否放在顯眼位置。建議先新增一個 Widget,完成一次比較後再考慮其他位置,避免兩個元件因更新時間不同而造成誤判。
進行一次比較,分辨顯示狀態與實際操作
- 開啟 Home,記下連線狀態、目前的 Global Routing 和選用的伺服器。回到系統中 Widget 所在的位置,先不要點選,觀察顯示內容是否與剛才看到的狀態一致。若顯示更新慢於 App 內狀態,先視為顯示差異,而不是新的連線故障。
- 若目前的 Widget 提供可操作入口,只觸發一次。回到 Home 確認預期操作是否確實發生,再用一次實際請求驗證。若出現系統確認提示,先依提示確認是否繼續,不要反覆點選試圖強制更新。
- 分別在手動連線和啟用 On Demand 的情況下進行一次比較。若手動中斷後又自動連線,請依觸發條件與退出檢查系統行為;不能只根據 Widget 前後顯示的文字判斷連線是由哪個入口建立。
找不到入口、顯示延遲或操作無效
若系統搜尋不到 Shadowrocket,先開啟 App 確認基本設定已完成,再回到系統的新增清單,確認目前入口是否提供相應的 Widget。若 App 內運作正常,只有系統端狀態在切換連線後短暫不同,先等待系統更新,或回到 App 核對;不要為了修正顯示延遲而還原設定或更換伺服器。若多次比較後仍無法更新,可只移除該 Widget,再從系統清單新增一個,確認問題是否只出現在原本的元件。
若點選後只開啟 App,沒有改變連線狀態,先確認該入口是否支援直接操作,以及系統是否要求解鎖或進一步確認。若回到 Home 後可以手動連線,且實際流量正常,就在 Widget 層級排查。只有手動連線也失敗時,才進一步檢查 DNS、伺服器或規則。不再使用該入口時,請從系統版面移除 Widget,再到 Home 確認日常設定仍然存在。移除 Widget 不等於中斷連線,也不等於關閉 On Demand;這兩項應分別確認。
iCloud 同步:範圍、衝突與還原
iCloud 同步可在支援此功能的裝置之間,同步用戶端允許納入的資料。不要因此推斷所有設定、訂閱狀態、系統權限和執行中的連線都會保持一致。新裝置同步到某個項目後,仍需確認已啟用的 Config、目前的 Global Routing,以及系統連線許可。若只想一次性轉移可讀取的設定檔,可先確認 App 提供的匯出範圍,不必為了搬移單一檔案而開啟持續同步。
分別確認三項條件:系統、用戶端與資料範圍
先確認各裝置登入的是同一個 iCloud 帳號,並確認系統設定允許相應 App 使用 iCloud;最後在 Shadowrocket 中檢查實際顯示的同步狀態和支援範圍。系統允許 App 存取 iCloud,不代表用戶端已開始同步;用戶端有同步選項,也不代表所有資料類型都包含在同步範圍內。判斷時以兩台裝置目前實際顯示為準;若單一裝置不需要同步,可維持目前設定。首次測試建議以資料完整的裝置作為基準,不要在兩台裝置上同時整理資料。
iCloud 同步和從 App Store 取回已購買的 App 是兩種不同操作。前者涉及 App 資料和雲端狀態,後者涉及帳號中的 App 購買紀錄。能重新安裝 App,不代表本機設定檔或匯入內容也已取回。新裝置上的系統連線許可也應依實際提示確認,不要預期它會從舊裝置直接複製。若要確認取得方式,請依下載頁的已購項目還原說明區分 App 取得方式與資料移轉,再返回驗證同步狀態。
啟用前先備份,首次只驗證一個項目
- 確認哪台裝置上的資料最完整,使用用戶端實際提供的方式保存需要保留的設定副本,並記下未納入匯出範圍的項目。能匯出設定不代表能匯出所有狀態。若檔案包含自己的伺服器或訂閱資料,請存放在自己可控的位置,不要為了比對而上傳至公開目錄。
- 先讓另一台裝置暫停同時編輯,分別確認兩端的系統與 App 選項。選擇一份不含憑證且容易辨認的測試設定副本;若該類資料屬於同步範圍,就只觀察這一項是否出現。尚未確認結果前,不要刪除舊檔案來判斷同步是否開始。
- 目標裝置收到測試副本後,比較檔案內容和啟用狀態,確認是否仍需手動啟用。接著使用相同目標進行一次實際存取。若只是名稱相同但內容不同,先保留兩份副本,不要急著取代檔案或重複開啟同步。
同名檔案、同步延遲與誤刪
名稱相同不代表是同一個項目,也不能只依清單順序判斷哪個版本較新。發生衝突時,先暫停兩端編輯,分別保存需要保留的候選檔案,再比較實際內容,特別是 [General] 和 [Rule]。若暫時看不到同步動作,先確認系統是否允許存取、網路是否正常、雲端空間是否足夠,以及測試資料是否屬於已確認的同步範圍。不要一開始就反覆登出帳號、刪除 App 或清空雲端,這些操作會讓原始狀態更難確認。
需要還原至原狀時,請以變更前保存的檔案為準,不要在可能仍有變更待處理的兩台裝置上輪流修改。先在一台裝置上建立本機基準,確認重新啟用檔案後能恢復正常,再決定是否繼續同步。最後記下哪些內容已確認能在裝置間同步,哪些項目必須手動核對。下次更換裝置時,依照這份清單逐項驗證,不要因為上次某個項目成功出現,就認定所有資料都已還原。
Proxy 連接埠:監聽範圍與最低限度設定
若本機代理設定中有 Proxy 連接埠,指的是其他 App 連線至本機代理入口時使用的連接埠,不是已匯入伺服器在遠端使用的連接埠,也不是 Global Routing 的 Proxy 模式。先確認是否真的有 App 需要手動填寫代理設定。若只是在裝置上正常使用 Shadowrocket,不必為了讓 Home 能連線而開啟額外的監聽入口;修改本機連接埠也無法修復已失效的遠端連線。
確認協定、綁定位址與連接埠
先確認目前平台是否提供相應設定,再核對介面標示的本機代理協定、實際監聽範圍和連接埠。HTTP 與 SOCKS5 是不同的連線方式;使用端填錯協定時,即使能連上該連接埠,也可能無法完成有效請求。連接埠預設值以介面顯示為準,不能從遠端伺服器項目推斷,也不必為了與其他裝置使用相同數字而修改。若需變更,請選用用戶端明確支援且目前未被其他程式占用的連接埠,並同步修改實際使用該入口的 App。
同一台裝置上使用時,建議優先選擇只可從本機迴路連線的監聽方式,並讓使用端填入相同的位址類型。只有介面確實允許其他裝置連線,且你能控制測試網路和存取範圍時,才為明確需求暫時啟用區域網路存取。請勿在公共或共用網路上擴大監聽範圍、在路由器上為此入口設定對外連接埠轉送,也不要為了單次測試關閉系統防護。若介面未提供所需的綁定控制,請改用範圍可確認的方式,不要自行猜測位址代替。
依失敗位置逐項排查
| 現象 | 優先檢查項目 |
|---|---|
| 本機無法連上入口 | 確認監聽是否啟動、位址類型是否一致,以及連接埠是否填寫正確或已被占用。 |
| 連接埠可連,但請求失敗 | 確認使用端協定是否與監聽協定一致,再檢查 Log 是否出現目標請求。 |
| 本機正常,另一台裝置失敗 | 檢查監聽範圍、兩台裝置所在的網路,以及區域網路隔離政策。 |
先從本機進行一項可還原的測試。在明確支援手動代理的 App 中記下原有設定,填入已確認的協定、監聽位址和連接埠,接著只送出一次新請求。若無法建立連線,先確認入口是否存在,不要修改遠端連接埠。若已連到入口但請求仍失敗,再檢查 Log 是否出現與測試時間相符的目標。確認請求已進入用戶端後,再區分問題出在規則路徑、DNS 還是遠端協定。連上入口和存取目標是兩項獨立驗證。
本機使用的迴路位址不能直接作為另一台裝置存取此入口的位址,因為另一台裝置會將它解讀為自己的本機位址。若確實需要經核准在區域網路中使用,請確認監聽裝置在目前網路中的實際位址,以及兩台裝置是否受到訪客網路或組織政策隔離。切換網路後,舊位址可能已失效;不要因此將失敗歸因於伺服器參數。受管理的網路請依其使用規範操作,不要透過擴大開放範圍來規避限制。
本手冊以 iPhone / iPad 介面為基準;Mac(Apple 晶片與 Intel)、Windows、Android 和 Linux 是否顯示相同選項,請以各平台用戶端為準。取得方式分為兩種:iPhone / iPad 版由 App Store 取得,美國商店售價為 $2.99,一次性付費;系統需求以 App Store 頁面標示為準。Mac / Windows / Android / Linux 版免費,安裝檔由本站提供。用戶端一次性買斷 ≠ 線路方案。本網站不提供、販售或推薦節點及訂閱;連線與測試請使用自己已有的資料。各平台的取得方式與系統提示處理方法,請參閱下載用戶端。