設定參考 / v2rayN
v2rayN 進階設定指南
首次安裝、匯入訂閱或驗證連線,請先完成快速入門。本指南以已能建立連線的設定為起點,依訂閱來源、流量入口、名稱解析與出站路徑逐項說明。桌面端建議使用 v2rayN;尚未選好安裝檔的話,請先前往下載用戶端確認平台與架構。
訂閱分組與伺服器篩選
先標記來源,再整理名稱
開啟 v2rayN 的「訂閱分組設定」,先為每筆訂閱填寫能辨識來源與用途的備註,例如「日常使用」和「維護備用」。備註用來辨識分組,不會改寫伺服器位址,也不會納入路由條件。同一份訂閱即使更改本機備註,伺服器清單仍由訂閱網址決定。反過來說,兩筆訂閱出現相同名稱,也不能證明它們來自同一網址或使用相同連線參數。整理清單時先依來源分組,再查看伺服器備註,比直接在「全部」檢視中逐筆重新命名更容易核對。
手動新增的伺服器也應與訂閱管理的記錄分開處理。需要長期保留的測試設定,不宜只放在會隨訂閱更新而變動的清單中。先確認本機的保留方式,再整理訂閱分組。如果用戶端支援將設定複製到獨立分組,複製後請確認新記錄不再受原訂閱更新影響;否則就將它當成獨立設定維護。不要用顯示順序標記常用伺服器:來源一旦更新,排序和備註都可能改變。選取某筆記錄與將它設為目前使用的伺服器是兩回事,操作後請查看主視窗的使用狀態。
分開處理清單搜尋與更新篩選
清單搜尋適合臨時查找,清除搜尋後原有記錄應會重新顯示。訂閱設定中的篩選條件則可能參與匯入或更新,決定這次哪些記錄會加入分組。兩者的驗證方式不同:測試清單搜尋不必再次擷取資料;測試訂閱篩選則應在目標分組執行一次更新,再核對實際保留的記錄。如果介面有獨立的篩選輸入框和訂閱「篩選」欄位,請先依介面提示確認各自用途,別把兩個輸入框當成同一項持續套用的規則。
若目前版本的篩選欄位明確支援正規表示式,可以先從簡單的比對開始。下方的表示式只會比對備註以「備用」或「測試」結尾的項目,並允許結尾有空白。這不代表一定會保留或排除這些記錄;實際方向取決於欄位說明。先用一筆確定會符合及一筆不會符合的備註測試。不要拿完整訂閱網址、帳戶識別資訊或連線參數當作比對範例,也不要把一般搜尋框是否辨識直線符號當成支援正規表示式的證據。
(備用|測試)\s*$
將空清單恢復為可驗證狀態
更新後分組變成空的,先清除清單搜尋和其他檢視條件,再查看更新記錄是否收到可解析的項目。擷取失敗、解析結果為空、篩選後沒有項目,表面上都是看不到新項目,但處理方式不同。擷取失敗時,先確認更新使用的網路路徑,以及訂閱是否仍有效;解析結果為空時,先核對來源回傳的格式;篩選後為空時,則暫時清除篩選表示式,只更新目前分組並重新計數。不要一開始就選「更新所有分組」,否則其他分組也會同時變動,容易看不出是哪項設定造成差異。
如果只剩少數記錄,抽查備註格式是否有變化。結尾新增說明文字、全形括號改成半形,或標籤從尾端移到前面,都可能讓原本的表示式漏掉項目。較好的做法是將表示式限縮在穩定的命名慣例;如果上游沒有固定格式,寧可用臨時清單搜尋,也不要綁定過於嚴格的匯入規則。篩選只能整理顯示或匯入結果,無法判斷協定是否相容,更不能取代連線測試。確認清單恢復後,再用一台已知可用的伺服器驗證使用狀態與實際請求。
路由規則實作
先分清流量入口與出站比對
路由規則只處理已交給核心的流量。瀏覽器使用系統 Proxy 時,請求可能會先進入用戶端;未使用系統 Proxy 的應用程式,通常不會因此自動經過相同入口。在判斷規則無效前,先確認目前應用程式的連線確實經過用戶端。可以在應用程式中明確使用用戶端監聽的本機 Proxy 作為對照,也可以在適用的平台檢查 TUN 入口。規則不是作業系統的全域網路開關;修改一條規則,不會自動讓原本繞過用戶端的程序進入核心。
在 v2rayN 的路由介面選取目前使用的規則集,再調整單一規則。新建但尚未啟用的規則集,不會接管目前執行中的設定。對於依序處理的 Xray 路由,先放比對範圍較窄的例外,再放一般規則,最後才考慮預設規則。同一條規則中填入多個比對欄位時,通常必須全部符合;如果要表達「某個網域或某段位址都直連」,宜分別建立網域規則與位址規則,不要期待同時填入網域和位址條件的一條規則能表示「或」。
使用可控網域驗證規則順序
以下是可替換的 Xray 設定 routing 物件,並非完整設定。保留現有設定的入口與其他欄位,並確認已有對應的 direct 和 proxy 出站標籤。範例會將公用範例網域及其子網域送往直連出站,其他 TCP 或 UDP 流量則送往 Proxy 出站。實際使用時,可以將範例網域換成有權測試且可穩定存取的網域。若在圖形介面編輯,請依介面欄位分別填入,不要將整個物件貼進單一網域輸入框。
{
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"domain": ["domain:example.com"],
"outboundTag": "direct"
},
{
"type": "field",
"network": "tcp,udp",
"outboundTag": "proxy"
}
]
}
domain: 用來篩選網域及其子網域;只需精確比對單一主機名稱時,可使用 full:。如果入口只收到 IP 位址,AsIs 不會將該位址反查為請求網域,因此網域例外可能不會符合。部分入口可以從可辨識的連線內容取得網域,但結果會受協定、入口設定和流量形式影響。不要把嗅探視為所有連線都能還原網域的保證。若要涵蓋以字面 IP 位址發起的連線,再為已確認由自己管理的目標位址單獨設定位址條件。
依序核對比對結果與連線狀況
先測試規則是否符合,再測試實際服務。針對例外目標和一個不符合例外的目標,分別建立新連線;如果記錄能顯示入口、目的地或出站標籤,請逐項核對。瀏覽器的連線池可能重複使用舊連線,網頁仍能開啟不代表新規則已生效。最好結束舊連線,或改用全新的測試工作階段。確認標籤正確後,再檢查連線是否真正建立。符合 direct 但服務無法開啟,可能是目標在目前網路中無法連線;改用其他標籤前,先確認該目標原本應透過哪條路徑存取。
如果使用 geosite 或 geoip 集合,請分開檢查資源檔是否存在、分類是否包含目標,以及規則順序。分類資料會隨更新變動,不能只憑分類名稱推定某個網域一定包含在內。排查時先改用明確的網域規則作為對照,再決定是否恢復集合。若沒有任何規則符合,Xray 通常會使用出站清單中的第一個出站;範例明確設定預設規則,正是為了避免依賴清單順序。儲存前先記下舊規則集,若發生大範圍異常,可以先切回,而不是繼續堆疊例外。
DNS 設定最佳化
從實際發出查詢的層級著手
同一台裝置上,作業系統、瀏覽器和 Proxy 核心都可能負責解析名稱。系統 DNS 服務使用系統解析介面的應用程式;瀏覽器可能有自己的安全 DNS;Xray 的 dns 物件則提供核心端的解析功能。三者不一定使用相同上游,也不一定取得相同答案。修改用戶端 DNS 設定後,系統網路面板仍顯示原本的位址,並不足以判定設定失敗。先確認應用程式從哪一層取得答案,再檢查該層的查詢路徑。
也要區分目標網域與 Proxy 伺服器網域。目標網域是應用程式要存取的服務;伺服器網域則可能需要在建立 Proxy 連線前先解析。如果負責解析伺服器網域的查詢,必須依賴這條尚未建立的 Proxy,就會形成循環。排查時先確認伺服器的解析與連線可以獨立建立,再調整目標網域的查詢策略。分流中「DNS 請求從哪個出站送出」和「目標連線最後使用哪個出站」也是兩回事,不要用其中一項的結果推斷另一項。
確認上游、位址類型與生效範圍
以下是 Xray 最精簡的 dns 對照物件,請放在完整設定頂層的 dns 欄位。範例使用位址形式指定公用 DoH 服務,避免範例本身額外依賴解析上游主機名稱,同時限制核心這部分查詢只使用 IPv4。上游仍須能從執行查詢的路徑連線;使用企業 DNS 或內部網域的網路,應保留組織要求的解析器。這個物件不會自動將所有應用程式的 DNS 切換至核心,也不會更改系統介面的 DNS 設定。
{
"servers": ["https://1.1.1.1/dns-query"],
"queryStrategy": "UseIPv4"
}
| 檢查項目 | 作用 | 驗證線索 |
|---|---|---|
servers | 為核心 DNS 設定上游 | 比對核心記錄與上游連線狀況 |
queryStrategy | 限制核心查詢使用的位址類型 | 比對 A 與 AAAA 記錄及實際連線狀況 |
| 瀏覽器安全 DNS | 控制瀏覽器本身的解析路徑 | 使用相同應用程式和目標重新測試 |
只查詢 IPv4 適合作為排查手段,例如確認失敗是否由無法連線的 IPv6 路徑造成。若目標只提供 IPv6,或本機網路依賴 IPv6,這項設定就會漏掉必要答案,不適合作為通用最佳化。啟用雙堆疊時,解析到某個位址也不代表系統一定有可用路由連到該位址。請針對同一目標分別檢查兩種位址類型,記錄問題是查詢沒有回應、連線未建立,還是應用程式在既有連線上重試。不要只憑一次網頁開啟速度評估 DNS 策略。
驗證快取、分區解析與回復設定
有些名稱在辦公室網路中應由內部解析器回覆,交給公用上游可能會取得不同答案,甚至查無此名稱。先選一個內部目標和一個公開目標作為對照,分別確認解析器、答案適用的網路,以及實際連線路徑。若要設定網域分流,先確認專用上游負責的名稱範圍,再設定其他網域的預設上游。不要用公用解析結果覆蓋企業內部記錄,也別把同一網域因網路位置不同而回傳不同答案一律視為錯誤。
修改後盡量使用新連線驗證,並留意系統、瀏覽器和核心各自的快取。命令列查詢工具通常會直接詢問指定解析器,可以驗證上游回應,但無法單獨證明應用程式使用相同路徑。若問題只出現在瀏覽器,請另外核對該瀏覽器的安全 DNS 和快取;若只在 TUN 模式下發生,則檢查 DNS 是否確實由 TUN 接管。復原時先還原原本的上游和分流規則,再用原始範例重新測試。若解析成功但網頁仍無法開啟,可參閱常見問題,繼續區分連線與應用程式層的錯誤。
TUN 模式
確認應用程式為何需要虛擬介面
系統 Proxy 通常為遵循 Proxy 設定的應用程式提供轉送入口;TUN 則透過虛擬網路介面和作業系統路由接收指定的 IP 流量。它常用於沒有個別 Proxy 設定的桌面應用程式,但是否能接收流量,仍取決於系統路由、用戶端設定和應用程式行為。TUN 不等於新增一條 Proxy 線路,也不會取代核心中的路由規則。可以將它理解為更換流量入口:入口收到請求後,才由規則判斷要直連、走 Proxy 或採取其他處理方式。
先在 v2rayN 目前的模式下確認使用中的伺服器可正常連線,再檢查主視窗的「啟用 Tun」選項。不同桌面平台的權限提示、虛擬介面建立方式和核心實作可能不同,請依用戶端提示及系統管理流程處理,不要為了排查而關閉整套系統防護。如果 macOS 在開啟程式或授權階段出現提示,請先閱讀macOS 安裝與網路權限說明,確認問題出在應用程式啟動、系統 Proxy 還是網路權限,不要把三個階段當成同一種故障。
逐項切換以隔離變因
啟用前記錄原本的系統 Proxy 狀態、使用中的伺服器和目前路由集。如果情況允許,先關閉會重複接管同一測試應用程式的系統 Proxy,並確認清除的是本次用戶端設定,不要覆蓋原有的組織 Proxy。暫停其他由自己管理、可能爭用路由的工具,保持伺服器與 DNS 設定不變。啟用後先查看用戶端與核心是否成功啟動,再確認虛擬介面是否出現,最後確認測試目標的實際流量是否進入該介面。逐項驗證這三件事,比看到開關變色就開始修改更多設定可靠。
驗證時至少選擇兩類目標:一個原本應透過 Proxy 的應用程式請求,以及一個原本應使用本機網路的服務。如果公用目標可用,但印表機或內部服務失去連線,先區分名稱解析與位址是否可達;同一台裝置可能可以直接連到位址,但依賴區域網路探索的應用程式仍看不到它。多點傳播、廣播和鏈路本地通訊與一般網頁請求不同,不能因網頁正常就推論裝置探索也正常。保留本機服務所需的系統路由,依用戶端實際支援的排除範圍進行對照,並檢查網段是否與其他虛擬介面重疊。
排查斷網、迴圈與休眠後恢復
啟用 TUN 後大範圍斷網,先關閉 TUN 並確認原本模式恢復,再重新啟用一次並記錄最早出現的錯誤。介面建立失敗時,優先檢查權限、驅動程式或同時執行的虛擬介面;介面已建立但連線不斷重試時,檢查預設路由和 Proxy 伺服器本身的出站路徑。如果核心連往伺服器的流量又被送回同一個虛擬介面,可能形成迴圈。此時應檢查用戶端如何保護自身連線,以及選用哪個實體網路出口;不要靠將所有目標改成直連來掩蓋入口問題。
只有少數應用程式異常時,先判斷它是否重用了啟用前的連線,再比對位址類型和傳輸方式。網頁的小型請求能成功,但長連線或較大的傳輸經常停住,也可能與網路路徑可承載的封包大小有關。不要盲目填入網路上抄來的介面參數;請記下原值、確認環境特徵後,再一次只測試一項調整。裝置從休眠恢復或切換網路後,也要重新核對預設出口與虛擬介面狀態。關閉 TUN 後若仍無法連線,先確認系統 Proxy 是否仍指向本機連接埠,以及用戶端新增的路由是否已撤銷。
FakeDNS
了解合成位址的用途
FakeDNS 會對符合條件的網域查詢回傳合成位址,並在核心中記錄網域與位址的對應關係。應用程式取得位址後發起連線;如果連線再次進入保有映射的入口,核心就有機會還原原始網域,並依網域規則處理。這不代表遠端服務真的位於合成位址,也不代表建立連線時可以完全省略實際解析。使用直連或需要真實位址的出站時,仍須在適當的層級解析真實目標。
FakeDNS 需要查詢與後續連線形成完整流程。應用程式若使用自帶解析器,從系統以外取得真實位址,合成解析流程可能根本沒有發生;即使應用程式取得合成位址,後續連線若繞過用戶端,也無法使用映射。後者常見的情況是解析工具有回覆,但應用程式無法連線。啟用前,應先在一般 TUN 與一般 DNS 設定下建立可重現的基準,確認目標應用程式會將查詢送到預期的解析入口,也會將後續 IP 連線交給同一個負責還原映射的核心。
範圍、映射池與排除對象
以下是 Xray 頂層 fakedns 欄位的精簡對照範例,展示位址池與容量的設定方式。它只定義位址池,不會單獨啟用合成解析。完整流程還需要讓核心 DNS 對指定查詢使用 FakeDNS,並在接收連線的入口設定支援還原網域的嗅探。如果圖形用戶端已經產生相關設定,請優先檢查現有設定,不要在同一入口再疊加另一組位址池。實際介面選項取決於用戶端和所選核心。
{
"fakedns": [
{
"ipPool": "198.18.0.0/15",
"poolSize": 4096
}
]
}
位址池範圍必須與本機網段、實驗網路及其他虛擬介面的用途區分。範例範圍只供參考,不代表在每台裝置上都不會衝突。容量也不是越大越好:應用程式使用合成答案期間,必須仍能找回映射;頻繁查詢網域和應用程式快取長時間保留,都會增加對應錯誤或映射失效的風險。先在用途明確的一組網域上驗證,再逐步擴大範圍。需要真實位址來進行本機探索、企業登入或裝置管理的應用程式,應優先保留原本的解析路徑,不要在初次測試時一併納入內部服務。
依症狀找出缺少的環節
看不到合成回覆時,先確認應用程式是否使用自帶解析器或快取,再確認查詢實際進入哪個 DNS 入口。取得合成回覆後,若路由記錄中看不到原始網域,請核對應用程式的連線是否進入正確介面、入口是否啟用相應的還原功能,以及應用程式使用的位址是否仍有有效映射。如果已看到正確網域和出站標籤但仍無法連線,應改查出站本身與目標真實位址的解析,不要反覆調整位址池容量。
不要用瀏覽器開啟合成 IP 來驗證網站身分。直接存取 IP 會改變請求內容,也可能不會帶上應用程式原本應使用的主機名稱。請讓應用程式依原始網域建立新連線,再核對記錄中還原的網域及符合的出站。測試結束並關閉 FakeDNS 時,先恢復原本的 DNS 選擇,再結束仍保留合成答案的測試工作階段;必要時依應用程式和系統的正常方式清除快取。如果用戶端剛重新啟動,但應用程式重用了舊的合成答案,也應重新查詢,不要期待新程序必然沿用先前的映射。
多組訂閱管理
分開管理來源、更新與日常切換
持有多份訂閱時,每個來源各自使用一個分組。分組備註可以標示用途,例如日常使用、短期測試或保留舊設定。不要把供應來源、目前線路品質和協定類別全塞進同一個名稱:來源相對穩定,線路狀態會隨時間變化,協定也可能隨上游更新而改變。分組備註只需回答「這批記錄來自哪裡、為什麼保留」。伺服器備註則用來辨識組內項目,兩層名稱不必重複堆疊。
首次新增來源時,先手動更新目前分組。查看是否收到可解析的清單、項目是否符合預期,以及常用協定是否與所選核心相容,再決定是否啟用自動更新。桌面端使用 v2rayN;Android 上的 v2rayNG 與 v2flyNG 不應只憑介面相似度選擇。訂閱中的協定、傳輸設定和核心支援需要一併核對;可參閱Xray 與 V2Fly 核心差異。成功顯示一筆記錄,只代表用戶端辨識到足夠資訊,不代表執行時一定支援這組參數。
為更新保留故障處理空間
自動更新適合來源穩定且手動更新已驗證的訂閱。設定間隔時,優先考量來源允許的頻率和實際變更節奏,不必為了探測伺服器狀態而頻繁重新整理。盡量分開更新不同來源,方便將錯誤對應到特定分組。更新訂閱所使用的網路請求,與透過訂閱中的伺服器建立 Proxy 連線並非同一個流程。更新失敗時,現有連線可能仍正常;清單剛更新成功時,新伺服器也可能尚未驗證。這兩種狀態應分開記錄。
如果介面提供不同的更新路徑,先使用目前已知可連線的方式測試目標來源。透過目前 Proxy 更新時,要考慮 Proxy 失效後是否仍有獨立的復原路徑;改用直連更新前,也要確認來源允許從該網路直接存取。不要因某一份訂閱更新失敗就清空所有分組。先保留目前可用的項目,確認問題發生在請求、回應解析還是匯入階段,再決定是否只暫停該分組的自動更新。
處理內容變更、重複項目與連結輪替
上游更新會新增或移除項目,也可能更名或更換參數。同名項目不一定重複,不同名稱也不一定代表兩條獨立線路。整理前至少核對協定、位址、連接埠與傳輸方式,也不要將憑證複製到公開記錄中。不確定更新是覆寫還是合併時,先對一個分組手動更新一次,比較使用中的伺服器、新增項目和消失項目。重要線路消失時,不必立刻修改整份路由:先選擇已驗證的備用來源恢復連線,再單獨檢查原分組的變化。
訂閱網址更換時,若情況允許,可將新網址放進獨立分組進行短期驗證:先更新、檢查協定相容性,再完成一次實際應用程式請求。確認可以接替後,再停用舊分組的更新,最後視需要移除舊項目。若來源不支援兩個網址並存,請先記下分組名稱、篩選條件和選取的伺服器,並保留另一條已驗證的連線路徑,再更換網址。訂閱連結通常包含帳戶憑證,分享排錯資訊時只提供分組備註、失敗階段和已清除敏感資訊的錯誤訊息,不要貼出原始網址或完整匯出內容。
更換裝置時也應遵循相同原則。先遷移必要的一份來源,確認用戶端和目前網路都能使用,再遷移篩選與自動更新設定。不同裝置的使用中伺服器、系統 Proxy 狀態和本機介面都不相同,不能只靠匯入清單就重現整套執行環境。整理完成後,留下一份不含連線機密的維護記錄:來源用途、更新方式、測試目標,以及最近一次成功處理的故障。
自訂出站
先定義用途,再選擇設定入口
出站描述核心如何處理已接收的連線。它可以透過系統網路直接連線、使用指定的 Proxy 協定轉送,或明確拒絕連線;路由規則則透過 outboundTag 引用對應出站。伺服器記錄是用戶端管理連線參數的方式,出站則是執行設定中的處理對象,兩者不一定一一對應。自訂出站適合需要穩定引用多種處理路徑的情境。如果只是暫時切換目前使用的伺服器,主視窗中的使用中伺服器與路由集通常就已足夠。
先確認 v2rayN 介面允許編輯哪些設定,以及目前執行的是用戶端產生的設定,還是自行維護的完整設定。直接修改執行時產生的檔案,下一次儲存、切換伺服器或重新啟動時可能會被覆寫。如果透過自訂設定入口維護完整檔案,就必須一併處理入口、DNS、路由和出站之間的關聯;不要預期圖形介面的每項設定都會自動合併。開始前先保留一份可正常啟動的設定,記下本機監聽連接埠和目前路由集,方便確認復原後應用程式重新連上正確入口。
使用明確標籤組合出站與路由
以下是 Xray 的頂層設定片段,定義兩種行為不同的出站。direct 使用 freedom 直連,blocked 使用 blackhole 拒絕連線。這不是包含入口的完整設定,也不含 Proxy 伺服器。合併時保留現有出站,並在同一個陣列中新增所需物件;如果已有相同名稱的標籤,請沿用或明確更名,不要直接貼上重複項目。供引用的標籤必須與路由規則中的字串完全一致。
{
"outbounds": [
{
"tag": "direct",
"protocol": "freedom",
"settings": {}
},
{
"tag": "blocked",
"protocol": "blackhole",
"settings": {}
}
]
}
只有規則符合 blocked 時,該分支才會依預期拒絕連線。準備測試時,選一個允許中斷的目標,為它設定明確規則並放在一般預設規則之前,再建立新連線進行對照。不要拿作業系統的連線狀態檢查目標測試封鎖,否則系統狀態指示可能與實際連線狀況不一致。沒有明確預設規則的設定,也要檢查出站陣列中的第一個項目是什麼;變更陣列順序可能會將原本不符合任何規則的流量導向其他出站,即使規則文字完全沒改。
檢查啟動、規則符合與實際連線
依三個階段蒐集證據。第一階段是核心接受設定:檢查結構能否解析、協定是否受目前核心支援,以及標籤引用與本機監聽參數是否一致。第二階段是請求是否走到正確出站:用兩個目標測試,一個符合新增分支,另一個仍走原有分支。第三階段是出站能否完成任務:直連分支要檢查目前網路是否可達;Proxy 分支則另外檢查伺服器解析與連線;拒絕分支則確認影響範圍僅限測試目標。成功啟動不代表路由正確,符合標籤也不代表遠端連線正常。
新增實際 Proxy 出站時,不要只從其他核心的設定中複製協定名稱就直接使用。還要依目前核心的設定格式核對傳輸與安全設定、伺服器位址的解析路徑,以及支援的傳輸類型。發生逾時時,先改用手邊已驗證的出站,在相同條件下比較;若只有新出站失敗,請繼續排查該分支,不要改動系統 DNS 或擴大 TUN 接管範圍。每輪變更後都使用新工作階段驗證,避免應用程式重用舊連線造成誤判。
測試完成後,依用途分開歸檔設定:可復原的完整設定放在受保護的位置;可供交流的排錯記錄只保留規則順序、欄位名稱和已去識別化的錯誤資訊。簡短記下變更原因,例如「將內部測試網域移到直連例外前」,比保留一串用途不明的測試設定更有用。標籤和規則的概念可查閱術語表;如果基本入口也不穩定,請先還原設定,再回到快速入門的連線驗證流程。