核心設定 · 欄位手冊
V2Ray 設定檔參考
依 JSON 層級查閱入站、出站、路由、DNS 與連線策略,再透過一份精簡設定檔確認它們如何搭配運作。
第一次匯入訂閱或設定系統代理,請先閱讀快速入門教學。教學說明操作順序,這裡則介紹核心實際讀取的欄位。遇到連接埠、出站標籤或解析結果不符的問題,可從目錄前往相關章節。
01 設定層級
V2Ray 設定檔的 JSON 結構
用戶端儲存的設定不等於核心設定
桌面端建議使用 v2rayN;Android 可依需求選擇 v2rayNG 或 v2flyNG,下載入口請見用戶端下載頁。使用圖形介面時,訂閱網址、目前選取的項目、系統代理和介面偏好通常由用戶端管理;用戶端再依據選取項目和全域設定產生或載入核心設定。介面上顯示的項目名稱不一定是 JSON 裡的標籤,用戶端儲存的資料檔也未必能直接交由核心讀取。比對欄位前,請先確認目前執行的核心,以及實際載入的是哪一份設定。
日常連線通常不必手動撰寫整份 JSON。只有確認介面設定無法達成所需行為,或需要縮小故障範圍時,才建議複製一份獨立設定。直接編輯用戶端產生的檔案,修改內容可能在重新連線、切換項目或更新訂閱時遭到覆蓋。反過來說,修改未載入的副本也不會影響連線。驗證修改是否生效,不要只看檔案的儲存時間,還應檢查啟動結果,以及監聽、出站等可觀察到的行為。
根物件、物件陣列與協定參數
根節點是物件。入站和出站各以陣列表示,因為同一個程序可以有多個入口和出口;陣列中的每個項目才是個別的入站或出站物件。路由、解析、策略和記錄各自有根層級物件。欄位即使寫在錯誤層級而通過 JSON 語法檢查,也未必會被核心採用。例如,監聽連接埠是入站物件的屬性,而驗證方式位於 SOCKS 入站的 settings 物件中。不要因為兩項設定都能在同一個設定視窗找到,就把它們寫在同一層。
{
"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", "settings": {} }
]
}
這份完整的精簡設定只接收本機 SOCKS 請求,並直接連線到目標,不依賴遠端服務。它沒有路由規則,未分流的請求自然會交由陣列中的第一個出站處理。JSON 的書寫順序要分兩種情況:同一物件中先寫 log 或先寫 inbounds,不會改變這裡的行為;但陣列通常有順序上的意義,尤其是預設出站的位置和規則先後。複製片段時應保留外層結構,將需要的項目插入對應陣列,而不是把兩份完整的根物件直接串接。
| 欄位 | 型態 | 用途 |
|---|---|---|
inbounds | 物件陣列 | 接收連線,並為入口命名 |
outbounds | 物件陣列 | 定義目標連線或丟棄行為 |
routing | 物件 | 選擇出站,內含規則陣列 |
dns | 物件 | 設定由核心發起的網域解析 |
policy | 物件 | 定義連線時限與統計開關 |
log | 物件 | 控制記錄層級及相關輸出 |
先檢查語法,再確認欄位關聯
以標準 JSON 儲存時,鍵名和字串須以半形雙引號括住,不加註解或尾隨逗號。連接埠填數字,驗證方式填字串,開關則填不加引號的 true 或 false。同一物件不要重複使用相同的鍵:有些讀取器會採用最後一個值,看似只是新增一組設定,原有規則卻可能整組遭到覆蓋。遇到錯誤指向下一行時,也要回頭檢查上一項是否漏了逗號,或某個陣列是否提早結束。
通過語法檢查只代表檔案能被讀取為結構化資料。接著還要確認三種關聯:協定是否與 settings 相符、規則引用的標籤是否存在,以及設定引用的檔案在執行環境中是否可讀。最後才檢查連接埠能否繫結、對端能否連線等執行問題。不同核心對未知欄位的處理方式可能不同,有時不會明確回報錯誤。本文以兩類核心常見的基本結構說明設定關係;若使用特定核心的擴充功能,請以實際載入該檔案的核心所支援的欄位為準。
02 接收連線
inbounds:監聽位址、連接埠與入站協定
監聽位址決定哪些裝置能連上入口
在本機使用時,請明確將 listen 設為 127.0.0.1,避免入口暴露給同一個網路中的其他裝置。應用程式連線的對象是執行核心的那台裝置;如果在手機上填入這個位址,指向的是手機本身,而不是桌上型電腦。只監聽這個 IPv4 迴路位址時,使用 IPv6 迴路位址連線也不會接到同一個監聽器。排查用戶端介面中的代理位址時,建議先使用明確的位址,不要讓 localhost 的解析結果成為另一個變數。
port 指核心實際等待連線的本機連接埠,不是訂閱中的伺服器連接埠。監聽位址和連接埠的組合受作業系統的繫結規則限制:若已有程序占用,新入站可能無法啟動;監聽所有 IPv4 介面的設定,也可能與指定位址的監聽設定重疊。切換連接埠時,也要一併修改應用程式或系統代理所填的連接埠。只修改其中一邊時,常見情況是用戶端看似正常運作,應用程式卻仍連到舊入口,甚至誤連到占用舊連接埠的其他程式。
{
"inbounds": [
{
"tag": "local-socks",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": {
"auth": "noauth",
"udp": false
}
}
]
}
先比對協定,再比對路由規則
範例使用 SOCKS 入站,應用程式應主動選擇 SOCKS5 代理;瀏覽器請求的是網頁,不代表代理交握也要使用 HTTP。若應用程式只提供 HTTP 代理設定,應改用獨立的 HTTP 入站或由用戶端產生的相應入口,並依實際設定填入連接埠。向 SOCKS 連接埠傳送 HTTP 代理請求時,連接埠可能確實有回應,但核心無法依入站協定讀取請求目標,自然也不會進入後續路由規則。判斷是否進入路由階段,不能只看連接埠探測結果。
當 auth 設為 noauth 時,不需要帳號,適合用於這裡限制在迴路位址的測試。udp 設為 false 時,此入口不提供 SOCKS UDP 轉發。即使啟用,應用程式也必須支援 SOCKS5 UDP 關聯,後續出站同樣必須支援這類流量。網頁能開啟,只能驗證這次網頁請求成功,不能證明即時通訊或其他依賴 UDP 的應用也能透過同一入口連線。請分別記錄發生問題的應用程式、代理協定和實際使用的傳輸方式。
入口標籤、目標位址與嗅探是不同功能
tag 用來為入口命名,路由可透過 inboundTag 區分來自不同監聽器的請求。例如,為兩個本機入口分別命名後,可以只讓測試應用的規則在測試入口生效,不影響日常使用的入口。入站標籤不會隨應用程式的代理協定自動變更;更名時要一併修改路由中的引用。如果兩個入口的行為不一致,請先檢查應用程式連的是哪個連接埠,再確認相關規則的條件是否寫入另一個入口名稱。
網域不一定會隨入站請求一併傳送。應用程式可能把網域交給核心,也可能先在本機解析,只傳送 IP。啟用 sniffing 後,核心可嘗試從支援的流量中辨識網域,例如 HTTP 請求中的主機名稱,或部分 TLS 交握中的伺服器名稱;但不保證每條連線都能辨識,也不會因此解密應用程式流量。有些設定還會區分僅將辨識結果用於路由,或直接改寫實際目標。為方便驗證,請先使用能明確提交網域的應用程式測試,確認基本分流正常後再考慮啟用嗅探。
03 發起連線
outbounds:出站協定、標籤與預設出口
標籤用於引用,協定才決定實際行為
outbounds 定義請求要交給哪個處理器。將某個項目命名為 direct 只是方便閱讀;真正執行直連的是 freedom。同樣地,阻擋項目通常命名為 block,實際處理由 blackhole 負責。名稱本身不會改變出站行為。複製設定時若只複製路由規則,沒有複製同名出站,就會缺少規則所引用的物件。反過來說,即使定義了阻擋項目,若規則從未選中它,也不會主動阻擋任何指定請求。
{
"outbounds": [
{
"tag": "direct",
"protocol": "freedom",
"settings": {}
},
{
"tag": "block",
"protocol": "blackhole",
"settings": {
"response": { "type": "none" }
}
}
]
}
在這種未另設預設出口的常見設定中,沒有符合規則的請求會交由第一個項目處理。將阻擋項目移到第一個位置,即使一條規則都不改,也會改變所有未符合規則的流量結果。預設項目和明確的兜底規則並不相同:前者在沒有規則符合時生效;後者若使用寬泛條件,可能會攔截後面更具體的規則。檢視設定時,應先決定未知目標要由哪個出口處理,再決定依賴第一個項目,或明確在末尾加入通用規則。
遠端服務參數分為協定與傳輸兩個層級
遠端出站通常同時涉及協定參數和連線參數。protocol 指定核心使用的協定;settings 依該協定描述遠端位址、服務連接埠及身分資訊;streamSettings 則描述這條連線使用的傳輸和安全層。兩部分都必須符合遠端提供的設定。直接將一個項目的傳輸區段搬到另一個項目,可能會讓協定身分仍然正確,但路徑或交握條件不相符。排查時請依欄位所屬層級逐項比對,不要把所有交握失敗都歸咎於訂閱更新。
遇到多個名稱看起來都像「位址」的欄位時,先確認各自負責哪個階段。建立遠端連線需要撥號位址;安全交握可能還要使用伺服器名稱;某些傳輸也有獨立的路徑或主機名稱需求。它們在某些服務上可能相同,但不能當成可任意替換的同義欄位。將撥號網域改成 IP,不代表其他名稱也都應一併修改。單一節點參數如何透過分享連結傳遞,可參閱分享連結與訂閱網址的差異;不要把整條連結貼進 JSON 的位址欄位。
區分「規則符合」與「出站連線成功」
路由符合規則只代表選中了處理器,不保證它能建立連線。直連失敗時,應檢查本機能否解析目標、是否有通往目標的網路路徑,以及目標連接埠是否可用。遠端出站失敗時,先區分能否連上遠端位址、能否完成該出站的協定交握,再確認是所有目標都失敗,還是只有單一目標失敗。阻擋代表刻意不轉送請求,範例中的 none 不會顯示文字說明的阻擋頁面,應用程式只看到連線失敗並不意外。
遇到「換了節點卻仍像是直連」的情況,也不要只靠網頁能否開啟來判斷。直連和遠端轉送都可能讓同一個網頁成功載入;既有的長連線也可能在切換後繼續維持一段時間。更可靠的做法是先確認新請求確實進入指定入站,再檢查記錄或對照測試反映的出站選擇。如果兩個出站看起來都無法連線,可先用精簡設定只保留直連出站。如此便能將應用程式到本機入口的路徑,與依賴遠端服務的連線分開驗證。
04 比對規則
routing:規則順序、目標類型與出站引用
由上往下比對,符合一條便停止
routing.rules 是依序比對的清單,不是替每條候選規則評分的列表。較寬泛的規則若排在前面,後面更具體的條件可能永遠不會用到。例如先將測試入口的所有請求交給直連,再設定同一入口下某個網域的阻擋規則,網域規則就會被第一條規則先行攔截。排查這類問題時,可從最上方開始逐條確認「這條規則是否已符合」,而不是只盯著預期會符合的那一條。
{
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"inboundTag": ["local-socks"],
"domain": ["full:example.org"],
"outboundTag": "block"
},
{
"type": "field",
"inboundTag": ["local-socks"],
"outboundTag": "direct"
}
]
}
}
第一條規則同時要求請求來自 local-socks,且目標的完整網域為 example.org。不同條件欄位必須同時成立;同一個清單中的候選條件通常符合其中任一項即可,例如網域清單中的任一模式符合就算成立。若要實現「符合網域條件或符合目標網段條件」,通常應拆成兩條規則;不能預期在同一物件中放入 domain 和 ip 就會形成「或」的關係。這也是合併多條規則後,符合率反而下降的常見原因。
網域規則不會比對網頁路徑
使用 full: 限定完整網域;使用 domain: 比對該網域及其子網域。前者不包含子網域,後者也不是在整條網址中搜尋任意子字串。設定中填的是主機名稱,不要加上網址前綴、路徑、查詢參數或頁內錨點。一次網頁瀏覽可能先重新導向至另一個網域,再從第三個網域載入靜態內容;看到部分頁面載入成功,不代表所有請求都符合同一條規則。測試時先使用明確的主機名稱,並確認失敗的是主要文件,還是後續資源。
IP 規則比對目標位址,可使用單一位址或 CIDR 網段。連接埠條件針對目標連接埠,不是本機 SOCKS 監聽連接埠。如果應用程式提交的是 IP,網域項目通常無法直接符合,除非核心從流量中辨識出可用的網域。反過來說,應用程式提交網域時,路由階段是否會解析成位址供 IP 規則使用,取決於路由自己的 domainStrategy。不要把路由找不到可比對位址,誤判為出站已完成解析但連線失敗。
網域解析策略與規則庫
路由的 AsIs 不會為了比對 IP 規則而額外解析網域。IPIfNonMatch 會在首次比對未命中時嘗試解析後再比對,因此若寬泛的兜底規則在第一輪就符合,可能不會再進行解析。IPOnDemand 則允許路由在比對需要 IP 條件時觸發解析。設定時先確認確實需要使用網域解析結果比對位址範圍,再選擇相應方式。若只依主機名稱分流,就不必因此多增加一次查詢及其失敗情況。
geosite: 和 geoip: 依賴實際載入的資源檔案及其分類名稱。同名分類並非固定不變;某個網域或網段是否包含在分類中,應以目前使用的資源為準。核心回報找不到資源、分類不存在,與資源載入正常但某個位址未被收錄,是不同層次的故障。可先用明確的網域或一小段已知網段確認比對流程,再改用分類。這樣若相同測試失敗,問題範圍就能縮小到規則庫或其更新結果。
05 解析網域
dns:內建解析器、靜態對應與查詢來源
先確認是由哪一方進行解析
應用程式可能先自行解析網域,再把 IP 傳給入站;也可能將網域連同代理請求交給核心。後一種情況下,核心仍可能把網域交由遠端處理,或在路由比對和直連撥號階段自行解析。頂層 dns 設定控制使用核心解析器的查詢,不會自動接管所有應用程式或作業系統發出的查詢。瀏覽器啟用獨立的解析方式時,作業系統查詢工具和瀏覽器顯示的結果也可能不同;兩者都不足以單獨證明核心使用了哪一套設定。
先依據個別連線列出完整路徑:應用程式提交的目標是網域還是 IP、路由是否為比對位址而觸發查詢,以及最終出站是自行解析,還是將目標交給遠端。不同階段可能查詢同一個網域,也可能完全沒有觸發查詢。例如應用程式將 IP 傳給核心,而直連出站只需連到該位址,這時新增一筆對應原始網域的靜態紀錄,通常不會改變結果。要驗證對應紀錄,測試請求必須保留網域,而且所選出站必須實際呼叫核心的解析器。
{
"dns": {
"hosts": {
"sample.test": "127.0.0.1"
},
"servers": ["localhost"]
},
"outbounds": [
{
"tag": "direct",
"protocol": "freedom",
"settings": { "domainStrategy": "UseIP" }
}
]
}
了解 hosts、servers 與出站的 domainStrategy
範例中的 hosts 將測試網域指向迴路位址,只會影響使用這份 DNS 設定的核心。servers 中的 localhost 表示使用本機系統的解析功能,不是要你在迴路位址另外架設 DNS 服務。直接將字面位址 127.0.0.1 當作 DNS 伺服器填入,和使用這個特殊值並不相同:前者要求該位址和連接埠上確實有可回應的服務。靜態對應只會回傳位址,不會代替應用程式協定交握,也不會為目標網域提供憑證。
freedom.settings.domainStrategy 控制直連出站如何處理網域目標,與 routing.domainStrategy 各自負責不同工作。這裡使用 UseIP,讓直連出站解析後再嘗試撥號;只調整路由策略,不能據此判定最終撥號使用了哪個位址。測試時,可讓已知可用的本機 HTTP 服務監聽迴路位址,再從支援提交網域的 SOCKS 應用程式連線至測試網域和服務實際使用的連接埠。如果服務會依請求主機名稱區分網站,也要確認它是否接受這個測試主機名稱。
上游可以使用簡單的伺服器項目,有些核心也支援透過物件為特定伺服器設定網域範圍。依網域分配上游時,符合後優先使用哪個項目,與失敗後是否另有備援,是兩個不同問題;還要區分回傳空白結果、查詢逾時,以及回傳了不符合預期的位址。若一次啟用多種查詢方式,症狀通常只能顯示某個結果異常,無法確認問題來自哪個上游。先保留一條已知可用的解析路徑,再逐步加入網域範圍和備援限制,會比較容易逐項驗證和定位。
位址家族、快取與 FakeDNS
同一個網域可能同時有 IPv4 和 IPv6 位址,但目前網路未必能連通這兩種位址家族。請先比對解析結果與實際撥號位址,再判斷是否需要限制查詢或出站使用的位址類型;只排除其中一種查詢結果,無法修復該位址家族的底層連線問題。修改靜態紀錄後仍可能看到舊位址,因為應用程式、作業系統、核心或上游各自都可能保留快取。驗證時應建立新連線,並確認重新整理的是哪一層,而不是只反覆重新整理網頁。
FakeDNS 回傳的是供代理流程辨識的虛擬位址,必須由同一條路徑上的核心還原相關網域,不能取代一般的真實位址快取。如果應用程式取得虛擬位址後繞過核心,或位址對應已遺失,後續連線就難以依原網域處理。一般 SOCKS 範例不需要啟用它;若要了解透明代理中位址如何傳遞,可參閱FakeDNS 原理與適用情境。先確認一般解析正常,後續才能對照判斷虛擬位址出現在哪個環節。
06 管理連線
policy:連線時限、使用者層級與統計開關
層級是策略索引,不代表權限高低
policy.levels 將一組參數對應到使用者層級。在 JSON 物件中,層級鍵值使用字串,例如 "0";協定設定中指定使用者層級的欄位通常填數字。層級不是方案名稱,也不是數字越大權限越高。哪條連線使用哪個層級,取決於相關入站協定及其使用者層級欄位。初次排查可從預設層級著手,不要先在 policy 中建立實際上沒有任何設定引用的新層級,接著又誤以為策略修改沒有生效。
{
"policy": {
"levels": {
"0": {
"handshake": 8,
"connIdle": 300,
"uplinkOnly": 3,
"downlinkOnly": 10
}
},
"system": {
"statsInboundUplink": true,
"statsInboundDownlink": true
}
},
"stats": {}
}
這是要併入根物件的片段,不是可獨立啟動的設定。數值僅用於說明欄位用途,並非適用所有網路的通用建議。策略不會替路由選擇出站,也不會替入站變更監聽範圍。遇到入口連線遭拒或某個項目無法撥號等問題時,應先檢查錯誤發生的階段;若交握根本尚未開始,增加某個工作階段時限通常不會提供線索。反過來說,如果每次都能完成交握,只有連線閒置一段時間後才中斷,才值得以策略參數進行比對測試。
四種時限分別限制哪些階段
handshake 以秒為單位,表示入站協定等待交握完成的時限,不是所有網路操作共用的總計時器。它不等於瀏覽器等待第一個位元組的時間,也不等於建立遠端服務連線的上限。檢查這項設定時,要區分用戶端連上連接埠後遲遲沒有完成交握,與交握完成後對端遲遲沒有回傳資料。只憑應用程式介面顯示「連線逾時」,無法判斷應調整的是入站交握,還是下游連線參數。
connIdle 衡量的是連線沒有資料活動的時間,不是從連線建立起算的固定存續時間。持續收發資料的連線,不應因為達到這個秒數就被視為閒置。uplinkOnly 與 downlinkOnly 處理一側結束後,另一側仍可繼續傳輸的階段:只剩上行或只剩下行時分別適用。請先確認應用程式是否會提早關閉傳送方向,或是否需要繼續接收較長的回應,再判斷相應時限是否合適。
較短的閒置時限可能較早回收長時間未使用的連線,但也可能讓偶爾才傳輸資料的工作階段必須重新連線;拉長時限則會讓暫時無用的連線保留更久。如果斷線週期與設定值相近,只能視為線索,因為應用程式、遠端服務或中間網路設備也會管理自己的逾時。比對時請分別觀察持續傳輸、完全閒置和單向結束三種情況。一次只修改與現象相關的項目並保留其他參數,才有機會判斷是核心策略,還是連線路徑上的其他元件先中斷連線。
啟用統計開關不會自動產生介面報表
範例中的頂層 stats 會啟用統計模組,policy.system 的兩個開關則要求依入站記錄上行和下行流量。請為需要區分的入站設定固定標籤;更名後,讀取端也要查詢新名稱。其他開關用於使用者層級的統計,能否對應到使用者,須視協定是否提供使用者識別資訊而定;不能將系統層級的入站計數等同於每個應用程式或訂閱項目的用量。兩台裝置若恰好使用同一個監聽器,入口計數可能包含兩台裝置的請求。
統計開關只會讓核心記錄相關指標。是否能看到數值,取決於用戶端是否支援讀取統計資料,以及讀取的是哪個執行個體。沒有讀取管道時,即使開關設為 true,也不會在設定檔中產生報表;重新啟動後,舊程序的計數也不會自動併入新程序的累計值。驗證時,可透過單一入口傳送少量可辨識的流量,再檢查同一執行個體的計數是否變化。不建議為了查看計數而將管理介面開放給其他裝置。
07 組合驗證
完整設定範例:本機 SOCKS、直連與單一網域阻擋
在獨立的測試設定中實際操作
以下設定沒有遠端出站,不需要訂閱或帳號。它使用僅限本機存取的 SOCKS 入站,搭配一條完整網域阻擋規則,其餘請求交由第一個直連出站處理。直連出站會要求內建解析器處理網域,再透過本機系統取得結果。此組合刻意不使用規則庫、嗅探或遠端連線:只要為應用程式選對代理類型,就能先專注測試入站、目標格式和出站引用。需要正常匯入訂閱時,請依照訂閱匯入教學操作。
開始前,請保留目前可用的用戶端設定,並在支援載入自訂設定的測試環境中選用獨立檔案。確認目前執行的核心能讀取這種完整 JSON,並檢查範例連接埠是否已被用戶端占用。若要更換連接埠,只需同時修改範例中的入站連接埠和測試應用程式的代理連接埠;不要把它填進網域比對項目。測試時只修改一個應用程式的代理設定,不必讓整台裝置的流量都參與。如此測試結束後只需還原該應用程式,也更容易確認觀察到的請求來自何處。
{
"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",
"settings": {
"domainStrategy": "UseIP"
}
},
{
"tag": "block",
"protocol": "blackhole",
"settings": {
"response": { "type": "none" }
}
}
],
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"inboundTag": ["local-socks"],
"domain": ["full:example.org"],
"outboundTag": "block"
}
]
},
"dns": {
"servers": ["localhost"]
},
"policy": {
"levels": {
"0": { "connIdle": 300 }
}
}
}
依據可觀察到的結果驗證,不要只看網頁能否開啟
先確認是否成功啟動:若解析或監聽失敗,就不必反覆開啟瀏覽器測試。啟動後,在測試應用程式中明確設定 SOCKS5,填入本機監聽位址和連接埠,並選擇透過代理傳送網域的方式。先存取已確認可從本機直接連線的測試主機,再透過另一條新連線存取 example.org。預期第一個請求會直連,第二個請求會符合阻擋規則。第一個請求能否成功取決於本機和目標是否可連線,因此不要選擇原本就無法連線的目標來當作成功組。
驗證阻擋規則也需要基準測試。可先暫時移除唯一的規則,讓 rules 保持空陣列,重新載入後確認測試網域原本可以連線;再還原規則並發出新請求。如果規則存在時連線失敗,移除後成功,才能說明差異與這條規則有關。若兩種狀態都失敗,不能據此確認阻擋成功;若兩種狀態都成功,則應優先檢查請求是否未經過這個入口、應用程式是否先將網域解析成 IP,或使用的是否是設定修改前已建立的連線。
再做一項反向確認:透過同一入口存取與阻擋目標不同的已知主機,確認移除和還原規則不會對它造成相同影響。如此便能區分「所有請求都因本機代理設定錯誤而失敗」和「只有一個目標被規則阻擋」。若記錄支援同時記下目標和入站資訊,也能提供幫助,但不同核心和用戶端的記錄格式並不相同。重點是核對當下的新請求、目標格式和選取的出口,不必要求記錄文字和某篇教學的截圖完全一致。
擴充設定時保留可還原的基準版本
要新增遠端出站時,可先保留目前的直連首項和阻擋規則,將新出站單獨加在後面,再新增一條只針對已知目標、並指向該出站的規則。成功載入後,分別驗證原有目標與新目標;若原有目標的行為維持不變,才能確認這次增量沒有意外改變預設路徑。若要將範例合併回用戶端的日常設定,不要整段覆蓋原有出站陣列或 DNS 物件。應逐項合併並檢查引用,特別確認新產生的標籤沒有與現有物件重複。
08 排查與維護
V2Ray 設定故障:從載入到目標連線逐層排查
無法啟動:先區分讀取、驗證與繫結問題
完全無法啟動時,請保留第一個錯誤訊息。若指出解析位置,先檢查括號、逗號或複製進來的全形符號;若指出欄位型別或協定名稱,檢查欄位層級與選用的核心;若指出位址無法繫結,則檢查本機介面和連接埠是否被占用。這三類錯誤的處理方式不同。用戶端也可能只顯示概括性的啟動失敗訊息,可從它提供的核心記錄中找出首次失敗的位置。之後接連出現的連線錯誤,可能只是入口根本沒有啟動,不必與第一個錯誤並列處理。
若同一個檔案在另一個環境可以載入,請先確認比較的是相同設定格式,而不是一個用戶端匯入了項目,另一個則直接讀取整份 JSON。規則庫路徑、記錄目錄和連接埠是否可用,也會依執行環境而異。相對路徑的起點未必是設定檔所在目錄,不要只因檔案管理員顯示「兩個檔案放在一起」就認定路徑可用。先用不引用外部資源的設定確認能否啟動,再逐項恢復檔案引用,會比一次把所有路徑都複製到新目錄更容易找出差異。
可以啟動但行為不符:找出第一個偏離預期的環節
| 現象 | 優先檢查 | 接著檢查 |
|---|---|---|
| 應用程式連不上本機代理 | 監聽位址與連接埠 | 確認程序已啟動,且位址家族相符 |
| 交握失敗 | 應用程式使用的代理協定 | 確認入站協定與驗證方式 |
| 符合了錯誤的出站 | 目標格式與規則順序 | 確認入站限制、標籤和預設項目 |
| 出站正確但無法連線 | 解析與出站撥號 | 區分位址無法連線與遠端交握失敗 |
| 只有閒置後才中斷 | 連線階段與持續時間 | 比對應用程式、策略與遠端逾時設定 |
「所有應用程式都無法連線」和「只有一個應用程式無法連線」是重要的區別。如果所有請求都沒有到達入站,請優先檢查系統代理或測試應用程式的個別設定;有些應用程式不會使用系統代理。如果只有某個應用程式失敗,請檢查它是否讓代理處理網域、是否改用其他傳輸方式,以及是否沿用既有連線。不要為了驗證一條網域規則,同時切換裝置的代理模式、應用程式的解析方式和核心的路由策略;否則即使恢復正常,也無法判斷是哪一項發揮作用。
如果入口已有請求,而且規則也指向預期的出站,下一步就不是重新排列路由。分別檢查直連和遠端兩條路徑,判斷錯誤發生在哪裡:本機位址解析失敗、遠端位址無法連線、出站交握中斷,或目標服務本身連線失敗。某個目標成功,也不能推論其他目標都能連線。比對時請使用相同的測試應用程式和目標;每次修改一項後,都發出新請求。遇到間歇性故障時,記下發生前後的時間,以及是否曾切換網路或喚醒裝置,方便區分設定問題與偶發的連線變化。
使用暫時性記錄與小範圍修改保留線索
{
"log": {
"loglevel": "info"
}
}
需要更多線索時,可將片段中的 loglevel 合併至既有的 log 物件,暫時提高記錄詳細程度。用戶端可能會另外控制記錄顯示位置和篩選方式;在視窗中看不到記錄,不一定代表核心沒有收到請求。請只重現一個操作並記下時間,再確認它是否出現在預期執行個體的記錄中。排查完成後請還原日常層級;分享診斷資訊前,移除訂閱網址、身分資訊及可能連結到個人的目標記錄,不要直接轉傳完整設定。
日常維護時,可保留兩份用途不同的副本:一份是已確認能啟動的精簡範例,另一份是最近一次驗證可用的實際設定。更新用戶端或切換核心後,先用日常設定執行固定的入站與分流測試,再啟用新增功能。若發生回歸,可用精簡範例判斷通用結構是否仍能運作,再逐步加入原設定中的 DNS、路由和遠端出站。最後記下哪些項目由用戶端產生、哪些來自外部資源、哪些是手動維護的。下次覆寫或遷移時,就能知道該保留哪個層級。