首次設定
先匯入有效設定，再確認流量是否進入客戶端。安裝程式、節點訂閱與系統代理是三個不同環節，依序處理，排查時才能找到明確的起點。
準備與匯入
客戶端負責管理設定，安裝後不會自動產生可用節點。請先準備來源明確且仍在有效期限內的訂閱網址。訂閱網址通常含有可識別帳戶的資訊，複製時請保留完整內容，也別把瀏覽器中的管理頁面網址誤當成訂閱連結。
在 v2rayN 頂端選單開啟「訂閱群組」中的「訂閱群組設定」，新增群組並填入網址，儲存後執行「更新目前訂閱（不透過代理）」。如果目前網路無法直接連線至訂閱服務，再考慮透過已可使用的代理更新。完成後查看記錄，確認伺服器清單中已出現節點；更新失敗時先核對網址與回應內容，不必反覆重新安裝客戶端。
節點與模式
在伺服器清單選取要使用的節點，透過右鍵選單中的「設為使用中伺服器」確認選擇。伺服器名稱只是備註，無法據此判斷協定是否適用。匯入後請檢查位址、連接埠與傳輸設定是否完整，再執行「測試伺服器真實連線延遲」，確認代理交握是否成功。
首次驗證可先使用預設路由規則，讓設定保持簡單。在主視窗底部的「系統代理」選擇「自動設定系統代理」，再檢查「路由」選項。系統代理會讓遵循系統設定的應用程式連線至本機代理；路由規則則決定流量進入核心後的去向，兩者不能互相取代。
連線與檢查
開啟要測試的網頁，同時查看 v2rayN 底部的記錄。只有看到相應的連線記錄，才能確認該應用程式的請求已進入客戶端。瀏覽器能開啟網頁，不代表所有應用程式都使用代理；有些程式會採用個別的代理設定，也有些只會讀取啟動時的系統設定。
如果網頁仍無法連線，請依序檢查系統時間、使用中的節點、本機監聽連接埠、TLS 參數與路由規則，每次只調整一項。退出客戶端前先關閉系統代理，避免系統仍指向已關閉的本機連接埠。Android 使用 v2rayNG 時，也要確認系統連線授權與背景執行狀態，不能直接照搬桌面版的系統匣操作。
平台與客戶端
桌面平台使用 v2rayN。Android 可優先選用採用 Xray 核心的 v2rayNG；需要 V2Fly 核心時再選擇 v2flyNG。下載頁整理了安裝檔格式、處理器架構與客戶端差異，請先選擇作業系統，再挑選安裝檔。
初次安裝可先了解採用跨平台介面的桌面版；習慣經典介面配置的使用者則可選擇 WPF 版。兩種介面的選單位置可能不同，教學中的「訂閱群組」、「系統代理」與「路由」仍分別代表訂閱管理、應用程式流量入口與核心分流，別只憑按鈕外觀判斷設定是否生效。
安裝前請在系統「設定 → 系統 → 關於」中查看系統類型，並閱讀下載頁的適用說明。啟動後先測試一般系統代理，再依應用程式需求考慮使用 TUN。需要提高權限的功能與一般代理的檢查方式不同，遇到問題時先查看記錄，不要同時更動多個開關。
在系統選單「關於這台 Mac」中查看「晶片」或「處理器」，再選擇相符的架構。Apple Silicon 與 Intel 使用不同的安裝入口；安裝檔格式相同，不代表兩者可以互換。匯入訂閱前，請先完成首次啟動與系統授權，並確認客戶端視窗和記錄都能正常顯示。
可在「系統設定 → 網路 → 目前的網路服務 → 詳細資訊 → 代理伺服器」中檢查系統代理。如果退出客戶端後網頁無法瀏覽，請優先確認代理是否仍指向本機監聽位址。切換 Wi-Fi、有線網路或其他網路服務後，也要重新檢查目前使用的服務，而不是只查看先前連線的項目。
多數較新的手機可優先查看 arm64 安裝選項；不確定架構時，再參閱通用版說明。v2rayNG 與 v2flyNG 的主要差異在於使用的核心及設定相容性。介面相似，不代表所有協定和傳輸參數都能互相移轉。請先確認訂閱需求，再決定是否使用其他客戶端。
在 v2rayNG 右上角選單開啟「訂閱群組設定」，新增訂閱後返回並更新節點。首次啟動連線時，系統會顯示 VPN 連線授權；這項授權用來建立本機流量接管通道，不代表遠端節點已成功連線。如果鎖定螢幕後連線中斷，請到系統的應用程式設定中檢查電池最佳化與背景活動權限。
先確認發行版採用的套件格式，再核對處理器架構。deb 和 rpm 分別適用於不同的套件管理系統，x64 和 arm64 則對應不同硬體；四種組合不能只看副檔名來選擇。可透過發行版的軟體安裝介面完成安裝與首次啟動，桌面環境所需的相依套件請以下載頁說明為準。
Linux 是否能讓應用程式讀取系統代理，取決於桌面環境和應用程式本身的實作。瀏覽器可能使用系統設定，但終端機程式和背景服務通常需要個別設定。驗證時先選擇明確支援代理設定的應用程式，確認本機入口可用後，再測試其他程式；不要把應用程式未使用代理誤判為訂閱匯入失敗。
設定分鏡
訂閱決定可用節點，路由決定請求的去向，核心則負責執行協定。先區分這三個層次，再找出問題所在。客戶端會產生執行設定，分享連結並不是可直接交由核心讀取的完整設定檔。
訂閱網址是取得節點清單的入口，分享連結通常只描述單一節點。在 v2rayN 的「訂閱群組設定」中填入網址並儲存，再更新對應群組。若清單沒有變化，先查看更新記錄，判斷是網路請求失敗、回應內容無法辨識，還是訂閱已失效。傳統 VMess 分享連結會將節點欄位編碼在協定前綴之後，並非核心原生 JSON；必須由客戶端解析，不能直接貼進核心執行設定。
v2rayN · 選單與格式結構
訂閱群組
訂閱群組設定
更新目前訂閱（不透過代理）
更新目前訂閱（透過代理）
傳統 VMess 分享連結結構
vmess:// + Base64(JSON)
解碼後的常見欄位
add → 伺服器位址
port → 伺服器連接埠
id → 使用者識別碼
net → 傳輸方式
tls → 傳輸安全設定系統代理是應用程式連線至本機代理的入口，路由則是核心收到請求後使用的分流規則。在 v2rayN 主視窗底部檢查「系統代理」和「路由」，不要混淆全域路由與流量接管範圍。右側片段表示比對中國網域集合後，將流量交由直連出站；這需要相應的網域資料及已定義的出站標籤。規則通常依序比對，較寬泛的規則若排在前面，可能會攔截後續請求；修改後請查看記錄，確認實際命中的規則。
routing · 網域集合 → direct
{
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
}
]
}
}
規則欄位：domain
比對內容：geosite:cn
出站標籤：direct核心負責協定交握、傳輸與路由執行，客戶端介面則用來管理這些設定。在 v2rayN 中，可於「設定 → 參數設定 → Core 類型設定」查看各協定對應的核心選項，實際可選項目依客戶端而異。v2rayNG 使用 Xray，v2flyNG 使用 V2Fly；即使可以匯入相同的分享連結，也不代表目標核心支援其中所有擴充參數。移轉設定時，請核對協定、傳輸方式與 TLS 欄位；切換核心並非所有連線失敗的通用解法。
客戶端 · 核心設定位置
v2rayN
設定
參數設定
Core 類型設定
依協定檢查核心選項
Xray
V2Fly
Android 客戶端對應關係
v2rayNG → Xray
v2flyNG → V2FlyDNS 也需要分層檢查。系統解析、瀏覽器的安全 DNS 與核心 DNS 設定可能採用不同路徑。只修改系統 DNS，不一定會改變核心的解析行為；只修改核心 DNS，也不一定會影響未經代理的應用程式。記錄請求來自哪個應用程式、採用哪種流量接管方式，再到相應位置調整，比一次更換所有解析位址更容易重現問題。相關步驟請參閱V2Ray DNS 設定。
Project V · V2Fly · Xray
客戶端、核心與節點服務各有不同角色。開源代表程式碼的授權與協作方式；連線能力則取決於設定、遠端服務和目前的網路環境，不能只憑客戶端名稱判斷。
V2Ray 源自 Project V 代理工具生態系，核心概念是將入站、出站、路由與傳輸模組分開設定。V2Fly 延續 V2Ray 的社群開發，Xray 則以相關程式碼為基礎，發展出獨立的核心路線。三者在概念及部分設定欄位上有所關聯，但不代表所有新增功能都一致。閱讀教學時，應同時確認客戶端與實際執行的核心；只寫「V2Ray 設定」通常不足以判斷相容範圍。
VMess、VLESS、Trojan 與 Shadowsocks 是協定名稱；TCP、WebSocket 等則是傳輸方式，TLS 涉及傳輸安全。這些項目位於不同層次，並非同一類選項。伺服器位址正確但仍無法連線時，還要核對連接埠、協定身分欄位、傳輸路徑與伺服器名稱，而不只是比較節點備註。
v2rayN 適用於桌面平台，提供訂閱管理、伺服器清單、記錄檢視、系統代理與路由設定介面。v2rayNG 適用於 Android，使用 Xray 核心；v2flyNG 則提供採用 V2Fly 核心的 Android 選項。這三款客戶端都是開源軟體，負責管理本機設定與控制連線，不提供遠端服務，也不會在安裝後自動取得可用訂閱。
桌面與手機可以匯入相同來源的訂閱，但系統權限、流量接管與背景執行機制各不相同。桌面教學中的系統匣操作不能直接套用於手機；手機的連線授權也不能取代桌面上的系統代理設定。若要跨裝置使用，請先同步訂閱來源，再分別檢查各裝置的執行狀態。
v2rayN、v2rayNG 與 v2flyNG 客戶端專案採用 GPL-3.0 授權，V2Fly 與 Xray 核心程式碼採用 MPL-2.0 授權；個別檔案及其相依套件仍應以各專案的授權聲明為準。開源授權規範的是程式碼的使用、修改與再散布，並不代表遠端節點服務一定可用。客戶端可免費使用，也不代表任何第三方訂閱都免費或永久有效。
設定中的訂閱網址、使用者識別碼與驗證欄位可能連結至個人帳戶。請只將完整設定傳送給可信任的裝置，公開記錄前先移除這些資訊。需要求助時，提供錯誤類型、協定名稱和必要設定即可，不要為了說明問題而公開完整訂閱內容或節點 QR Code。
客戶端、核心、訂閱與路由資料的更新，分別會變更不同內容。客戶端更新可能調整介面及設定產生方式；核心更新會影響協定實作；訂閱更新會取得遠端節點；路由資料更新則會影響網域或位址集合。完成其中一項，不代表其他內容也會自動更新。排查前記下剛才執行的操作，有助於判斷變化發生在哪個層次。
發生異常時，先保留可重現問題的最小設定，確認系統時間與本機連接埠，再檢查 TLS、路由及 DNS。不要在同一次測試中同時更換節點、切換核心和啟用 TUN。若要依平台查看選單位置，請參閱全平台指南；只想確認概念時，可先查常見問題，再回到目前的操作。
設定紀錄
完成首次連線後，再處理測速、裝置同步與間歇性逾時。先確認文章討論的是哪個連線層次，再調整相應設定，避免把連接埠可連通誤當成代理可用，也別把設定相同視為網路環境相同。
TCPing 只測到連接埠，真實連線延遲會進行完整的代理交握，下載測速則反映實際傳輸量。三種結果回答的問題不同，不能只依單一數字排序。本文說明各項測試涵蓋的連線範圍、選擇節點時應參考哪些數據，以及低延遲為何不一定代表下載速度較快。
閱讀文章 →訂閱適合持續更新，QR Code 適合傳送單一節點，分享連結方便批次匯入，設定備份則須留意本機參數。本文比較四種同步方式，區分可共用的節點欄位與需要重新檢查的裝置設定，並說明敏感資訊的處理方式。
閱讀文章 →節點逾時不一定是遠端伺服器造成的。本機時間偏差、監聽連接埠衝突、TLS 伺服器名稱不符與路由選擇，都可能中斷連線。本文依檢查成本安排步驟，逐一說明客戶端中的檢查位置；先記錄錯誤，再透過單項調整確認原因。
閱讀文章 →