JSON 結構與設定歸屬
頂層物件與陣列
獨立核心讀取的設定通常是一個頂層物件。入站與出站分別是陣列,因為一個程序可以有多個監聽和多個出口。路由是物件,其中的規則則以陣列表示。解析、策略與記錄也各自是獨立物件。不要把用戶端匯出的訂閱資料、單一節點分享文字或應用程式本身的設定當成這份設定檔:它們可能也包含連接埠或協定欄位,但讀取者與欄位層級不同。
{
"log": { "loglevel": "warning" },
"inbounds": [],
"outbounds": [{ "protocol": "freedom", "tag": "direct" }],
"routing": { "rules": [] }
}
這份完整 JSON 用來辨識結構層級,不提供可供應用程式使用的監聽。最外層鍵值的排列不會改變意義,但陣列並非無序集合。出站陣列的第一個項目通常是未符合規則時的預設出口;規則陣列則由上而下比對。編輯器的格式化功能可以調整縮排,但不應順手重排這兩個陣列。即使兩份檔案的鍵值完全相同,調換規則或出站的位置也可能改變實際行為。
| 頂層欄位 | 容器類型 | 優先檢查 |
|---|---|---|
inbounds | 陣列 | 監聽位址、連接埠、應用程式使用的協定。 |
outbounds | 陣列 | 預設出口、標籤及出口本身的設定。 |
routing | 物件 | 規則順序、比對欄位與目標標籤。 |
dns | 物件 | 內建解析器使用的伺服器與呼叫時機。 |
policy | 物件 | 等級對應、連線時限與統計開關。 |
撰寫嚴格的 JSON 時,鍵名和字串要使用雙引號;數字與布林值則不加引號,最後一個元素後也不加逗號。同一物件內不可出現同名鍵。有些編輯工具接受註解或重複鍵,但某些載入器會報錯,或只保留後一個值,導致結果難以重現。若連接埠沒有生效,除了核對數字,也要確認修改的是目前物件中唯一的欄位,而非同名鍵或另一個入站中的欄位。
用戶端介面與核心檔案
桌面版請先從下載頁選擇 v2rayN,再到「參數設定」查看本機監聽相關選項,到「路由設定」查看規則。用戶端可能在切換節點、套用設定或重新啟動時重新產生核心檔案。若連線由圖形介面管理,請先透過介面修改並查看記錄;若自行維護設定,請另存檔案並確認載入方式。不要把執行期間的暫存檔當成永久設定來編輯。
Android 版的 v2rayNG 與 v2flyNG 各自管理應用程式設定,使用的核心也不同。桌面版檔案中的本機監聽、系統代理行為或資料檔案路徑,不能直接套用到行動裝置。移轉前先確認真正要帶走的內容:節點連線資料、路由規則,或特定應用程式的連線方式。節點能匯入,不代表桌面版的監聽與解析設定也會一併移轉;記錄中出現相同的協定名稱,也不代表所有選項都已生效。
從症狀回頭確認對應層級
將錯誤分為讀取檔案、建立監聽與處理請求三類。讀取檔案階段出錯時,先檢查語法或欄位位置;啟動後仍看不到本機監聽,再檢查連接埠衝突與位址綁定;應用程式已連入但存取結果不如預期,才檢查路由、出站與解析。從最早失敗的步驟開始查,才不會把所有問題都歸咎於節點。若重新啟動後結果沒有變化,請確認是否仍有舊程序占用連接埠,避免把舊程序的回應誤認為新設定已生效。
以下各章的短片段都以頂層物件的成員為例。同一個頂層鍵已有內容時,應合併到對應物件或陣列中,不要再新增同名的頂層鍵。若只想確認欄位行為,可使用後面的完整範例建立獨立檔案。記錄原始值、修改後的值與可重現的請求,再比對修改前後的記錄;這比替換整份設定後才追問哪一行生效,更容易找出問題。沒有完整設定作為基準,就很難判斷問題是新變更造成,還是原本就存在。
inbounds 入站監聽
一併核對位址、連接埠與協定
入站決定哪些應用程式能將請求交給核心。疑難排解時,應將監聽位址、連接埠號碼與代理協定一起檢查。應用程式中填寫的是代理入口,不是訂閱網址,也不是節點的遠端連接埠。將本機瀏覽器指向本機 SOCKS 入口,只能驗證這條應用程式連線路徑;系統代理是否啟用、其他應用程式是否讀取系統設定,則須分別確認。代理連接埠已開啟,不代表所有流量都會經過它。
{
"inbounds": [
{
"tag": "local-socks",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": { "auth": "noauth", "udp": false },
"sniffing": { "enabled": false }
}
]
}
此監聽只綁定本機 IPv4 迴路位址;應用程式也要填入相同位址。將位址改成名稱時,應用程式可能先嘗試 IPv6 迴路位址,造成位址看似相同、連線卻無法建立。若連線遭拒,請檢查目前程序是否確實綁定對應的位址與連接埠,也確認是否有其他用戶端占用相同的監聽。不要先修改遠端伺服器位址,因為請求此時尚未進入路由。
代理類型必須與監聽協定相符。即使使用相同的數字連接埠,HTTP 代理請求與 SOCKS 交握也完全不同。填錯時,應用程式可能連上連接埠,卻在交涉階段中斷。若要開啟兩個入口,請為它們設定不同的標籤和連接埠,並依應用程式的代理選項分別測試。若只有讀取系統代理的應用程式能使用,請優先檢查系統設定指向的連接埠與協定,而非將所有入口改成同一種協定。
範例停用 UDP,是為了先確認基本的 TCP 請求。開啟 udp 只代表此 SOCKS 入口能處理相應的 UDP 轉送請求;應用程式必須支援相關交涉,選定的出口也必須能傳送,且中間環節不能阻擋。網頁瀏覽成功,不代表語音、遊戲或其他資料封包服務也能正常使用。不要只根據應用程式的一次連線結果,就推斷所有網路類型都走同一路徑。
入站標籤與嗅探範圍
入站標籤是規則引用的名稱,不是對外顯示的節點備註。請為每個入口設定不同標籤,方便使用 inboundTag 區分來自瀏覽器、工具或代理轉接的連線。重新命名時,除了入口本身,也要修改路由中的引用。若兩個應用程式都使用同一入口,單靠這個條件無法區分它們;請先確認應用程式是否能連到不同入口,再決定是否拆分,不要試圖用重疊的網域規則取代。
若應用程式先在本機將網域解析成位址,入站可能只會收到 IP。嗅探能在部分協定與請求格式中辨識主機資訊,但不保證能取得每條連線的原始網域。在支援相應欄位的核心中,routeOnly 可讓辨識結果只供路由使用,不取代原始目標。檢查網域規則時,請先比較應用程式送入的網域與位址結果;不要假設啟用嗅探就能修正所有比對失敗的請求。
在共用情境中,先於主機裝置驗證入口,再從另一台裝置測試主機的區域網路位址,最後才修改防火牆規則。對方若填入自己的迴路位址,連到的會是對方自己的裝置。若只有同一台裝置能連線,請分別核對綁定位址、裝置所在網路與存取規則。離開可信任網路後請關閉共用,再確認迴路入口是否恢復原本的運作方式,避免將臨時調整留作日常預設值。
交接設定時,請將入口的位址、協定與用途寫在一起。單一裝置上的應用程式可能有系統代理、應用程式內代理和擴充功能代理等多個設定位置;先用一個明確指定代理的請求建立基準,再核對其他入口。若介面顯示已啟用卻看不到流量,可回到系統代理設定步驟,確認應用程式是否採用系統設定。若要驗證某個故障入口,可讓同一個應用程式暫時改用已確認可用的入口,比較交握結果;如此便能區分應用程式行為與本機監聽問題。
outbounds 出站與標籤
出口行為由協定決定,路由則依標籤選擇
出站是核心實際轉送請求的方式。直連出口由執行核心的裝置直接連至目標;阻斷出口會終止符合條件的請求;遠端代理出口則依對應協定與伺服器交涉。標籤只是名稱,取名為「直連」不會改變協定行為。若記錄顯示路由選中了某個標籤,下一步應找出同名的出站物件,核對其協定與設定,而不是根據標籤名稱猜測連線路徑。
{
"outbounds": [
{ "tag": "direct", "protocol": "freedom" },
{
"tag": "blocked",
"protocol": "blackhole",
"settings": { "response": { "type": "none" } }
}
]
}
此處將直連放在第一個項目。沒有符合任何規則時,通常會使用第一個出口,不會依標籤名稱自動尋找備用路線。若將阻斷項目移到第一位,未符合規則的請求也會失敗。相反地,若設計要求特定請求只能經由指定出口,卻將直連設為預設,漏寫規則的請求就可能改走直連。準備調整陣列順序時,先用一個確定不符合任何規則的目標測試原本的預設行為,再用同一目標重新測試。
路由符合某個出口後,若出站連線失敗,比對器通常不會回頭嘗試下一條規則。連續寫入兩條條件相同、出口不同的規則,不等於建立故障切換。排查這類問題時,應先確認指定出口能否完成連線與協定交涉。若預設出口可用、指定出口卻報錯,只能證明應用程式已接入且某條連線路徑正常,不能據此判定另一個出口的參數有效。
遠端參數與傳輸參數的區別
遠端代理出口需要符合該協定要求的伺服器位址、伺服器連接埠與使用者參數。這些設定與目標網站的網域、目標連接埠,以及應用程式連入的本機連接埠,分屬不同階段。使用圖形用戶端編輯節點時,請先對照服務提供者給的參數,再核對協定相關欄位。更換傳輸方式時,不要用從其他協定複製的使用者結構填補缺少的值;相同名稱的設定在不同協定下也可能允許不同值。
在具備相應功能的出口中,streamSettings 用來描述連線至遠端時採用的傳輸與安全設定,不是用來切換最終網站的加密方式。目標網站的安全連線與用戶端到遠端伺服器的安全連線應分開檢查。若記錄顯示錯誤發生在連線至代理伺服器的階段,請核對位址、連接埠、傳輸類型,以及與服務端約定的名稱。不要為了避開安全交涉錯誤而關閉憑證檢查;請先確認實際失敗的層級。
協定欄位通過語法檢查,不代表目前的核心已實作所需的傳輸與安全組合。桌面用戶端可以管理不同核心,行動用戶端也不保證與目前執行的桌面版本功能相同。將節點複製到另一台裝置時,請先確認目標用戶端實際使用哪種核心,再確認它支援這些選項。如果介面沒有相應欄位,不要假設匯入文字就能啟用該功能。協定術語請參閱入門指南中的協定說明。
疑難排解時,應區分伺服器網域與請求目標網域。即使應用程式提交的是目標位址,代理伺服器本身仍可能需要先解析並建立連線;即使伺服器成功連線,實際目標也可能因遠端規則或網路狀況而失敗。請記錄失敗發生在入口交涉、代理連線還是目標回應階段,再對照該階段的設定。比較時盡量只更換出口,維持請求目標、應用程式與入口不變。
建立自己的出口清單時,可為每個項目記下用途、所屬核心、是否依賴伺服器網域解析,以及哪些規則會選用它。將本機直連、遠端代理與測試用阻斷分開說明,不要在記錄或截圖中複製節點的驗證資料。準備停用某個出口時,先修改引用並測試預設出口,確認沒有規則仍選用舊標籤後,再移除舊物件。逐步小範圍調整,比全部刪除後再一併修復更容易發現遺漏,也方便檢視設定時追查每條規則的實際目的地。
routing 規則順序與比對
先符合的規則優先採用
規則陣列會由上而下檢查。同一條規則若同時指定目標網域、網路類型與入站標籤,就必須符合設定中的各項條件;同一個比對清單則可以列出多個候選值。若要表示「符合網域或位址」,通常應拆成兩條規則,而不是把網域與位址放在同一條中。較精確的規則應放在涵蓋範圍較大的規則之前,否則只會看到廣泛規則選出的出口,後面的例外規則就沒有機會生效。
{
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"inboundTag": ["local-socks"],
"domain": ["full:blocked.example"],
"outboundTag": "blocked"
},
{
"type": "field",
"inboundTag": ["local-socks"],
"domain": ["domain:example"],
"outboundTag": "direct"
}
]
}
}
此片段引用前兩章中的標籤。第一條只會比對指定入口上,完整網域為 blocked.example 的請求。第二條以網域後綴比對該後綴本身及其子網域。若將兩條對調,範圍較廣的後綴規則會先符合,阻斷規則便不會生效。此處使用保留網域說明比對方式,不代表它是實際可存取的服務。測試阻斷最適合選用原本可直連成功的目標,詳見完整範例。
full: 適用於精確的主機名稱;domain: 則適用於網域本身及其子網域。網域比對項目不要加入網頁路徑、查詢參數或網址前綴,這些都不是目標主機名稱。使用部分文字比對容易意外涵蓋不相關的網域,尤其是名稱很短的服務。排查特定網站時,先用完整主機名稱驗證,再依需求擴大範圍。瀏覽頁面時也可能連線到其他主機,不要因主頁載入成功,就認定所有請求都已符合規則。
比對連接埠時,port 指的是請求的目標連接埠,不是入站監聽連接埠。若要依入口區分,應使用 inboundTag。網路類型條件限制的是連線類型,不代表應用程式名稱。若只用一個瀏覽器頁面測試規則,很難判斷失敗是連接埠、協定還是網域不符合條件。可先只保留一個條件進行驗證,再逐一加入其他條件,找出未符合的限制。
網域解析策略與資料檔案
AsIs 不會為了路由解析收到的網域,因此不能期待位址規則直接比對該網域解析後的位址。IPIfNonMatch 會在網域目標未符合規則時嘗試解析,讓位址條件參與後續比對。若前面已有範圍廣泛的規則符合,後續解析階段就不一定會發生。IPOnDemand 則允許在比對需要位址的規則時解析網域。這三種設定控制的是路由階段,不是瀏覽器如何查詢網域。
位址條件可使用單一位址或網段,也可引用核心資料檔案支援的類別,例如 geoip:private。網域類別如 geosite:cn,則取決於對應檔案是否存在、類別是否收錄,以及核心實際讀取的路徑。選用類別前,先用一個明確的網域或網段驗證規則結構,再改用類別;否則檔案載入與規則比對兩類問題會混在一起。請參閱GeoIP 與 GeoSite 規則檔更新。
使用類別時,若核心提示類別不存在,不要先調整規則優先順序。請核對程序實際讀取的資料檔案與類別名稱,再檢查工作路徑是否變更,導致載入另一套資料。若核心能啟動但結果不符,分別測試一個應符合與一個不應符合的目標。類別更新可能改變所含項目;一併保留更新前的比對結果與資料檔案,比只看檔案更新時間更有助於釐清問題。
最後測試預設路徑:準備一個不符合任何例外條件的目標,以相同方式送出請求,確認它確實進入預期的預設出口。若測試結果取決於應用程式是否傳入網域,請在記錄中註明,避免其他裝置重測時得到相反結論。應用程式若已先解析成位址,規則可能只會看到位址;核心可以替網域查詢位址,卻無法保證從任意位址還原應用程式最初輸入的網域。
dns 解析與路由互動
先確認是誰發起查詢
內建 DNS 模組會向核心功能提供解析結果,不會因為存在 dns 物件就自動接管整台裝置。應用程式可能使用系統解析器、自行進行加密解析,或將目標名稱交由代理端處理。若應用程式在連線前已完成查詢並提交位址,變更核心的解析伺服器不一定會影響這次請求。即使目標網域能開啟,也無法直接判斷是哪個解析器回傳了位址。
{
"dns": {
"servers": [
{ "address": "1.1.1.1", "port": 53 }
]
}
}
範例為內建解析器指定一個以 IP 表示的伺服器,使用一般 DNS 連接埠。它不會新增可供系統設定的本機 DNS 監聽,也不保證查詢經過加密。個人測試前,請確認目前網路允許連線至該解析器;受管理的網路則宜使用管理員指定的伺服器。最簡單的組合只保留一個解析端,方便判斷逾時是由伺服器選擇、網路路徑還是回退機制造成。
若將伺服器位址寫成網域,還要考慮最先由誰解析該伺服器名稱。如果引導解析也依賴尚未建立的同一個入口,可能會反覆等待。遠端代理伺服器使用網域名稱時,也有相同的相依問題。疑難排解時,請分開記錄「目標網域解析」與「用來建立解析或代理連線的伺服器名稱解析」;前者失敗不一定代表目標無法存取,後者失敗則可能讓所有依賴它的目標同時逾時。
確認解析發生於比對階段還是連線階段
路由遇到網域目標時,可以依前一章的策略取得位址,供位址規則比對。這個結果首先用於比對判斷,不代表最後連線一定使用相同位址。直連協定如何處理網域,也可能受其本身設定與核心實作影響;遠端代理則可能收到目標網域後自行解析。若只修改路由策略而不檢查出口行為,就容易將「符合的條件改變」誤認為「目標連線位址也改變」。
若要設定不同網域使用不同解析端,可在支援的核心中使用伺服器項目的 domains 指定優先比對範圍。這不是系統層級的防止洩漏開關。查詢失敗後是否會改用其他伺服器,還要視相關回退設定與核心行為而定。先讓一個明確的測試網域可重現地走完單一路徑,再加入其他分組。若以地理類別描述範圍,也要確認本機資料檔案能載入該類別。
比較解析結果時,避免同時更改查詢類型與伺服器。有些網路環境中的 IPv4 與 IPv6 可達性不同,查詢回傳位址也不代表裝置一定能建立連線。瀏覽器、作業系統與核心還可能各自快取結果。進行前後對照時,請使用相同主機名稱、代理入口與網路條件,核對預期的位址類型,並註明是否由應用程式先在本機解析。否則,即使兩次測試得到不同位址,也不足以定位問題。
FakeDNS 需搭配支援的核心與連線方案使用,回傳的是供後續還原關聯的合成位址,並非網站的實際服務位址。若後續連線未進入能識別該關聯的路徑,就可能出現解析成功、連線失敗的情況。疑難排解基本解析時,先排除這一層:用一般解析驗證查詢與連線,再單獨加入合成位址方案,確認解析、流量接管與目標還原都位於同一條設定路徑。
疑難排解記錄至少應包含:請求使用網域還是位址、實際選到哪個出口、解析發生在哪一端,以及是等待逾時還是收到失敗回應。若只有單一應用程式異常,先檢查該應用程式的解析選項;若所有依賴特定解析端的請求都異常,先確認從使用位置能否連到該解析端。不要只是不斷增加內建 DNS 清單項目,除非能說明每個項目的用途、查詢優先順序及失敗後的預期結果。
還有一種常見誤判:網頁內容來自應用程式快取,因此即使解析路徑已遭破壞,原頁面仍可能繼續顯示。應以重新送出的網路請求判斷,並在結果中註明測試時間與裝置連線的網路。只有確認查詢如何進入預期解析端,再對照路由與連線情況,才能將解析故障與其他階段的故障區分開來。
policy 連線策略與統計
連線等級不等於分流優先順序
策略物件會將一組連線參數套用至使用者等級。levels 中的鍵是 JSON 字串,引用等級的欄位值通常則是數字。未另外指定等級的連線一般使用等級零。某個協定能否為使用者或入口指定等級,須查閱所用核心與協定的欄位定義;不能假設所有協定都在相同層級使用同一欄位。等級不會重新排列路由規則,也不能用來選擇代理出口。
{
"stats": {},
"policy": {
"levels": {
"0": {
"handshake": 8,
"connIdle": 300,
"uplinkOnly": 2,
"downlinkOnly": 5
}
},
"system": {
"statsOutboundUplink": true,
"statsOutboundDownlink": true
}
}
}
這些時限以秒為單位,範例僅供說明,並非適用於所有裝置的建議值。handshake 限制相關連線完成交握的等待時間;connIdle 用於判定連線是否閒置。只要連線持續傳輸資料,閒置限制就不等於單次請求的總時限。若頁面一直無法建立連線,應先查明失敗發生在入口交涉、解析還是出口連線階段,不要簡單歸因於閒置時間過短。
uplinkOnly 與 downlinkOnly 用於控制連線僅剩單向傳輸時的等待時間,分別對應只剩上行與只剩下行的階段。它們不會限制頻寬,也不是每次上傳或下載的最長時間。調低這些值,可能使一側已關閉、另一側仍在傳輸的連線提早結束。診斷這類異常時應觀察半關閉後的傳輸情形,不宜只看短暫網頁或一次很快就完成的請求。
| 策略欄位 | 觀察角度 | 無法據此判斷 |
|---|---|---|
handshake | 是否停在連線交握階段 | 目標網站的整體回應時間 |
connIdle | 最後一次傳輸後多久中斷 | 持續活動中的連線存續時間 |
uplinkOnly / downlinkOnly | 單向關閉後的剩餘傳輸 | 上行與下行速度限制 |
觀察到固定間隔的中斷時,先記錄從哪個事件開始計時:連線啟動、最後一段資料傳輸,還是某個方向結束。相同的實際時間可能來自應用程式、遠端伺服器或中間網路,不一定是本機策略造成。若調高某個欄位後,中斷時間沒有改變,請還原該欄位,再找出其他層級的限制。一次放寬多處設定會讓真正的觸發原因更難辨識,也可能使閒置連線長時間占用本機資源。
啟用計數與讀取計數是兩回事
在支援範例欄位的核心中,頂層 stats 會啟用統計模組,policy.system 中的開關則用來選擇要記錄的出站方向。這些設定不會自動建立可供瀏覽的統計網頁。要讀取數值,仍須透過支援的用戶端或核心管理介面取得。範例刻意未設定遠端介面;一般連線驗證也不需要向其他裝置開放管理功能。
計數可用來確認某段流量是否經過特定出口,但不等於目標收到的資料量,也不等於測速結果。計數為零時,應一併檢查開關、讀取方式、出口標籤,以及測試期間是否實際產生流量。用戶端重新載入或切換執行個體後,讀到的數值也可能來自新程序。每次比較都要確認統計資料來自同一處;先完成一個明確請求,再查看該標籤的數值是否變動,以免將其他應用程式的流量誤認為目前的請求。
若要依等級區分使用者統計,請確認協定是否提供統計用的使用者識別欄位;不要將介面中的節點備註視為相同欄位。標籤、使用者識別與計數名稱各不相同。若只關心出口是否有流量,先測試出站方向的計數;只有確實需要依使用者觀察,且目前設定能提供合適識別欄位時,再新增對應等級的統計設定。
日常維護時,策略設定宜維持精簡。經常修改的情境,只列出實際使用的等級與時限,並註明對應的用戶端或自行維護的檔案。接手舊設定時,先確認是否有連線使用特定等級,不要照搬一批從未引用的參數。接著在相同條件下測試短請求,以及閒置後恢復的情境,再決定要保留明確設定值或採用核心預設值。
本機完整設定與驗證
使用實際可連線的目標比對兩種出口
這份獨立設定只在本機接收 SOCKS 請求,不需要遠端帳戶,也不會修改作業系統的代理設定。規則依目標網域選擇阻斷出口,其他請求則使用預設直連。目的是驗證三個環節:應用程式將連線交給正確的監聽、核心能依網域符合規則,以及未符合規則時會選到第一個出站。測試現有用戶端時,請保留原設定,改用閒置連接埠,或先結束占用範例連接埠的程序。
{
"log": { "loglevel": "info" },
"inbounds": [
{
"tag": "local-socks",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": { "auth": "noauth", "udp": false }
}
],
"outbounds": [
{ "tag": "direct", "protocol": "freedom" },
{
"tag": "blocked",
"protocol": "blackhole",
"settings": { "response": { "type": "none" } }
}
],
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"inboundTag": ["local-socks"],
"domain": ["full:example.org"],
"outboundTag": "blocked"
}
]
},
"policy": {
"levels": { "0": { "connIdle": 300 } }
}
}
將檔案另存至容易辨識的位置,不要覆蓋圖形用戶端產生的檔案。若已安裝獨立 Xray 核心,且目前終端機可以呼叫它,可分別執行下列兩個命令。第一個命令只測試能否載入設定,不能證明連接埠可成功綁定;第二個命令才會執行核心。若要在圖形用戶端使用自訂設定,請採用用戶端提供的載入方式,並查看它實際啟動的核心與記錄,不必另外啟動獨立程序。
xray run -test -c config.json
xray run -c config.json
命令中的檔名必須與目前目錄中的檔案相符。若檢查結果顯示無法開啟檔案,請先核對工作目錄與檔名,不要急著修改設定欄位。檢查通過但啟動時顯示位址已被占用,應釋放該連接埠或改用確認未占用的連接埠,並同步更新後續請求。若核心顯示入口已建立,但系統代理仍是關閉狀態,這是正常的:此設定只提供入口,並未要求作業系統將應用程式流量導向該入口。
啟動後,在另一個終端機傳送兩個明確經由本機代理的請求。使用 socks5h 將網域交給代理端處理,避免應用程式先解析成位址,導致網域條件無法符合。--noproxy "" 可避免環境中的代理例外設定使測試目標繞過指定入口。若系統中已有同名命令別名,請改用實際的 curl 程式,例如在相應系統中執行 curl.exe。
curl --noproxy "" --proxy socks5h://127.0.0.1:10808 --max-time 15 https://example.com/
curl --noproxy "" --proxy socks5h://127.0.0.1:10808 --max-time 15 https://example.org/
若目前網路能連上這些範例網站,第一個請求應走直連;第二個則應符合規則並選到阻斷出口,可能在服務建立前或安全交涉時就失敗。不要只依據某一句固定錯誤訊息判斷結果。若網路本身無法連線,直連請求也會失敗;請改用自己確認可存取的非敏感目標,並確保規則與命令中的完整主機名稱一致。
若兩個請求都失敗,先確認第一個請求能否通過入站。終端機顯示無法連上代理時,請檢查本機位址、連接埠與程序;若已連上代理但無法開啟目標,則配合記錄檢查出口連線。若兩個請求都成功,請確認實際載入的檔案、請求傳入的是網域還是位址,再檢查入站標籤與規則的對應關係。不要為了讓結果符合預期而把阻斷出口移到第一位,否則會失去對照測試的意義。
將實驗結果與用戶端行為分開
也可以暫時移除阻斷規則,重新啟動後只重試第二個請求。若請求恢復,表示原本的失敗與規則有關,而不是目標一直無法連線。此時不要同時更換連接埠或應用程式,否則無法單獨歸因於規則。記錄命令、符合的出站與測試結果後,停止獨立程序、清理測試連接埠,再還原先前使用的用戶端設定。
此範例不會驗證 UDP、系統代理的涵蓋範圍、遠端協定參數或行動裝置的流量接管。驗證圖形用戶端時,請以入門指南中的連線測試為主;若對特定欄位有疑問,再用這裡的最小範例重現。若已有能正常運作的檔案,請先在副本中逐步加入規則與策略。每加入一段就重新執行兩個對照請求,結果一有變化,就能判斷是哪個步驟造成。
驗證成功後,請記錄可重複執行的測試條件,而不只是寫下「可以開啟」。例如明確記錄請求從哪個入口進入、哪個主機應可正常連線、哪個主機應遭阻斷,以及未符合規則時預期使用的出站。之後更新用戶端或調整欄位時,就能依原條件重新測試。若重測前發現範例連接埠已有其他用途,請另選連接埠並更新記錄,不要借用實際業務入口進行阻斷測試。
分層疑難排解與設定還原
先區分訂閱、啟動與單次請求
訂閱更新是由用戶端下載節點資料,不代表核心已使用該資料建立連線。更新按鈕出現逾時或憑證錯誤時,先區分是訂閱請求失敗,還是現有節點無法使用,並檢查用戶端更新時採用的連線方式與本機時間。若現有節點仍可用,不必立刻刪除設定再重新匯入。訂閱相關問題請參閱訂閱更新失敗疑難排解;本章則從設定已選定後發生的問題開始分層檢查。
核心無法啟動時,先查看最近一次啟動錯誤中第一個明確原因。若語法或欄位類型錯誤,請核對括號、逗號與欄位所在層級;若規則載入異常,先確認引用的資料檔案與類別;若位址綁定失敗,請確認監聽是否衝突或位址是否屬於本機。後續錯誤可能只是前一個環節失敗造成,逐一排除根本原因,比同時調整網路與設定更有效。
核心啟動成功但應用程式無法連線時,先用明確指定代理的請求測試入口。若該請求可用、一般瀏覽器卻不行,請檢查瀏覽器是否採用系統代理、是否有自己的代理設定或例外。若明確指定代理也無法使用,請比對入口與同一時間範圍內的記錄。看不到請求不一定代表沒有接入,也可能是記錄詳細程度不足,未記下相關事件。請綜合啟動資訊、請求錯誤與目標行為判斷。
{
"log": {
"loglevel": "info"
}
}
需要觀察特定連線時,可暫時提高記錄詳細程度。請將這段設定合併至原有的記錄物件,不要覆蓋原檔案中的其他記錄設定;若由用戶端管理,優先在其記錄設定中調整。重現一次後,請恢復原本的詳細程度。記錄可能包含目標網域、位址、裝置路徑或伺服器資訊;準備分享時,先刪除與問題無關的內容,保留欄位名稱、失敗階段及必要的前後幾行。
比對異常、出口失敗與復原方法
已能接入但疑似分流錯誤時,請從一個可重現的請求開始。記錄請求來自哪個入口、送入的是網域還是位址、是否先符合範圍較廣的規則,以及實際選到的出站。入站標籤不符或網域已被應用程式預先解析,都可能導致規則條件不成立。若記錄已確認選到正確出口,就不要繼續修改比對條件,應改為檢查該出口的伺服器連線、協定參數與目標回應。
只有少數網域失敗時,可在同一入口比較以網域與位址提出的請求;但不能只把網頁網址換成 IP,就推斷網站服務正常,因為主機名稱與憑證的語意也會改變。應分別確認解析是否回傳預期位址、規則是否符合目前輸入,以及保留正確主機名稱時能否建立目標連線。若一整類網域都異常,請核對網域類別資料與解析分組,不要為每個網站各自新增規則。
還原時應恢復最後一份實際執行成功的檔案或介面設定,而不只是復原編輯器中的最後一行。若規則依賴外部資料,請確認還原後的檔案仍與目前資料相容。若用戶端曾更換核心,也要核對目前核心是否仍能讀取還原後的欄位。先重新啟動並驗證本機監聽,再重試原本的對照請求,最後恢復日常使用方式。若無法回到原先結果,請重新確認目前執行的是否為原本那份設定。
電腦設定正常、Android 設定異常時,不要因為同一個節點成功匯入,就認定兩端行為相同。請逐項比較使用的核心、用戶端路由模式、連線方式與各自的解析設定,找出差異。同步時優先移轉連線資料,再於目標裝置重新設定本機行為。操作方式請參閱多裝置設定同步,並將這類移轉問題與單次連線失敗分開記錄。
完成疑難排解後,只保留能解釋結果的變更。檢查暫時加入的測試規則、調高的記錄詳細程度,以及區域網路監聽是否已還原;確認預設出站符合預期,再以原本失敗的請求重新測試。若問題已解決但原因仍不明,請註明這只是恢復運作,並非已找出故障原因。下次再發生時,從已記錄的原始條件重新重現,不要因為曾在重新啟動後恢復,就把反覆重啟當成長期解決方案。