設定總覽 · JSON 參考

V2Ray 設定檔參考

首次安裝、匯入訂閱或測試連線,請先依照入門指南完成快速設定。本頁是配套的欄位手冊:從最小設定檔了解請求經過的流程,再依目錄查找需要修改的區段。

JSON 結構與請求流程

從完整的最小設定檔開始

設定檔由一個頂層物件組成。入站與出站使用陣列,因為核心可以同時接收來自不同入口的流量,也能維護多條傳送路徑。路由、解析和策略通常各自獨立成物件。它們不會依照在檔案中的排列順序逐段執行,而是在處理請求時分別參與判斷。設定檔中有某段設定,不代表每次請求都會用到。

以下完整範例只開啟一個本機 SOCKS 入口,並使用直連出口。這份設定用來確認應用程式能否將請求傳給核心,再由核心連線至目標;不需要遠端伺服器或帳號,也不代表用戶端安裝後的預設設定。若要在支援匯入自訂核心設定的介面載入此檔案,請先確認本機連接埠未被其他設定占用。應用程式端應選擇 SOCKS5,不要將這個入口當成 HTTP 代理。

{
  "log": { "loglevel": "warning" },
  "inbounds": [
    {
      "tag": "app-socks",
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks",
      "settings": { "auth": "noauth", "udp": false }
    }
  ],
  "outbounds": [
    { "tag": "direct", "protocol": "freedom" }
  ]
}

請求會先抵達入站。入站依自身協定解析封包,取得應用程式要存取的目標。這份設定沒有路由規則,因此請求會交給清單中的第一個出站。直連出站接著由目前裝置發起連線。目標是否可連,仍取決於作業系統的網路環境。成功存取目標,只能證明這條本機路徑可用,無法據此判斷其他遠端出站是否正常。

欄位型別、標籤與設定片段

欄位名稱與字串請以雙引號括住。範例中的連接埠是數字,開關則使用布林值。物件與陣列使用不同括號,最後一個元素後面不要加逗號。同一物件內不要重複設定同名欄位。有些解析器會接受重複欄位並採用後一個值,讓前面的修改看似悄悄失效。儲存時請保留標準 JSON;即使某個核心支援擴充語法,跨用戶端匯入時也不必依賴它。

欄位型態用途
inbounds陣列接收應用程式請求
outbounds陣列傳送或拒絕請求
routing物件依條件選擇出站
dns物件設定核心內建解析
policy物件設定連線行為與統計開關

標籤是設定檔內部使用的名稱,不是視窗中顯示的別名。路由指定目標標籤時,核心會依字串尋找出站。為入站與出站取不重複且能說明用途的標籤,可避免重新命名時改錯項目。例如,變更直連出口的名稱後,也要檢查路由中是否仍引用舊名稱,而不能只確認出站陣列裡有沒有新名稱。

後續的短範例都是要合併至完整設定檔的片段,不應在原物件後方再加上第二個頂層物件。替換陣列前,先確認原陣列中的入口是否仍供應用程式使用。設定檔也可能包含用戶端為介面或統計功能產生的專用區段。保留這些區段比直接覆蓋整段範例安全,尤其是之後還要透過圖形介面切換伺服器時。

請區分訂閱內容、用戶端儲存的選項,以及核心最後載入的設定檔。訂閱通常提供伺服器參數,用戶端還會依本機連接埠與路由選項產生執行設定。修改匯出的副本不會自動變更目前執行中的核心;修改暫存的執行檔則可能在下次切換時被覆蓋。先確認目前編輯的是哪一層,再決定要從介面儲存,還是以自訂設定檔載入。

學習時可保留兩份明確的基準:一份未修改的完整本機設定檔,另一份只加入目前章節欄位的副本。執行前記下設定來源與監聽連接埠,執行後再比對預期結果。如此便能分辨是新增欄位改變了請求行為,還是用戶端仍在載入舊檔案。一次驗證一個欄位,比一口氣匯入大量規則更容易重現問題。

inbounds 入站設定

監聽範圍、連接埠與協定

入站決定本機應用程式從哪裡接入。listen 限定監聽位址,port 指定連接埠,protocol 決定核心如何解析收到的請求。這三項必須與應用程式填寫的代理位址相符。若代理類型設定錯誤,即使網路連線抵達同一連接埠,核心仍無法依預期讀取目標位址。

僅供目前裝置使用時,範例會明確監聽 IPv4 回送位址。若應用程式填寫本機名稱,系統可能先將它解析為 IPv6 回送位址。只監聽 IPv4 的入口不一定能接收這項請求。排查時可直接填入設定檔中的字面位址,先讓兩端完全一致。不要為了解決回送位址不一致,就把監聽範圍擴大到整個區域網路。

{
  "inbounds": [
    {
      "tag": "app-socks",
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks",
      "settings": { "auth": "noauth", "udp": false }
    },
    {
      "tag": "app-http",
      "listen": "127.0.0.1",
      "port": 10809,
      "protocol": "http",
      "settings": {}
    }
  ]
}

以這段內容取代最小設定檔中的入站陣列。兩種入口各自使用不同連接埠,方便確認應用程式實際連到哪一項。應用程式中的 HTTP 代理選項應指向 HTTP 入站;測試 SOCKS5 時,再改用對應連接埠。有些用戶端可以建立混合監聽,但上述設定並未啟用此功能,不要將混合入口的用法套用到兩個獨立入口。

不要混淆代理連接埠與目標連接埠。前者是應用程式連線至核心時使用的本機連接埠;後者由應用程式請求提供,指向最終要存取的服務。瀏覽網頁時,應用程式可能透過本機 HTTP 入站,要求建立通往目標 HTTPS 服務的通道。目標仍可使用網頁本身的連接埠,不必跟著修改本機代理連接埠。HTTP 入站指的是代理交握方式,不代表目標只能接收未加密的網頁請求。

協定功能與本機測試

範例會關閉 SOCKS 的 UDP 功能,以便先測試常見的 TCP 請求。開啟此選項不代表系統上的所有 UDP 流量都會進入核心。應用程式必須以受支援的方式送出請求,後續選用的出口也必須能處理該流量。若網頁正常、其他功能卻連線不穩,先確認出問題的功能實際使用哪種網路協定,不要一概認定是連接埠失效。

未設定驗證的本機入口應限制在回送位址。即使只允許本機連線,其他能連到該連接埠的本機程式也可能送出請求。在多人共用裝置或容器環境中,請先確認哪些程序需要接入,以及應用程式與核心是否位於相同網路環境。容器中的回送位址通常只指向該容器,不能用來存取主機上同名的位址。

若監聽失敗,先確認是否有其他執行個體或設定占用相同的位址與連接埠。修改連接埠後,請逐一更新瀏覽器手動代理、系統代理及終端機設定中已填入的位址。只修改核心端,其他地方仍可能引用舊入口。占用情況的排查與修改順序請參考本機連接埠衝突排查。

測試前先關閉測試應用程式中的其他代理來源,只保留一個明確入口。確認核心正常載入後,再測試一個已知可連線的目標。接著使用另一個應用程式測試相同位址,不要馬上更換出站。如此可分辨問題出在單一應用程式的代理設定,還是本機監聽。若只有其中一個入口正常,也應分別檢查兩個連接埠,不要拿其中一項的結果代替另一項。

入站設定有時還會包含目標識別選項,讓支援的流量提供額外線索供路由使用,但不能保證每條連線都能找回原始網域。先測試應用程式保留網域時的比對結果,再判斷是否確實需要額外識別。選項名稱相同,不代表預設行為也相同,尤其是入口由用戶端自動產生時。

outbounds 出站設定

直連出口與拒絕出口

出站設定的是請求離開核心後如何處理。出口可以直接連線至目標、依遠端協定轉送,或主動拒絕流量。出站項目不會因為列在清單中,就輪流接管請求。路由會將請求交給指定出口;沒有規則符合時,通常由清單中的第一個出口處理。調整順序可能改變所有未符合規則的流量去向。

{
  "outbounds": [
    { "tag": "direct", "protocol": "freedom" },
    { "tag": "reject", "protocol": "blackhole" }
  ]
}

這段內容可直接取代最小設定檔中的出站陣列。直連出口仍排在第一位。此時沒有規則引用拒絕出口,因此它不會主動攔截請求。下一章會為測試網域新增明確的拒絕規則。這種順序讓預設行為容易判斷,也方便確認失敗是因為規則命中,還是目標本身無法連線。

直連表示由執行核心的裝置存取目標,不代表應用程式繞過本機核心。可分兩次進行對照測試:一次讓應用程式直接連線,另一次讓應用程式經由本機入口與直連出口。若結果不同,先比較進入核心後的目標表示方式與解析方式。若兩次都失敗,應一併檢查裝置網路與目標服務,而不是先懷疑遠端節點。

拒絕出口用來表達規則的處理意圖,不適合用來檢查遠端連線狀態。應用程式可能將拒絕視為連線中斷,也可能只顯示存取失敗。不要只靠介面上的一行錯誤訊息判斷規則是否命中。可針對可控的測試目標暫時修改該規則,比較修改前後的結果,並搭配核心記錄確認入站與出站標籤。

遠端參數與傳輸參數

遠端出站通常需要同時符合兩組設定。第一組是協定參數,例如伺服器位址、連接埠與服務端核發的驗證資訊。第二組是承載請求的傳輸與安全參數,例如傳輸方式、路徑或預期的伺服器名稱。第一組正確,不代表第二組也正確。若遠端已建立底層連線,卻始終無法正常存取,請依服務提供的完整設定逐項比對。

settings 的內容取決於協定,不能直接套用其他協定的資料結構。streamSettings 用來描述出站採用的傳輸方式及相關安全設定,與系統代理設定也不相同。使用訂閱產生出站時,請在用戶端介面確認這些欄位是否已由訂閱填入。不要為了排除錯誤而大量更換憑證相關選項,以免掩蓋真正的名稱或時間問題。

本機入口位址與遠端伺服器位址是兩個不同方向的參數。將遠端伺服器連接埠填成本機代理連接埠,不會讓核心自動連上伺服器;反過來說,把本機回送位址填進遠端出站,也無法指向真正的服務。填寫時先確認參數由哪個程序讀取,再確認連線的另一端是誰。服務端提供的網域也不一定等於最終要存取的網站網域。

保留直連作為對照時,請為手動新增的遠端項目設定清楚標籤,並只用一條範圍明確的測試規則引用它。先確認未符合規則的請求仍會沿用原本路徑。之後若更換遠端項目,請保留相同標籤,或一併修改引用。要判斷單次修改的影響時,不要同時調整預設出口的位置。

說明出站問題時,通常只需提供協定、傳輸方式、錯誤發生階段,以及已遮蔽敏感資訊的欄位結構。實際驗證資訊不應出現在截圖或公開設定檔中。將本機入口與遠端出口分開說明,也能協助他人判斷該查看哪一端的記錄。若需從多個可用伺服器中挑選一個,可先參考節點延遲、倍率與協定類型對照。

routing 路由規則

依規則順序選擇出口

路由處理的是已進入核心的請求。系統代理會讓遵循該設定的應用程式將請求送進核心;路由則決定這些請求從哪裡送出,兩者不能互相取代。只切換路由模式,不會讓原本忽略系統代理的終端機程序自動接入。圖形介面中的模式與開關關係,請參考系統代理與路由模式對照。

{
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "inboundTag": ["app-socks"],
        "domain": ["full:example.com"],
        "outboundTag": "reject"
      },
      {
        "type": "field",
        "inboundTag": ["app-socks"],
        "outboundTag": "direct"
      }
    ]
  }
}

將這段加入包含相應入站與兩個出口的範例。第一條規則要求請求同時來自指定入站,且目標為精確網域;同一網域的子網域不會一併遭到拒絕。第二條規則處理該入口的其他流量。其他入口若不符合規則,仍會交由預設出口處理。測試第一條時,應用程式必須將網域傳給 SOCKS 入口;若應用程式先自行解析成位址再送出,目前的條件就無法依原始網域比對。

規則會依陣列順序逐一檢查,第一條符合的規則決定流量去向。若把涵蓋範圍較廣的第二條規則移到前面,即使第一條設定正確,也沒有機會命中。維護實際規則時,先列出例外,再列範圍較廣的分類,最後才設定兜底規則。同一條規則中的不同條件應同時符合,不能把每個欄位都當成獨立選項。

同一個網域條件陣列可以列出多個候選值。精確比對適合測試單一主機;若要比對網域及其子網域,可使用 domain: 前綴。不要將完整網頁網址放進網域條件,因為連結中的路徑、查詢參數與片段都不屬於主機名稱。載入網頁時若又存取其他網域,應分別檢查這些連線,不能只依頁面主要網址推斷所有資源都會符合同一條規則。

網域策略與位址規則

應用程式將網域交給核心時,AsIs 不會為了比對路由中的位址條件而主動解析網域。這不代表整個請求都不會進行解析;直連出口最後仍可能需要解析網域。若策略改為 IPIfNonMatch,核心可在原始目標沒有符合規則時,額外解析網域以比對位址規則。若在末尾放入一條總是符合的規則,可能會讓這項後備比對無法觸發。

IPOnDemand 會在檢查需要位址的規則時,按需觸發解析。選用此策略前,請先確認哪些規則確實依賴解析結果。網域可能對應多個位址,結果也可能隨網路狀況改變。依位址設定的規則比對的是位址,不是網站身分;共用同一位址的不同網域可能受到相同處理。若應用程式已傳入位址,更應先確認是否還有可供網域比對的資訊。

使用區域清單前,請確認目前核心能讀取對應的資料檔案,而且規則引用的分類確實存在。匯入時若只複製規則,卻沒有複製用戶端原先提供的資料資源,啟動時可能會發生錯誤。先用一條不依賴外部分類的規則確認路由邏輯,再加入分類清單,就能分開排查欄位用法與資料資源問題。

每次變更至少檢查一個應該符合規則的目標,以及一個不應符合的目標,並記錄應用程式實際使用哪個入口送出請求。修改設定後請建立新連線,避免沿用依舊規則建立的連線。若只有特定瀏覽器出現差異,再檢查瀏覽器是否自行解析,或使用獨立的代理規則。設定檔中的路由順序正確,也不能取代對輸入條件的確認。

dns 解析設定

先確認解析發生在哪一層

有時應用程式會先自行解析目標,再將位址交給代理;有時則會把網域一併交給本機入口。核心也可能為了路由判斷或直連出站而主動解析。若遠端協定支援傳遞網域,存取目標所需的解析也可能由遠端完成。頂層 dns 設定主要管理核心內建的解析元件,不會自動接管其他層已送出或完成的查詢。

以下範例使用本機系統解析作為後備,並新增方便檢查的靜態對應。測試名稱使用保留網域,並指向本機,適合在同一裝置上執行受控測試服務。此對應只會套用至使用核心內建解析的查詢。測試服務應由使用者明確啟動,並監聽預期的連接埠;否則收到連線拒絕,也不代表解析設定有誤。

{
  "dns": {
    "hosts": { "v2ray-test.invalid": "127.0.0.1" },
    "servers": ["localhost"]
  },
  "outbounds": [
    {
      "tag": "direct",
      "protocol": "freedom",
      "settings": { "domainStrategy": "UseIP" }
    }
  ]
}

將這段加入最小設定檔時會取代出站陣列。直連出口的 UseIP 會讓它在處理網域目標時使用核心內建解析,並以位址連線。若先前已採用路由章節中的拒絕出口,請保留相應項目,或移除已不適用的引用。測試時,請將網域而非預先解析的位址送入 SOCKS 入口,才能觀察這筆靜態對應。

若應用程式在連上核心前就顯示找不到網域,先確認 SOCKS 選項是否允許將主機名稱交給代理。應用程式取得的解析錯誤,與核心記錄中的解析錯誤並非同一件事。系統的獨立查詢工具也不會因為核心正在執行,就讀取此處的靜態記錄。若兩種查詢方式得到不同結果,應先釐清路徑差異,不要立刻覆寫系統設定。

位址族、上游與快取

選擇只查 IPv4 或 IPv6 時,請區分查詢回傳的記錄與裝置實際的連線能力。查到 IPv6 位址,不代表目前裝置有可用的 IPv6 路徑;強制只查 IPv4,也可能讓僅提供 IPv6 位址的目標無法連線。檢查時先保留可用的預設行為,再以單一位址族進行對照。排查時臨時加入的限制,不要在未註明的情況下保留於日常設定。

需要更換上游時,先只修改一處。解析伺服器本身也必須能從目前網路連線。若上游以網域表示,還要確認核心透過哪條路徑解析上游位址。使用加密解析時,請依目前核心支援的位址格式填寫。照搬其他核心的上游寫法而未確認其意義,可能導致流量去向或解析入口與預期不同。

查詢失敗後,不一定會立即改用清單中的下一個上游。網域限制、失敗回退與位址過濾等設定都會影響最後的選擇。先以一個上游和一個目標重新測試,確認正常後再逐步加入限制。這樣才能分辨是上游無法連線,還是回傳結果遭到過濾。解析逾時也可能延長應用程式等待連線的時間,讓表面上的錯誤看起來像目標連線逾時。

修改設定後,舊結果可能仍快取在應用程式、系統或核心其中一層。請關閉原有測試連線並重新載入設定,再比對新請求。若只有某個應用程式仍取得舊位址,請檢查該應用程式的快取與專用解析設定,不必先重設整台裝置的網路。記錄測試時間與使用的解析路徑,比只記下一組位址更容易釐清結果變化。

維護記錄中請註明靜態項目存在的原因,以及何時應移除。供測試使用的本機對應不應混入日常正式設定。移除測試項目後,請以正常解析的目標重新檢查路由與直連出口。本機範例中的解析設定有效,不代表使用遠端解析的流量也會得到相同結果。

policy 連線策略

等級與逾時分別影響什麼

策略描述連線如何等待、如何結束,以及是否收集特定統計資料。它不會決定某個網域應走哪個出口,也不能取代應用程式本身的重試與逾時機制。確認請求實際使用的入口與出口後,再檢查連線策略。若一開始就調高多項逾時,原本容易重現的問題可能變成長時間等待,反而更難觀察。

等級策略設定在 levels 中,等級編號則作為物件的字串鍵。範例設定等級零,用來檢查採用此等級的連線。某些協定或使用者設定可以指定其他等級;策略存在,不代表所有協定與連線都會套用。請先確認相應協定如何選擇等級,再決定要調整等級零,或為特定用途另設一組數值。

{
  "policy": {
    "levels": {
      "0": {
        "handshake": 8,
        "connIdle": 300,
        "uplinkOnly": 2,
        "downlinkOnly": 5
      }
    }
  }
}

這些數值以秒為單位,只用來說明觀察方式,並非通用建議值。handshake 限制適用連線的交握等待時間,不等同於整個網頁載入的計時。connIdle 著重於沒有資料傳輸時的等待。請求持續緩慢傳輸,與連線長時間完全閒置是不同情況,不宜用同一種現象推斷兩類逾時。

uplinkOnly 和 downlinkOnly 涉及只剩單一方向持續傳輸時的等待時間。一側結束傳送,不代表另一側已送完回應。過早結束單向等待,可能導致開頭正常、末段資料卻未收到。排查這類問題時,請優先記錄哪個方向先結束,以及問題是否只出現在特定應用程式或目標。

一次只修改一個策略參數

先用原設定重現問題,再依現象挑選最相關的參數。若連線在建立前反覆失敗,記錄從開始連線到出現錯誤的時間;若連線建立後閒置一段時間才中斷,記錄中斷前最後一次收發資料的時間。每次只修改一個欄位,並以新連線重新測試。修改後沒有改善就還原原值,不必一味調高所有逾時。

瀏覽器、終端機、遠端服務與中間設備都可能主動中斷連線。應用程式已停止等待時,即使核心的閒置時間設得更長,也無法挽回這次請求。若多種不同連線都在相近時間中斷,可用本機直連範例進行對照;若只有某一條遠端出站發生,則繼續檢查遠端服務與中間鏈路,不要只因時間相近就歸咎於本機策略。

策略中的部分開關只用來決定是否為特定對象收集計數。是否有統計模組、連線是否具備可識別的使用者標記,以及介面如何讀取資料,都是不同問題。圖形介面顯示的流量累計,也不一定來自核心的同一組計數。排查單次連線故障,無須同時啟用整套統計功能並長期保存詳細記錄。

設定日常使用的策略值時,需兼顧清理閒置連線與保留偶爾傳輸資料的工作階段。閒置時間太短,部分應用程式會頻繁重新建立連線;時間太長,則可能保留早已不再使用的連線。遇到長時間沒有回應時,先判斷是不是應用程式正在等待結果,不要把持續傳輸誤認為閒置。重新測試時應使用發生問題的同一個應用程式,單次短請求不足以證明長連線已恢復。

請在旁註明變更原因、驗證條件與原始數值。升級核心或更換用戶端後,應重新確認等級是否生效,不能只比對設定文字。若修改策略後看不出差異,先確認載入中的設定來源,以及連線實際使用的等級。只有這些條件都明確,前後兩次測試才有比較意義。

用戶端設定與核心差異

選擇正確的修改位置

桌面版建議使用 v2rayN。Windows、macOS 與 Linux 請選擇各自對應的安裝套件。Android 端可先使用採用 Xray 核心的 v2rayNG;若要使用 V2Fly 核心,則可選擇 v2flyNG。三款用戶端的入口請見下載頁;初次使用只需依作業系統與裝置架構選擇安裝套件,不必先手動編寫核心設定。

用戶端平台優先確認
v2rayNWindows、macOS、Linux執行核心、本機監聽、系統代理
v2rayNGAndroid連線授權、應用程式範圍、Xray 欄位
v2flyNGAndroid連線授權、應用程式範圍、V2Fly 欄位

圖形用戶端通常會將伺服器項目、訂閱網址、本機連接埠與路由偏好儲存為不同類型的資料。選擇伺服器並啟動後,用戶端才會依這些內容產生核心所需的設定。因此,匯入一組伺服器不等於匯入整份核心設定;備份節點清單也不代表已保存本機路由。操作前請先確認要修改的是服務參數、連線入口,還是整份執行設定。

在桌面版調整應用程式的接入方式時,通常從本機監聽與系統代理設定著手。將系統代理設為自動設定,是為採用系統設定的應用程式提供入口,不代表所有流量都會納入處理。各桌面作業系統的代理入口不同,同一個應用程式也可能完全使用自己的代理設定。測試前請記下應用程式讀取的是系統設定,還是手動填入的位址。

Android 端通常由用戶端透過系統提供的連線機制接收應用程式流量。能否開始接入,取決於授權與應用程式範圍。不要直接將桌面範例中以軟體手動連線至回送連接埠的測試方法套用為行動裝置的連線步驟。若只有某個應用程式一直正常或一直失敗,先檢查它是否在目前用戶端的處理範圍內,再比對核心的路由結果。

遷移設定時保留用戶端產生的部分

不同核心家族共用許多基礎欄位,但協定選項、傳輸名稱與擴充行為不一定完全一致。匯入前請確認新環境實際使用的核心,不要只看用戶端名稱或檔案副檔名推測。以目標用戶端產生的設定為基準,只遷移確實需要的欄位。複製時應保留原檔案中由用戶端管理的接入、介面及其他內部設定,不要直接照搬另一台裝置的設定。

以下片段只示範將記錄層級調整為較適合日常使用的設定。若原本已有記錄物件,只需合併層級欄位,不必刪除其他參數。若執行設定由介面自動產生,請優先使用介面中的記錄選項;只有以自訂設定啟動時,才在相應檔案中修改。如此一來,重新啟動或更新訂閱後,仍能確認設定的來源。

{
  "log": {
    "loglevel": "warning"
  }
}

切換裝置前,先列出需要保留的行為,例如是否依應用程式接入、是否需要特定本機監聽,以及哪些目標應走指定出口。先在新環境確認基本連線正常,再逐項恢復分流與解析設定。若訂閱更新後清單有所變動,請參考訂閱分組與伺服器篩選說明確認來源,避免將其他分組中的同名項目誤認為目前使用的伺服器。

匯出的設定可能包含訂閱網址與驗證參數,請只保留在自己的工作環境中。若需要他人協助,請另外製作只包含相關欄位的說明,再用本機直連範例重現可公開討論的問題。這樣既能避免公開個人連線資訊,也能縮小他人需要檢查的範圍。回報問題時請註明用戶端名稱、作業系統與執行中的核心,比只寫「匯入失敗」更有幫助。

完成遷移後,至少確認一次重新啟動用戶端後的行為。只在目前工作階段正常的設定,可能沒有儲存到下次產生設定時所使用的來源。若重新啟動後結果改變,請檢查實際啟用的伺服器項目、訂閱分組與選取的自訂檔案。先確認沒有切換設定,再考慮是否是不同核心對同一欄位的處理方式不同。

設定驗證與故障排查

依載入進度縮小排查範圍

先確認核心是否成功啟動。檔案解析錯誤通常發生在剛載入時;監聽衝突則發生在準備開啟本機入口時。這兩類問題都可能讓用戶端看起來完全無法使用,但處理方式不同。先查看本次啟動時最早出現的明確錯誤,再檢查後續訊息。某項初始化失敗後接連出現的錯誤,通常不必當成多個互不相關的問題逐一修改。

遇到語法錯誤時,請從提示位置往前檢查括號、逗號與引號。若錯誤指向下一行,真正缺少的符號可能在上一行。語法正確卻仍無法載入時,再檢查欄位型別、協定名稱、引用與資料檔案。合法 JSON 只能證明文字結構可解析,不能保證目前核心認得所有欄位,也不能證明出站一定能連線。

確認核心正在執行後,再檢查應用程式能否接入。使用一個已指定代理類型與位址的應用程式測試,不要同時啟用系統代理和應用程式內建代理。若應用程式顯示連線遭拒,先確認本機位址與監聽連接埠。請求已進入核心卻無法存取目標時,再檢查符合條件的出口與解析結果。若瀏覽器正常、終端機失敗,可參考瀏覽器與終端機分開排查的方法,確認設定來源。

記錄比對與還原順序

必要時可暫時套用以下片段以增加診斷資訊。它只會修改記錄層級,不會新增監聽,也不會改變預設出口。重現問題後請還原原本的層級;記錄內容可能揭露存取目標或網路資訊。查看記錄時請以單次測試的時間範圍為準,不要依賴固定提示文字,因為用戶端與核心的顯示格式可能不同。

{
  "log": {
    "loglevel": "info"
  }
}

若請求已進入核心,但出口與預期不同,請依序確認規則順序、入站標籤、目標形式與出口標籤。只用位址測試,無法證明網域規則有效。若選用的出口正確但連線逾時,可先用直連基準確認本機路徑,再檢查目前出站使用的傳輸方式、解析與遠端設定。每次測試只替換一個變數,不要同時更換入口與出口。

若網域連線失敗、直接指定位址卻能連線,再單獨檢查 DNS。測試條件應說明由哪一端進行解析,以及請求進入核心時是否仍帶有網域。若服務需要伺服器名稱,直接指定位址可能造成憑證名稱錯誤,不能將這類結果一概視為網路不通。若只在閒置一段時間後失效,請另行測試閒置時間,再考慮連線策略。

還原設定時,先停止載入有問題的設定,恢復已知可用的副本,再同步還原應用程式使用的代理位址。只還原核心設定,卻保留新的系統代理連接埠,問題仍可能持續。確認原本路徑恢復後,再依序重新加入入站、出站、路由、解析與策略的修改。再次出現異常的那個區段,就是下一輪縮小排查範圍的起點。

若故障反覆發生,請保留簡短記錄,列出觸發操作、使用的入口、對照路徑、修改欄位、測試結果與還原方式。先重現,再判斷原因。一次連線成功不代表所有應用程式都採用相同的接入方式;單次連線失敗也不代表整份設定無效。將可重現問題的最小案例留存,下次更新用戶端或調整訂閱後即可再次驗證。