設定參考 · v2rayN
V2Ray 進階設定手冊
完成初次連線後,可參考本頁了解訂閱、路由、DNS 解析與流量接管的設定範圍。若尚未確認基本連線正常,請先依照入門指南完成匯入、連線與驗證,再回到本頁,每次只調整一個設定層面。
訂閱分組與伺服器篩選
先設定更新範圍,再匯入伺服器
訂閱分組可區分伺服器資料的來源與更新範圍,但不等於路由策略,也不會自動替特定應用選擇出站。以下以桌面端常用的 v2rayN 為例:在訂閱分組管理中新增分組,為來源填寫易於辨識的備註,再輸入訂閱網址。儲存後先切換至該分組,使用只更新此分組的功能,避免初次驗證時一併改動其他來源。不同介面可能將更新功能標示為「更新目前訂閱」,或放在分組選單中;判斷依據是操作對象為目前分組還是所有分組,而非按鈕的位置。
更新完成後,別只看介面是否顯示成功。先確認分組內是否有可用項目,再選取預期出現的伺服器,檢查協定與傳輸類型是否符合提供者的說明。接著將它設為目前伺服器,使用先前已驗證的連線模式實際送出一次請求。訂閱請求成功、清單解析成功,以及清單中的伺服器可連線,是三件不同的事。即使更新收到正常回應,也可能只取得登入頁面、錯誤訊息,或用戶端不支援的訂閱格式。
分清匯入篩選與清單搜尋
伺服器清單上方的搜尋通常只會影響畫面顯示;分組設定中的伺服器篩選若套用於匯入階段,則可能改變更新後實際匯入的項目。修改前先確認篩選依據是備註、協定或其他欄位,以及規則是保留符合項目還是排除符合項目。若沒有明確說明支援正規表示式,請先用確定存在的一般關鍵字測試,不要直接貼上含有管線符號和括號的表示式。關鍵字盡量選用來源長期沿用的穩定前綴,避免使用可能隨維護而更名的臨時標記。
若條件允許,可在可丟棄的測試分組中使用同一來源進行比較:先保留未篩選的結果,再加入只會比對少數項目的條件,最後清除條件並重新更新。清除清單搜尋後仍找不到相關項目,就表示問題不只是搜尋欄位隱藏了資料。若用戶端明確使用正規表示式,也要檢查錨點是否限制字串開頭,以及括號是否改變替代條件的適用範圍。中文別名中的全形符號與一般連字號並不相同;排查時直接從伺服器備註複製一小段,比手動輸入完整名稱可靠。
從更新階段找出清單為空的原因
更新失敗時,先確認錯誤發生在送出請求前、讀取回應時,還是解析項目後。若請求根本沒有送出,請檢查分組是否已儲存、是否已啟用,以及選取的更新操作是否正確。若記錄中出現憑證或時間錯誤,先校正系統時鐘並檢查連線路徑,不要以降低憑證驗證強度來掩蓋問題。若記錄顯示已取得回應但沒有可匯入項目,請暫時移除分組篩選,改在獨立測試分組重試。移除篩選後仍無法匯入,應向來源確認輸出格式與連結狀態,而不是繼續調整路由策略。
部分來源只能透過特定網路路徑存取。直連更新和經由目前代理更新應分開驗證;測試後者時,不要先刪除可用伺服器,否則可能失去更新所需的連線。Android 上也可用相同方式檢查 v2rayNG 或 v2flyNG 的訂閱管理,但不要假設桌面端的分組欄位都能逐一移植。安裝檔與平台入口請見下載用戶端;更新錯誤的詳細排查方式請見訂閱更新失敗與自動更新間隔。
路由規則實作:比對順序與預設出站
先確認請求已進入核心
路由規則只處理已進入代理核心的流量。在系統代理模式下,遵循系統代理設定的應用通常會將請求交給用戶端;有獨立代理設定的應用則可能仍走其他路徑。TUN 模式能擴大接管範圍,但系統路由排除項與應用本身的行為仍會影響結果。因此,測試規則前,應先用確定會經過用戶端的應用送出請求,並確認執行記錄有記下這次連線。若記錄中完全沒有請求,就不能根據目標是否能存取來判斷路由有沒有比對成功。
在 v2rayN 的路由設定中,先複製目前可用的方案,再編輯副本。記下三件事:規則的執行順序、命中後使用哪個出站,以及未命中時的預設出站。例外規則通常應放在涵蓋範圍較廣的規則之前;例如,若只想讓某個子網域使用指定出站,就應將該子網域規則排在涵蓋整個父網域的規則之前。不要只看規則名稱推斷範圍:精確網域、網域後綴與關鍵字比對的對象各不相同;後綴比對通常也會涵蓋符合條件的子網域。
分別驗證網域比對與 IP 位址比對
核心收到的是網域還是 IP 位址,取決於入站方式及應用提供的目標格式。若應用已自行解析,並將 IP 位址交給用戶端,單純比對網域的規則通常無法直接命中該位址。某些入站可透過協定嗅探取得網域,但仍受使用的協定與入站設定限制,不能假設所有連線都會自動嗅探。反過來說,若收到的是網域,IP 位址規則能否命中,則取決於核心是否會為路由判斷額外解析。測試時請用獨立的 IP 位址目標驗證位址規則,再用可控網域驗證網域規則,不要混為一談。
| 網域策略 | 路由階段的解析時機 | 排查重點 |
|---|---|---|
AsIs | 不會主動解析目標網域以進行路由比對。 | 不要預期只靠 IP 位址規則就能比對收到的網域。 |
IPIfNonMatch | 第一輪未命中時,嘗試解析網域並重新比對。 | 先命中的寬鬆規則可能導致 IP 位址比對無法執行。 |
IPOnDemand | 判斷到需要 IP 位址資訊的規則時,可觸發解析。 | IP 位址類規則的位置會影響解析發生的時機。 |
用對照請求找出錯誤規則
假設要讓本機管理網段直連,並讓某個測試網域走代理。先新增明確的私有網段例外,再新增測試網域規則,最後確認預設出站。準備三種請求:一個已知存在的管理位址、一個符合網域規則的目標,以及一個未受管理且未列入規則的對照網域。每次只送出一個新連線,記錄入站、目標格式與出站標記。應用可能會重複使用既有連線,因此切換規則後應關閉舊連線,必要時重新啟動測試應用;只重新整理重複使用連線的頁面,無法證明新策略沒有生效。
若明確設定的例外正確,但其他所有目標都走上非預期路徑,問題通常出在兜底規則或預設出站。若只有依賴規則集的項目異常,先用精確網域或明確網段建立最簡規則,確認順序與出站本身正常,再檢查規則集標籤及載入記錄。不要同時更新規則集、切換核心並修改 DNS;這些操作都會改變結果,讓比較失去意義。需要進一步閱讀記錄時,請參閱常見錯誤訊息與逐項排查方式。
DNS 設定最佳化:解析來源與請求路徑
區分應用程式、系統與核心解析
排查 DNS 時,第一步不是更換解析器,而是先確認由誰發出查詢。使用系統解析的應用會受作業系統網路設定影響;啟用獨立加密解析的瀏覽器可能直接連線至自己的上游;代理核心也可能在比對 IP 位址規則、解析伺服器位址,或處理接管的 DNS 請求時查詢網域。這些行為可能同時發生。即使在用戶端設定了遠端 DNS,也不能因此斷定系統中的每筆查詢都會改走該上游;瀏覽器透過代理存取網站,也不能反推該網站的網域已由代理核心解析。
建立基準時,先維持現有連線模式,選一個一般公開網域和一個必須透過區域網路解析的名稱。確認公開網域能否取得合理結果,以及區域網路名稱是否仍回傳內部位址。若一般查詢正常、內部名稱卻失敗,先確認內部網域是否被交給只認得公用紀錄的解析器。涉及組織內部名稱時,請使用管理員提供的測試目標並遵守網路政策,不要將真實內部網域交給外部解析服務進行比較。
設定上游與分流規則
在 v2rayN 的 DNS 設定中,先確認目前使用的核心,以及設定是由一般介面產生,還是採用自訂設定。不同核心的 DNS 結構並不通用。若介面支援指派解析器,通常先設定負責解析內部名稱的上游,再設定一般查詢的預設上游。此處的「遠端」只表示上游不在本機,不代表連往上游的請求一定會經過代理。若使用加密 DNS,也要一併確認位址格式、連線至上游時的路由,以及上游使用網域時的首次解析路徑。
如果代理伺服器網域和加密 DNS 上游網域都交由只能在代理建立後使用的解析鏈處理,啟動時可能形成循環:核心必須先解析伺服器才能連上代理,但解析器又要等代理可用才能存取。常見現象是切換設定後第一個請求逾時,但暫時保留舊連線時卻看不出問題。驗證方式是先還原原本的解析方式,結束用戶端並重新啟動,確認能冷啟動後再逐項啟用設定。若原有路徑可以啟動,應優先為建立連線的階段提供獨立可用的解析路徑,而不是延長逾時等待。
逐項比對解析結果與存取結果
驗證時先查看記錄中的解析錯誤,再單獨檢查目標連線。若出現沒有可用紀錄、請求逾時或回傳的位址類型不符預期,先檢查上游與查詢策略;若已有解析結果但連線失敗,再檢查出站能否連到該位址。在雙堆疊環境中,某個位址類型的連線失敗,不代表解析失效。請分別記下 IPv4 與 IPv6 的查詢結果、應用最後選用的位址,以及實際連線錯誤。不要為了讓單一測試通過,就將限制永久套用到所有解析器與應用。
切換設定後,應用程式、系統與用戶端的快取未必會同時失效。先關閉舊連線,改用尚未測試過的受控名稱,或重新啟動測試應用,再比較不同路徑的結果。必要時可在連線模式不變的情況下,暫時停用瀏覽器的獨立解析功能,以便分辨查詢來源;測試後再還原設定。若只有用瀏覽器測試時結果不同,請先檢查瀏覽器的解析選項,不要只根據單一頁面的回報,就斷定系統解析路徑已改變。驗證方式與具體操作可參考DNS 洩漏測試與防洩漏設定。
TUN 模式:接管範圍、排除項與復原
依應用需求選擇接管方式
系統代理提供連線設定給應用,應用可以採用,也可以忽略。TUN 則透過虛擬網路介面與系統路由,將符合條件的流量交給用戶端處理鏈。它適合需要涵蓋未使用系統代理的應用,或分析應用在不同傳輸方式下的行為;但不代表所有流量都會經由同一個出站傳送。路由排除、本機介面、位址類型支援,以及應用本身的連線方式,都會影響實際路徑。若現有情境已能透過系統代理正常運作,就不必只為了達到相同結果而增加新的接管層。
啟用前,記錄目前的網路介面、區域網路存取狀態、用戶端連線模式與 DNS 設定,並確認能關閉功能及還原原設定。桌面端可優先使用 v2rayN 驗證,並依作業系統確認是否需要相應權限或服務。Android 上的 v2rayNG 與 v2flyNG 使用系統提供的網路接管能力,介面用語不一定與桌面端相同。若已有其他虛擬網路或工作網路接管功能,先確認是否允許並行使用;在受組織管理的裝置上,應由管理員確認政策,不要自行移除管理元件。
先驗證介面,再驗證應用程式
依照用戶端介面啟用 TUN 後,先檢查核心記錄是否出現介面建立、路由或權限錯誤。開關顯示已開啟,不代表系統路由已套用,也不代表 DNS 和 UDP 都以相同方式處理。介面穩定後,先測試一個原本可透過系統代理存取的目標,再測試一個不依賴系統代理的應用。為確保比較有效,請記下測試期間系統代理是開啟還是關閉;若兩者同時開啟,應用先交給系統代理的請求不能證明 TUN 已成功接管。
區域網路存取失敗時,先用已知有效的管理位址測試,再測試相應的區域網路名稱。前者失敗時,檢查目標網段是否應保留直連路徑、是否與虛擬位址池重疊,以及系統路由實際選用哪個介面;前者成功而後者失敗,則優先檢查內部名稱的解析路徑。不要為了恢復單一服務就任意排除整個大型網段;排除範圍應符合實際的本機子網,否則其他原本應由 TUN 接管的連線也會被繞過。
排查迴圈路由與切換後斷線
若啟用後所有存取都失效,請確認代理伺服器本身的連線是否被導回虛擬介面。先停用 TUN,確認仍能連上伺服器,再查看用戶端是否支援自動選擇出口介面,以及多網卡環境中選用的出口是否對應目前啟用的網路。切換有線、無線或既有虛擬網路後,先前儲存的介面綁定可能已不適用。若設定需要手動指定,僅綁定已確認的介面,或使用用戶端支援的排除機制,並保留原設定以便復原。
若只有某一類應用異常,不要直接歸咎於代理伺服器。分別測試短連線與持續連線,記錄問題是在連線建立前發生,還是在傳輸一段時間後出現。若小型請求穩定,但較大傳輸經常停滯,可在其他條件不變時檢查虛擬介面的 MTU 是否符合目前路徑;若只有 UDP 服務失敗,則分別檢查 TUN 接管、用戶端規則及目標出站是否支援該流量。復原時先關閉 TUN,再確認系統代理與 DNS 是否回到預期狀態。若問題在裝置休眠或網路切換後重現,應在相同網路環境下重新測試;手動重啟應用只是復原方法,不是問題診斷結論。
FakeDNS:網域映射與啟用條件
了解虛擬位址的用途
應用程式通常會先解析網域,再將取得的 IP 位址交給網路介面建立連線。如果流量接管層只看得到這個位址,依網域判斷的路由規則就缺少直接依據。FakeDNS 的作法是讓被接管的查詢取得虛擬位址,並在核心中保留該位址與原始網域的映射。應用連到虛擬位址後,接管鏈路會依映射還原網域,供路由或出站處理。虛擬位址不是目標伺服器的真實紀錄,也不是固定的出站標記;離開建立映射的狀態後,同一個位址就不再具有原本的意義。
這項機制需要兩個條件:查詢必須進入能提供映射的解析鏈,後續連線也必須回到能辨識映射的處理鏈。若只將 DNS 查詢交給 FakeDNS,卻讓連線繞過用戶端,應用可能會拿著虛擬位址走向無效路徑。反過來說,若應用使用自己的解析器取得真實位址,即使 TUN 已接管連線,也無法從該連線取得不存在的 FakeDNS 映射。因此,「已啟用 TUN」和「應用正在使用 FakeDNS」必須分開驗證。
基本連線穩定後再啟用
先在關閉 FakeDNS 的情況下,確認 TUN 可正常運作、一般網域能解析,且區域網路服務可存取。記錄目前使用的核心與 DNS 方案,再確認用戶端是否為該核心提供完整的 FakeDNS 設定入口。不要將某個核心的虛擬位址池欄位直接複製到另一個核心,也不要只填入虛擬位址池參數而未檢查 DNS 規則與入站還原設定。啟用後,請從重新啟動的測試應用送出一次請求,確認接管的查詢、回傳的位址類型、還原後的目標網域及最終路由結果彼此吻合。
位址池必須避開裝置目前使用的網路、組織內部路由,以及其他虛擬介面占用的範圍。即使某個位址區段未用於公網的一般服務,也不代表本機環境一定不會使用。判斷是否衝突時,應比較整個網段範圍,而非只看兩個起始位址是否相同。在同時使用 IPv4 與 IPv6 的環境中,也應分別測試兩種查詢類型;一種位址取得虛擬映射,不代表另一種位址的查詢也進入相同處理鏈。
為內部服務保留真實位址
有些應用會儲存解析結果,並交由其他程序或裝置使用;也有應用直接依賴服務的真實位址進行探索或存取。這些情況不適合只憑一般網頁能否正常開啟來判斷相容性。對於需要真實位址的內部網域與特定服務,先確認設定是否支援以一般方式解析指定網域,再用已知可連線的位址進行比較。不要把虛擬位址範圍加入直連規則來修復問題,因為這會跳過原本應還原網域的步驟。
啟用後若首次存取正常,重新啟動核心後卻有一段時間逾時,可能是應用仍快取舊的虛擬位址,而新程序中已沒有相應映射。復原時先關閉 FakeDNS,還原一般上游並重新建立用戶端連線,再清除測試應用的舊連線與相關快取;不要將尚未清除快取的測試結果當成策略仍在生效。若目前只能確認介面接管成功,卻無法確認網域還原與內部服務正常,保留一般 DNS 會更容易維護。位址池與相容情境的詳細說明請見FakeDNS 原理與啟用前須知。
多訂閱管理:更新順序、切換與復原
按來源分開管理,不靠備註合併項目
單一分組用來管理一批伺服器如何匯入;多訂閱管理則確保某個來源異常時,其他來源仍能維持可用。建議為不同來源分別建立分組,並以穩定名稱區分主要、備用與測試用途。若同一來源提供兩種不同格式,也可先分別匯入測試,確認差異後再決定要保留哪一種。多個分組中出現相同備註,不代表它們指向同一台伺服器;位址、協定、傳輸或驗證參數不同,都可能造成不同的連線結果。不要只憑顯示名稱就批次刪除同名項目。
在 v2rayN 更新前,先確認目前連線使用哪個分組,以及更新後是否會取代原有項目。若目前節點來自即將更新的主要分組,先透過備用分組獨立完成連線驗證,再更新主要分組。若測試用途需要保留手動修改的伺服器項目,請將它放在不會被訂閱更新覆蓋的位置,並確認修改符合來源的使用條件。訂閱提供的設定與只在本機生效的手動調整是兩回事;用戶端重新匯入時,通常仍會以來源回傳的設定為準。
為更新設定明確的網路路徑
訂閱更新本身是存取訂閱網址的請求,與連線至清單中的伺服器不同。有些訂閱可直連更新,另一些則必須透過目前可用的連線才能取得。請先分別確認各來源的更新路徑,再執行批次更新。若用戶端只能為整個更新操作選擇一種路徑,請優先手動更新有特殊條件的分組,不要將某一組的網路條件套用至所有來源。若更新間歇性失敗,先記錄是否總在裝置剛喚醒、剛切換網路或剛更換伺服器後發生,再調整更新時機。
自動更新間隔應依實際變更頻率、提供者限制與用戶端支援的設定粒度調整。間隔太短會放大短暫斷線、流量限制與解析故障的影響,也不保證伺服器一有變動就能立即取得。啟用自動更新前,至少先手動更新一次,確認更新不會移除備用分組,並能區分更新失敗、回傳空清單與正常刪除。若用戶端不支援個別排程,保留可預期的手動更新順序,比假設背景更新一定會準時執行更可靠。
建立可重複執行的切換流程
先選定一個一般公開目標作為連線基準,再準備另一個要驗證的業務目標。切換伺服器後先連線至基準目標,確認入站與出站正常,再測試業務目標,以區分伺服器不可用和規則不適用於特定目標。若測試必須涵蓋 UDP,再另外測試一種實際使用的 UDP 服務;一般網頁能開啟,並不足以證明所有協定與出站都正常。請記下切換前後使用的分組與備註,但不要在公開排錯紀錄中貼出含有憑證的訂閱網址、完整設定或分享連結。
主要分組更新後突然變成空清單時,先暫停該分組的自動更新或停止重複更新,維持其他分組不變,再依訂閱分組與篩選一章的對照方式判斷原因。若備用分組仍正常,可先維持現有連線,再單獨檢查主要來源。若備用分組也同時失敗,優先排查共用依賴,例如系統網路、解析器、接管模式與憑證時間,而不是逐一修改伺服器。在 Android 上移轉設定時,先確認訂閱本身支援相應核心;不要假設桌面端路由與自動更新時間可以直接沿用。常見安裝與切換問題請參閱常見問題。
自訂出站:標籤、規則與最小設定
確認是否需要自訂
出站決定由誰處理連線;路由則決定在什麼條件下將請求交給該出站。桌面端若只是切換目前的訂閱伺服器,通常使用介面產生的出站即可。只有在確實需要依不同目標採用不同處理方式,或要驗證核心欄位是否如預期生效時,才值得維護自訂設定。首先確認 v2rayN 目前項目的設定模式與所選核心。介面產生的暫存設定可能在切換伺服器或重新啟動後重建,直接修改這類檔案並非可維護的設定方式;應保留用戶端支援匯入的獨立檔案,並記錄負責載入它的項目。
使用自訂檔案時,不要假設一般訂閱項目中的路由、DNS 與入站設定一定會合併進去。請確認目前模式的載入範圍:是由核心獨立讀取整份檔案,還是由用戶端產生外層結構。接著檢查每個出站標籤是否唯一、規則指定的標籤是否確實存在,以及規則未命中時會交給哪個出站。標籤本身沒有網路功能;寫成 direct 不會自動建立直連,寫成 proxy 也不會自動從訂閱取得伺服器。
在迴圈位址上驗證直連與拒絕
以下是可直接交由 Xray 核心載入的完整最小設定。它會建立僅限本機存取的 SOCKS 入站,第一個出站用於直連未命中的目標,並將精確網域 example.net 交給拒絕出站。此範例不依賴遠端伺服器或憑證,適合驗證規則與標籤,但不是可任意併入用戶端匯出檔案的片段。若連接埠已被占用,必須同時修改設定與測試應用的連線設定。
{
"log": {
"loglevel": "warning"
},
"inbounds": [
{
"tag": "local-test",
"listen": "127.0.0.1",
"port": 11080,
"protocol": "socks",
"settings": {
"auth": "noauth",
"udp": false
}
}
],
"outbounds": [
{
"tag": "direct",
"protocol": "freedom",
"settings": {}
},
{
"tag": "reject",
"protocol": "blackhole",
"settings": {}
}
],
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"inboundTag": ["local-test"],
"domain": ["full:example.net"],
"outboundTag": "reject"
}
]
}
}
使用選定的 Xray 核心載入後,將支援 SOCKS 的測試應用連線至 127.0.0.1:11080,並設定應用將網域而非預先解析的 IP 位址交給 SOCKS 入站。存取 example.net 時,連線應遭拒絕;存取另一個已知可直連的公開網域時,則應透過直連出站。若兩個目標都失敗,先檢查監聽連接埠與測試應用是否使用了該入口。若只有拒絕規則沒有生效,請確認是否使用了其他主機名稱、是否已由應用自行解析,或是否實際重複使用舊連線。此範例未啟用 UDP,也未測試 TUN;請勿用它判斷應用是否支援 UDP。
從最小設定檔逐步擴充
需要新增遠端出站時,請依照有權使用的伺服器所提供的協定與傳輸參數,在 outbounds 中新增唯一標籤,再加入一條涵蓋範圍較小、引用該標籤的網域規則。保留原有直連與拒絕對照不變,先驗證新規則確實選用新的出站,再單獨確認遠端交握成功。支援的出站協定與傳輸組合取決於核心,不能只更改協定名稱,就沿用舊的驗證與傳輸欄位。選擇協定前,可先參閱VMess 與 VLESS 的驗證、加密及傳輸差異,再核對來源提供的實際設定。若使用組合出站,也要確認代理伺服器的網域解析與連線路徑能否不依賴此新出站而獨立建立。
最後,將自訂檔案與日常使用的設定分開,並保留原本已驗證的用戶端項目。恢復業務流量前,重新檢查三個環節:目標是否進入預期的入站、比對是否選到預期標籤,以及出站是否成功建立連線。只有其中一個環節異常時,就只復原該環節;若核心啟動失敗,先切回日常項目並還原原本的系統代理或流量接管設定,再脫離業務流量驗證自訂檔案。保留一份能重現最小案例的設定,比保留一份只能在目前裝置上偶然運作的完整設定,更有助於排查問題。