設定參考 config.json
V2Ray 設定檔參考
從請求進入本機連接埠開始,沿著標籤、規則與連線策略,追查核心實際使用的出站。
本頁依欄位逐一說明。若尚未安裝用戶端,或只想完成匯入與首次連線,可先依照快速入門的操作流程,再回到本頁核對用戶端產生的設定。
JSON 結構總覽
用戶端設定與核心設定
用戶端儲存節點、訂閱、介面選項與執行模式;核心讀取的是啟動時載入的設定。兩者彼此相關,卻不是同一份檔案。例如,用戶端的「系統代理」決定應用程式是否將請求交給本機代理;核心中的 routing 則決定已收到的請求要如何處理。修改路由,無法讓原本不使用代理的應用程式開始送出代理請求。
桌面版可前往用戶端下載頁選擇 v2rayN;Android 可選用 v2rayNG 或 v2flyNG。檢視設定前,先確認實際啟動的是哪個核心,再查看個別欄位。Xray 與 V2Fly 共用許多結構,但協定選項、傳輸參數和資源檔案並非完全通用。核心能讀取某份設定,不代表用戶端匯入或保留設定的方式也相同。
先確認手上的檔案是節點匯出檔、完整設定檔,還是用戶端的設定備份。節點匯出檔描述單一遠端節點,不會設定本機監聽連接埠;用戶端備份可能同時包含介面偏好和多組節點,不能直接交給核心讀取。排查時應檢視本次啟動實際使用的設定。若用戶端重新產生檔案,請在介面修改對應設定,或使用用戶端支援的自訂設定入口。
頂層物件、陣列與標籤參照
根節點是物件。inbounds 與 outbounds 是陣列,因為一個程序可以有多個監聽器和出口。routing 是物件,規則陣列放在其中的 rules 欄位。dns 與 policy 也是物件。不要因為每個區塊都使用大括號,就把同一層的欄位塞進前一個欄位的 settings。
| 欄位 | 結構 | 用途 |
|---|---|---|
inbounds | 陣列 | 設定監聽位址、連接埠與接收協定。 |
outbounds | 陣列 | 設定直連、拒絕或遠端代理;第一個項目是預設出站。 |
routing | 物件 | 依序比對請求,將符合條件的請求導向出站或負載平衡器。 |
dns | 物件 | 為需要內建解析的流程提供靜態記錄與解析器。 |
policy | 物件 | 依級別設定工作階段限制,並視需要啟用統計。 |
標籤不是類型名稱,也不是陣列索引。將某個出站命名為 direct,不會讓它自動直連;真正執行直連的是 freedom。路由只會依字串尋找標籤。重新命名出站時,應搜尋所有參照並一併更新;只改定義、不改參照,可能導致設定測試或請求轉送失敗。為入站和出站採用不同前綴,也有助於在記錄檔中分辨方向。
物件屬性的排列順序通常不影響行為,但陣列順序可能有實際影響。移動路由規則會改變優先符合的規則;移動第一個出站會改變未符合規則的流量去向。整理檔案時可以統一縮排,但不要將所有陣列都按字母排序。比對兩份檔案時,先檢查陣列順序,再確認欄位的新增與刪除。
獨立執行的起點
以下是一份可獨立儲存的基本設定檔。它接收本機 SOCKS 請求,再由同一台裝置直連,不需要遠端節點或規則資源。測試前,請先關閉占用相同連接埠的用戶端,或一併更改範例連接埠與測試工具的代理連接埠。除非另有說明,後續章節的程式碼都是套用於同一個根物件的獨立片段;不要直接串接多段各自帶有根括號的內容。
{
"log": { "loglevel": "warning" },
"inbounds": [
{
"tag": "local-socks",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": { "auth": "noauth", "udp": false }
}
],
"outbounds": [
{ "tag": "direct", "protocol": "freedom" }
]
}
範例採用嚴格 JSON 格式:鍵名與字串使用雙引號,陣列和物件的最後一個項目後不加逗號,同一層不可有重複鍵。連接埠使用整數,開關使用布林值,列舉值則依核心接受的拼法填寫。兩份頂層設定都包含 routing 時,應逐條合併規則並安排順序,而不是保留兩個同名鍵。重複鍵不一定會造成語法錯誤;部分解析器會覆蓋前面的值,檔案看似完整,執行時卻只剩後一段。
inbounds 入站監聽
繫結位址與連線端點
入站是應用程式進入核心的第一段連線。listen 指定繫結的本機位址,port 指定連接埠,protocol 則定義用戶端傳送的格式,三者必須相符。若應用程式將代理指向裝置的區域網路位址,但程序只繫結回送位址,即使連接埠相同也無法連線;若協定設定錯誤,則可能先連上通訊端,卻在代理交握時中斷。
在本機使用時,請明確繫結 127.0.0.1,並在應用程式端填入相同位址。部分應用程式填入 localhost 時可能優先嘗試 IPv6 回送位址,而目前範例只監聽 IPv4,因此排查時不宜混用兩種寫法。若要測試其他監聽位址,請確認該位址屬於本機、連接埠可供繫結,並釐清哪些裝置可以存取;不要用監聽所有介面來取代連線故障排查。
兩個程序若繫結相同位址和連接埠,可能互相衝突;用戶端內建核心與手動啟動的測試程序也不例外。連接埠遭占用時,先確認占用者是否為正在運作的舊執行個體,不要直接關閉不明程序。若改用其他測試連接埠,應同步修改應用程式代理、核心監聽設定和測試命令。更改連接埠後若仍向舊連接埠送出請求,可能會誤以為新設定已生效。
分別設定 SOCKS 與 HTTP 入站
以下片段可取代基本設定檔中的 inbounds 陣列。兩個監聽器共用相同的出站設定,但連接埠與入口協定不同。使用 HTTP 代理的應用程式,請填入第二組位址和連接埠;支援 SOCKS5 的應用程式則使用第一組。入站的 tag 可供路由依來源比對。應用程式是否接受系統代理,取決於應用程式本身及其執行環境,不能只因啟用了第二個監聽器就認定它會使用系統代理。
{
"inbounds": [
{
"tag": "local-socks",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": { "auth": "noauth", "udp": false }
},
{
"tag": "local-http",
"listen": "127.0.0.1",
"port": 10809,
"protocol": "http"
}
]
}
HTTP 代理可處理用戶端送出的 HTTP 代理請求;支援通道的用戶端也可送出 CONNECT 請求,但這不代表監聽程序能接收任意格式的資料。使用 SOCKS 的應用程式會直接送出 SOCKS 交握,不能將 HTTP 代理連接埠當作 SOCKS 連接埠。先在單一應用程式中明確設定一種代理,再檢查系統代理設定,即可區分作業系統轉送問題與監聽器問題。
SOCKS 入站的 udp 控制是否允許 SOCKS UDP 轉送,不會自動將應用程式送出的普通 UDP 資料包轉送到這個連接埠。應用程式本身必須實作 SOCKS UDP 關聯,後續出站也必須能依實際協定處理。網頁能正常載入,通常只能證明測試用的 TCP 路徑可用。若使用 UDP 的功能失敗,請分別驗證入口、路由與出站,不要只憑同一台裝置能開啟網頁就下結論。
目標識別與接管範圍
入站收到的目標可能是網域名稱,也可能是 IP。若應用程式先解析名稱,再傳送 IP,路由就無法直接將該 IP 當作原始網域名稱比對。部分核心允許透過入站的 sniffing 識別特定協定所攜帶的目標名稱,但能否識別取決於流量格式與實際可見資訊。啟用識別前,先確認需要的是補足路由條件,還是確實要替換連線目標;兩者效果不同。
不要把目標識別當成解決所有分流問題的萬用開關。先用明確帶有網域名稱的代理請求驗證網域規則;若仍未符合,應檢查規則語法與順序。只有在網域請求正常、但應用程式實際請求只帶 IP 時,才進一步檢查目標識別或應用程式的代理選項。測試時一次只啟用一個額外選項,避免同時改變路由輸入與實際連線目標。
系統代理、應用程式內代理和 TUN 是不同的入口路徑。系統代理會將代理位址提供給願意讀取相關設定的應用程式;TUN 則透過虛擬網卡接管指定流量,涉及系統路由與權限。若某個應用程式沒有經過一般入站,應先檢查入口路徑,不要反覆修改出站。若已啟用虛擬網卡而一般代理測試異常,可參考TUN 模式說明核對模式,再以只啟用一種入口的狀態重新檢查。
outbounds 出站協定
預設出口與明確拒絕
出站定義請求要送往何處,以及下一段連線使用哪種協定。freedom 會依目前請求的目標直連,使用執行核心的裝置所具備的網路路徑。它不是遠端節點,也無法改變系統閘道。blackhole 則用來主動丟棄符合條件的請求。兩者都可用於驗證路由,但只有前者會實際連線至目標服務。
以下範例在基本設定檔的出站中新增拒絕選項。若沒有任何路由參照 deny,它不會自行攔截流量。範例將 direct 保留在第一個位置,因此未符合規則的請求會直連。若將 deny 移到第一個位置,未符合規則的流量就會遭拒絕。這是改變預設路徑,不是局部調整;變更順序前,請先確認管理流量和日常使用的應用程式是否依賴原本的預設路徑。
{
"outbounds": [
{ "tag": "direct", "protocol": "freedom" },
{ "tag": "deny", "protocol": "blackhole" }
]
}
直連的意義應連同入口一起理解。應用程式先連到核心,再由出站連線至目標;這與應用程式完全略過代理是不同路徑,兩者可能使用不同解析器、位址家族與逾時設定。對照測試時,請記錄「未進入核心」與「進入核心後直連」兩種結果。若只有後者失敗,應檢查核心收到的目標與執行環境,而不是只確認系統能否開啟相同網址。
遠端位址、代理協定與傳輸方式
遠端代理至少包含三個層次:要連線的伺服器位址與連接埠、該連線使用的代理協定,以及底層採用的傳輸方式與安全設定。位址和連接埠決定如何連到伺服器;代理協定欄位決定驗證等語意;傳輸欄位則指定承載方式。某一層運作正常,不代表下一層也正常:即使能連上伺服器連接埠,仍可能因協定或傳輸方式不一致而無法完成工作階段。
檢視 VLESS 等出站時,請分開核對協定專用的 settings 與共用的 streamSettings。節點位址是用戶端最先撥號的目標;若啟用 TLS,交握時使用的名稱則用於該連線的安全驗證,不應直接替換成瀏覽網頁的網域名稱。代理協定識別、傳輸類型、安全類型與伺服器端對應欄位,都要逐一核對;不要從其他類型的節點複製整段傳輸設定。
取得分享設定後,先確認匯入的是單一遠端項目,還是完整執行設定。即使遠端項目完整,仍需要用戶端產生監聽器與路由;完整設定檔則可能已定義本機連接埠和預設出站。第一次測試只啟用一個已知可用的遠端節點,不要修改進階路由設定。確認相同請求能穩定經由該出站後,再將它加入多出站規則,才能分辨後續問題出在節點還是選擇邏輯。
遠端項目的身分欄位與訂閱網址屬於管理資料,不應將用戶端匯出的原始內容貼到公開討論區。討論交握失敗時,只需提供核心類型、代理協定、傳輸類型、出站標籤,以及已移除識別資訊的記錄檔。比較不同協定時,可先閱讀VMess 與 VLESS 的欄位差異,不要將某個協定的選項直接當成另一個協定的同義設定。
更換標籤不等於故障切換
同一份設定中的出站標籤應各自唯一,並且容易辨識。將新的遠端節點加入陣列,不會自動建立主備切換;路由仍只會轉送至選定的出站。選定的出站無法連線時,核心不會因為後面還列有直連項目就自動改走直連。若需要故障切換,應確認實際核心支援的負載平衡能力、候選項目與探測條件,不能只在末尾多加一個項目。
更換出口後,應分別重新測試明確比對與預設比對:一個請求符合明確指向新標籤的規則,另一個則不符合任何規則。這樣可以找出「更改第一個出站,但舊規則仍指向原出口」或「修改規則,卻意外影響預設出口」這兩類問題。切換出口後請重新建立測試連線,避免瀏覽器連線集區中的舊工作階段繼續使用修改前的路徑。
routing 路由規則
依序比對與條件組合
routing.rules 是有順序的清單。請求會由上往下尋找符合條件的規則,符合後便交由該規則指定的出口;核心不會先收集所有候選項目,再替使用者挑出最精確的一項。如果依入站標籤比對所有網頁請求的規則排在最前面,就可能蓋過後續的網域例外。應將需要優先處理的條件排在前面,並用一個確實不符合任何規則的請求檢查預設出站。
對常見欄位規則而言,同一條規則中的不同條件必須全部符合;單一欄位清單中的多個候選值通常只需符合其中之一。若在同一條規則中同時設定入站標籤與網域,代表請求必須來自該入站,且目標名稱也符合條件。若要表示「任一入站來源,或任一指定網域」,應分別建立兩條規則。合併相鄰規則雖能減少行數,卻可能將原本的聯集改成交集。
以下片段搭配本頁的雙出站設定;它只會拒絕經由 local-socks 前往指定保留示例網域的請求。domain: 會依網域邊界比對該名稱及其子網域。若只要比對唯一的完整主機名稱,可改用 full:。網域欄位填入主機名稱條件,不要填入包含通訊協定、路徑和查詢參數的網頁網址;路由不會比對瀏覽器網址列中的整串內容。
{
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"inboundTag": ["local-socks"],
"domain": ["domain:blocked.example"],
"outboundTag": "deny"
}
]
}
}
可以先用保留網域核對輸入內容,並從記錄檔確認是否符合 deny。這個示例網域原本就無法正常連線,因此只看連線失敗無法證明拒絕規則已生效。進行對照時,讓兩次請求使用相同網域:一次經由 SOCKS 入站,另一次經由已設定的 HTTP 入站。前者應選擇拒絕出站,後者則應使用預設直連。即使兩次都沒有網頁回應,所選出口也應不同。
網域策略與規則資源
AsIs 會依現有目標進行比對,不會為了將網域轉成 IP 而主動查詢位址。IPIfNonMatch 允許在網域目標首次比對未命中後再進行解析,並嘗試套用 IP 規則;若前面已有網域規則或寬泛規則命中,就可能不會進行這次補充判斷。IPOnDemand 則允許在比對過程有需要時觸發解析。這三種模式改變的是比對階段何時需要位址,不應視為整個系統的解析策略。
geosite: 用來參照分類網域項目,geoip: 用來參照分類位址項目;實際分類與位置取決於執行環境中的資源檔案。分類名稱並非核心內建的一組固定字串。啟動記錄顯示找不到資源或項目時,先確認核心載入的是哪一套資料,再以單一已知網域或網段進行比對。資料缺失時,不要大幅放寬規則,否則會讓資源載入問題變成難以察覺的錯誤比對。
驗證位址規則時,先確認目標類型。用戶端提交 IP 時,依網域分類的規則沒有可供比對的輸入;提交網域時,在 AsIs 模式下也不能預期路由會自動解析並比對位址分類。內建解析器取得多個位址時,還可能涉及不同位址家族。測試時記錄輸入是網域、IPv4 或 IPv6,並一次只更改一項輸入條件。
確認符合與未符合的路徑
維護規則清單時,請為每條重要規則記錄一個應符合的請求,以及一個只差一項條件的請求。排查誤比對時,先檢查目標內容、來源入站和實際出口,再從清單中找出更早符合的候選規則。暫時將某條規則移到前面可用於對照,但正式調整時要重新檢查其他例外,尤其是原本由嚴格條件保護的請求,以免移動一條規則就讓多組流量同時改道。
路由不會自動修復所選出口的連線問題。記錄檔已指向預期出站時,即使請求失敗,也應改查該出站的位址解析、撥號或交握;只有所選標籤不符合預期時,才適合繼續修改比對條件。用戶端介面中的全域代理或規則模式屬於另一層選擇,可先參考代理模式操作說明,確認目前模式確實載入正在檢查的規則集。
dns 網域解析
解析發生在哪一端
同一個網域可能由應用程式、執行核心的裝置或遠端出口解析。若應用程式先查詢位址,入站收到的可能就只有 IP;若應用程式將主機名稱交給核心,路由便能先依網域名稱判斷;若出站將目標名稱交給遠端,建立目標連線時也可能由遠端解析。結果不同時,不要先認定某個解析器回傳了錯誤答案;先釐清哪一段連線正在查詢哪個名稱。
遠端節點的位址與欲存取網站的位址,是兩個不同的解析對象。核心必須先找到遠端位址才能撥號;遠端連線建立後,目標名稱才可能交由遠端處理。若記錄檔顯示節點網域查詢失敗,修改針對目標網站的分類規則無法修復節點撥號。反之,成功連上遠端只能證明節點位址可用,不能證明遠端能解析並連線至使用者指定的目標。
本節的 dns 是核心本身的設定,不會取代系統解析器,也不會自動攔截瀏覽器、其他應用程式或虛擬網卡上的所有 DNS 查詢。應用程式若使用自己的解析功能,系統設定與核心設定都可能不會參與首次查詢。進行對照時,保持入口、目標和出口不變,只改變解析發生的位置,以免混淆 DNS 與路由變更的影響。
靜態對應、系統解析器與查詢觸發
以下範例在內建解析流程中為測試主機設定靜態對應,其他需要查詢的名稱則交由 localhost 使用執行環境的本機系統解析機制。範例位址屬於文件保留網段,並非提供服務的測試伺服器。它用於觀察網域名稱對應到哪個位址,不適合用來驗證網頁能否開啟。觀察完成後請刪除測試記錄,不要保留在日常設定中。
{
"dns": {
"hosts": {
"reference.test": "192.0.2.10"
},
"servers": ["localhost"]
}
}
只新增上方片段,不代表每個存取 reference.test 的請求都會呼叫內建解析器。若要觀察路由如何使用解析結果,可在獨立測試檔中使用 IPIfNonMatch,確認前面沒有較寬泛的規則先行命中,再新增一條比對 192.0.2.10/32 並指向 deny 的位址規則。送出保留網域,並由代理接收主機名稱的請求,搭配記錄檔確認位址規則是否命中。此測試觀察的是路由決策,不要求實際連上示例位址。
路由為了比對 IP 條件而進行解析,不代表出站一定會使用同一個位址撥號。出站可能保留網域名稱,也可能依自身的位址策略再次解析。排查解析結果不一致時,請分別記錄「路由為何符合」與「最後撥號至何處」;若兩個階段使用不同位址,應依各階段的輸入與解析器說明,而不是把條件表中的 IP 當成最終連線記錄。
位址家族、快取與解析依賴
有位址回應卻仍連線失敗時,請確認回傳的是 IPv4、IPv6,還是兩者都有,再檢查相應網路是否可連線。沒有可用的 IPv6 路徑,與未取得 IPv6 記錄是不同問題。比較不同位址家族時,應使用相同目標與出口,不要拿另一個網站的成功結果證明原網站有問題。將策略限制在特定位址家族前,先確認它影響的是比對、查詢還是撥號。
切換解析設定後,應用程式、系統與核心可能各自保留解析結果,既有連線也可能繼續使用舊位址。重新測試時,先建立新連線;必要時再依個別元件清除快取。不要同時刷新所有元件並修改多項策略。若使用網域形式的自訂解析服務,也要確認它如何取得初始位址,以及查詢是否依賴目前尚無法連線的遠端出站。若依賴形成循環,增加查詢等待時間也無法補足啟動所需條件。
錯誤應區分為查無記錄、拒絕查詢、查詢逾時,以及已解析後的連線逾時。前幾種應檢查查詢目標與解析器是否可連線;最後一種則應檢查實際撥號路徑。裝置上的系統查詢可作為對照,但不能取代核心存取記錄。記下哪一段只看得到目標名稱、哪一段已取得位址,通常就能將問題縮小到特定環節。
policy 工作階段策略
使用者級別與適用範圍
policy.levels 依使用者級別設定工作階段參數。物件鍵以字串表示,例如 "0";協定中用來參照該級別的值通常是整數。若工作階段未指定其他級別,通常會使用零級;實際情況取決於協定與核心實作。級別只是參數索引,數字較大不代表權限較高、優先順序較高或速度較快。設定多個級別前,先確認協定會從哪個物件讀取這個值。
路由負責選擇出口;工作階段策略負責控制適用工作階段在特定階段如何等待。inboundTag 與使用者級別是不同機制:前者用於區分監聽器並參與規則比對,後者則用來選擇工作階段參數。若要讓不同入站採用不同逾時設定,請先確認入站協定是否允許設定對應的工作階段級別。只修改入站標籤,或在路由中參照級別名稱,都無法建立這種關聯。
{
"policy": {
"levels": {
"0": {
"handshake": 8,
"connIdle": 180,
"uplinkOnly": 5,
"downlinkOnly": 10
}
}
}
}
這些數值僅供示範,單位為秒,不代表預設值或通用建議值。handshake 限制適用入站的協定交握階段,並非整次存取的總時限。若應用程式尚未連上監聽器,調整此值無法修復連接埠無法連線;若遠端回報安全交握錯誤,也不能直接歸因於此。先確認記錄指出的是入站協定交握、遠端撥號,還是遠端交握,再決定要檢查哪組參數。
閒置與單向連線收尾
connIdle 設定連線閒置時的等待時間。連線耗時很久但持續有資料往返,與長時間沒有活動,是兩種不同情況。間歇傳送資料的應用程式可能會合法地靜默一段時間;若長連線總是在接近相同的閒置時間後中斷,請固定出口與應用程式,記錄最後一次有效傳輸到中斷之間的時間,再調整單一參數重測。不要把所有短連線失敗都歸因於閒置限制。
uplinkOnly 與 downlinkOnly 管理的是工作階段只剩單一傳輸方向後的等待時間,並非上傳或下載限速。下行結束但上行仍在進行時,請看前者;上行結束但下行仍在進行時,則看後者。有些應用程式送出請求後不再上傳,但仍需等待剩餘回應;過短的收尾等待時間,可能比一般短時間瀏覽網頁更容易暴露問題。要重現這類中斷,請維持相同的請求本文與回應行為。
連線關閉也可能是應用程式、伺服器或途中設備造成的。調整核心閒置時間後,若中斷時間沒有改變,就應繼續檢查其他參與方,而不是一再延長等待時間。請分別記錄交握失敗、閒置後中斷與半關閉後中斷。為了讓調整前後可比較,測試時應盡量維持目標、傳輸方式、出口、應用程式版本與入口模式一致。
統計開關與觀察方式
統計與逾時雖位於同一個策略區域,兩者彼此獨立。通常需要啟用頂層 stats 模組,再於相應策略中開啟所需計數。例如,policy.system.statsInboundUplink 可用來啟用入站上行統計;依使用者計數則還需要使用者級別的開關,並視協定能否提供使用者識別資訊而定。設定名稱相似的選項,不代表統計一定會顯示在用戶端的每個頁面。
計數資料必須由支援統計的元件讀取,不會自動產生使用報表,也不是延遲或連線能力測試。若用戶端已提供統計介面,先用現有功能確認計數對象;只為檢視記錄檔,不必額外開啟管理監聽器。若計數為零,請依序檢查模組是否啟用、對象是否有對應標籤或識別資訊、讀取的是否為目前程序,以及測試請求是否實際經過該對象。
使用策略調整參數前,請保留未修改的基準設定與可重現的請求。比較時記錄開始時間、最後活動時間與連線結束原因,不要只記錄網頁是否開啟。用戶端重新產生檔案後,還要確認設定已寫入實際載入的設定檔;若執行中的檔案沒有該策略,就不能用測試結果判斷參數是否有效。只有在能穩定觀察到一致變化時,才固定採用調整後的參數。
設定驗證與分層排查
從檢查檔案到送出代理請求
驗證分為三個層次:檔案可解析、程序可成功啟動,以及實際請求經由預期路徑。通過任何一層都不能取代下一層。比對檔案時,先確認啟動命令指定的路徑;透過介面重新啟動時,也要確認目前的設定來源與使用中的核心。尤其同時存在測試目錄和用戶端工作目錄時,僅憑檔名都是 config.json,無法證明實際執行的是剛儲存的那份檔案。
手動執行核心時,可依核心類型選擇以下一條設定檢查命令;請在設定檔所在目錄執行,或將檔案參數改為實際路徑。若啟動器使用不同的命令列參數,請以本機核心說明為準。設定檢查成功只代表核心接受設定輸入,不保證監聽器能成功繫結,也不保證啟動後可連上遠端。檢查完成後,再啟動程序並檢視啟動記錄。
xray run -test -config config.json
v2ray test -c config.json
先啟動結構總覽中的最小設定檔,再使用支援 SOCKS5 的應用程式送出一次明確的代理請求。以下命令適用於已安裝 curl 的環境。socks5h 會讓目標網域隨代理請求一併送出;但這不代表最後一定由內建 DNS 查詢,只能確認測試工具沒有在送出目標前先將網域轉成 IP。外部目標也可能無法連線,可改用自己有權存取且已知可直連的測試網站。
curl --verbose --max-time 12 --noproxy "" --proxy socks5h://127.0.0.1:10808 https://example.com/
一開始不必同時啟用系統代理或虛擬網卡。明確送出代理請求,可以排除應用程式是否遵循系統設定的問題。先以直連出站確認一次完整往返,再加入拒絕出站與路由規則,觀察標籤是否改變;最後才接入已知可用的遠端節點。若基本連線路徑已經失敗,加入分流資源、解析策略或多個節點只會讓排查範圍更大。
依第一個失敗環節定位
| 現象 | 優先檢查 | 對照測試 |
|---|---|---|
| 設定檢查失敗 | JSON 結構、欄位值、規則資源 | 從第一個錯誤開始檢查;恢復可啟動的基準設定後,再逐段加入內容。 |
| 入口連線失敗 | 執行中的執行個體、繫結位址與連接埠 | 暫時只保留一個監聽器,透過明確設定代理的應用程式測試。 |
| 出口選擇不符預期 | 請求目標、入站標籤與規則順序 | 分別送出應符合與不應符合規則的新請求。 |
| 出口正確但連線失敗 | 解析、撥號、傳輸與交握 | 使用相同入口比較直連與指定遠端,並檢視失敗階段。 |
| 使用一段時間後才中斷 | 最後活動時間與關閉方向 | 固定應用程式與連線路徑,分別驗證閒置與單向收尾情況。 |
讀取記錄檔時,優先依單次請求的時間範圍收集連續紀錄。啟動過程中的警告可能與請求失敗無關,後續重試也可能掩蓋第一個有用資訊。先找出第一筆與本次請求相關的失敗,再往前確認入口與出口是否已建立。暫時提高記錄層級,足以觀察所需階段後,就應恢復原設定,避免長期保留更多存取目標與執行資訊。
介面顯示正在執行,只代表用戶端認為啟動流程已開始,不代表應用程式進入了正確的入站。若記錄檔中完全沒有測試請求,先檢查應用程式設定的協定與位址,再確認是否只走了系統預設路徑。若記錄檔已出現請求但出站不符預期,應重新檢查目前使用的設定與規則順序。若記錄檔顯示遠端交握錯誤,先確認該出站設定是否與伺服器相符,不要急著更換整套路由。
最小重現與復原順序
回復時,先還原最後一份已知可用的檔案,重新啟動對應執行個體,並以相同代理連接埠和目標送出新請求。確認基準設定仍可用後,一次只加入一項修改,並記下預期標籤與實際結果。若連基準設定也失效,優先檢查環境是否改變:程序是否仍在執行、連接埠是否遭新應用程式占用、系統路由是否改變,以及原本的目標是否仍可連線。此時不要繼續累積尚未驗證的修改。
尋求協助時,請提供作業系統、用戶端與核心名稱、問題發生階段、最小化設定,以及同一請求的記錄片段。請刪除訂閱網址、身分欄位、內部網域和其他無關的連線紀錄,同時保留錯誤類型與欄位間的參照關係。若要依錯誤訊息尋找排查方法,可參考執行記錄定位方法;若問題發生在匯入訂閱或切換系統代理時,也可查看常見問題,先確認用戶端層,再檢查核心欄位。