新增訂閱
訂閱網址 https://example.com/sub?token=xxxx 確定匯入訂閱
先儲存網址，再取得設定內容。
設定註解工作台
v2rayN 設定的五個入口
訂閱負責提供設定，系統代理負責讓應用程式連線，路由則負責選擇出口。這些功能各有用途，初次啟動時不必全部調整。先完成訂閱更新並確認瀏覽器可連線，再依個別應用程式的需求補上規則，能減少同時修改多項設定造成的排除困難。
以下視窗為靜態設定示意，並非可直接操作的用戶端。切換標籤可查看設定用途；實際選單名稱與位置可能隨用戶端介面調整，操作時請以所用用戶端的設定頁面為準。
新增訂閱
網址（URL）· 教學範例 https://example.com/sub?token=xxxx 確定匯入訂閱適合集中管理服務提供者發布的設定。在「訂閱群組設定」中新增群組名稱與完整網址，儲存後執行「更新全部訂閱」，再從清單選擇要使用的設定。相較於逐一貼上分享連結，訂閱群組更方便日後同步變更；不過，更新結果仍取決於網址是否有效、網路是否可連線，以及服務是否仍在有效期限內。網址中的權杖通常代表存取權限，不應放進公開截圖，也不要提交到來源不明的轉換頁面。更新後清單若是空的，請先查看更新記錄，不必反覆重新安裝用戶端。
- 自動設定系統代理
- 清除系統代理
- 不變更系統代理
系統代理模式會將遵循系統設定的應用程式導向本機代理連接埠。初次測試瀏覽器時，可選擇「自動設定系統代理」；「清除系統代理」會移除系統中的代理設定；「不變更系統代理」則保留現有設定，並不代表自動停用代理。不同於透過 TUN 接管網路流量，系統代理是否生效取決於應用程式有沒有讀取這些設定。終端機、遊戲或自行設定代理的瀏覽器，可能需要另外設定。排除問題時，先確認用戶端核心正常執行，再檢查應用程式本身的代理選項，避免誤以為設定無效。
私人位址直連
geoip:private→direct
路由規則會依網域、位址或其他條件選擇直連、代理或封鎖出口。範例中的 geoip:private 用來比對私人位址，direct 代表直連，有助於保留區域網路裝置的存取路徑。與將所有目標送往同一出口相比，分流還需同時考量規則順序、網域解析與預設出口。建議先使用符合目前需求的預設規則，再補上少量明確規則；每次修改後，分別測試一個目標網站和一項區域網路服務。若只有特定網站異常，應先檢查該網站符合哪條規則，而非立刻修改所有 DNS 設定或切換整組設定。
流量接管
啟用 TUN 模式
TUN 模式設定 →
TUN 模式透過虛擬網路介面接管流量，可用於處理不讀取系統代理設定的應用程式。它與系統代理的差異在於接管網路的層級，但不代表每個目標都會經過代理，最終出口仍由路由規則決定。桌面版啟用前，請確認具備相應權限；Windows 通常需要系統管理員權限，也要留意其他虛擬網路介面與網路工具。建議先確認一般系統代理可正常連線，再嘗試 TUN，避免同時排除兩種連線方式。啟用後若區域網路存取或網域解析異常，先停用 TUN 進行對照測試，再檢查私人位址規則與 DNS 設定。
核心類型
- Xray
- V2Fly
用戶端負責介面與設定管理，核心則負責實際執行網路連線。切換核心適用於處理協定、傳輸方式或特定設定的相容性問題，不是每次連線失敗都必須採取的步驟。Xray 與 V2Fly 是相關但各自發展的專案，支援範圍應以實際發布說明為準；用戶端可選的項目也會受安裝內容影響。切換前請記下目前設定，確認目標核心能處理現有設定，再重新啟動連線並查看記錄。若錯誤源自訂閱網址、系統代理或伺服器狀態，單純更換核心通常無法解決根本原因。
安裝檔選擇
依作業系統選擇用戶端
桌面系統使用 v2rayN，Android 裝置可優先選擇 v2rayNG；需要 V2Fly 核心時再考慮 v2flyNG。請先確認作業系統與處理器架構，再前往下載頁選擇對應的安裝檔。桌面版安裝檔無法直接用於手機，訂閱網址是否適用於目標用戶端，則需向服務提供者確認。
以下入口會前往下載頁的對應平台區段，不會直接開始下載檔案。下載頁整理了安裝檔類型、安裝條件與用戶端差異，適合更換裝置或首次安裝前參考。用戶端可免費使用，但它只是設定與連線工具，安裝後仍須準備有效的設定或訂閱。
Windows
桌面版採用跨平台介面，適合從一致的操作流程開始使用；經典 WPF 版則保留熟悉的桌面操作布局。兩種版本都以管理訂閱、選擇設定與調整路由為主，請依作業系統條件與操作習慣選擇，不必將它們誤認為必須同時安裝的兩個元件。
安裝前請確認系統架構及下載頁列出的執行需求。日常使用瀏覽器連線可先採用系統代理；只有應用程式不遵循系統設定時，再評估是否使用 TUN。更換介面版本前，請先保留必要設定，尤其是訂閱群組、自訂路由與連接埠設定，以免覆蓋原有的使用環境。
macOS
先在「關於這台 Mac」查看晶片資訊，再選擇 Apple Silicon 或 Intel 對應的下載入口。安裝前應確認安裝檔與處理器相符，不要只依裝置外觀或購買年份判斷。啟動後先匯入訂閱並選擇設定，再檢查系統網路設定中的代理是否已依預期寫入。
若系統提示需確認應用程式來源，請先核對安裝檔的取得管道，再依系統說明處理，不要為了啟動用戶端而關閉整體安全機制。系統代理也可能與應用程式自己的代理設定並存；若只有特定瀏覽器異常，請優先檢查瀏覽器擴充功能及其連線方式。
Android
v2rayNG 使用 Xray 核心，v2flyNG 使用 V2Fly 核心，選擇時應留意設定所需的協定支援。多數較新的手機可優先查看 arm64 安裝檔；若無法確認架構，可參考裝置資訊與下載頁說明選擇通用版。兩款用戶端是不同的應用程式，安裝後不會自動互相補上核心元件。
匯入訂閱並更新後，選擇一項設定，再啟動連線。首次連線通常需要確認系統的 VPN 連線授權。若離開應用程式後容易中斷，可檢查電池最佳化與背景執行限制；這些系統行為與訂閱是否有效無關，應分別測試，不必反覆刪除已成功匯入的群組。
Linux
Ubuntu、Debian 等發行版通常選擇 deb 套件，Fedora 等發行版通常選擇 rpm 套件，並進一步確認處理器架構。這裡提供的是圖形介面桌面用戶端入口，適合透過視窗管理訂閱與路由的桌面環境。安裝套件格式符合發行版後，也要留意桌面環境與執行相依項目。
系統代理能否影響目標應用程式，與桌面環境及應用程式讀取代理設定的方式有關。瀏覽器已可使用、終端機仍直接連線時，請先檢查終端機工具本身的代理設定，不要直接認定安裝失敗。開機啟動、登入後啟動，以及需要權限的網路功能也應分開設定，以免啟動順序影響連線。
快速入門預覽
從匯入訂閱到確認連線
初次設定不必複雜：準備一份有效訂閱、選好一項設定，並明確採用一種流量接入方式。先建立可重現的連線，再加入自動更新、自訂分流或 TUN。遇到問題時，便能判斷是新設定造成影響，還是原有連線條件已經改變。
查看完整教學 →-
新增群組並更新訂閱
在桌面用戶端的訂閱群組設定中新增名稱與網址，儲存後更新訂閱。Android 用戶端也可在訂閱設定中完成相同步驟，再執行更新。訂閱網址與單一設定的分享連結用途不同，不要只因網址看起來很長，就判斷應使用哪個匯入入口。完成後請確認清單中有設定項目，且沒有更新失敗的提示。
若網址可以儲存卻無法取得內容，先檢查複製時是否多了空格、換行或漏掉參數，再查看服務狀態與更新記錄。此時不要同時修改路由、DNS 與核心設定，否則難以確認哪項變更真正生效。
-
選擇設定並確認連線方式
從更新後的清單選擇一項設定作為目前使用的項目。桌面版先啟動核心並使用「自動設定系統代理」；Android 版則啟動連線並確認系統授權。系統代理和路由模式是不同的設定：前者決定應用程式請求如何進入用戶端，後者決定進入後的請求使用哪個出口。
先保留現有的一般路由，不必為了首次測試逐條新增規則。若其他代理或虛擬網路工具正在執行，請先確認它們是否修改了相同的系統設定或占用本機連接埠，再決定是否暫時關閉以進行對照測試。
-
分別測試網頁與其他應用程式
開啟一個明確需要透過所選出口存取的目標，同時確認一般網頁與區域網路服務是否仍可正常使用。用戶端顯示啟動成功，只能表示本機程序已執行，不能單獨證明遠端連線成功。請依實際存取結果與記錄判斷，不要把一次測試結果當成所有應用程式都已連線的證明。
瀏覽器正常、終端機失敗時，請優先檢查終端機是否讀取系統代理；所有目標都無法連線時，回頭檢查核心記錄與設定是否有效；只有網域無法使用時，再檢查解析路徑。確認連線穩定後再設定自動啟動，並記下可正常運作的連線方式。
用戶端、核心與開源生態系
Project V、V2Fly 與 Xray 的關係
了解用戶端與核心的分工，有助於看懂安裝說明與錯誤記錄。介面上出現相同的協定名稱，不代表不同用戶端的所有選項完全一致；同樣地，安裝圖形用戶端也不表示已具備有效的遠端服務。選擇工具時，應分別確認介面、協定支援與設定來源。
生態系背景
Project V：代理協定與工具的背景
Project V 是認識 V2Ray 相關工具時常見的生態系背景，涵蓋代理協定、傳輸方式、路由與設定等一系列工具。一般所說的「V2Ray 用戶端」，通常泛指可管理相關設定的圖形應用程式，不一定是同一個安裝程式。桌面版與 Android 版介面不同，但都需要將使用者選擇的設定交給負責實際連線的核心。
因此，匯入訂閱的教學可能有相似的操作順序，但具體設定仍應以目標用戶端為準。遇到協定名稱、傳輸方式與加密參數時，不要只因其他應用程式有同名選項就照填。先確認伺服器端的要求，再核對用戶端與核心是否支援相應組合，比大量嘗試無關的開關更有效。
核心系列
V2Fly 與 Xray：各自發展的實作
V2Fly 維護 V2Ray 相關實作，Xray 則是以相關技術為基礎發展出的另一條核心路線。兩者共享部分協定背景，但功能支援、設定欄位與發展步調並不完全相同。看到「使用 Xray 核心」或「使用 V2Fly 核心」時，應理解為連線執行層的差異，而非介面風格或服務品質的保證。
是否需要切換核心，應由設定需求決定。例如，記錄指出無法識別某個欄位或不支援某種傳輸組合時，才需要進一步確認相容性；若只是系統代理未寫入或訂閱更新逾時，應先檢查連線方式與網路路徑。核心能解析設定，也不代表伺服器目前一定在線。
三款開源用戶端
v2rayN、v2rayNG 與 v2flyNG 的用途
v2rayN 適用於桌面環境，提供訂閱、設定選擇、系統代理與路由等管理功能；v2rayNG 適用於 Android 裝置，使用 Xray 核心；v2flyNG 同樣適用於 Android 裝置，提供 V2Fly 核心路線的選擇。三款用戶端皆以開源方式發布，實際是否適用仍須視裝置、設定需求與所使用的發布版本而定。
開源授權說明軟體使用、修改與散布的條件，並非訂閱服務的方案說明。用戶端、核心及附帶元件可能各自採用不同授權；若要重新散布或修改軟體，應閱讀相應的授權條款。一般使用者可先留意系統需求與操作流程，不必為了匯入訂閱而學習建置或修改原始碼。
更新與設定維護
分清軟體更新與訂閱更新
軟體更新用於調整介面、修正問題或增加功能支援；訂閱更新則用於重新取得服務提供者發布的設定，兩者並非同一項操作。訂閱內容變更時，通常先更新對應群組；遇到明確的用戶端相容性問題時，再閱讀發布說明並評估是否更新軟體。不要把重新安裝當成處理所有故障的第一步。
更新軟體前，請先保留自訂路由、訂閱群組與必要設定，並留意敏感網址的儲存位置。更新後依照原本的連線方式，重新測試瀏覽器、其他應用程式與區域網路存取，再逐步還原個人化選項。若仍有版本差異、記錄內容或常見設定方面的疑問，可繼續參閱常見問題與依問題症狀整理的故障排除指南。
設定專題
協定、系統代理與 DNS 排除
完成基本連線後，再依實際遇到的問題閱讀專題。協定說明可協助辨認設定類型，系統代理排除則用於區分瀏覽器與終端機的連線方式；DNS 專題會說明網域解析請求實際經過的路徑。每次調整後使用相同目標重新測試，才能判斷設定變更是否有效。
V2Ray DNS 洩漏檢測方式與 v2rayN 防洩漏設定教學
先透過檢測結果確認解析請求從何處送出，再區分本機 DNS、遠端 DNS 與 TUN 模式下的 DNS 劫持。調整後重新測試，避免只修改一項設定，就將所有解析結果都視為符合預期。
VMess 與 VLESS 有什麼不同？選擇節點前的協定快速入門
從協定用途、時間要求與傳輸搭配來認識 VMess 和 VLESS。先學會辨認分享連結與設定欄位，再確認用戶端是否支援所需功能，不要把協定名稱直接等同於連線表現。
v2rayN 系統代理無效怎麼排除？分別檢查瀏覽器與終端機
瀏覽器異常時，檢查系統代理、擴充功能與 PAC；終端機異常時，檢查環境變數及工具本身的代理設定。分別驗證連線路徑，判斷問題出在應用程式設定、本機連接埠或遠端連線。