用戶端操作
圖形介面用戶端負責管理連線資料與執行狀態，核心則負責實際處理流量。成功匯入、核心啟動、應用程式使用代理，是三個不同的檢查點。先確認一條連線正常，再逐步增加規則與接管範圍，排查時更容易找出變動環節。
{
"type": "field",
"domain": [
"geosite:category-ads-all"
],
"outboundTag": "block"
}須先定義 block 出站，並提供對應的網域規則集。
以上畫面僅示意操作架構。實際選單名稱會因平台與版本而異，連接埠也可由使用者調整。需要核對欄位時，先確認用戶端目前使用哪種核心，再查閱對應的設定結構；不要直接把圖形介面的選項名稱當成 JSON 欄位複製。
查看設定檔參考 →選擇安裝檔
桌面版請選 v2rayN，Android 裝置可優先查看 v2rayNG，v2flyNG 則是採用 V2Fly 核心的另一個選擇。作業系統名稱相同，不代表安裝檔通用；下載前還要確認處理器架構與套件格式。安裝完成後，使用既有伺服器資料或訂閱開始設定。
v2rayN · Desktop / WPF
提供採用新一代跨平台介面的桌面版，以及經典 WPF 版下載入口。初次安裝可先閱讀下載頁的介面差異說明，再依執行環境選擇版本；已有穩定設定的使用者，更新前應備份訂閱群組、自訂規則與相關設定。
請將程式放在目前使用者可寫入的資料夾，避免直接從壓縮檔內執行。若啟動時出現執行環境提示，先依指示安裝所需元件，不要把視窗未開啟誤判為伺服器故障。系統代理生效後，仍須確認瀏覽器是否使用獨立的代理擴充功能，以及本機監聽連接埠有沒有被其他程式占用。
前往下載v2rayN · Apple Silicon / Intel
在「關於這台 Mac」查看晶片資訊：Apple Silicon 對應 arm64，Intel 處理器對應 x64。依晶片選擇安裝檔，比依電腦外觀或購買年份判斷更準確。安裝後從「應用程式」資料夾啟動，並依系統提示處理開啟權限。
選單列入口可用來切換系統代理及查看執行狀態。需要使用 TUN 時，再確認目前版本是否支援及所需權限；一開始不要同時啟用多個流量接管工具。若關閉主視窗後連線仍正常，先查看選單列中的用戶端是否仍在執行；結束程式前，確認網路代理設定已還原。
前往下載v2rayNG · v2flyNG
v2rayNG 使用 Xray 核心，v2flyNG 使用 V2Fly 核心。多數較新的手機可選 arm64；若不確定裝置架構，可查看下載頁的通用版入口。兩款用戶端名稱相近，但核心功能與設定支援各有不同，不能只看圖示判斷。
首次連線時需要授予系統 VpnService 權限。完成授權後再測試連線；若背景執行容易中斷，請檢查電池最佳化及手機廠商的背景執行限制。分應用程式代理會決定哪些應用程式納入接管範圍，設定前先確認「已選取的應用程式」代表什麼，避免把允許與繞過的意思弄反。同時執行其他網路接管應用程式，也可能影響授權及實際流量路徑。
前往下載v2rayN · deb / rpm
先確認發行版採用的套件管理系統，再區分 x64 與 arm64。deb 和 rpm 是不同的安裝格式，不能只改副檔名互相轉換。下載頁提供相應格式的下載入口，適合透過圖形化軟體管理工具安裝的桌面環境。
不同桌面環境讀取系統代理的方式不盡相同，瀏覽器能連線不代表所有程式都會使用代理。初次執行時先查看核心啟動記錄，再測試需要連網的特定應用程式。啟用 TUN 前確認權限與網路管理方式；遇到衝突時，先停用其他虛擬介面或同類型的流量接管程式。保留能重現問題的最精簡設定，避免同時修改 DNS、路由與伺服器設定。
前往下載安裝檔下載入口與系統需求集中在下載頁。更換用戶端前請保留原始訂閱資料；用戶端匯出的執行設定可能含有自動產生的欄位，不宜直接移轉至其他核心。
查看所有用戶端 →開源生態與設定界線
V2Ray 是生態系與技術討論中常見的名稱，實際執行能力則由用戶端、核心與設定共同決定。分開理解這三個層面，有助於判斷安裝檔、教學與協定參數是否適用於目前環境，也能避免誤以為「匯入成功就能連線」。
Project V 著重於模組化網路代理工具，V2Ray 是其中廣泛使用的實作。設定會透過入站、出站、路由與 DNS 等部分組織運作方式：入站接受本機應用程式的連線，出站描述如何連接目標或代理伺服器，路由則負責選擇出口。這種架構讓協定與流量處理能分開設定，也表示一條完整連線往往涉及多個部分。排查時不能只檢查伺服器位址，本機連接埠、傳輸參數與路由目標也都必須相符。
V2Fly 延續 V2Ray 的社群維護與實作演進，Xray 則以相關程式碼為基礎，發展為獨立演進的核心專案。兩者有共同的技術背景，但後續功能與參數支援並不完全相同。看到 VMess、VLESS 或其他協定名稱時，還須確認傳輸方式、安全設定與核心的實作需求。不能因設定檔看起來相似，就認為所有欄位都能在不同核心間直接共用。sing-box 也有自己的設定架構，應查閱相應語法，而非直接貼上 Xray 的路由片段。
v2rayN 適用於桌面環境，提供伺服器管理、訂閱群組、系統代理與核心設定入口；v2rayNG 適用於 Android，搭配 Xray 核心與系統網路服務介面處理連線；v2flyNG 則提供另一種採用 V2Fly 核心的 Android 用戶端選擇。三款用戶端皆為開源軟體，原始碼可供社群檢視與協作。圖形介面能減少手動撰寫設定的工作，但不能取代有效的伺服器資料，也無法自動修正錯誤的驗證資訊或伺服器端傳輸設定。
開源授權說明程式碼的使用、修改與散布條件，不等同於代理服務的使用條款。用戶端、核心及打包相依元件可能各自採用不同授權；若要重新散布，應閱讀相關專案的授權文字與聲明。用戶端免費使用，不代表用戶端專案會提供伺服器連線資料。訂閱服務是否可用、存取憑證與使用範圍，應向資料提供者確認。公開分享設定前，請移除訂閱網址、使用者識別資訊、密碼及其他可用來存取個人服務的資料。
介面、核心與規則集更新，解決的是不同問題。介面更新可能調整操作方式與設定產生流程；核心更新可能變更協定實作及參數限制；規則集更新則會影響網域或位址分類。更新前先記錄可用設定並閱讀更新說明，更新後沿用原本的測試流程驗證。若設定解析失敗，優先查看記錄指出的欄位與檔案位置；不要同時升級、切換協定並替換路由。每次只變更一個項目，才能判斷故障原因。
先確認核心能正常啟動，再檢查本機監聽狀態，接著確認應用程式是否真的透過代理連線。網頁能開啟只是其中一項結果，不能據此判定所有應用程式或請求都使用相同出口。建立基本連線後，再測試區域網路存取、指定網域規則與 DNS 行為。延遲測試只反映特定的探測路徑，不代表完整服務連線一定成功。若持續逾時，請依序檢查系統時間、連接埠、防火牆、驗證資訊與傳輸設定，不要只憑一次測試就刪除所有伺服器。
已能連線的使用者，可先了解 outbounds 的出站標籤與 routing 規則之間的關係；要排查本機連入問題，先查看 inbounds 的監聽位址、協定與連接埠；若涉及網域解析，再搭配 dns 與路由解析策略一起檢查。policy 等策略項目通常不是初次執行時必須修改的設定，只有明確需要時才調整。範例片段用於說明欄位關係，合併前仍須對照目前核心的完整設定架構，並保留可還原的原始設定。
教學與疑難排解文章
依實際使用情境補充用戶端說明。遇到背景連線中斷、區域網路分享或啟動異常時，先找出相符的症狀，再依文章中的檢查順序操作。調整權限與防火牆前，應先了解影響範圍，並保留還原原始設定的方法。
Android 端連線中斷或流量未經代理，可能與系統授權、背景省電設定或應用程式選取範圍有關。依序檢查連線前的授權、背景執行狀態與分應用程式設定，釐清問題來自用戶端設定或系統限制。
閱讀文章 →分享前先確認電腦的監聽位址與實際連接埠，再設定防火牆及其他裝置的代理。本文說明同一網路內的連線方式、存取範圍，以及停止分享時應還原的設定。
閱讀文章 →視窗閃退時，先釐清是介面版本還是執行環境問題，再檢查資料夾寫入權限與設定檔。保留原始資料，逐項排除以恢復啟動，避免直接清除所有設定。
閱讀文章 →