設定參考 / JSON

V2Ray 設定檔:JSON 欄位參考

沿著一條連線追查設定:應用程式交給哪個入站、路由選了哪個出站,以及由哪一層負責解析與逾時。

首次安裝或匯入訂閱時,請先依快速入門教學完成連線。本頁供調整設定時查閱各欄位,並透過本機監聽與直連範例,分辨核心行為和用戶端的流量接管方式。

JSON 結構總覽

先分清根物件、陣列與協定參數

常見的 V2Ray 相容 JSON 設定檔以物件作為根節點。inbounds 和 outbounds 是陣列,因為一份設定可以包含多個入口與出口;routing、dns、policy 和 log 通常是物件,分別描述轉送選擇、網域解析、連線策略與日誌。進入這些物件後,仍須逐層確認資料型別。例如 routing.rules 是陣列,policy.levels 則是以等級編號為鍵的物件。縮排只是方便閱讀,不會改變相鄰欄位的層級。

看到 settings 時,先回頭確認同一層的 protocol。許多入站和出站都會出現這個名稱,但沒有一套通用的參數表。SOCKS 入站的驗證選項不能套用到 HTTP 入站,出站目標也不能用入站監聽位址取代。查閱設定時,記下完整路徑,例如「第一個入站的監聽連接埠」或「第二條路由規則的目標標籤」,比只記欄位名稱更容易判斷變更發生在哪一層。

可獨立啟動的本機基準設定

完整範例 · 回環 HTTP 入站與直連出站
{
  "log": {
    "loglevel": "warning"
  },
  "inbounds": [
    {
      "tag": "http-local",
      "listen": "127.0.0.1",
      "port": 10809,
      "protocol": "http",
      "settings": {}
    }
  ],
  "outbounds": [
    {
      "tag": "direct",
      "protocol": "freedom",
      "settings": {}
    }
  ]
}

這是一份完整的單檔基準設定,可交由支援這組欄位的核心載入。入口只監聽本機的 127.0.0.1:10809;設有代理選項的應用程式可明確指定使用這個 HTTP 代理。出站只有一個,且未設定額外路由時,交給核心的一般請求會透過預設出口直連。這份基準設定不含遠端服務資訊、不會替系統設定代理,也不會自動建立虛擬網卡。若桌面用戶端已占用這個連接埠,請先改用閒置連接埠,並同步更新測試應用程式的設定。

判斷基準設定是否正常,須分兩個階段檢查。啟動後沒有設定錯誤,只能表示核心接受了設定並嘗試建立監聽;還要送出一筆目標明確的請求,才能確認應用程式、入口與出站都有參與連線。先用同一個應用程式直接連線目標,再透過明確指定的代理連線同一目標。如果原本直連就失敗,基準設定也可能無法連線,不能據此認定入口設定有誤。測試時不要順手變更整台裝置的代理設定,以免其他應用程式的請求混入結果。

獨立檔案與章節片段的合併方式

下文標示為「替換欄位」或「加入根物件」的設定區塊都是局部範例。外層大括號用來表示所屬層級,不代表要另存一個檔案啟動,也不能把第二個根物件直接貼到檔案末尾。若已有同名根欄位,請以範例取代該欄位,或依需求合併其中的資料。合併路由後要重新檢查順序,合併入站後要重新確認連接埠;編輯器沒有標示錯誤,不代表合併結果符合執行時的限制。

維持嚴格的 JSON 格式,可減少不同匯入方式造成的歧義。鍵和值中的字串使用半形雙引號,數字連接埠不加引號,物件和陣列的最後一項後面都不要加逗號,也不要在程式碼中加入說明註解。重複鍵尤其不容易察覺:有些解析器會拒絕載入,有些則保留後出現的值,讓人誤以為前面的設定沒有生效。請以 UTF-8 儲存,並將執行中的檔案與修改草稿分開。若設定檔由用戶端產生,請優先透過用戶端提供的介面修改,避免下次切換設定時被重新產生。

inbounds 入站

監聽位址、連接埠與協定必須相符

入站定義核心在哪裡接收連線,以及如何解讀應用程式送來的資料。listen 是執行裝置上的綁定位址,不是遠端伺服器位址;port 是應用程式應連線的本機連接埠,不是對方服務的連接埠。使用回環位址可將本機測試與區域網路存取隔開。即使兩種位址最後都指向同一台電腦,監聽回環位址的入口也不會因此接受送往網卡位址的請求。

應用程式中的代理類型也不能省略。選擇 HTTP 代理,就必須連到 HTTP 入站;選擇 SOCKS 代理,就必須連到 SOCKS 入站。即使位址和連接埠都填正確,若選錯協定,通訊端可能成功連線,但接下來的代理交握仍會失敗。也請留意應用程式預設填入的 localhost:若它先嘗試 IPv6 回環位址,而設定只綁定 IPv4,暫時將應用程式位址改為 127.0.0.1,即可排除位址族差異。

為兩個入口分別加上標記

替換欄位 · 保留 HTTP,另外新增 SOCKS 入口
{
  "inbounds": [
    {
      "tag": "socks-local",
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks",
      "settings": {
        "auth": "noauth",
        "udp": false
      }
    },
    {
      "tag": "http-local",
      "listen": "127.0.0.1",
      "port": 10809,
      "protocol": "http",
      "settings": {}
    }
  ]
}

雙入站範例將兩種協定分配到不同連接埠,方便比較。tag 是設定內部使用的標記,應用程式填入的仍是位址與連接埠。標記應保持唯一且穩定;若要分開測試不同應用程式的請求,先讓它們使用不同入口,再透過 routing.rules 中的 inboundTag 區分,不要只憑應用程式名稱推斷路由。設定沒有要求入口名稱與出口名稱相同;刻意使用不同名稱,可一眼看出日誌記錄的是連線進入還是離開的位置。

範例中的 SOCKS 入口不需驗證,且限制為本機監聽。這裡停用了 SOCKS 的 UDP 轉送,適合先確認一般網頁請求等 TCP 流量。若測試軟體主要使用 UDP,即使 SOCKS 的 TCP 測試通過,也不能據此認定它可正常運作;還要確認應用程式是否支援相應的代理轉送、入口是否允許,以及後續出站能否承載這類流量。不要為了看到連線就擴大監聽範圍,本機測試不需要讓其他裝置存取代理。

從連線失敗的階段判斷入口問題

若核心啟動時回報綁定失敗,先確認監聽位址是否屬於本機,再檢查連接埠是否已被舊執行個體、用戶端內建入口或其他程式占用。改用新連接埠時,不只要修改檔案;瀏覽器的手動代理設定、系統代理紀錄和測試指令也可能仍指向舊連接埠。新舊設定不一致時,有時請求不會被拒絕,而是測試程式連到了另一個仍在執行的代理,讓人誤以為變更完全沒有生效。

若連接埠可連線,但日誌沒有預期的入口標籤,請優先檢查應用程式是否使用自己的代理設定、是否設有目標例外,或這次請求是否重用了先前建立的連線。看到入口標籤後,再檢查出站與網域比對。也要分辨入站收到的目標是網域名稱,還是應用程式已解析好的位址:如果應用程式預先解析,網域規則可能沒有可供比對的資訊,問題不一定出在監聽協定。請先保留輸入條件,記錄應用程式實際送來的是哪種目標,再調整後續規則。

outbounds 出站

第一項是預設出口,標籤供路由引用

入站接收請求後,核心還要決定由哪個出站連線至目標。outbounds 中每個項目的 protocol 定義其實際行為;tag 只是供路由引用的標記。將標籤命名為 direct,不會讓任意協定變成直連;命名為 blocked,也不會自動封鎖連線。沒有符合路由規則的一般請求,會由設定陣列中的第一個項目作為預設出口。並列設定兩個項目,不代表會同時嘗試,或在失敗後自動切換。

以直連作為預設出口,適合本頁的本機實驗,因為不依賴伺服器;實際使用時,不應照搬為所有情境的預設選擇。請先確認規則清單未列出的目標是否可以直連,再決定預設出口。若要檢查分類規則是否完整,可在獨立測試設定中將拒絕出口設為預設項,再明確放行已知目標。這麼做是為了觀察未命中規則的情況,不適合直接取代正在服務多個應用程式的現有設定。

直連與拒絕的最簡行為

替換欄位 · 預設直連,另設拒絕出口供路由引用
{
  "outbounds": [
    {
      "tag": "direct",
      "protocol": "freedom",
      "settings": {}
    },
    {
      "tag": "blocked",
      "protocol": "blackhole",
      "settings": {
        "response": {
          "type": "none"
        }
      }
    }
  ]
}

freedom 會直接連線至目標,實際使用的本機網路與解析方式取決於執行環境及出站設定。即使請求曾經過代理入口,它也不會因此將請求送往某個遠端代理伺服器。blackhole 則不會連線至目標。範例將回應類型設為 none,因此應用程式可能會看到連線中斷或一般代理錯誤,不會收到說明封鎖原因的頁面。若要區分主動拒絕與目標故障,應搭配所選出口及目標服務的存取日誌判斷,不要只看應用程式的錯誤提示。

尚未加入路由時,範例中的第二個項目不會處理一般請求。可保留陣列順序,再新增一條範圍較小的規則來驗證拒絕行為;測試失敗後,先確認該規則是否被前面的規則攔截。若重新命名出口,請一併更新所有引用舊標籤的規則,並確認大小寫一致。無法解析的出站標籤不能當作有效的備用路徑;即使核心成功載入檔案,也不能假設請求一定會回到第一個項目。

遠端連線應逐項核對伺服器參數

設定遠端出站時,先分辨代理協定、承載連線的傳輸方式,以及傳輸安全層。這幾者彼此相關,卻不能互相取代。同一種代理協定可以使用不同傳輸方式;即使位址與連接埠相同,也不足以證明雙方設定一致。匯入分享連結後,請先在用戶端確認轉換後的協定、傳輸與安全設定是否符合服務提供者的說明。不同核心家族的部分欄位與取值可能不相容,請勿直接從其他範例複製幾行設定拼在一起。

修改遠端設定時,保留已知可用的本機入口,固定測試應用程式與目標,每次只變更一個條件。入口日誌有紀錄,但遠端連線逾時時,先分別確認遠端位址能否解析、連接埠能否連線,以及失敗發生在建立連線還是交握階段。同一台電腦使用本頁的直連基準設定能連上測試目標,只能表示本機入口到該目標的直連路徑可用,不能證明遠端服務參數正確。協定欄位的意義可參考代理協定比較,再回到實際設定找出差異。

routing 路由規則

先寫專用規則,再寫一般規則

routing.rules 會依陣列順序逐條檢查。對於下方這類欄位規則,命中較前面的規則後,就會使用該規則指定的出口,不再比較後續規則是否更精確。例如先放一條涵蓋某個網段的直連規則,再寫一條針對該網段內特定裝置的拒絕規則,後者通常不會執行。若要設定例外,請將範圍較小的規則排在涵蓋範圍較大的規則之前;除錯時應從清單開頭尋找第一條可能命中的規則,而不是只看最後修改的項目。

同一條欄位規則若同時設定 inboundTag 與 ip,範例要求入口和目的位址兩個條件都成立;單一欄位中的清單則可列出多個候選值。若要表達「來自指定入口,或目標位於指定網段」,通常應分別寫成兩條指向同一出口的規則。混淆這兩種寫法時,常會發生範例中的某個目標剛好符合條件,但換用其他應用程式或位址後就走到預設出口的情況。

以本機請求驗證規則順序與範圍

加入根物件 · 搭配雙入站、雙出站片段測試
{
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "inboundTag": ["socks-local"],
        "ip": ["127.0.0.1/32"],
        "outboundTag": "blocked"
      },
      {
        "type": "field",
        "ip": ["127.0.0.0/8"],
        "outboundTag": "direct"
      }
    ]
  }
}

準備一個可正常直連的本機 HTTP 測試服務,目標使用 127.0.0.1 與服務本身的連接埠,不要把目標連接埠誤填為代理監聽連接埠。經 SOCKS 入口進入的連線符合第一條規則,會走拒絕出口;經 HTTP 入口進入的同一目標不符合第一條規則,會繼續檢查並命中第二條。調換兩條規則的順序後重新建立連線,就能看到範圍較廣的位址規則先於入口例外生效。這裡使用字面位址,是為了避免網域解析差異影響路由測試。

正式設定時,請分清三種情況:命中規則、未命中時使用預設出站,以及命中規則後出站執行失敗。即使沒有明確的兜底規則,第一個出站仍會發揮作用;加入範圍過廣的兜底規則後,後續規則可能再也無法命中。若日誌顯示已選到預期出口,但連線仍然失敗,應檢查該出口和目標服務,而不是一再調整路由順序。替現有規則加入例外時,也可另外選一個不應受影響的目標作為對照,避免只測試新增加的情況。

網域規則與位址規則使用不同的輸入

精確比對可使用 full:example.test;若要涵蓋該網域及其子網域,可使用 domain:example.test。明確標示前綴,比依賴字串包含關係更容易檢查。geosite:cn 這類寫法會引用網域資料中的分類;核心必須能找到相應資源,且分類結果取決於實際載入的資料。這不是地理位置偵測,也不保證涵蓋某項服務的所有相關網域。網域清單是否命中,應搭配實際請求目標確認。

AsIs 不會為了路由比對而額外將網域解析成位址;IPIfNonMatch 則可在第一輪未命中時,再嘗試以解析出的位址比對。選擇後者前,請考量查詢延遲、解析結果與後續連線目標之間的關係,以及現有兜底規則是否已在第一輪命中。這兩種策略都無法將應用程式主動送來的任意 IP 位址還原成網域。若要測試某條網域規則,請先確認應用程式有將目標網域傳給入站,再觀察是否進入預期的比對流程。

dns 網域解析

先確認是誰送出查詢

根物件中的 dns 設定屬於核心的解析邏輯,不等同於作業系統的 DNS 設定,也不會接管應用程式自行發出的每一筆查詢。應用程式可以先解析網域,再將位址交給代理;也可以將網域保留在代理請求中。有些應用程式還有獨立的解析選項。判斷某項設定是否生效前,請先確認這次請求的目標形式,以及核心的路由或出站是否呼叫了內建解析器。瀏覽器顯示某個網域,不代表同一段文字一定有傳到核心。

路由解析與出站解析也要分開看。前者用來判斷目標是否符合某條位址規則,後者則是為了建立最終連線。路由查到某個位址,不代表所有協定、出口和應用程式都會使用同一個解析結果;不同路徑可能各自快取,也可能因選用的位址族不同而得到不同答案。疑難排解時,不要把「網域查得到」和「目前連線實際使用這個位址」視為同一件事;必要時分別記錄目標與出口的觀察結果。

先用靜態對應驗證內建解析流程

成對修改 · 加入 dns,並替換基準設定的 outbounds
{
  "dns": {
    "hosts": {
      "example.test": "127.0.0.1"
    },
    "servers": ["localhost"]
  },
  "outbounds": [
    {
      "tag": "direct",
      "protocol": "freedom",
      "settings": {
        "domainStrategy": "UseIP"
      }
    }
  ]
}

在單一入口的基準設定中加入這個 dns 物件,同時替換原有出站。直連出站使用 UseIP,讓以網域名稱保留的測試目標可透過內建解析取得位址。hosts 會將測試名稱對應至回環位址,不會修改系統的主機名稱對應。servers 中的 localhost 是使用本機解析能力的寫法,不代表回環位址上已經有可查詢的服務。測試名稱使用保留網域後綴;請透過代理連線至已啟動的本機測試服務,不要將它當成公開網站。

請在原始基準設定上測試這個範例,不要覆蓋上一章仍引用 blocked 的設定,否則會移除被引用的出口。若應用程式將測試名稱排除在代理之外,或嘗試先用自己的解析器查詢,靜態對應就不會經過核心。反過來說,若改回直連出站的預設網域處理方式,系統可能會嘗試解析同一個名稱。使用兩份只有出站解析策略不同的設定進行比較,並在每輪測試時建立新連線,即可區分內建對應與系統解析的結果。

上游分組、位址族與快取

若要讓不同網域使用不同上游,可查閱所用核心是否支援 servers 物件中的項目,例如使用 address 指定解析端點,並以 domains 描述比對範圍。列出專用上游,不代表其他所有伺服器都一定不會被使用;請確認該核心對候選順序、失敗回退與結果篩選的規定。使用 HTTPS 解析端點時,也要檢查端點本身如何解析與連線。如果端點的網域必須先透過它自己查詢才能取得位址,就沒有可靠的啟動路徑。

字面位址可以連線、網域名稱卻不行時,先測試實際負責查詢的那一層,再查看結果包含哪種位址族。只啟用 IPv4 或只啟用 IPv6 的策略,可能讓某些目標沒有合適的解析結果;這類設定可用來縮小問題範圍,不適合當成所有網路問題的通用修復方式。修改設定後,也要考量應用程式既有的解析快取、系統快取與仍在使用中的連線,各自更新的時機不同。請先關閉舊連線並更換明確的測試目標,確認哪一層仍回傳舊位址,再決定是否清除對應快取。

policy 連線策略

等級策略控制連線行為,不負責選擇轉送路徑

policy 描述核心如何處理連線時限、緩衝或統計等行為,不負責將網域分配到不同出口。policy.levels 使用字串形式的等級編號作為物件鍵,例如 "0";連線使用哪個等級,取決於相應協定及入口的使用者等級設定。在設定中定義新等級,不會自動將請求切換到該等級。查閱參數前,先確認目前協定如何選擇等級,並分別測試預設等級和明確指定的等級。

策略設定很容易被用來掩蓋前面的設定錯誤。入口連接埠無法連線、遠端傳輸參數不相符,或網域查詢走了非預期的路徑時,增加時限無法解決這些問題,只可能讓用戶端晚一點才看到錯誤。建議先以最精簡的設定確認連線路徑正確,再根據具體的應用程式行為說明調整策略的理由。例如,完全沒有請求活動時才斷線,與持續傳輸資料但速度緩慢,不能用同一個逾時設定來解釋。

分清交握、閒置與單向結束

加入根物件 · 以第 0 級示範連線時限,單位為秒
{
  "policy": {
    "levels": {
      "0": {
        "handshake": 8,
        "connIdle": 180,
        "uplinkOnly": 4,
        "downlinkOnly": 12
      }
    }
  }
}

handshake 會限制適用協定等待初始交握的時間,不是所有網路呼叫共用的連線時限,也不會覆蓋遠端程式自己的時限。connIdle 著重於連線閒置的時間,不能解讀為從建立連線開始計算的最長連線時間。範例中的數值僅用來區分不同的計時項目,不代表任何用戶端的預設值。若應用程式自行設定的逾時更短,通常會先由應用程式主動結束請求。

uplinkOnly 指只剩上行的階段,也就是下行結束後,上行還能維持多久;downlinkOnly 則指只剩下行的階段。兩者都不是上傳或下載速度上限。單向結束後立即中斷剩餘方向,可能讓尚未接收完的回應提前終止;等待太久,也可能讓已無用途的連線繼續占用資源。若要測試這些設定,請選擇能清楚觀察讀寫結束行為的應用程式。一般短請求成功,不足以驗證長連線或單向結束的情境。

分辨使用者等級、系統統計與用戶端介面

policy.system 是核心的系統層級策略。部分實作支援在這一層啟用入站或出站計數,而使用者計數則由相應等級的設定控制。是否產生計數、用戶端能否讀取,以及是否會顯示為介面上的統計數字,是三個不同條件;還要確認相應的統計模組與讀取功能是否已啟用。只加入策略欄位,不保證介面會立即顯示資料,也不應為了查看計數而將管理介面開放給其他裝置。

調整策略時,請保留一組對照設定:固定應用程式、入口、出口與目標,只替換正在驗證的等級參數,並使用重新建立的連線。記錄錯誤是在首次送出請求時、閒置後恢復時,還是已收到部分回應後發生,再判斷與哪個計時器有關。如果只有單一應用程式異常,而其他應用程式透過相同入口與出站都能正常運作,也要檢查該應用程式自己的重試與連線池設定。觀察到穩定差異後再保留變更,其餘實驗參數則還原至基準設定,避免下次修改時因多個時限同時變動而無法判斷原因。

用戶端設定與生效範圍

先分清訂閱、單筆分享資料與核心設定檔

桌面版建議使用 v2rayN;Android 可依所需核心選擇 v2rayNG 或 v2flyNG;安裝方式請見安裝套件頁面。用戶端管理連線紀錄的格式,與核心執行時使用的設定並不相同。訂閱網址通常用來取得一組連線紀錄;單筆分享資料描述一條連線;完整的核心設定檔則可同時定義入口、出口、解析與路由。成功匯入一種資料,不代表另一種資料也能貼到同一處。

已有訂閱、只想新增一條連線時,繼續使用用戶端的紀錄管理與更新功能即可。若要修改本頁提到的根物件欄位,先確認用戶端是否提供相應設定,或是否支援匯入這種格式的自訂設定。若不確定應使用哪種匯入方式,請先閱讀訂閱匯入與分享格式說明。用戶端儲存的內部檔案可能包含介面偏好設定與紀錄索引;編輯這些檔案不等同於修改核心 JSON。直接將用戶端資料檔當成核心設定檔,常會在啟動時就失敗。

相同的設定欄位,不代表流量接管方式也相同

平台 用戶端 驗證設定時優先檢查
Windows v2rayN 系統代理是否指向目前的入口;測試應用程式是否遵循系統設定。
macOS v2rayN 目前使用的網路服務是否啟用了相應代理;比較時固定使用同一網路服務。
Android v2rayNG / v2flyNG 連線授權與應用程式範圍是否包含測試應用程式;匯入格式是否適用於該核心。
Linux v2rayN 桌面代理設定是否與個別處理程序的代理設定一致;終端機工具是否另有環境設定。

系統代理通常仰賴應用程式讀取並遵循系統設定;儲存 JSON 不會自行改變這項行為。若要在桌面端測試特定入站,可先在應用程式中手動設定代理,不要同時啟用所有流量接管方式。如果手動指定代理可用,切換到系統代理後卻失敗,請檢查應用程式如何讀取系統設定、是否套用了例外,以及用戶端寫入了哪個連接埠。此時改用其他協定的出站,通常只會增加新的變數。

TUN 模式透過虛擬網路介面接收流量,會受到路由範圍、應用程式範圍與系統權限等條件限制。它不是將 SOCKS 入口的協定名稱改為 TUN,也不是能繞過所有應用程式限制的一鍵替代方案。Android 的連線範圍還要配合系統授權與用戶端設定確認;桌面端可執行的單一連接埠測試檔,不能證明行動裝置會以相同方式管理裝置流量。跨平台移植時,應先沿用與協定相關的部分,再分別驗證各平台如何將流量送進核心。

確認實際載入的設定與核心

用戶端的圖形介面設定通常會在啟動或切換連線紀錄時產生執行設定。手動編輯執行目錄中的暫存檔,可能會在下次啟動時被正常覆寫。長期修改應透過用戶端支援的設定入口,或存放在受支援的獨立設定檔中。若要確認修改已套用至目前執行個體,可更換成不易混淆的本機測試連接埠,重新啟動連線後,讓應用程式明確連線至新連接埠,再與舊連接埠比較。不要把介面顯示的「已儲存」當成核心已重新讀取檔案的證明。

不同用戶端選用的核心,可能對同一個擴充欄位有不同解讀或支援範圍。移轉設定時,先依根物件與協定確認基本相容性,再逐項恢復選用功能。如果加入某段設定後才出現錯誤,請保留原本能啟動的版本,並記錄失敗段落的完整路徑。需要向他人求助時,只摘錄相關結構及錯誤附近的內容,並移除訂閱網址、驗證資料和不必要的網路資訊;提供重現條件比提供整份執行檔案更有幫助。

設定驗證與日誌疑難排解

依解析、監聽、轉送三個階段驗證

啟動後立即退出,先檢查實際執行的核心能否解析檔案。依錯誤位置回頭檢查前一行的逗號、引號與括號,再確認欄位型別,以及這份檔案是否透過正確的匯入方式載入。語法正確只表示物件可被讀取,不代表欄位有效。從第一個明確錯誤開始檢查,修正後再重新啟動;一處括號錯置可能導致後續多行一併報錯,逐條修復衍生錯誤反而會破壞原本正確的內容。

解析成功後,查看日誌是否指出位址綁定失敗或連接埠遭占用,再使用固定目標確認連線是否進入指定入站。以下範例假設本機的 127.0.0.1:8000 已有可存取的 HTTP 測試服務,並使用第一章的基準設定,不使用含拒絕規則的實驗設定。第一個指令略過代理,第二個則明確指定 HTTP 代理,並清除這次請求的代理例外設定。若 Windows 的命令名稱與殼層別名衝突,可將命令名稱寫成 curl.exe。

對照測試 · 先直接連線,再經過本機 HTTP 入站
curl --noproxy "*" --max-time 5 http://127.0.0.1:8000/
curl --noproxy "" --proxy http://127.0.0.1:10809 --max-time 5 http://127.0.0.1:8000/

兩次測試應使用相同的目標與路徑,第二次請求使用的代理連接埠則必須與設定一致。若第一個請求正常,第二個卻顯示無法連線至代理,請回頭檢查監聽;若能連上代理但收到錯誤,請確認是否命中非預期的出口,或目標是否拒絕連線。兩次都成功,只能證明這條本機 HTTP 路徑正常,不能代表其他目標、其他協定或系統流量接管也正常。接著再逐一加入額外入站、路由或遠端出口;從哪一步開始出現差異,就從該步的輸入與輸出查起。

依日誌階段縮小故障範圍

閱讀日誌時,請搭配一次可重現的操作。記下操作時間,關閉無關的測試視窗,送出一筆新請求,再查看同一時段的入口、目標、出口與失敗原因。預設基準設定使用 warning,成功轉送不一定會顯示詳細紀錄。若需要更多資訊,可暫時提高詳細程度,並使用用戶端提供的存取紀錄或日誌檢視功能。不同核心輸出的文字可能不同;判斷依據是連線進行到哪個階段,而不是尋找一模一樣的錯誤範本。

如果日誌顯示已選擇正確出口,但遠端交握失敗,先確認服務端要求的傳輸與安全參數,同時留意裝置時間及本機的信任憑證環境。若故障只出現在網域請求,請回到解析章節確認由誰發出查詢;若連線只在閒置一段時間後中斷,則對照連線策略章節的計時情境。更多範例請見v2rayN 日誌與錯誤排查;用戶端選擇與連線失敗的基本排查順序,也可參考V2Ray 新手常見問題十問。

結束測試時還原變更,並保留可重現的紀錄

驗證完成後,先還原暫時設定的系統或應用程式代理,停止不再使用的測試入口,再將日誌等級恢復至日常設定。將最終檔案與上一份基準設定一起保存,並記下本次變更的欄位路徑,以及使用哪個目標、入口與預期出口進行驗證。下次連線異常時,先重跑相同測試,再還原有問題的項目,不要直接替換整份設定。需要補查欄位脈絡時,可從本頁目錄返回對應章節;若不確定術語描述的是哪一層,可參考V2Ray 術語表。

下載用戶端