Settings 參考 · 官方手冊

Shadowrocket Settings 設定手冊

本頁按項目說明設定,不取代首次連線流程。若尚未完成匯入與連線,請先閱讀Shadowrocket 使用教學;若已能連線,並想調整 DNS、自動連線或診斷行為,再依目錄查閱。本教學協助建立可運作的起點,本頁則說明各項變更的影響範圍、驗證方式與還原方法。

所有操作均以使用者已有自己的訂閱或伺服器資訊為前提。一次買斷用戶端 ≠ 線路方案。本站為 Shadowrocket 官方網站與手冊,不提供節點服務。購買與系統需求請參閱App Store 正版取得說明;系統需求以 App Store 頁面標示為準。

一、Settings、Config 與執行狀態的適用範圍

調整前,先確認問題屬於哪個層面。Settings 中的 App 偏好設定、Config 中選用的設定檔、Home 中選擇的伺服器與連線開關,並非同一種狀態。伺服器決定連線目的地與通訊協定參數,設定檔決定規則及相關處理方式,Global Routing 則決定目前採用哪種分流方式。只修改某項設定,不代表其他層面也會隨之切換;排錯時應分別記錄這些項目。

Global Routing 的三種模式

日常需要依規則處理要求時,請使用 Config,並確認 Config 頁面目前選取的檔案。Proxy 適合暫時確認代理路徑,Direct 則適合比對直接連線的狀況;兩者都不能取代修正錯誤設定。尤其不能因為切換至 Proxy 後某個網頁能開啟,就認定 DNS 和規則都正確:這只能表示在目前測試條件下,所選的代理路徑能完成該次連線。

介面用語主要用途確認重點
Config依設定檔決定分流目前檔案、規則順序與策略引用
Proxy比對代理路徑的連線狀況已選取的伺服器及其驗證與連線條件
Direct比對直接連線的狀況目前連線的網路與系統解析結果

預設值、目前值與建議值

預設值是 App 尚未經過相關調整時提供的初始狀態;目前值則可能已因使用者編輯、匯入設定或還原操作而改變。看到開關處於開啟狀態,只能確認目前已開啟,不能據此推斷初始狀態也是如此。本手冊建議:不清楚用途的選項先維持原狀;只有在能說明問題並知道如何驗證時,才進行修改。伺服器通訊協定相關欄位應依既有服務資料設定,不要以所謂通用參數取代。

建立基準不必清除資料。先記錄 Global Routing、目前 Config 檔名、選取的伺服器與相關開關;若要編輯設定檔,請先保留本機副本。接著選擇一個穩定且可重複連線的目標,記錄在目前網路下的狀況。每輪只變更一個條件,例如只更換 DNS、只切換伺服器,或只停用 On Demand,避免同時變更多項設定而無法判斷影響來源。

設定檔中的設定如何協助排錯

設定檔可以包含全域參數、規則與本機對應。以下片段僅用來說明結構,並非要求覆寫現有檔案。範例網域僅供教學使用,PROXY 必須在目前執行環境中有可用的代理選項;若原檔案使用特定策略名稱,請保留有效引用。匯入後還須確認已選取該檔案,並透過要求紀錄檢查實際命中結果,而不只是確認文字已成功儲存。

[General]
dns-server = system

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

[Host]
localhost = 127.0.0.1

修改後應完成三項驗證:目標要求是否成功、是否採用預期策略,以及其他常用目標是否仍正常。若失敗,先還原剛才變更的項目,再比較結果。若還原後仍有異常,請檢查測試期間是否切換網路、更新訂閱或更換伺服器。設定檔各區段的詳細結構請參閱設定檔結構詳解;首次匯入步驟仍以教學頁為準。

二、DNS:解析來源、設定覆寫與快取判斷

DNS 負責將網域名稱解析為可連線的位址,但解析成功不代表連線也成功。網頁無法開啟,可能是網域解析、連線至代理伺服器、連線至目標,或後續加密通訊等階段發生問題。調整 DNS 前,應先判斷故障發生在哪個步驟:確認紀錄是否顯示解析失敗、是否已取得目標位址,以及伺服器本身是否可用。僅憑瀏覽器顯示連線失敗,無法直接判定是解析器出了問題。

dns-server 與 system 的含義

在設定檔中,dns-server = system 表示使用系統提供的 DNS 解析來源。這是方便與目前網路狀況比對的建議基準,並非本手冊宣稱所有裝置的出廠預設值皆如此。系統解析條件也會隨連線網路而改變,因此同一份設定在不同 Wi-Fi 與行動網路下,可能有不同表現。若既有設定明確指定其他解析來源,請先了解指定原因,再決定是否還原。

需要指定解析服務時,請使用自己能確認、且符合目前網路需求的位址與格式。一般 DNS 與加密 DNS 的連線條件不同;後者還涉及服務網域、憑證,以及連往解析服務的網路路徑。將位址填入輸入欄位,不代表該方式一定可用;儲存後應確認 App 接受該格式,再透過新要求進行驗證。請勿將 DNS 位址填入代理伺服器位址欄位。

項目建議基準需要變更時
解析來源先記錄目前值,必要時與 system 比對已確認解析環節異常,且有可信的解析來源
本機對應保留明確需要的項目排查過期對應或固定位址的影響
IPv6 相關選項先維持目前狀態已有紀錄支持地址族路徑異常的判斷

先檢查設定檔與 Host,再更換解析器

若只有單一網域異常,請先檢查目前設定檔的 [Host] 是否有對應項目。明確指定的對應可能會讓要求繼續使用固定位址,更換解析來源未必會改變結果。接著確認規則是否將該網域交給不符合預期的策略。規則命中與 DNS 查詢是不同的判斷流程;即使觀察到代理連線失敗,也不能因此推斷網域解析到了錯誤位址。

快取可能讓變更後的第一輪驗證不容易判讀。系統、App 與目標網站所使用的連線,都可能保留既有狀態;切換解析來源後,已建立的連線不一定會重新解析。建議關閉正在測試的頁面並重新送出要求,必要時透過 App 提供的清除入口處理相關快取,再重新連線。不要把清除所有網站資料當成固定步驟,以免遺失與排錯無關的登入狀態。

IPv6、連線網路與解析故障的界線

有些目標同時提供 IPv4 與 IPv6 位址,但目前網路對兩種位址的連線能力可能不同。若紀錄顯示解析成功,但特定地址族的連線持續失敗,才考慮針對相關設定進行單項比對。直接關閉相關功能可能暫時改變狀況,卻不能證明根本原因已修復。請保留變更前的紀錄,並確認其他依賴該地址族的連線是否受到影響。

建議排錯順序:確認目前的 Config,核對 dns-server 與 Host 項目,檢查紀錄,再更換一項解析條件進行比對。測試期間維持伺服器與 Global Routing 不變。若只在某個連線網路下失敗,優先記錄該網路的系統解析與驗證狀態;若切換網路後仍失敗,再檢查設定檔本身。驗證完成後,撤銷未帶來改善的調整,避免將臨時測試設定長期留在設定檔中。

三、On Demand:自動連線的觸發與停止條件

On Demand 用來依據設定條件觸發連線,不會替你選擇正確的規則,也不會補齊伺服器資料。啟用前,請先確認手動連線可正常運作:既有伺服器能連線,目前的 Config 可正常使用,且已完成系統 VPN 設定授權。若手動連線本身就失敗,請先處理伺服器、DNS 或規則問題,否則自動觸發只會不斷遇到相同故障。

何時適合啟用

只有在使用情境具備明確條件時,例如希望在指定網路環境下自動建立連線,才適合設定 On Demand。首次設定建議先保持停用,完成手動驗證後再單獨啟用;此處的停用是排錯時的建議基準,並非宣稱 App 有統一的預設狀態。已啟用的裝置應先記錄目前規則與條件,不要直接刪除,因為其中可能包含使用者為特定網路保留的例外。

請在 Settings 中找到 On Demand,逐項檢視目前介面實際提供的條件。不同條件之間可能有比對與順序關係,應確認每條規則的動作及適用範圍。若使用網路名稱作為條件,請注意名稱僅供比對,並非網路可信度的證明;多個無線基地台可能使用相同名稱,名稱變更也可能使原有條件不再適用。

系統 VPN 授權與 App 開關的差異

首次建立連線時,系統可能會要求新增 VPN 設定。此授權允許系統建立相關連線,不代表已匯入伺服器,也不表示所有 App 設定都已完成。若授權流程中斷,請返回 App 檢查連線狀態,再依系統提示處理。不要反覆建立設定碰運氣;先確認現有設定與 App 的對應關係,再排查是否受到管理政策或其他連線設定影響。

啟用 On Demand 後,手動中斷連線與停止自動觸發是兩種不同操作。使用者可能才關閉連線,新的網路活動又符合條件,系統便再次發起連線,看起來像是「開關自己打開」。遇到這種情況,請先暫時停用 On Demand,再中斷連線進行比對。若沒有再次連線,就應檢查觸發條件,而不是直接將自動重連視為 App 異常。

狀況優先檢查驗證方式
手動中斷後又再次連線On Demand 是否仍啟用暫時停用後重複相同的網路活動
切換網路後未連線條件是否符合、是否已取得系統授權先手動連線,再確認觸發條件
已連線但無法存取伺服器、DNS 與規則在相同網路下進行手動連線比對

如何完成一次觸發測試

測試應涵蓋符合觸發條件、維持連線與離開條件三個階段。先記錄連線網路與目前連線狀態,再啟用 On Demand,依條件切換網路並進行一次正常連線。觀察系統連線狀態與 App 紀錄,確認連線確實由預期條件觸發。接著離開符合條件的網路,檢查實際行為是否符合設定,不要只因首次觸發成功就結束驗證。

需要登入驗證的公共 Wi-Fi 應分開測試。網路尚未完成驗證時,解析與伺服器連線都可能受到限制;自動連線不能取代網路驗證。若驗證頁面無法顯示,可在清楚了解目前操作的前提下暫時停用自動觸發,完成網路驗證後再恢復原設定。不要將驗證期間的失敗紀錄與正常連網後的結果混在一起比較。

若裝置受組織管理,部分 VPN 行為可能受到系統政策限制,本頁的個人裝置操作無法突破這些限制。還原時,先停用 On Demand,再恢復原有條件與連線選擇,最後重新進行手動驗證。若有「中斷後又重新連線」或「只在某個網路觸發」等疑問,可繼續參閱常見問題,並保留當時的網路條件,不要只描述開關的顯示狀態。

四、Ping 與 Connectivity Test:測試結果的判讀範圍

Ping 與 Connectivity Test 用於觀察連線條件,不應視為實際服務品質的完整結論。測試成功一次,只表示當時採用的測試方式能完成相應的通訊;網頁、影片或其他要求仍可能因解析、規則、目標服務或通訊協定條件不同而失敗。測試前應先確認測試方法、目標與逾時條件,避免直接比較意義不同的數值。

測試方法決定數值的意義

請在 Settings 中找到 Ping 相關設定,先確認目前介面選用的測試方法。若提供 TCP 類型的測試,主要反映連線至目標連接埠的狀況;若提供透過代理發起的 HTTP 類型測試,還會涉及代理交涉、測試網址與回應流程。兩者測量的階段不同,因此即使顯示相同單位,也不能不加區分地認定數值越小就一定適合所有連線。

預設測試方式、測試網址與逾時值應以目前 App 顯示為準,本頁不預設固定數字。建議先使用現有設定建立可重複的基準,只有在測試目標本身無法連線,或測試方法不符合排錯目的時才調整。使用自訂測試網址前,請確認網址穩定且自己有權存取;不要將需要登入、經常轉址或限制自動要求的頁面當成通用連線測試目標。

逾時不代表所有要求都失敗

逾時表示測試未能在指定時間內完成,單憑這點不足以判定伺服器完全無法使用。原因可能包括連接埠無法連線、通訊協定參數不符、測試目標受到限制,或測試期間網路發生切換。反之,快速回應也不能證明大型檔案傳輸穩定。遇到逾時時,請先在相同條件下重新測試,再用一項正常服務要求進行驗證,並分別記錄兩者結果。

觀察結果可能涉及的環節下一步
測試失敗,實際使用也失敗連線網路、伺服器或通訊協定參數核對服務資料並檢查連線紀錄
測試失敗,實際使用正常測試方法或測試目標比對測試設定,不必急著更換伺服器
測試成功,部分網站失敗規則、DNS 或目標服務檢查失敗要求實際命中的策略

如何比較既有伺服器

比較時請維持連線網路、測試方法、測試目標與其他設定一致。先等待網路切換穩定,再對使用者已有的伺服器進行少量重複測試,觀察結果是否大致穩定,而不是挑選偶然出現的最低值。測試本身會產生網路要求;不必為了排序而頻繁連續測試,更不能將某個時間點的排序解讀為長期可靠度排名。

通訊協定欄位錯誤也可能造成「位址可連線但無法使用」。例如,連接埠連線成功只表示該連接埠有回應,不代表驗證資訊、加密方式或伺服器名稱等參數正確。請回到 Add Server 核對既有服務資料,特別注意複製時的空格、連接埠與欄位位置。不要為了讓測試顯示成功,就任意停用憑證驗證或變更通訊協定安全參數。

將測試結果與實際連線相互驗證

完成 Connectivity Test 後,請明確選取要用來驗證的伺服器,再確認 Global Routing 與目前的 Config。測試清單中的某個項目成功,不代表目前連線已切換至該項目;清單排序改變也不能作為切換成功的依據。請使用可重複的目標要求進行驗證,並從紀錄確認實際採用的路徑,才能將測試結果與實際連線對應起來。

若開關已開啟但仍無法存取,依序檢查網路、伺服器、模式、DNS 與規則,比反覆測試所有項目更容易找出問題。詳細流程請參閱連線開關已開啟卻無法存取的排錯清單。描述問題時應寫明測試方法與失敗階段,不要只提供逾時截圖;這有助於避免將測試目標故障誤判為伺服器故障。

五、Log 與 Data:要求紀錄、流量統計與隱私處理

Log 用來還原發生過的狀況,Data 則用來觀察 App 統計範圍內的資料變化,兩者用途不同。連線開關已開啟,只能表示已嘗試建立相關連線,不能證明每項要求都按預期處理。遇到異常時,應從一次可重現的要求著手,連結發生時間、目標網域、命中策略與錯誤訊息,而不是一次翻查大量歷史紀錄,尋找看似相關的項目。

如何選擇日誌詳細程度

請在 Settings 中確認 Log 相關選項與目前的紀錄層級。若介面提供不同的詳細程度,日常使用時保留足以觀察問題的層級;需要排查特定故障時,再暫時提高詳細程度。目前選取的項目才是該裝置的實際狀態,本頁不將任何層級指定為固定預設值。詳細日誌可能增加儲存與處理負擔,排錯完成後應恢復原設定,並視需要清理紀錄。

重現問題前先記下時間;必要時清理與本次排錯無關的舊紀錄,再只連線至一個目標。依序觀察:是否進行解析、是否取得位址、是否選擇策略、是否開始連線,以及最終在哪個環節失敗。不同紀錄行可能屬於並行要求,不能只因為相鄰就認定來自同一連線;應依據目標、時間與 App 顯示的關聯資訊判斷。

從規則命中確認設定是否生效

若原本預期某個網域走 PROXY,紀錄卻顯示 DIRECT,請先確認 Global Routing 是否設為 Config,再檢查規則順序與目前檔案。以下片段表示「指定網域優先走代理,其餘直接連線」。規則依序判斷,FINAL 放在末尾;範例僅用來說明命中邏輯,不代表應覆寫使用者現有設定。編輯後需重新送出要求,既有連線不一定會立即重新比對。

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

如果前面已有範圍較大的規則命中目標,後續規則不會因為寫得更精確就自動取得較高優先權。應檢查完整清單,不要只看新加入的兩行。DOMAIN、DOMAIN-SUFFIX 與 IP-CIDR 的比對對象各不相同,DNS 取得的位址也不等於原始網域。規則基礎知識請參閱規則關鍵字與比對順序。

為什麼 Data 數值不能直接視為帳單

查看 Data 時,先確認介面顯示的是目前工作階段、某個項目,還是累計數值,並確認是否曾重設。App 統計與服務提供方的帳單可能採用不同週期與計算方式;通訊協定額外流量、統計範圍與時間區間也可能不同。數值不完全相同,不代表一定異常;應先統一比較區間,再查看既有服務對流量的計算說明。

連線後仍有少量數據變化,可能來自正常的連線維護、解析或其他 App 要求,不能只憑計數增加就認定某個目標正在持續傳輸。若要判斷來源,應搭配要求紀錄查看。重設統計前先記錄原有數值與時間;重設通常是為了建立新的觀察起點,不會改變已產生的服務用量,也無法修復連線問題。

匯出與分享前的必要檢查

日誌可能包含瀏覽過的網域、伺服器位址、要求路徑或驗證相關內容;訂閱資料也可能帶有個人識別資訊。分享前應只複製必要片段,刪除密碼、完整訂閱網址、權杖及可識別個人的資訊。不要只遮住畫面上最顯眼的一行,卻保留其他位置的同類內容。若透過錯誤階段與少量上下文就能說明問題,就不必公開整份紀錄。

一份有效紀錄應能回答:何時測試、使用哪個網路、採用哪種模式,以及出現什麼結果。確認問題後,請關閉暫時提高的日誌詳細程度,視需要清理匯出副本,並恢復統計的觀察範圍。日後再次出現問題時,以相同方法收集新的最小重現資料,比長期保留大量含有敏感資訊的歷史內容更有助於判斷。

六、Widget:快速入口、狀態更新與系統限制

Widget 提供系統允許範圍內的快速入口或狀態顯示,不能取代 App 內的完整設定。Widget 能否即時更新、提供哪些操作,取決於目前 App 提供的元件與系統機制。設定前先在 Shadowrocket 中完成手動連線驗證,再新增系統可用的元件;不要因為元件已顯示,就認為伺服器已匯入、設定檔已選取或系統授權已完成。

新增前先確認 App 的基本狀態

先開啟 Home,確認目前選取的伺服器與連線狀態,再前往 Config 確認有效的檔案。若需要依規則分流,也應確認 Global Routing 設為 Config。接著檢查 Settings 中目前提供的 Widget 相關選項;只調整裝置上實際看得到的項目。本頁不預設元件數量、尺寸或固定按鈕排列,也不會將某種顯示方式視為所有裝置共通的預設狀態。

在系統新增元件的介面中搜尋 Shadowrocket,並選擇目前可用的樣式。若找不到入口,先確認 App 已完成首次開啟,再依系統目前的元件新增流程檢查。系統需求以 App Store 頁面標示為準。不要為了尋找目前介面中不存在的樣式而重設整份 App 資料;先返回 App 確認基本功能是否正常。

如何比對顯示狀態與實際連線

元件可能顯示上次更新時的狀態,不一定會與 App 內的即時畫面完全同步。若狀態沒有立即更新,請開啟 App 檢查,並透過實際要求進行驗證。系統連線標示也只是其中一項觀察資訊:它無法說明特定目標採用了哪條規則,更不能證明伺服器能連線至所有目標。判斷時應分別檢視元件、App 與要求紀錄。

狀況先檢查什麼不應直接推斷什麼
狀態未即時更新App 內的狀態與實際連線不能直接判定連線失敗
點選後仍需進入 App系統授權與目前操作需求不能判定所有快速操作都已失效
顯示的選項與預期不同App 內目前選取的伺服器與設定檔不能只靠元件判斷規則檔案

快速操作與 On Demand 的互動

若透過快速入口中斷連線後又重新連線,請先檢查 On Demand。元件執行的操作與自動連線規則可能接連觸發,最終狀態不能只用剛才的一次點選來解釋。若要暫時停止自動連線,應先在 App 中處理自動觸發條件,再中斷連線。反覆點選可能造成操作交錯,讓結果更難判讀;建議每次操作後等待狀態穩定再繼續。

裝置處於鎖定狀態、系統限制背景活動或需要額外確認時,快速操作的完成方式可能與直接在 App 內操作不同。請依系統實際提示處理,不要把背景權限、低耗電模式或更新設定視為必須全部放寬的固定清單。只有在能重現某項系統限制對目前功能的影響時,才進行單項比對,並在驗證後還原不必要的調整。

顯示內容與裝置隱私

元件放在容易被他人看見的位置時,顯示名稱可能透露伺服器用途或個人使用習慣。替使用者既有項目設定容易辨識、又不包含過多個人資訊的名稱,有助於降低誤選與資訊外露的風險。請勿將密碼、訂閱權杖或完整服務位址寫入名稱。名稱主要用於識別,不會改變伺服器驗證資訊,也不能用來判斷通訊協定設定是否正確。

建議先讓 App 內的流程穩定,再只保留自己確實需要的快速入口。移除系統元件通常不等於刪除 App 中的伺服器或設定檔,但實際清理前仍應確認操作對象。若問題只發生在元件中,先在 App 內重複相同操作;若 App 內也失敗,就進一步排查連線,不要繼續調整元件版面。如此可將系統顯示問題與網路處理問題區分開來。

七、iCloud 同步:資料範圍、衝突與還原順序

iCloud 相關功能可在目前支援範圍內儲存或同步 App 資料,不應視為所有執行狀態都會自動複製。伺服器項目、設定檔、App 偏好設定與系統 VPN 授權是不同類型的資料;實際支援內容應以目前 App 提供的入口與說明為準。首次使用前先保留可用的本機副本,避免尚未確認同步方向就覆寫唯一可正常使用的設定檔。

先區分同步、匯入與購買項目還原

App Store 已購項目還原用於恢復 App 的取得資格,不會還原使用者的伺服器與設定檔。使用原本的 Apple 帳號重新取得 App 後,仍應先檢查本機資料是否存在,再決定如何還原。購買步驟請參閱換機與已購項目還原說明。一般購買適用性以 App Store 頁面標示為準,不能因某台裝置已安裝,就推斷所有裝置上的資料都相同。

同步著重於多處資料之間的更新關係;匯入則通常是將選取的內容加入目前 App,兩者並不相同。看到 Import from Cloud JSON 時,應依該入口的要求選擇相應格式,不要把一般設定文字或訂閱網址當成同類檔案。匯入前先確認來源、內容類型與目的位置;操作後檢查是否產生重複項目,以及目前實際選取的項目是否仍正確。

預設狀態與建議啟用條件

iCloud 開關的目前狀態可能受到裝置系統設定、App 偏好設定與還原紀錄影響,本頁不宣稱有統一預設值。建議先在單一裝置確認資料有效,再依需求開啟同步。若只使用一台裝置且不需要同步,維持目前的使用方式即可。啟用前請確認系統允許 Shadowrocket 使用相關 iCloud 功能,並確認帳號與儲存空間狀態正常。

同步後不要立刻刪除本機副本來測試「雲端是否真的已儲存」。較穩妥的方式是在另一台已具備使用條件的裝置上檢查可見資料,並確認檔案內容、項目數量與必要欄位。同步完成的畫面提示也不能取代實際連線測試;系統授權、目前選取的伺服器與網路環境,仍須在該裝置上分別確認。

多台裝置同時編輯時發生衝突

不要在兩台裝置上同時修改同一份重要設定檔,再期待系統自動合併出正確結果。網路延遲或離線編輯可能使不同副本先後送達;修改時間較晚也不代表內容一定更合適。準備調整時,先指定一台裝置作為本次編輯設備,儲存副本並完成驗證後,再檢查另一台。發現差異時先比較內容,不要急著用其中一份覆寫所有資料。

階段執行內容完成條件
變更前儲存有效的設定檔副本,記錄目前的選取項目能找到可還原的本機資料
還原後檢查欄位、重複項目與選取狀態資料符合預期
重新使用手動連線並驗證規則目標要求與路由均符合預期

訂閱更新不等於雲端同步

訂閱更新會從使用者既有的訂閱來源讀取內容;iCloud 同步則涉及 App 支援的資料項目。某份本機設定已同步,不代表訂閱已更新;訂閱更新成功,也不表示另一台裝置已收到最新副本。排錯時請分別記錄這兩種操作,避免將「更新後項目變更」誤認為雲端覆寫。若需保留本機備註或編輯內容,也應先確認更新作業是否會影響它們。

匯出的資料可能包含伺服器驗證資訊,儲存與傳送時應視為敏感資料。刪除前先確認操作影響的是本機副本還是同步項目,不要假設刪除只會發生在目前裝置。完整還原順序應為:取得 App、還原資料、核對欄位、選取設定檔、處理系統授權、手動驗證,最後才恢復 On Demand。依此順序操作有助於找出問題,避免自動連線掩蓋資料尚未還原完成的狀況。

八、Proxy 連接埠:本機監聽、存取範圍與還原驗證

Proxy 連接埠相關設定須先區分兩種位址:伺服器項目中的遠端連接埠,以及本機提供代理入口時使用的監聽連接埠。前者屬於使用者既有的服務資料,後者則是目前裝置上的存取設定。修改本機監聽連接埠不會修正遠端伺服器連接埠填寫錯誤,也不會變更遠端驗證參數。排錯前先確認正在編輯哪一種欄位,避免將同一個數字填入所有位置。

何時需要調整本機連接埠

一般系統 VPN 連線流程不應只為了「最佳化」就任意修改本機 Proxy 連接埠。只有明確需要透過 App 提供的本機代理入口連線,或已確認存在監聽衝突時,才檢查相關設定。以目前 App 顯示的通訊協定類型、監聽位址與連接埠為準;本頁不指定固定預設連接埠。若介面未提供某項功能,不應參考其他資料自行虛構設定入口。

連接埠必須是有效數字,並與存取端填入的值一致。HTTP 與 SOCKS5 是不同的存取方式,不能因為都稱為代理就互換設定。連線遭拒時,先檢查監聽是否已啟動、位址與連接埠是否正確,以及所選通訊協定是否相符,再檢查後續遠端路徑。不要一開始就更換 DNS,因為要求可能尚未成功抵達本機代理入口。

本機位址與區域網路位址的差異

127.0.0.1 代表發起連線的裝置本身。另一台裝置填入這個位址,不會連到執行 Shadowrocket 的裝置。若要跨裝置存取,必須確認 App 目前確實提供並啟用了相應的存取功能,使用正確的區域網路位址,並確認兩台裝置可以互相連線。基地台用戶端隔離、不同子網路或裝置休眠,都可能導致連接埠無法連線。

開放更大範圍的存取會改變可使用此入口的對象,不應只為一次測試就長期維持。若 App 提供存取限制或驗證選項,應依實際需求設定;不需要共用入口時,建議限制在本機範圍,並停用相關的延伸存取功能。這是安全排錯基準,並非宣稱 App 出廠預設如此。請勿將本機代理入口暴露在自己無法控管的網路範圍內。

故障狀況先確認接著檢查
無法連線至本機入口監聽狀態、位址、連接埠通訊協定是否相符、區域網路是否隔離
可連線至入口但要求失敗驗證需求與要求格式伺服器、DNS 與規則紀錄
部分目標發生循環連線或逾時是否重複指向入口本身設定檔中的代理路徑與策略引用

避免重複轉送與錯誤迴圈

不要將本機代理入口再次用作目前連線路徑的遠端伺服器,否則可能造成重複轉送或連線迴圈。若修改後出現大量重複連線、持續逾時或異常流量,請立即停止本次測試,還原先前的伺服器選擇與監聽設定,再檢查引用關係。診斷時先釐清「要求從哪裡進入、經過哪項策略、最後連到哪裡」,比不斷更換連接埠有效。

規則檔案仍須獨立驗證。若希望只讓指定網域走代理,應檢查 Config 模式與 DOMAIN-SUFFIX 等規則,而不是依靠連接埠設定選擇目標。具體情境請參閱只代理指定網站的規則寫法。本機入口是否可連線,與目標是否命中 PROXY,屬於不同層面;測試資料應分別記錄。

通用的變更驗收與還原順序

完成任何 Settings 調整後,先驗證直接受影響的功能,再確認常用連線沒有受到影響。記錄修改前後的值、網路條件與結果;未明確改善的變更應予以還原。若同時涉及同步與自動連線,先讓本機設定穩定,再確認同步內容,最後啟用 On Demand。如此可避免設定仍在變動時,將自動觸發的結果誤認為最終驗收。

若要繼續排查,請依本頁的適用範圍、DNS、測試與日誌順序查閱,並透過快速入門教學重新建立最小可運作流程。若遇到購買、還原或裝置需求問題,請改看下載說明,不要透過修改網路參數處理帳號問題。手冊建議應搭配目前 App 的實際介面使用:能說明變更目的、重現驗證結果並保留還原方式,才算完成設定調整。