V2Ray 新手常見十問：一次釐清核心、用戶端、訂閱與連線失敗
集中解答新手最常遇到的十個問題：核心與用戶端的關係、三款用戶端如何選擇、如何匯入訂閱、全域代理與分流的差異，以及無法連線時該先檢查什麼。
適合已安裝用戶端，但還分不清系統代理與路由模式的使用者。先釐清設定由誰提供、流量由誰接收，再依序確認匯入與連線；將術語對應至介面設定後，後續排查才有明確起點。
閱讀新手常見問題 →CONFIGURATION INDEX
依設定項目查閱設定手冊
先確認連線可建立，再逐項調整分組、分流與流量接管方式。設定片段用於說明欄位，並非可直接覆寫的完整設定檔。
訂閱分組：分開設定更新網址與篩選條件
開啟「訂閱分組設定」，為每個來源建立獨立分組，再填入完整訂閱網址。分組名稱用來辨識來源，篩選條件則決定哪些伺服器會列入清單，兩者不可混為一談。首次更新時，先將篩選條件留空；確認能讀取內容後，再依名稱篩選。若更新後清單是空的，先確認連結是否失效、回應內容是否為訂閱資料，再檢查篩選運算式。相較於直接匯入一批分享連結，訂閱分組可保留更新入口，之後也能單獨重新整理某個來源。分享記錄前，請先移除訂閱網址中的存取憑證。
v2rayN → 訂閱分組設定
新增分組 → 填入訂閱網址 → 儲存
訂閱分組 → 更新目前訂閱（不透過代理）路由規則：先確認順序，再檢查出站
在「路由設定」中，先確認目前啟用的規則集，再新增網域或位址比對條件。規則會依序判斷，第一個符合的項目決定出站；若把範圍較廣的規則放在前面，後續較精確的規則可能就不會生效。確認 outboundTag 指向實際存在的出站，不要只看介面上的備註。下方片段僅示範一條封鎖規則，並依賴對應的 geosite 資源與 block 出站。相較於全域代理，規則分流可分別處理直連、代理與封鎖，但需要定期更新規則資源，並逐一測試目標網域。
{
"type": "field",
"domain": ["geosite:category-ads-all"],
"outboundTag": "block"
}DNS 設定：分清查詢路徑與連線路徑
先分清系統 DNS、核心 DNS 與應用程式自行進行的加密解析，三者不一定走相同路徑。「DNS 設定」中的伺服器位址決定核心向誰查詢，路由規則與出站策略則決定查詢如何送出。排查時先保留一個可連線的解析器，記錄目標網域與錯誤訊息，再逐步加入網域分流設定。不要以為更換 DNS 就能解決所有連線問題。下方是 V2Ray 系設定的局部範例；使用其他核心時，請確認欄位定義。相較於只修改系統解析器，核心 DNS 可參與路由判斷，但仍取決於入站是否取得網域名稱。
{
"dns": {
"servers": ["https://1.1.1.1/dns-query"]
}
}TUN 模式：確認權限與路由接管範圍
先透過系統代理確認伺服器可用，再啟用「TUN 模式」。TUN 透過虛擬網路介面接收流量，適合不讀取系統代理設定的應用程式；但是否接管目標連線，仍取決於路由、排除項目與核心實作。啟用前請確認管理員權限，並暫時停用其他使用相同網路功能的工具；啟用後，分別測試網頁、網域解析與區域網路資源。下方是 sing-box TUN 入站欄位片段，不可直接填入 Xray 設定。相較於系統代理，TUN 的接管範圍更廣，也更容易發生迴圈與路由衝突；若出現異常，請先停用流量接管再排查。
{
"type": "tun",
"auto_route": true,
"strict_route": true
}切換多種核心：依設定需求選擇執行核心
用戶端介面與負責執行連線的核心是兩個不同元件。開啟「Core 類型設定」前，先確認目標協定、傳輸方式，以及目前用戶端提供哪些核心選項。切換後請檢查啟動記錄，確認設定已成功產生，不要只憑選單中的選取狀態判斷是否生效。Xray、V2Fly 與其他相容核心的欄位並非完全通用，自訂設定尤其需要逐項核對。相較於更換整個用戶端，在同一介面切換核心可保留熟悉的管理流程；但能匯入訂閱，不代表每個伺服器都能正常運作。遇到不支援的欄位，請查閱文件，不要反覆重新安裝。
v2rayN → 參數設定 → Core 類型設定
確認協定對應的 Core 類型
儲存 → 重新啟動服務 → 查看啟動記錄PROJECT V / V2FLY / XRAY
分清開源核心與圖形用戶端
下載用戶端可解決安裝與管理需求；選擇核心決定設定功能；匯入伺服器參數後，才具備建立連線的條件。這三個環節需要分別確認。
認識 Project V 與核心家族
Project V 是以網路代理工具及相關功能為核心發展的專案體系，V2Ray 是其中的重要組成部分。V2Fly 社群延續 V2Ray 核心的開發與維護；Xray 則以相關技術為基礎，發展出自己的核心與功能路線。它們共用部分協定概念與設定習慣，但並非同一個程式的不同介面。查閱「V2Ray 核心差異」時，應一併比較支援的協定、傳輸組合、設定欄位與用戶端整合方式。
核心負責讀取設定、接收入站連線、比對路由並建立出站連線。圖形用戶端則負責將訂閱與設定轉換為核心可讀取的格式，並提供啟動、停止、記錄與系統整合功能。用戶端名稱相似，不代表核心完全相同；同一款用戶端也可能呼叫多種核心。確認實際啟動的核心與記錄，比只看應用程式名稱更能判斷相容性。
協定名稱描述連線雙方如何交換資料，傳輸方式描述資料透過什麼通道傳送，安全參數則會影響交握與身分驗證。匯入分享連結後，用戶端會解析這些欄位，但不會替伺服器補上缺漏的設定。遇到無法連線時，先檢查伺服器位址、連接埠、時間與交握參數，再判斷是否為核心功能差異，避免把所有錯誤都歸咎於軟體安裝。
依裝置選擇三款開源用戶端
v2rayN 適用於桌面環境，提供訂閱管理、路由設定與多核心呼叫等功能。桌面版採用跨平台介面；經典 WPF 版則保留另一套桌面介面與操作習慣。選擇時先確認作業系統與架構，再依需求挑選介面功能，不必因名稱相同就把兩種版本安裝在同一個資料夾。升級或移轉前，請備份訂閱分組、路由與自訂設定，避免覆寫後無法還原原有設定。
v2rayNG 適用於 Android 裝置，主要透過 Xray 核心提供連線功能，並利用系統 VPN 介面接收應用程式流量。v2flyNG 則是使用 V2Fly 核心的替代用戶端。兩者的介面與匯入操作可能相似，但支援的核心功能仍須分別確認。選擇行動裝置用戶端時，請先確認伺服器設定與核心相容，再檢查個別應用程式代理、背景執行與電池管理策略；不要把用戶端名稱當成連線成功的保證。
這三款用戶端都有開源專案背景。開源表示原始碼與相關授權可供查閱，不代表任意修改後發行的檔案都來自相同來源。閱讀專案授權時，請區分用戶端與整合的核心：V2Ray 核心採用 MIT 授權，Xray 核心採用 MPL-2.0 授權，用戶端本身也各自遵循專案授權條款。若要修改或散布，請分別確認適用條款。
分開管理軟體、訂閱與規則更新
軟體更新會改變用戶端或核心的執行能力；訂閱更新會重新整理伺服器參數；規則資源更新則會影響網域與位址的分類比對。這三種更新並非同一回事。訂閱更新失敗時，重新安裝用戶端通常無法修復已失效的連結；某條路由規則未符合，也不一定是伺服器故障，可能是分類資源、比對順序或目標網域辨識有問題。先找出需要更新的對象，再選擇相應的操作入口。
設定自動更新訂閱前，先手動確認完整流程。確認連結可連線、內容格式可辨識、分組篩選條件正確，再依來源實際更新頻率設定間隔。是否透過代理更新，應視目前網路能否連線至訂閱網址而定。若連線本身無法使用，不要讓更新流程依賴這條連線；也不要以為持續重新整理就能修復憑證錯誤，應先檢查系統時間與具體錯誤訊息。
調整核心或規則資源後，保留一組固定測試目標：一個預期直連的網域、一個預期透過代理的網域，以及確實需要存取的區域網路資源。對照記錄確認是否符合預期規則。先確認結果，再繼續修改 DNS 或啟用 TUN，可減少多個變數互相影響。匯出設定或分享截圖時，請移除伺服器身分資訊、訂閱憑證，以及其他與排查無關的私人資料。
依連線流程閱讀手冊與排查記錄
系統代理只會提供代理入口給會讀取該設定的應用程式，不會強制所有程式採用相同的連線路徑。路由規則則是在流量進入核心後才決定出站，因此「全域代理」與「所有應用程式都被接管」並不是同一回事。瀏覽器正常、其他程式異常時，先確認程式是否使用系統代理，或是否需要另外填入本機代理位址，再考慮透過 TUN 接管，避免在錯誤的層級反覆修改規則。
DNS 問題也要先判斷發生在哪個環節。應用程式可能先透過系統解析器取得位址，核心也可能在路由比對或建立連線時進行解析。記錄中出現位址，不代表原始網域一定有保留下來；啟用流量嗅探，也不表示每個連線都能還原網域。若需要依網域分流，請檢查入站、解析路徑與 sniffing 設定之間的關係。FakeDNS 設定應連同流量接管範圍一起檢視，不能只替換解析位址。
閱讀錯誤記錄時，先記下操作時間、目標與錯誤類型，再確認問題發生在解析、連線、交握或路由階段。連線逾時與憑證錯誤需要不同處理方式；核心無法啟動與無法連線至特定目標也應分開排查。本網站將完整操作整理在快速入門，將組合設定放在進階手冊；若要先判斷問題所屬層級，可從常見問題分類查看排查順序，再回到對應的設定頁面。
TECHNICAL NOTES
用戶端安裝與故障排除筆記
將單一問題拆解成可驗證的步驟。閱讀前，先記下用戶端類型、系統環境與觸發條件，避免直接套用其他平台的處理方式。
v2rayNG 耗電過快怎麼辦：電池最佳化白名單與背景常駐設定
分析 v2rayNG 在 Android 上耗電偏高的常見原因，涵蓋個別應用程式代理、記錄層級與廠商背景限制，並提供電池最佳化白名單及 VPN 常駐設定建議。
先分辨耗電是因連線持續運作，還是背景服務反覆重新啟動。保留必要的系統權限，確認是否將不需要代理的應用程式也納入流量接管，再依據記錄找出異常重連原因；不要只為了讓程式留在背景，就關閉所有系統電池管理功能。
查看耗電排查步驟 →在 macOS 安裝 v2rayN：處理「無法驗證開發者」提示與網路權限
說明在 macOS 首次開啟 v2rayN 時如何處理「無法驗證開發者」的阻擋，以及系統代理授權、TUN 模式所需權限與登入項目設定，並逐步列出系統設定路徑。
首次開啟時的安全提示與執行後的網路權限應分開處理。先確認安裝來源，再查看系統提供的具體選項；只有確實需要透過 TUN 接管流量時才授予相應權限，不要把降低整台裝置的安全性當成通用安裝步驟。
查看安裝與權限說明 →CLIENT DOWNLOADS
依作業系統選擇用戶端
先確認作業系統與處理器架構，再前往對應平台選擇安裝套件。用戶端提供本機設定與連線介面；伺服器參數或訂閱需要另外準備，安裝完成不代表已能正常連線。
Windows
v2rayN · 桌面版／經典 WPF 版
桌面版採用跨平台介面；經典 WPF 版保留熟悉的桌面操作方式。下載前請查看系統支援條件，依需求選擇其中一種版本。不要將兩版程式與設定檔混放，移轉前請先備份訂閱分組與自訂路由。
首次啟動後，先匯入訂閱並選擇一台伺服器，再設定「自動設定系統代理」。瀏覽器能連線後，再檢查需要個別設定代理的應用程式。只有確實需要更廣泛的流量接管時才啟用 TUN；若要共用區域網路連線，則須另外確認監聽位址、防火牆與存取範圍。
前往下載macOS
v2rayN · Apple Silicon / Intel
開啟「關於這台 Mac」查看晶片資訊：Apple Silicon 請選 arm64，Intel 請選 x64。安裝套件的架構必須與裝置相符。若首次開啟時出現提示，先確認來源，再依系統設定中的明確選項處理，不要照搬其他作業系統的權限操作。
安裝後分別確認系統代理、網路權限與登入項目。關閉視窗不一定代表已結束用戶端；請查看實際執行程序或選單列狀態。若要停止使用，先還原系統代理再結束程式；若只有 TUN 模式異常，請優先檢查授權，以及是否與其他網路工具衝突。
前往下載Android
v2rayNG · Xray / v2flyNG · V2Fly
建議先查看 v2rayNG；需要 V2Fly 核心時，再查看 v2flyNG。較新的主流裝置通常選擇 arm64；無法確認架構時，可參考通用版說明。安裝前確認系統需求，匯入設定後，再確認所選用戶端及其核心支援目標協定。
首次連線時，系統會要求授予 VPN 權限，這是接收應用程式流量的入口，不代表伺服器已通過驗證。連線後請確認個別應用程式的代理範圍，再測試需要使用的應用程式。若鎖定螢幕後連線中斷，請檢查電池最佳化與廠商背景執行策略；保留必要權限即可，不要同時啟動多個競用 VPN 介面的工具。
前往下載Linux
v2rayN · deb / rpm
依發行版的套件管理方式選擇 deb 或 rpm，再確認 x64 或 arm64 架構。安裝完成後，從桌面環境啟動圖形用戶端，先以一般使用者帳號管理訂閱並測試基本連線；不要為了略過權限確認而長期以高權限執行整個桌面程式。
不同桌面環境讀取系統代理設定的方式不盡相同。網頁可以正常瀏覽，但某個程式無法連線時，先確認該程式是否會讀取系統設定，以及是否提供獨立的代理選項。啟用 TUN 前，請再確認虛擬介面權限、路由與解析器設定；停用流量接管後，確認網路設定已還原，避免殘留設定影響下次測試。
前往下載