使用手冊 · 從安裝到疑難排解

V2Ray 使用手冊

只想完成首次連線,請先依照快速入門教學的步驟操作;若要了解設定的作用、調整流量接管範圍或排查問題,再回到本手冊按章節查閱。首次設定建議依序閱讀;已有可用設定時,則可直接查看需要確認的環節。

核心概念:應用程式、用戶端與核心

依請求經過的流程理解設定

先釐清請求路徑,再熟悉介面選項。應用程式發出請求後,可能自行連線,也可能將請求交由本機代理入口處理。在桌面系統上,這個入口通常由核心監聽於迴圈位址;在 Android 上,用戶端也能透過系統提供的 VPN 介面接收流量。請求進入核心後,核心會依路由設定選擇出口,可能直接連線至目標,也可能先連上所選的代理伺服器。應用程式只能看到最終結果,光憑逾時訊息無法判斷中間哪個環節發生問題。

圖形用戶端負責管理節點、接收訂閱、產生或載入設定,以及啟動和停止核心。核心則負責監聽、路由與轉送。視窗和系統匣圖示仍在,不代表核心正在運作;選取節點,也不代表瀏覽器已將流量送到核心。排查時請拆成三個問題:核心是否成功啟動、應用程式是否使用預期的入口,以及請求進入後是否到達預期出口。每個問題都應以個別證據確認,不要用同一則連線狀態提示代替所有判斷。

區分通訊協定、傳輸方式與安全層

節點設定中的通訊協定,決定用戶端與伺服器如何交換代理請求。傳輸方式決定這些資料透過何種連線傳送;安全層則依雙方設定保護連線並驗證身分。這些並非同一欄位的不同名稱。例如,兩筆同為 VLESS 的設定可能採用不同的傳輸方式或安全參數,因此不能只看通訊協定名稱就認定設定可以互換。換了用戶端後,節點仍能顯示,也不代表對應的核心支援該筆設定中的所有參數。

比對節點時,先確認伺服器位址、連接埠和通訊協定,再檢查傳輸方式、安全層及其相關欄位。連線已建立但交握失敗,與網域尚未解析或連線尚未建立,是不同階段的問題。不要為了讓錯誤消失而關閉安全驗證;若伺服器名稱、憑證或裝置時間不符,應修正對應設定。遇到不熟悉的欄位,可先查閱概念速查,再依服務提供者給的設定核對,不要從其他節點拼湊參數。

分開檢查訂閱更新與實際連線

訂閱是向設定來源取得節點資料的方式,並不是代理通訊協定。更新成功只表示用戶端已取得並處理內容,不能證明其中每筆資料都能連線。反過來說,即使現有節點仍可使用,訂閱服務也可能暫時無法連線。兩者通常使用不同位址;排查時先確認失敗的是更新請求,還是某個應用程式的連線請求,不要遇到任何逾時都改換訂閱。

網域解析也可能發生不只一次。用戶端連線到代理伺服器前,可能需要解析伺服器網域;應用程式要連線的網站網域,則可能由應用程式、作業系統或核心處理。即使使用數字位址可以連線,也不能據此認定所有網域都正常;網站服務通常仍需要正確的主機名稱。測試時請明確記錄發生錯誤的對象:是訂閱網域、代理伺服器網域,還是正在連線的目標網域。如此才能判斷要查看哪一段記錄。

用戶端選擇:系統、架構與核心

桌面版優先選擇 v2rayN

先確認實際執行用戶端的作業系統與處理器架構,再前往用戶端下載頁選擇安裝包。如果用戶端是在虛擬機器中執行,請以客體系統顯示的作業系統與架構為準,而非主機型號。如果是工作用裝置,也應先確認是否允許安裝用戶端、修改系統代理或建立虛擬網路介面。能下載檔案不代表有安裝權限,也不代表之後可以啟用 TUN。

平台用戶端選擇依據
Windowsv2rayN依下載頁的要求確認 x64 與執行環境,再選擇桌面版或 WPF 版。
macOSv2rayN依 Apple Silicon 或 Intel 處理器選擇對應的磁碟映像檔。
Android優先選擇 v2rayNG,v2flyNG 為備選先依核心需求選擇應用程式,再依系統支援的應用程式架構選擇 arm64 或通用版。
Linuxv2rayN確認發行版的套件格式與架構,再選擇 deb 或 rpm。

Windows 桌面版採用跨平台介面框架,WPF 版則使用傳統 Windows 介面框架。初次安裝可先使用桌面版;若要維護既有的 WPF 環境,建議優先考量原有操作習慣、設定路徑與執行階段需求。兩者的差異不能用來判斷連線速度。比較時應使用相同節點、網路與請求方式,並確認沒有兩個執行個體同時占用本機入口。介面、系統匣與套件名稱的差異,請參閱桌面版與 WPF 版選擇說明。

macOS 可在系統的裝置資訊中查看晶片或處理器項目。若標示為 Apple 晶片,請選擇對應的原生套件;若顯示 Intel 處理器,則使用 x64 套件。Linux 則須分別判斷套件管理系統與硬體架構:例如 Debian 或 Ubuntu 系統通常選 deb,Fedora 系統通常選 rpm;終端機顯示的 x86_64 與 aarch64,分別對應下載頁上的 x64 與 arm64。套件格式相符不代表相依項目一定符合需求,安裝前仍須確認發行版的支援範圍。

Android 先依核心選擇應用程式,再選擇架構套件

Android 預設可先使用採用 Xray 核心的 v2rayNG;若設定來源明確要求 V2Fly 核心,再考慮 v2flyNG。先確認對方提供的是一般節點資料、訂閱內容,還是指定核心才能讀取的完整設定。一般節點資料通常會由介面轉換為核心設定;完整設定則可能直接使用特定核心專屬欄位。名稱相近不代表相容,尤其不要假設換用其他用戶端後,自訂參數也能原樣移轉。

Android 安裝包的架構須符合系統支援的應用程式架構,不能只看處理器規格是否標示 64 位元。確認系統支援 arm64 應用程式後,再選擇對應套件;若不確定,請先查閱裝置資訊,再考慮下載頁提供的通用版。通用版也有系統需求,並非適用於所有裝置。如果系統提示應用程式與裝置不相容,應檢查系統版本與支援的應用程式架構,而非一再下載同一個檔案重試。

從舊裝置移轉時,先記錄使用的核心、訂閱群組與自訂路由,並透過應用程式支援的匯出方式備份設定。在新裝置上先還原一個群組,確認單筆節點正常後,再逐項還原其他設定。舊裝置的本機連接埠、啟動路徑和系統代理狀態都屬於特定環境,不宜整套複製。若是在同一台裝置上更換版本,先結束舊執行個體,保留一份可還原的設定,再確認新版本能否獨立啟動。

安裝與首次啟動:先確認核心正常運作

在桌面系統完成安裝

先依下載卡片與系統提示完成安裝,暫時不要匯入整套設定。Windows 若下載的是安裝程式,就讓安裝程式將檔案寫入目標目錄;若下載的是封存檔,請先完整解壓縮,不要直接從壓縮檔預覽視窗啟動。所需執行階段依所選版本的要求與實際錯誤訊息判斷。若提示缺少桌面執行階段,請分辨桌面執行階段與一般執行階段,並確認架構相符。重複點擊程式並不會補齊相依項目。

首次啟動時請使用一般使用者權限。若是解壓縮後執行的版本,請選擇目前使用者可管理、且不會被同步服務反覆修改的目錄。如果應用程式能開啟視窗但無法儲存設定,先檢查設定目錄的寫入權限,不要直接將整個用戶端永久設為以系統管理員身分執行。升級後若發生閃退,請先保留錯誤訊息與舊設定,再依啟動閃退排查分辨執行階段、目錄權限與設定解析問題。

macOS 開啟對應的磁碟映像檔,依映像檔中的說明放置應用程式,再從實際安裝位置啟動,不要將掛載中的映像檔當成長期執行目錄。若系統提示架構不符、檔案損毀或應用程式受到裝置政策限制,請先記下完整訊息,再依原因處理。工作裝置請依核准流程操作;不要為了啟動單一程式而關閉整體系統防護。應用程式結束後若仍有代理異常,請另外檢查系統網路設定,不要重複複製應用程式嘗試修復。

Linux 建議使用發行版的套件管理工具安裝相符的軟體套件,並參考工具回報的相依項目與衝突。安裝完成後,從桌面應用程式選單啟動,或在目前的桌面工作階段中排查啟動錯誤。命令列程式能執行,不代表圖形環境一定能正確顯示視窗和系統匣;同樣地,沒有系統匣圖示也不能據此判定程序未執行。如果程式開啟後沒有視窗,請先檢查程序、應用程式記錄與桌面工作階段狀態,避免多次啟動而留下多個執行個體。

分別處理 Android 安裝與網路授權

從下載頁取得適用的 Android 安裝包,再透過系統安裝介面開啟。若目前來源需要安裝授權,請依裝置規則只授權實際使用的來源。更新安裝失敗時,先閱讀系統提示:架構或系統版本不符合需求,與現有應用程式不允許覆蓋安裝,是不同問題。若必須先解除安裝舊版,請先備份可還原的訂閱與必要設定,否則解除安裝通常會刪除應用程式儲存的資料。

安裝完成後,先確認清單能正常開啟、設定也能儲存。首次連線時若出現系統 VPN 授權對話框,表示用戶端正在請求系統將相關流量交由它處理,不代表訂閱已更新或遠端已可連線。如果裝置已有啟用中的 VPN,請確認切換是否會影響工作連線;系統管理的連線則不要自行停用。開啟連線後,使用實際應用程式驗證,並在測試結束後確認能正常中斷連線。

設定首次啟動的驗收條件

先確認介面可正常使用、設定能儲存、程序能正常結束。桌面端匯入一筆支援的設定後,再確認核心已啟動,並在預期位址和連接埠監聽;即使看到連接埠正在使用,也要透過系統程序資訊確認是哪個程序占用。Android 則須確認已取得系統授權,且連線狀態與應用程式設定一致。完成這些檢查前,不要批次匯入群組、啟用開機自動啟動或同時變更多個網路選項,以免單純的安裝問題變成難以重現的啟動順序問題。

匯入訂閱:群組、更新與驗證

確認取得的是哪一種設定

訂閱網址用來取得一組節點;單筆分享連結描述一個節點;完整設定檔則可能包含入站、出站、解析與路由。這三種內容都可能以文字提供,但不能放進同一個輸入欄位。請先查看設定來源對格式與支援核心的說明,再決定使用訂閱管理、從剪貼簿匯入節點,或使用應用程式支援的設定匯入功能。瀏覽器能開啟某個網址,不代表該網址就是訂閱,也可能只是帳戶頁面。

訂閱網址通常含有存取憑證,請像保護帳戶資訊一樣妥善保管。不要將實際網址貼到公開討論區、線上格式轉換頁面或共用截圖中。複製前請確認沒有混入多餘空格、換行或說明文字,尤其不要任意刪改查詢參數。整理問題時只需記錄錯誤類型與發生時間;範例可用 https://example.com/sub?token=xxxx 表示網址結構,但不能將範例當成可更新的訂閱。

先手動更新一個群組

在 v2rayN 中開啟訂閱群組設定並新增群組,輸入容易辨識用途的別名,再將完整訂閱網址填入網址欄。儲存後,手動更新該群組。別名只供介面辨識,不會決定要連線到哪台伺服器。更新完成後切換至該群組,確認匯入內容合理,再選一筆支援的設定進行測試。新增第二個來源時請另建群組,避免不小心將已知可用的網址改成另一筆訂閱。

在 v2rayNG 或 v2flyNG 中開啟訂閱群組管理,新增名稱和網址並儲存,再返回清單執行更新。不同版本的選單名稱可能略有差異,操作重點是先儲存來源,再取得內容,最後選擇要使用的設定。管理訂閱與啟動連線是兩回事:清單中出現節點不代表系統 VPN 已啟動;反之,VPN 顯示已連線,也不代表剛才的更新已套用到目前選取的設定。

首次更新成功後,再設定自動更新。更新間隔應配合來源的更新說明與裝置使用習慣,不是越短越好。除錯期間可先關閉該群組的自動更新,或避開更新時段,以免測試到一半時節點資料遭到替換。有些用戶端會依新的訂閱內容重建群組,手動修改的資料可能被覆蓋;需要長期保留的測試資料可另放在手動群組,並記錄它與訂閱資料的差異。

依失敗階段採取不同處理方式

若記錄顯示名稱解析或連線失敗,先確認目前網路能否連到訂閱端點,並核對應用程式是否支援選擇更新請求的連線路徑。不要讓更新請求固定依賴尚未驗證的出口,否則節點失效時,更新也可能同時失敗。若伺服器要求驗證或拒絕存取,請先確認網址是否已過期、帳戶是否仍有權限,不要靠頻繁重試解決。若伺服器有回應,但用戶端沒有匯入任何資料,請檢查回應格式、用戶端對該通訊協定的支援,以及回傳內容是否其實是登入頁面。

匯入後先測試一個明確可用的目標,並保持其他變數不變。節點測試結果只能說明測試方法涵蓋的環節,不能取代對特定應用程式請求的驗證。若只有某筆資料失敗,請與同一群組中的其他資料比較;若整個群組都失敗,再檢查核心是否啟動、本機入口是否正確,以及網路是否有變化。需要依介面完整操作一次,可返回快速入門的訂閱匯入步驟;若跨群組仍無法連線,請接著參閱連線疑難排解。

代理模式:本機連接埠與系統代理

以最小範圍驗證本機入口

桌面端首次測試時,建議先讓單一應用程式明確連線至本機代理。開啟參數設定,查看實際的監聽位址、連接埠與類型。HTTP 代理連接埠與 SOCKS 連接埠可能分開設定,也可能由混合監聽連接埠提供;不能只憑數字判斷類型。若只供本機使用,建議維持迴圈位址監聽,不要為了修正本機設定錯誤而開放區域網路存取。迴圈位址的流量不會因為選取了某個遠端節點,就自動從其他裝置進入。

以下範例適用於支援這些參數的 curl。先確認 v2rayN 的本機 HTTP 或混合監聽確實使用範例連接埠,否則請改用設定中顯示的數值。在 Windows PowerShell 中可明確呼叫 curl.exe。此範例會向公開的示範網域發出一次請求,不會持續修改系統設定;若該網域在目前網路無法使用,請改用已確認允許存取的測試目標。

curl --noproxy "" --proxy http://127.0.0.1:10809 --max-time 15 -I https://example.com/

這裡的明確代理參數只會套用於目前命令;空白的排除清單則可避免既有代理排除項目讓目標直接連線。若連線本機連接埠時遭到拒絕,先確認是否正在監聽,以及位址家族是否相符,例如只監聽 IPv4 迴圈位址,卻連線到另一個位址。若本機代理回傳錯誤,請查看連線目標或遠端記錄。收到目標回應,表示這次請求經過已設定的本機入口;但核心最終選擇直連或代理,仍須核對路由結果。

了解系統代理實際涵蓋的範圍

設定系統代理,是告知遵循系統設定的應用程式使用指定的代理入口,並不會讓作業系統接管每個封包。瀏覽器通常會讀取系統設定,但設定檔、瀏覽器擴充功能或裝置政策也可能改變實際行為。終端機程式是否讀取系統設定和環境變數,取決於程式本身的實作;即使兩個命令都能連上同一個網站,也不能假設它們使用相同代理。瀏覽器與命令列結果不一致時,請分別檢查各自生效的設定。

有些系統或用戶端提供自動設定指令碼,可在應用程式支援的前提下,決定個別請求要送往本機代理,或由應用程式直接連線。這與核心路由是兩個判斷階段:應用程式若沒有把請求交給核心,核心的分流規則就無從比對。排查時先用前述明確代理方式驗證本機入口,再還原系統代理的實際用法;如果明確入口有效、系統代理無效,應先檢查系統或應用程式層,不要急著修改節點。

分別確認關閉代理與結束程式

測試完成後,先在用戶端執行清除或還原系統代理的操作,再視需要結束程式。若原本就有工作用代理,請還原原有位址、連接埠與自動設定方式,不要把關閉所有代理當成通用的還原方法。受管理的裝置可能只有系統政策允許修改這些設定。關閉後,請在原本依賴系統代理的應用程式中重新測試;必要時重新啟動應用程式,避免沿用先前已建立的請求工作階段。

Android 通常透過系統 VPN 與應用程式範圍設定接管流量,不應直接套用桌面系統代理的步驟。測試 Android 應用程式時,先確認它是否在接管範圍內,再確認用戶端是否已取得系統授權。桌面端若只有終端機命令異常,請參閱分別排查瀏覽器與終端機的方法;若核心記錄顯示監聽連接埠遭占用,請檢查衝突程序,而不是修改不同應用程式的代理通訊協定來掩蓋啟動失敗。

路由分流:比對條件、順序與預設出口

先確認三種實際結果

分流只會處理已進入核心的請求。開始設定前,先列出三種預期結果:哪些目標要直接連線、哪些目標要經由所選代理傳送,以及哪些目標應由規則封鎖。接著為未符合任何明確規則的請求設定預設出口。預設出口也是設定的一部分,不應靠猜測判斷。如果介面沒有獨立的預設選項,就要依該核心的運作方式,檢查產生設定中的出口順序與規則指向。

預設路由模式可作為起點,但模式名稱不會列出實際比對內容。啟用預設模式後,請查看規則清單,確認它依據網域、目標位址還是分類資料判斷,並記錄最後的處理方式。地區或網站分類資料集可能更新,測試結果也會隨解析結果改變。建立可用的基準後再新增自訂規則;不要一次更換分類資料、解析策略與預設出口,否則即使結果改善,也難以判斷是哪項調整發揮作用。

網域規則與位址規則各有適用範圍

網域條件適合描述特定名稱的目標;位址範圍條件適合描述明確的網路範圍。網域規則能否比對,取決於核心判斷時是否取得目標名稱。如果應用程式已自行解析,只交出數字位址,網域資訊可能無法使用;如果規則需要目標位址,而核心目前只知道網域,則還要看路由解析策略。不要把這兩種狀況都歸咎於分類資料庫失效。

以 Xray 的欄位規則為例,規則會依序檢查,由第一條符合的規則決定出口。通常應將明確的例外規則放在範圍較廣的規則之前。如果同一條欄位規則同時設定網域和位址條件,應依該核心對組合條件的定義理解;若要表達「符合網域或位址就直連」,拆成兩條指向同一出口的規則會更清楚。以下範例是可用於 Xray 設定的 routing 物件,不是完整設定,也不是用戶端訂閱內容。使用前請確認 direct 是已定義的直連出口標籤。

{
  "domainStrategy": "AsIs",
  "rules": [
    {
      "type": "field",
      "domain": ["full:example.com"],
      "outboundTag": "direct"
    },
    {
      "type": "field",
      "ip": ["192.168.50.0/24"],
      "outboundTag": "direct"
    }
  ]
}

第一條只會比對完整名稱 example.com,不包含其子網域;第二條比對的是示範網段,不能取代對實際區域網路範圍的確認。AsIs 不會為了這個階段的位址規則主動將網域解析成位址,因此不要預期以網域傳入的請求只因最終解析至該網段,就符合第二條規則。未符合規則的請求會依其他規則或核心預設出口處理。平時建議優先使用用戶端的規則編輯器輸入等效條件,避免手動修改介面之後會重新產生的檔案。

同時驗證符合與未符合規則的情況

每新增一條規則,至少測試兩類目標:應符合規則的正例,以及相似但應交由後續規則處理的反例。針對完整網域名稱的例外,可測試該名稱與其子網域;針對位址範圍,則可測試範圍內位址與相鄰範圍。命令執行成功只表示目標可連線,不代表流量經過預期出口,應搭配核心現有的路由或出口記錄確認。若沒有詳細記錄,可短暫啟用診斷記錄,測試後再恢復原本層級。

網頁通常會同時請求資源網域、登入服務與介面位址。主頁正常但部分內容載入失敗時,先找出失敗請求的目標,再決定是否需要新增規則,不要將所有出口統一切換來掩蓋差異。新增規則後若區域網路資源、共用服務或裝置管理頁面受到影響,請先還原原有規則,再檢查新增條件是否過於寬泛,或是否遭到更前面的規則攔截。保留每條規則的用途與驗證方式,日後整理時才能判斷哪些項目可以刪除。

TUN 模式:接管範圍、權限與 DNS

有明確需求時再啟用

TUN 適用於需要接管不讀取系統代理之應用程式的情況。桌面用戶端啟動相關核心功能後,系統會透過虛擬網路介面與路由,將符合條件的流量送入處理流程。接管範圍較廣,不代表所有請求都會送往同一個代理出口,也不代表每個介面和每種流量都已涵蓋。哪些流量會被接管取決於系統路由與用戶端設定;接管後如何傳送,則仍由核心路由決定。

啟用前先確認一般本機代理入口與節點運作正常,並記下裝置原有的系統代理、網路介面狀態與常用區域網路服務。明確指定這次要讓哪個應用程式進入 TUN,並準備一項只針對該應用程式的測試。如果目前裝置依賴遠端工作階段或受管理的 VPN,請勿在沒有還原方法時更改接管方式。路由變更可能影響維持該工作階段的連線,即使使用者介面沒有顯示異常也一樣。

桌面版啟用步驟與常見衝突

在 v2rayN 中找到啟用 Tun 的選項或相關設定,確認目前版本與核心符合該功能的需求,再依作業系統提示授予必要權限。Windows、macOS 與 Linux 的授權和介面建立方式各不相同。若提示權限不足,請確認是啟動輔助元件失敗、無法建立虛擬介面,還是無法調整路由;只有裝置規範允許且版本確實需要時才授權。不要為了處理單一介面的權限問題,而讓所有應用程式都以高權限執行。

第一次測試時,盡量只保留一條容易判斷的接管路徑。若已設定系統代理,記錄原值後可暫時還原,再使用目標應用程式確認 TUN 是否確實接收到流量。否則即使 TUN 沒有生效,應用程式仍可能主動連線至本機代理而正常連線。先檢查虛擬介面與用戶端狀態,再測試一般網域、目標應用程式與需要保留的本機服務。每次只新增一種條件,例如確認基本功能正常後,再調整區域網路例外。

啟用後若所有連線突然逾時,先關閉 TUN,確認是否恢復到基準狀態。可能原因包括介面未正確建立、系統路由未依預期安裝,或核心與代理伺服器之間的連線又被導回自身的接管路徑。請查看記錄中的失敗環節,以及用戶端是否提供適用於目前網路的自動介面選擇或出口排除設定;不要憑猜測手動刪除系統預設路由。更多介面說明請參閱v2rayN TUN 模式設定。

區分 DNS 問題與目標連線問題

若數字位址可以連線,但一般網域普遍失敗,應優先檢查解析路徑,並使用適合直接以位址連線的目標進行對照。直接將網頁網址換成數字位址通常不是可靠的測試方式,因為憑證和網站選擇都依賴名稱。請檢查核心能否解析代理伺服器網域、一般應用程式的查詢是否進入預期處理流程,以及解析結果是否符合區域網路與外部目標的需求。

有些應用程式會自行採用加密解析,作業系統取得的解析結果未必與應用程式相同;工作網路中的內部名稱也可能必須交由指定的解析服務處理。不要一看到網域逾時,就同時更換本機、核心與應用程式的解析設定。先確認失敗的是哪一類名稱,再檢查查詢是否有回應、回傳位址是否落在預期範圍,以及應用程式接著連線到哪裡。修改前先保留原設定,若出現問題便依相反順序還原。

Android 的 VPN 授權與桌面 TUN 選單是不同操作。Android 端請先確認 VPN 是否正在運作,再檢查應用程式範圍、系統常駐 VPN 設定及既有連線衝突。測試結束後,依用戶端操作停止接管,並確認目標應用程式在原有網路下恢復預期行為。關閉後若仍有異常,請檢查系統網路設定與用戶端記錄,勿反覆切換開關碰運氣。

日常維護:更新、備份與問題排查

分開處理三種更新

用戶端升級會改變介面、設定讀寫方式或套件內容;核心升級會改變通訊協定、解析與路由行為;訂閱更新則會變更節點資料。除非安裝包本身會同時更新用戶端與核心,排查期間應盡量避免在同一輪主動變更多個層面。更新前記錄執行環境、使用的核心、目前有效的入口與一項測試結果。更新後先重新測試這個基準,再啟用其他選項,以免忽略相容性回歸。

備份時優先保留可重新匯入的設定、路由規則與必要使用紀錄,不要將整個執行目錄複製到公開同步位置。備份可能包含訂閱憑證、伺服器位址及完整連線參數,應存放在受控目錄。完成備份後,記錄還原方式與適用的用戶端;若尚未測試過還原,至少確認匯出內容可讀取且必要資訊完整,並在不影響日常連線的情況下測試還原單一群組。

跨用戶端或跨平台移轉時,請區分可重複使用的設定與本機狀態。節點群組或規則意圖可依支援格式移轉;工作目錄、監聽位址、系統代理狀態與虛擬介面選擇則須針對新裝置重新確認。升級失敗後,不要將新舊設定混在同一個目錄中反覆嘗試。請結束程序、保留故障副本,再於獨立且可寫入的位置還原已知可用的設定,並比較最小差異。

依本機到目標的順序檢查

先確認問題範圍:是所有裝置還是單一裝置、所有應用程式還是單一應用程式、所有目標還是特定類型的名稱。接著確認用戶端是否啟動、核心是否正在監聽,以及應用程式是否指向相同入口。以上條件都成立後,再檢查節點參數、網域解析與路由。若更換網路後才出現問題,請使用相同設定比較兩種網路;若更換節點後才出現問題,請保留相同目標進行對照。

在 Windows 上,可用 PowerShell 查看範例本機連接埠是否正在監聽,以及占用它的程序編號。請將連接埠號碼換成參數設定中的實際值。若使用其他系統,請參閱本機連接埠占用排查,依平台查詢。若查不到監聽結果,請回頭查看核心啟動記錄;若查到監聽,則先確認程序歸屬,不要只憑連接埠號碼認定那就是 v2rayN。

Get-NetTCPConnection -State Listen -LocalPort 10809 |
  Select-Object LocalAddress, LocalPort, OwningProcess

若占用來自舊的用戶端執行個體,建議透過原應用程式正常結束。若占用者是其他必要程式,請保留該程式並為用戶端選擇可用的連接埠,接著同步修改所有明確引用舊連接埠的瀏覽器、終端機或應用程式設定。不要只在用戶端單方面更改連接埠;完成修改後,確認新連接埠正在監聽,並重新執行最初失敗的請求。與連接埠無關的驗證或交涉錯誤,應回頭檢查相關通訊協定欄位,不要一直查本機連接埠。

保留精簡但足夠的診斷資訊

記錄平台、用戶端名稱、使用的核心、測試時間與時區、故障前最後一次變更、錯誤發生階段,以及可重現問題的最短步驟。分享記錄前,請移除訂閱網址、驗證欄位、帳戶資訊、內部網域與不必要的完整存取路徑;保留錯誤類型及事件先後順序。短暫提高記錄層級,只為收集一次重現所需的證據,完成後恢復日常設定。若問題無法立即重現,先觀察發生條件,不要連續重新安裝或重設整個系統網路。

進階路線:可重現的設定與變更還原

先建立精簡的驗證矩陣

穩定運作後再擴充設定。先為常用情境列出入口、目標與預期結果,例如瀏覽器使用系統代理、指定的終端機命令使用本機入口、區域網路管理頁面依既定路徑連線,以及不讀取系統代理的應用程式只在啟用 TUN 時進入接管範圍。每項測試都要寫明預期結果,不要只寫「能開啟」。同一個目標透過不同入口都可能開啟,但實際使用的出口可能不同。

將測試分成基本檢查與情境檢查。基本檢查用來確認核心啟動、連接埠監聽、單一目標連線與正常結束;情境檢查則驗證訂閱可更新、路由例外正確、DNS 在目標網路可用,以及切換接管方式後能否恢復。使用相同的一組目標比較變更前後,並記錄網路條件。偶發逾時不一定代表設定失敗,但應在相近條件下重測,以區分暫時波動與可穩定重現的問題。

有相容性需求時才更換核心

選擇核心應根據設定需求,而非名稱或介面觀感。桌面版 v2rayN 可選的核心與設定項目,取決於目前版本和節點類型;Android 在 v2rayNG 與 v2flyNG 之間選擇時,應確認來源要求的核心。切換前先儲存原設定,使用副本測試,不要覆蓋日常使用的群組。成功啟動後,先查看解析記錄,確認欄位未遭忽略或拒絕,再測試一個明確的連線目標。

同一筆節點分享連結可匯入多個應用程式,不代表自訂路由、DNS 策略或額外傳輸參數在各應用程式中的意義都相同。移轉規則前,先寫下設定意圖,例如「工作網域使用系統指定的解析路徑,其餘目標依原有條件選擇出口」,再以新核心支援的方式表達。不要只替換出口標籤就認定設定效果相同,尤其要檢查未符合規則的條件、網域解析時機,以及連線共用對測試的影響。

讓規則套用順序與還原步驟清楚可查

圖形用戶端產生的設定,通常會在啟動或儲存設定時重新建立。若需要使用自訂設定,先確認目前介面是否提供獨立的匯入功能,以及它如何與介面選項搭配。只修改暫時產生的檔案,下次啟動時可能就無法重現。持久設定應存放在明確位置,並記錄哪些值由介面管理、哪些來自匯入檔案;憑證則應與可分享的設定說明分開儲存。

每次變更都記錄原因、修改項目、預期結果與還原方式。調整路由時先新增一條例外,並用正反例驗證;調整 DNS 時,先比較一個公開名稱與一個必須保留的內部名稱;變更流量接管方式時,先確認關閉後可以恢復。準備兩種還原方式:一是只撤銷新修改的項目,二是在影響不明時還原一組已知可用的設定。兩種方式都應說明是否需要重新啟動程序、清除系統代理或還原原有的應用程式範圍。

下次遇到問題時,可依最近的變更直接返回相關章節:更新訂閱後清單異常,請從匯入訂閱檢查來源與群組;只有部分目標走錯出口,請從路由分流檢查條件與順序;新增流量接管後區域網路無法連線,則回頭檢查TUN的介面、例外與解析設定。忘記操作步驟時,可使用快速入門教學重新完成最基本的連線流程,再回來處理進階設定。設定是否適合日常使用,取決於能否說明請求經過的路徑,以及發生問題時能否還原至已驗證的狀態。