完整手冊 / 設定與疑難排解
V2Ray 用戶端完整手冊
從選擇用戶端、驗證第一條連線開始,再處理分流、TUN 與日常維護。每章先說明調整的層面,再提供檢查方式與還原步驟。
想先建立連線,請依照快速入門教學操作;需要了解欄位、比較不同平台的差異,或確認故障發生在哪個層面,再回到本手冊查閱相關章節。
一、核心概念:用戶端、核心與連線
介面負責儲存設定,核心負責處理流量
先將用戶端與核心分開理解。v2rayN、v2rayNG 和 v2flyNG 是用來編輯、匯入及啟停設定的圖形化用戶端。介面中的目前設定、訂閱群組與規則預設,最終都必須轉成核心可讀取的設定。核心負責監聽本機入口、解析規則並建立對外連線。清單中看得到一筆項目,只代表介面讀取到該項目;核心可能尚未啟動,也可能在載入時拒絕某個欄位。遇到「按了連線卻沒有反應」,先確認是否有啟動錯誤,再判斷該檢查應用程式入口還是遠端連線。
Project V 是理解 V2Ray 生態系的起點。V2Fly 延續 V2Ray 的社群開發,Xray-core 則沿著相同的技術脈絡發展,之後各自演進。兩者共用部分設定概念,但不保證所有欄位都能互通。桌面端可先使用 v2rayN,再依實際設定選擇它提供的核心;Android 端的兩款用戶端使用不同核心,相關差異會在下一章檢查。如果介面顯示匯入成功,啟動時卻回報傳輸或安全欄位不支援,先確認用戶端實際啟動的是哪個核心,不要只憑產品名稱推斷功能。
協定、傳輸與連線安全是不同項目
VMess、VLESS、Trojan 用來區分對外連線協定,各自有相應的參數與身分驗證方式。傳輸則說明資料如何送至對端,例如透過原始串流連線或 WebSocket。TLS 是其中一種連線安全方式;REALITY 是 Xray 可用於特定部署的連線安全機制,並非與 VLESS 同類的欄位。檢查一筆設定時,依序核對位址與連接埠、協定、傳輸方式及安全方式。不要只因為看到兩個熟悉的縮寫,就認定兩筆設定可以互換。
同一個網域名稱可能出現在不同欄位,作用也各不相同。伺服器位址用來找到要連線的對端;啟用 TLS 時,伺服器名稱可用於交握與憑證身分比對;應用程式要存取的目標網域,則可能是路由判斷依據。把目標網站的網域填入伺服器位址,或在名稱不符時隨意修改安全驗證,都無法解決欄位填錯的問題。遇到交握失敗,保留出錯欄位的類別與提示,並逐項比對可信來源提供的設定;不要只因為「看起來像網域」就自行替換。
先確認流量從哪裡進入、從哪裡出去
用戶端在本機開啟的監聽連接埠稱為入站;流量離開核心時,可能直接連線,也可能經由遠端轉送,這稱為出站。代理模式決定應用程式的請求能否進入用戶端,路由規則則決定進入後使用哪個出站。瀏覽器能開啟網頁,不一定代表流量經代理出站;核心日誌有啟動紀錄,也不表示瀏覽器使用了這個入站。排查時將應用程式、入口、符合的規則與出站分成四個步驟,逐一記錄觀察到的證據。這樣就不會為了修復未使用代理的應用程式,誤改原本能正常載入的遠端設定。
訂閱是發佈一組連線設定的方式,不是另一種協定,也不能證明遠端服務目前可用。更新訂閱只能確認「能否取得並讀入設定」,連線測試才能確認「目前的應用程式能否透過這筆設定完成請求」。從一開始就分開記錄這兩種結果:更新時使用的群組與時間、測試時使用的設定與應用程式,以及用戶端回報的第一則錯誤。之後遇到更換網路或更新軟體時,這些紀錄可協助區分偶發故障與實際變化,也方便在原因不明時先還原至可用狀態。
二、選擇用戶端:平台、架構與核心
桌面端先確認系統與套件類型
桌面端建議優先使用 v2rayN。先前往下載中心選擇作業系統,再依裝置的處理器架構與套件格式挑選。作業系統名稱只能決定要看哪個下載區,無法決定該區中的每個下載項目。例如,同樣是 macOS,Apple Silicon 與 Intel 就要使用不同安裝套件;同樣是 Linux,即使處理器架構正確,也不能混用為不同套件管理系統準備的安裝套件。如果系統顯示的資訊不明確,先記下系統設定中的原始文字再查詢,不要只依購買年份或應用程式商店中的裝置名稱判斷。
| 平台 | 用戶端 | 選擇套件的依據 |
|---|---|---|
| Windows | v2rayN | 下載區提供 x64 桌面版與經典 WPF 版,先確認系統類型,再選擇介面。 |
| macOS | v2rayN | 在「關於這台 Mac」中查看晶片或處理器,選擇 Apple Silicon 或 Intel。 |
| Android | 優先使用 v2rayNG,v2flyNG 可作為替代方案 | 確認系統支援 arm64 後再選擇該套件;不確定架構時,可先參考通用版說明。 |
| Linux | v2rayN | 在 x64 與 arm64 之間選擇架構;發行版使用的套件管理系統則決定選 deb 或 rpm。 |
Windows 的兩種安裝方式並非兩種代理協定:桌面版採用跨平台介面,WPF 版則採用經典 Windows 介面。若已有使用習慣,可依選單配置挑選;初次安裝則先用其中一種完成訂閱與連線,不必為了對照教學同時開啟兩個視窗。兩個執行個體可能會嘗試監聽相同的本機連接埠,也可能各自修改系統代理;其中一個最後關閉時,還可能清除另一個仍在使用的設定。如果系統類型沒有明確對應下載中心列出的項目,先查看系統需求與下載頁常見問題,不要拿其他系統的套件來替代。
Android 依設定需求選擇核心
Android 端先確認現有設定需要什麼。v2rayNG 使用 Xray 核心,建議優先選用;v2flyNG 使用 V2Fly 核心,適合需要核對 V2Fly 設定時作為替代方案。如果可信的設定說明明確要求某個核心專屬欄位,就應優先符合這項要求,而不是把「匯入成功」當成相容的證明。對於較常見的設定,第一次先安裝一款並完成驗證;確實需要比較時,再關閉原有 VPN 連線,改用另一款測試相同目標。否則系統可能已切換到新的 VPN,讓人誤以為兩款用戶端都在處理請求。
選擇架構時,Android 裝置的處理器能執行 64 位元程式碼,不一定代表目前的系統也提供 64 位元執行環境。若系統提示安裝套件不適用於裝置,先確認裝置規格與安裝項目;若套件是透過其他方式傳到手機,也要確認取得的是 Android 安裝套件。通用版可以降低架構判斷錯誤的機率,但不會改變核心,也無法彌補系統版本未達需求的問題。若系統提示與已安裝的應用程式衝突,先別急著解除安裝,先保存可重新匯入的設定,再核對兩者的安裝來源。
分三次檢查相容性
第一次確認系統能否完成安裝,第二次確認核心能否載入目前的設定,第三次才確認目標應用程式是否真的能建立連線。三次檢查失敗時,處理方向各不相同:安裝失敗就回頭檢查系統與架構,載入失敗就檢查欄位與核心,應用程式連線失敗才檢查代理模式、名稱解析與路由。移轉到另一台裝置時,先移轉可重新取得的訂閱或單筆設定,不要一開始就複製整套應用程式資料。不同裝置的流量接管權限、綁定連接埠與介面選項可能不同,從最精簡的設定開始,比事後釐清哪些舊設定造成衝突更省時。
記錄選擇理由時,不必抄滿一整張參數表。留下裝置架構、安裝方式、用戶端名稱、目前使用的核心與設定來源等資訊即可。也可以簡單註明未選另一種方式的原因,例如「需要讀取含 Xray 專屬欄位的設定」。若他人提供的選單路徑與自己的介面不同,先依這份紀錄比對;確認只是介面名稱不同後,再按功能尋找入口。日後要確認問題是否只出現在特定用戶端時,固定使用相同網路、目標與連線設定,這樣切換的才只有用戶端。
三、安裝:執行權限與首次啟動
桌面版安裝完成後,先只開啟介面
Windows 依下載中心選定的項目執行安裝程式,按照系統提示完成安裝後,從開始功能表啟動對應的 v2rayN。首次使用時,不必因為日後可能啟用 TUN,就讓每次啟動都以系統管理員身分執行。先以平常登入的帳戶確認視窗、選單與設定都能正常使用,再依特定功能的提示授予所需權限。若出現缺少執行元件的提示,記下完整元件名稱與目前的安裝方式,再回到下載說明核對。不要從不明來源尋找名稱相近的檔案來替換,也不要把程式無法開啟誤認為訂閱網址有問題。
macOS 請使用符合晶片的磁碟映像檔。開啟映像檔後,依視窗中的安裝指示將應用程式放入應用程式資料夾,再從該處啟動;不要把掛載中的視窗當成長期執行位置。如果系統阻擋啟動,先看清楚提示,確認是架構、來源還是管理政策造成,再檢查下載項目與裝置需求。受公司管理的裝置應遵循裝置政策,不要為了一次安裝就全面降低系統防護。安裝後確認開啟的是應用程式資料夾中的版本,避免更新後又誤開舊映像檔中的副本,造成設定似乎沒有儲存的錯覺。
Linux 請依發行版使用圖形化軟體安裝工具開啟 deb 或 rpm 套件,並核對安裝程式顯示的架構與相依性。若系統工具提示缺少相依套件,先確認套件符合目前的發行版與架構,再透過該發行版的軟體來源處理相依性。完成後從桌面應用程式清單啟動 v2rayN。如果電腦只透過遠端終端機使用,沒有可開啟圖形程式的桌面工作階段,本手冊中的圖形介面設定步驟就不適用;不要反覆安裝不同格式的套件來尋找視窗,也不要為了啟動程式就把系統目錄改成所有人皆可寫入。
分開處理 Android 安裝權限與連線授權
透過瀏覽器或檔案管理員開啟可信的安裝套件時,系統可能會要求允許目前來源安裝應用程式。只為實際開啟安裝套件的應用程式授予這次權限,安裝完成後可在系統設定中撤銷這項臨時權限。首次開啟代理用戶端與首次啟用 VPN 是兩件事:可以先確認介面、訂閱入口與設定都能正常儲存,再處理系統 VPN 授權。未經授權時,應用程式仍可能顯示已匯入的項目,但目標應用程式的流量不會因此進入 VPN。如果裝置已由公司設定連線管理政策,先確認是否允許取代,不要直接解除管理政策。
初次安裝時,先別急著還原舊裝置的所有設定。先關閉自動連線及其他會改寫網路入口的用戶端,讓新程式以預設狀態獨立啟動。開啟設定頁後退出,再重新進入,確認目前帳戶可以正常儲存設定;桌面端也可記下介面顯示的本機監聽設定,但不必將連接埠開放給區域網路。如果關閉再開啟後設定又恢復成舊值,先確認是否開啟了另一份程式、是否使用不同的登入帳戶,或資料目錄是否無法寫入。此時尚未匯入訂閱,排查範圍最小。
將首次啟動結果記錄為基準狀態
基準狀態不是網速測試結果,而是目前裝置上可重複觀察的狀態。先用原本的網路方式開啟一個日常使用的一般網頁,並記錄此時用戶端尚未接管流量;關閉視窗後,再確認系統代理或 VPN 狀態是否維持原樣。如果原本已有手動代理或常駐 VPN,記下原始設定,以免之後無法還原。接著準備一組來源清楚的設定,進入下一章。如此一來,匯入後發生的故障才有前後可比的紀錄;如果匯入前網路就不正常,應先排除基本連線問題,不要增加新的變因。
四、匯入訂閱:群組、更新與套用
先分清訂閱網址與單筆設定
訂閱網址通常用來取得一組設定,更新後群組內的項目可能有所變動;單筆分享連結或 QR Code 通常只會匯入對應的一筆連線設定,不會隨某個群組更新。不要因為網址看起來像一般網頁,就直接交給線上轉換工具處理。完整網址可能包含可識別帳戶的敏感資訊,QR Code 也可能含有伺服器位址與身分欄位。先確認資料來源與格式說明,再開啟用戶端中對應的匯入入口;不要把完整網址貼到公開搜尋欄或聊天群組來判斷格式。
在 v2rayN 中開啟「訂閱群組」內的訂閱群組設定,新增群組,填入容易辨識的別名與「可選地址(URL)」,儲存後返回主畫面切換至該群組,再執行更新目前訂閱。第一次只更新這個群組,就能一眼確認新增項目出現在哪裡。儲存只會寫入網址,並不會開始取得資料;更新才會下載資料並嘗試解析。如果群組中已有手動補上的項目,先將重要設定另行保存,避免下次更新時被取得的資料覆蓋或移除。
在 v2rayNG 或 v2flyNG 中,先開啟側邊欄或選單中的訂閱群組管理,新增群組並儲存備註與網址,再返回設定清單執行更新訂閱;實際選單名稱會依介面而異。單筆分享連結則使用新增選單中的剪貼簿匯入或掃描 QR Code 入口,掃描後先檢查顯示的協定與群組,再決定是否啟用。如果剪貼簿中有多行文字,最好重新複製來源提供的完整連結,不要手動從聊天紀錄截取。第一次只匯入一種來源,避免兩個相同別名讓目前選取項目難以辨認。
更新失敗時,分開檢查請求與解析
更新時沒有取得資料,先確認網址是否過期、複製時是否漏字元、目前網路能否送出請求,以及裝置時間是否明顯不準。若已收到內容卻沒有任何項目,先確認回傳的是設定資料,還是登入頁、錯誤頁等一般網頁,再檢查格式與核心是否相符。不要把回應本文直接公開求助。如果日誌顯示逾時,也要檢查用戶端更新時選用的請求路徑:直接連線更新與透過目前代理更新是不同路徑,後者必須先有可用的連線。若手上只有已失效的舊連線,反覆選擇透過代理更新不會自行修好問題。
清單出現項目後,先選一筆名稱與來源都能確認的設定。桌面端將它設為目前使用的設定;Android 端點選項目後再啟動連線,並依系統提示授權。觀察日誌是否出現欄位解析錯誤或連接埠占用,再以同一個一般目標驗證連線;必要時保留一筆已知可用的設定作為對照。即使訂閱更新狀態顯示成功,某筆設定仍可能因對端停用或安全參數不符而連線失敗。先用同一群組中的另一筆可信設定重測,再決定要重新檢查整個訂閱,還是只記錄這筆設定的異常。
首次連線成功後,再設定自動更新
先手動更新並用其中一筆設定完成連線,再決定是否啟用自動更新。在 v2rayN 的群組設定中確認該群組允許更新,並依來源實際變更頻率設定自動更新間隔;欄位單位為分鐘。取得新項目不代表應用程式會依照預期切換至另一筆設定,更新後應重新確認目前使用的項目。如果同一網址同步至其他裝置,各裝置的更新時間與目前選取項目可能不同。網址變更或更新流程異常時,可參考訂閱更新疑難排解筆記,並記錄錯誤發生在取得、解析還是選用階段。
五、代理模式:入口與連線驗證
桌面端先用系統代理建立基準
在 v2rayN 中選定目前使用的設定並確認核心已啟動,再開啟系統代理選項,選擇「自動設定系統代理」。這會將系統代理指向用戶端的本機入口,適合先用支援系統代理的瀏覽器進行驗證。如果瀏覽器另裝了可獨立控制代理的擴充功能,測試時應確認它是否覆蓋系統設定;有專屬代理設定的應用程式也要另外檢查。系統代理不會重新導向所有程式的流量,更不代表每個請求都會從遠端送出;進入核心後的出站方式仍由目前的路由規則決定。
| 選項 | 作用 | 檢查重點 |
|---|---|---|
| 清除系統代理 | 移除系統代理設定 | 原有的手動代理需依照紀錄還原;此操作不會管理應用程式本身的代理設定。 |
| 自動設定系統代理 | 將系統代理指向用戶端的本機入口 | 系統記錄的位址與連接埠應與實際監聽設定一致。 |
| 不變更系統代理 | 不要求用戶端改寫系統代理 | 原有代理設定可能仍然生效,不能據此認定已清除。 |
如果只想讓支援手動代理的工具使用用戶端,不必改寫整台裝置的系統設定。在用戶端查看目前本機監聽的類型與連接埠,於工具的代理選項中填入相同類型,並使用本機迴路位址。不要把遠端伺服器的連接埠填入本機代理欄位,也不要將本機 HTTP 入口當成 SOCKS 入口;連接埠數字填得進去,不代表兩端使用相同協定。手動測試結束後,先從該工具移除設定再退出用戶端,免得工具日後一直嘗試連線至已停止監聽的本機位址。
Android 連線前先確認 VPN 狀態
Android 上常見的操作是選取目前的設定,再點選連線;系統第一次要求建立 VPN 時,需要使用者確認。確認對話框只代表同意建立系統流量接管通道,不代表遠端已成功交握。如果已有其他 VPN 或工作設定正在執行,先檢查系統連線狀態與管理要求;一般使用時一次只用一個用戶端進行測試。若介面提供依應用程式代理的選項,出問題的應用程式也可能不在接管範圍內。先用同一個瀏覽器完成基準測試,再單獨確認目標應用程式是否列在排除清單中。
使用同一個目標驗證三段連線路徑
驗證時固定網路與目標,依序確認三件事:用戶端程序是否正常監聽、應用程式送出請求時日誌是否出現對應時間的連線,以及應用程式最後是否取得預期結果。建議重新載入頁面並發送一次請求,避免把瀏覽器快取中的舊畫面當成連線成功的證據。頁面能開啟但日誌中沒有請求,可能是應用程式沒有使用這個入口;日誌有入站紀錄但出站逾時,則應回頭檢查規則與實際連線狀況。成功存取一個網站,不代表所有應用程式與傳輸方式都正常。
如果瀏覽器正常,但更新工具無法連線,先檢查工具是否支援系統代理、有沒有獨立設定,或是否使用了目前接管方式無法處理的其他流量。如果系統顯示本機代理已設定,但核心提示連接埠占用,先關閉同類用戶端或確認占用來源,再決定是否更換連接埠。更換後也要檢查曾手動設定的應用程式;系統代理可能已指向新連接埠,但個別工具仍在使用舊連接埠。排查時一次只變更一個入口,才能判斷現象變化的原因;不要在同一輪操作中同時更換節點、路由與連接埠。
結束測試前,先記錄目前狀態,再還原入口。桌面端若原本是直接連線,清除這次新增的系統代理,並確認退出應用程式後一般網頁仍可存取;若原本已有公司或個人設定的手動代理,請依準備階段的紀錄還原,不要把清除設定當成還原舊值。Android 停止應用程式連線後,檢查系統 VPN 狀態,尤其留意「一律開啟」或「未透過 VPN 連線時封鎖」等設定。如果停止後整台裝置都無法連線,先檢查這個層面,不要重新匯入設定。入口開關可獨立驗證,下一章的分流測試才不會受到接管範圍干擾。
六、路由分流:比對、順序與 DNS
分流是為已進入用戶端的請求選擇出口
開始前先保留一份已驗證的路由預設,再複製一份進行測試。預設名稱雖方便選用,卻不能取代規則檢查;不同設定中的「繞過」可能代表不同規則清單。判斷一筆請求時,先確認應用程式傳給入口的是網域名稱還是 IP,再檢查規則條件與順序,最後才查看出站標籤。如果規則只依網域名稱判斷,但應用程式提供的是 IP,應先確認核心能否透過目前的入口還原目標資訊,不要隨意增加幾個相似網域碰運氣。
單條規則可依網域、位址範圍等條件比對;部分組合條件則必須同時符合。規則會依序評估,若把寬鬆條件放在專用規則之前,後面的例外規則可能永遠不會生效。維護時將較具體的規則排在寬鬆規則之前,並另外設定預設出口。新增網站規則後,至少檢查該網站、原本應使用另一個出口的目標,以及未個別列出的普通目標。只測新增的網站,看不出這次變更是否也改變了預設路徑。
核心 JSON 範例:區域網路直連與預設出站
以下是可併入 Xray 或 V2Fly 自訂設定的頂層 routing 片段,並非可直接啟動的完整設定:現有設定必須已定義標籤為 direct 的直連出站,以及標籤為 proxy 的代理出站,並保留原有入站。如果現有標籤不同,請改用實際標籤。使用圖形用戶端的規則編輯器時,請對照輸入條件與目標出站,不要將整段 JSON 貼進網域文字欄位。先在副本中驗證,再套用至常用設定。
{
"routing": {
"domainStrategy": "IPIfNonMatch",
"rules": [
{
"type": "field",
"ip": ["10.0.0.0/8", "172.16.0.0/12", "192.168.0.0/16"],
"outboundTag": "direct"
},
{
"type": "field",
"network": "tcp,udp",
"outboundTag": "proxy"
}
]
}
}
此範例會讓符合指定私有網段的 IP 請求直接連線,最後一條則比對其餘進入路由的 TCP 與 UDP 流量。這裡有個容易忽略的邊界:IPIfNonMatch 只有在沒有規則符合時,才會嘗試解析網域以進行 IP 比對。因此,合法的寬鬆預設規則可能早已符合,後續就不會再嘗試解析。不能把此範例解讀為「所有解析至私有位址的網域一定會直連」。如果已有明確的內網網域,請在預設規則之前為該網域新增專用規則;若確實需要依網域解析結果比對位址,再評估 IPOnDemand 額外帶來的查詢與解析流程。
分開觀察 DNS 查詢與最終連線
分流需要識別目標,但 DNS 查詢本身也有通往解析服務的路徑。某個網站的流量走代理,不代表解析該網站的請求也會走相同路徑。瀏覽器自己的加密 DNS、系統設定的解析服務與用戶端內建 DNS 都可能參與。調整時先記錄實際啟用的是哪一種,再依目標決定需要由核心處理的解析範圍。先測試一個直連目標與一個代理目標,記錄日誌中的目標名稱、符合的規則與出口;有需要時再依照DNS 查詢路徑與防洩漏設定檢查解析流程。
如果修改規則後只有區域網路服務無法使用,先用確認無誤的區域網路位址測試,再用原本的網域名稱測試;兩次結果不同,通常表示名稱解析或網域比對需要另外處理。如果所有目標都失敗,先還原備份的預設並重新載入,確認至少能恢復基準狀態,再檢查是否引用了不存在的出站標籤,或覆蓋了現有必要的例外規則。與其一次寫完數十條規則,更穩妥的方式是每增加一種條件就測試一組結果,並記錄實際使用的順序;日後更新用戶端時,也能用這份清單確認規則行為是否改變。
七、TUN 模式:接管範圍與還原
先確認問題是否真的出在入口
TUN 透過虛擬網路介面或相應的系統機制,接收符合路由條件的流量,不要求每個桌面應用程式都理解系統代理設定。當同一筆設定已透過系統代理驗證,但目標應用程式仍未使用該入口時,可考慮將 TUN 作為下一步。如果原設定在一般瀏覽器中已經交握失敗,或核心根本無法啟動,啟用 TUN 也無法修復遠端參數。先寫清楚要新增接管哪個應用程式,以及與原模式相比預期會出現什麼差異,避免誤以為接管範圍越廣就一定越穩定。
接管範圍變廣,不代表所有流量都會經過相同出口。系統路由、用戶端的 TUN 設定、內網排除項目與應用程式本身的解析方式都可能造成影響。桌面端可能需要啟用相關元件並取得系統權限;Android 常用的是系統 VPN 通道,不要把桌面介面中的選項直接套用到手機。若已有特殊網路環境,例如必須存取區域網路共用資源,或裝置上已有其他虛擬介面,請先準備可還原的測試路徑。若遠端工作階段依賴目前的網路,不要貿然切換接管模式,以免中斷後無法在本機還原。
從乾淨的基準狀態啟動 v2rayN TUN
先在桌面端確認可透過系統代理建立正常連線,並記下原本的系統代理狀態、目前路由與使用中的設定。接著停止系統代理接管,但保留同一筆設定,並確認沒有其他代理用戶端正在修改系統路由。找到 v2rayN 介面提供的 TUN 開關,依提示處理必要權限。如果目前介面沒有這個選項或啟動失敗,請查看日誌中的元件與錯誤訊息,不要照抄其他系統截圖中的開關參數。初次驗證只測試 TUN,不要同時新增遠端 DNS 或改寫分流規則。
啟用開關後,依序測試三類目標:一般網頁、原本不走系統代理的應用程式,以及需要維持直連的區域網路資源。每次測試前重新發送請求,並觀察日誌中是否出現該應用程式嘗試連線時的入站紀錄或規則命中。只有一般網頁可用,表示原本的問題尚未解決;原應用程式開始正常運作但內網資源無法使用,則應檢查區域網路路由與排除範圍。如果功能正常,但關閉 TUN 後整台裝置出現異常,請檢查系統預設路由、原有代理與 DNS 是否恢復,並記錄殘留的是哪一項;不要把反覆關閉再開啟當成長期解法。
分開判斷 DNS、虛擬位址與傳輸故障
使用 TUN 時,DNS 請求可能改走其他路徑。先比較已知可用的內網位址是否能連線,以及對應的內網名稱是否能解析;若位址可連線但名稱解析失敗,先檢查解析服務的選擇與範圍,不要先重新安裝用戶端。如果啟用了 FakeDNS,回傳的位址可能是核心為網域對應的虛擬 IP;後續連線只有依設計返回能還原這份對應的入口,規則才能依還原後的目標判斷。可接著閱讀FakeDNS 原理與適用情境;尚未建立基準狀態前,無須啟用此功能。
某個應用程式的網頁存取正常,但語音或即時連線仍失敗,可能是實際流量類型與網頁測試不同。先在相同網路下關閉 TUN 進行對照,確認問題並非目標應用程式本身造成,再檢查目前的出站與路由是否支援該應用程式使用的傳輸方式。不要只因為「網頁能開」就認定所有類型的流量都正常。反過來說,如果啟用後所有請求立刻失敗,先關閉 TUN、還原原本的系統代理狀態並驗證基準。第二輪測試時,只檢查一個方向,例如權限或路由衝突,直到能確認是哪項設定改變了結果。
八、日常維護:更新、備份與檢查
分開處理訂閱更新與軟體更新
訂閱更新會變更連線項目,軟體或核心更新則會改變設定解析、介面與執行行為。同一天遇到這兩種更新時,先完成其中一項並驗證,再處理另一項。日常可依來源實際更新頻率檢查訂閱,不必把自動更新間隔設得很短。更新群組後,確認目前使用的設定是否仍存在、是否出現同名項目,再測試固定目標。如果更新前可用、更新後出現異常,先用先前另行保存的設定進行比對;比起直接刪除後重新匯入,更容易判斷是項目變更,還是當下網路剛好不穩定。
升級用戶端前,先記下使用的安裝方式與目前核心,並保存訂閱群組、常用路由、本機連接埠、DNS 選項與流量接管偏好。如果升級說明提及設定移轉,先確認備份能在可用環境中讀取。升級後先不要切換核心或路由,只使用原本的接管模式,重新檢查一個一般目標與一個本機資源。若新介面更改了預設選項,記下實際選擇,不要依舊截圖猜測。需要還原時,先保留升級後產生的重要紀錄,盡量使用升級前的備份還原,不要把已移轉的資料直接交給舊版程式。
依還原需求選擇備份方式
訂閱網址適合重建經常變動的清單,單筆匯出適合保留目前可用的項目,用戶端備份則適合移轉同類裝置上的群組與部分偏好。三者包含的資料不同:訂閱網址不會保存手動路由,單筆分享通常不含全域設定,備份也可能不包含系統權限與其他系統層級狀態。準備更換裝置時,先閱讀多裝置設定同步筆記,依需求分別保存,不要把一個 QR Code 當成整台裝置的網路設定快照。
備份時要清楚檔案存放位置、開啟方式,以及哪些人有權存取。設定檔可能包含帳戶識別資訊與完整訂閱網址,不要直接存到公開共用位置,也不要在公開回報中上傳整個壓縮檔。移轉時優先使用用戶端支援的匯入與匯出功能;匯入後先還原必要的群組與規則,再逐項設定本機連接埠、裝置權限與網路接管。新裝置完成一輪驗證前,先不要修改舊裝置的設定。如果項目能匯入,但路由設定無法辨識,手動重建少量必要規則,比覆蓋整份設定更容易確認差異。
故障紀錄只保留有用資訊
遇到間歇性故障時,記錄發生時間、目前網路、自己使用的設定別名、是否啟用 TUN,以及出問題的應用程式,再擷取該時間區間內最早出現的錯誤。如果裝置從睡眠喚醒後才出現故障,請特別記下「喚醒前正常、喚醒後異常」,再檢查網路是否切換,以及本機監聽是否恢復。只有特定網路無法使用時,先切回可正常運作的網路重測,不必立刻判定訂閱失效。向他人求助時保留錯誤類別與必要背景,並移除完整網址、QR Code、身分欄位與可識別個人的存取紀錄。
為常用裝置安排一輪簡短檢查:確認設定可載入、一般目標走預期出口、本機資源仍可存取,再確認停止流量接管後能否回到原本的網路狀態。如果打算讓電腦與其他裝置共用代理,先確認確實有此需求,並分清本機迴路監聽與區域網路監聽,不要向不受信任的網路開放;詳細檢查項目請參閱v2rayN 區域網路代理共用設定。停止共用後,記得確認監聽已關閉。平時不需要這項功能,就維持關閉狀態,也能減少日後排查連接埠時需要檢查的入口。
九、進階路線:單一變因測試與疑難排解
以對照測試取代反覆切換開關
進階操作應從可重現的問題開始。先寫清楚基準條件:「在這台裝置、這個網路,使用這個入口存取同一個目標」,接著只改一個變因:用戶端、核心、規則、DNS 或接管模式擇一。例如瀏覽器可用但某個工具不能用,先只更換入口,不要同時修改路由與訂閱;兩種入口都失敗,再使用同一個應用程式更換目前的連線設定。如果故障無法重現,也不要把某次成功歸因於最後操作的開關。記錄操作前後相同的觀察項目,才能判斷下一輪應繼續檢查還是還原。
可以用「預期、實際、證據、下一步」記錄異常。例如預期內網工具存取區域網路資源時直連,實際上啟用 TUN 後逾時;證據是區域網路位址可連線,但網域名稱請求失敗;下一步便是檢查由哪個元件處理該網域的解析。另一種情況是用戶端完全沒有收到工具的請求,此時應先檢查入口與接管範圍,而不是分析路由規則。使用這種格式時,不要把看不到日誌寫成「確認沒有發生」;日誌層級與記錄範圍可能不足,可暫時提高可見度,測試後再改回日常設定。
從本機基準判讀啟動與連線錯誤
桌面端出現綁定失敗時,先核對設定中的本機監聽類型,再檢查實際是否有對應連接埠。Windows 可在 PowerShell 中執行下方這條唯讀命令,列出本機正在監聽的 TCP 位址、連接埠與程序識別碼;再到工作管理員的詳細資料頁比對程序識別碼,確認使用該連接埠的是目前用戶端元件還是其他程式。這條命令不會驗證代理協定,也不會測試遠端連線,因此無法據此判斷訂閱品質。檢查綁定位址時,請留意本機迴路位址與面向所有介面的位址並不相同;後者需搭配既有共用設定一併判斷。
Get-NetTCPConnection -State Listen |
Select-Object LocalAddress, LocalPort, OwningProcess
監聽正常但核心回報外部連線逾時時,先區分是無法解析目標、連線尚未建立,還是在交握後才失敗。欄位不識別通常發生於載入階段;憑證名稱不符會發生在相關安全交握階段;遠端回傳的應用程式錯誤則是連線建立後的另一個層面。不同日誌用語可能相似,請依發生時間點判斷,不要關閉安全檢查來掩蓋名稱不符的問題。如果只在特定網路出現故障,請在已知可用的網路中以相同設定重測;如果多筆設定都在同一階段失敗,再檢查本機共用環境。
依需求安排接下來的練習
第一輪只練習修改一條網域規則:在備份的路由副本中新增一個需要直連的測試目標,觀察它與另一個一般目標的連線去向,再移除新規則重測。第二輪才調整解析:固定同一條路由,分別觀察直連目標與代理目標的名稱查詢及出站結果。第三輪處理流量接管:同一個應用程式先使用明確支援的入口測試,再比較系統代理或 TUN,並保留最精簡、可重現的設定。每一輪都先寫下預期結果與還原方式;如果上一輪的結果還無法解釋,就不要用下一層的變更把異常掩蓋掉。
日常只使用訂閱、系統代理與少量分流時,能說清楚這三項就足夠。需要處理不遵循代理設定的應用程式,再學習 TUN;需要移轉設定或使用自訂核心設定時,再檢查核心差異、欄位與出站標籤。遇到安裝、架構或裝置需求問題,請回到下載中心與下載常見問題;需要從頭重新建立基本連線時,依照快速入門教學操作。完成一輪排查後,留下最後可用的狀態與可重複的驗證步驟,比啟用所有進階選項更有幫助。