Project V 生態系
Project V 奠定了 V2Ray 的協定與設定方式基礎，並由此發展出核心實作、圖形化客戶端及規則資料等不同專案。這些專案彼此有所關聯，但不能將任何一款圖形介面的功能清單，直接視為整個生態系的能力。閱讀設定說明時，先確認內容討論的是客戶端操作、核心參數，還是伺服器提供的連線資訊。同一個術語可能出現在不同層級；釐清層級後再修改設定，可減少因設定位置錯誤而增加的排查時間。
CONFIGURATION / 01
設定功能與對應選項
從系統代理到流量路由，先確認需要處理的流量範圍，再選擇客戶端中的對應功能。以下片段用於說明設定結構；實際使用時，請以客戶端介面及目前核心支援的欄位為準。
先分清本機監聽與系統代理
本機 SOCKS 入站負責接收應用程式送出的代理請求；系統代理則會將遵循作業系統設定的應用程式導向這個本機連接埠。兩者不是同一個開關。日常瀏覽可先啟用「自動設定系統代理」；需要依目標位址決定是否經過代理時，再檢查 PAC 模式。終端機或個別設定代理的瀏覽器可能使用自己的設定，不能只看選單列狀態，就判定它們是否已接入代理。網頁無法載入時，先確認本機連接埠、系統代理指向及目前伺服器狀態，逐項排查比反覆切換節點更容易找到問題。
{
"inbounds": [{
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": { "auth": "noauth" }
}]
}依網域與目標位址決定出站
路由規則會將符合條件的流量交給指定出站，而不是取代伺服器設定。常見做法是先處理明確指定直連的網域與私有位址，再讓其餘請求進入預設出站。規則會由上而下比對，因此範圍較廣的規則若排在前面，可能會先於更具體的項目生效。編輯前，先確認核心已載入對應的地理資料，並檢查規則引用的出站標籤確實存在。若網頁與應用程式的結果不同，也要確認它們是否透過同一個本機入站送出請求；未經過客戶端的流量不會套用這組規則。
{
"routing": {
"domainStrategy": "AsIs",
"rules": [{
"type": "field",
"domain": ["geosite:private"],
"outboundTag": "direct"
}]
}
}分開管理訂閱來源與伺服器選擇
訂閱群組儲存的是更新來源；群組內的伺服器清單則是更新後取得的結果。新增網址後，必須執行更新並確認清單中確實出現伺服器，接著再選擇要使用的項目。管理多個來源時，為各群組取容易辨識的名稱，有助於確認項目來源。訂閱更新可能變更伺服器名稱與排序，不建議只靠清單位置記住常用項目。匯入失敗時，先檢查網址是否完整、回傳內容是否為客戶端支援的格式，再確認網路連線；不要將訂閱網址直接當成單一伺服器設定匯入。
訂閱群組：工作環境
更新訂閱 → 檢查伺服器清單 → 選擇使用中的伺服器
分別管理訂閱來源與本機路由規則處理不讀取系統代理設定的應用程式
TUN 模式透過虛擬網路介面接管符合條件的系統流量，適合需要涵蓋不遵循系統代理設定的應用程式。它與一般系統代理的作用範圍不同，也可能需要額外的系統權限。啟用前，先確認一般代理連線正常，再查看客戶端目前平台的 TUN 設定與路由選項。啟用後若無法正常存取區域網路裝置，應優先檢查私有位址、DNS 與排除規則，而非直接修改伺服器協定。停止使用時，請在客戶端關閉 TUN，並確認作業系統的網路設定已恢復預期狀態。
連線檢查順序：
一般系統代理 → DNS 設定 → TUN 虛擬介面
區域網路存取異常 → 檢查私有位址路由客戶端介面與執行核心各司其職
v2rayN 提供訂閱、伺服器選擇及代理模式等圖形化操作；實際協定處理則由所選核心負責。Xray 與 V2Fly 是彼此相關、但獨立維護的核心系列；能否使用特定協定或傳輸設定，取決於核心能力及客戶端提供的設定入口。切換核心前，先記下目前可用的連線方式，確認目標核心支援現有伺服器參數，再重新啟動相關服務並測試連線。若發生啟動錯誤，查看客戶端記錄中的欄位或程序錯誤，比只觀察系統代理圖示更能協助判斷。
客戶端：v2rayN
核心選擇：Xray / V2Fly
檢查順序：協定支援 → 設定欄位 → 啟動記錄需要逐項檢查規則、DNS 與訂閱管理時，請參閱進階設定手冊 →
PLATFORMS / 02
依作業系統選擇安裝套件
桌面端使用 v2rayN；Android 可依核心需求選擇 v2rayNG 或 v2flyNG。先確認作業系統與處理器架構，再前往對應平台的下載頁面。
Windows
v2rayN 提供桌面版與經典 WPF 版。桌面版採用跨平台介面；習慣 WPF 操作方式的使用者，可參考經典版入口。
前往下載 →macOS
v2rayN 依 Apple Silicon 與 Intel 晶片分別提供下載項目。請在系統資訊中確認晶片類型，再選擇對應安裝套件。
前往下載 →Android
建議先查看採用 Xray 核心的 v2rayNG；需要 V2Fly 核心時，則選擇 v2flyNG。兩款均提供 arm64 與通用版。
前往下載 →Linux
v2rayN 依套件格式提供 deb 與 rpm，並列出對應的 arm64 版本。請先確認 Linux 發行版的套件管理工具與處理器架構。
前往下載 →
不確定該選哪個版本？下載頁依平台列出安裝套件、架構及系統需求。查看所有客戶端 →
FIRST CONNECTION / 03
從安裝到首次連線
先讓一台伺服器在一般系統代理模式下正常運作，再調整路由、DNS 或 TUN。一次只變更一類設定，連線結果才容易判斷。
- 01
安裝並匯入設定
依系統架構安裝客戶端。在訂閱設定中新增服務提供者提供的網址，手動更新訂閱，並確認伺服器項目已出現在清單中。若收到的是單一設定連結，請使用客戶端的連結匯入功能，而非訂閱群組入口。
- 02
選擇伺服器與模式
選取一台伺服器作為使用中的設定，啟動核心並啟用系統代理。先以一般代理模式確認基本連線；需要依目的位址處理不同流量時，再開啟路由設定，檢查規則順序與出站標籤。
- 03
驗證連線並找出問題
使用遵循系統代理設定的應用程式存取目標服務，接著查看客戶端記錄。若無法連線，依序確認訂閱是否已更新、伺服器是否已選取、本機連接埠是否正常監聽，以及應用程式是否讀取系統代理設定。
OPEN SOURCE / 04
Project V、核心與客戶端
介面負責管理設定，核心負責處理連線。了解這項分工，有助於看懂錯誤記錄，也能避免將客戶端功能與協定支援範圍混為一談。
V2Fly 與 Xray
V2Fly 延續 V2Ray 專案的核心維護工作；Xray 則是相關生態系中另一個獨立的核心系列。兩者都可處理連線，但支援的協定、傳輸選項及設定欄位可能不同。若伺服器設定需要特定功能，必須同時確認客戶端的匯入方式及目前選用的核心。設定解析失敗時，記下錯誤欄位並查閱對應核心的設定說明，不要只根據客戶端名稱判斷相容性。多核心選擇是為了符合實際設定需求，不代表同一份設定能自動適用於所有實作。
三款客戶端的定位
v2rayN 適用於 Windows、macOS 與 Linux 桌面環境，整合伺服器管理、訂閱更新、系統代理及路由操作。Android 版 v2rayNG 使用 Xray 核心；v2flyNG 則提供 V2Fly 核心的另一種選擇。這三款都是原始碼開放的專案，但介面配置、更新頻率與支援功能並不完全相同。選擇時先確認作業系統，再考量所需核心與設定功能；即使在多台裝置上使用同一份訂閱，仍須分別檢查各裝置的代理模式與本機規則。
協定與更新範圍
專案採用公開的開源授權；實際授權條件請以各專案發布的資訊為準，生態系中可見 GPL-3.0、MIT 等授權。客戶端、核心與規則資料的維護進度可能各自獨立，因此更新其中一個元件，不一定會改變其他元件的行為。進行較大幅度的設定調整前，請保留目前可正常運作的設定，並記錄使用的客戶端、核心與作業系統平台。發生問題時，這些資訊比籠統地描述「無法連線」更有助於找出原因。下載頁整理了各平台入口，設定細節則依主題收錄於進階手冊。
要進一步檢查訂閱篩選、DNS、FakeDNS 與自訂出站，請閱讀進階手冊 →
TECHNICAL NOTES / 05
近期技術筆記
整理啟動故障、連接埠衝突與初次使用的具體排查步驟。每篇文章都對應一種可重現的設定情境。