用戶端下載入口
桌面電腦使用 v2rayN，Android 裝置建議先查看 v2rayNG。確認作業系統與處理器架構後，再前往相應的下載分類。
用戶端負責儲存訂閱、管理伺服器設定並啟動核心；安裝包本身不會提供遠端連線服務。取得訂閱網址或單一設定後，再依使用指南完成匯入。更換裝置時可沿用相容的連線參數，但本機連接埠、系統代理與應用程式權限都需要在新裝置上重新確認。
下載分類提供桌面版與經典 WPF 版。桌面版採用跨平台介面，適合希望在不同桌面系統維持相近操作方式的使用者；WPF 版保留經典桌面介面，熟悉原有操作方式時可依需求選用。兩種介面的設定位置可能不同，教學中的欄位意義仍可參照。
安裝前請在系統設定的「系統 → 系統資訊」確認系統類型。首次啟動後，先檢查參數設定中的本機監聽連接埠，再設定系統代理。請勿讓兩個用戶端同時接管同一組系統代理，也不要監聽相同連接埠；否則即使成功匯入訂閱，應用程式的請求仍可能送往另一份設定。
前往下載 Windows 用戶端依「關於這台 Mac」顯示的晶片資訊，選擇 Apple Silicon 或 Intel 安裝包。晶片類型決定程式架構，與訂閱使用 VMess、VLESS 或 Trojan 無關。安裝完成後，先開啟用戶端確認設定目錄與執行狀態，再匯入現有連線設定。
桌面應用程式是否透過代理連線，也取決於它是否遵循系統代理設定。瀏覽器可以正常連線，不代表終端機程式也會走相同路徑。排查時先用會遵循系統代理的應用程式測試，再檢查其他應用程式各自的代理選項。若系統提示權限問題，請查看系統提供的具體原因，不要以關閉整體安全設定取代判斷。
前往下載 macOS 用戶端v2rayNG 使用 Xray 核心；若需要 V2Fly 核心環境，可查看替代選項 v2flyNG。多數較新的手機採用 arm64 架構，不確定時再查看通用版說明。兩款用戶端支援的協定以各自核心為準，不能只因名稱相近，就認定所有設定都能直接互換。
首次建立連線時，系統會要求確認 VPN 連線權限。這是用戶端接收裝置網路請求的入口，與遠端伺服器是否可用是兩回事。若連線常在鎖定螢幕後中斷，請檢查系統的電池最佳化與背景執行限制；也要確認沒有其他應用程式占用 VPN 連線。訂閱內容、連線權限與背景執行策略應分別核對，避免反覆重新安裝，卻沒有排除真正的故障原因。
前往下載 Android 用戶端依發行版的套件管理系統選擇 deb 或 rpm，再確認 x64 或 arm64 架構。發行版名稱與處理器架構是兩項獨立條件：即使裝置使用相同的 deb，也可能需要不同架構的套件。下載頁集中提供相關入口，安裝前請先確認系統資訊，避免將架構不相容誤判為程式無法執行。
圖形桌面的系統代理設定通常只影響遵循該設定的應用程式，不會自動替每個程式設定環境變數。初次使用時先保留回環位址監聽，並在桌面瀏覽器測試連線；若要替其他程式單獨設定代理，再填入實際的協定與連接埠。服務啟動失敗時，先查看記錄中的連接埠占用、權限或設定錯誤，不要直接擴大監聽範圍。
前往下載 Linux 用戶端設定分段閱讀器
入站接收請求、路由選擇路徑、出站負責連線。先了解三者如何透過 tag 串接，再調整 DNS 與策略。
以下是局部設定範例，並非可直接連線至遠端服務的完整檔案。範例採用常見的 V2Ray 設定結構；如涉及特定協定或擴充欄位，請再確認實際執行的核心。視窗中的 final 表示預設處理方式，並非在此新增的 JSON 頂層欄位。
入站設定會定義核心在哪個位址與連接埠接收請求，以及使用哪種代理協定。本機應用程式通常連線至回環位址，避免代理連接埠暴露在區域網路中。範例中的 SOCKS 與 HTTP 分別監聽不同連接埠，應用程式端必須填入相符的協定。連接埠並非固定標準，應以用戶端設定中的實際值為準。入站與系統代理不同，本身不會通知瀏覽器使用代理；兩端都設定正確，請求才能進入核心。
{
"inbounds": [
{
"tag": "socks-in",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": { "auth": "noauth", "udp": true }
},
{
"tag": "http-in",
"listen": "127.0.0.1",
"port": 10809,
"protocol": "http",
"settings": {}
}
]
}出站負責將已接收的請求傳送至目的地。直連使用 freedom，封鎖使用 blackhole，代理出站則需要相應協定的遠端參數。tag 是設定內部的參照名稱，不是協定名稱；routing 中的 outboundTag 必須與它完全相同。範例只展示直連與封鎖，不包含遠端代理。常見設定會在沒有符合路由規則時使用第一個出站，因此調整陣列順序也可能改變預設路徑，不能只看規則清單。
{
"outbounds": [
{
"tag": "direct",
"protocol": "freedom",
"settings": {}
},
{
"tag": "block",
"protocol": "blackhole",
"settings": {}
}
]
}路由規則會由上而下依序判斷，符合後便選擇相應的出站。較具體的網域或位址規則應排在較寬泛的規則之前，避免請求提早符合前面的條件。範例將私人位址導向 direct，前提是該出站已存在。IPIfNonMatch 表示網域規則未符合時，嘗試解析位址後再判斷；這不代表所有應用程式都會統一使用內建 DNS。geoip 與 geosite 引用的資料集合也必須可用，規則文字本身並不包含這些資料。
{
"routing": {
"domainStrategy": "IPIfNonMatch",
"rules": [
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
]
}
}dns 模組會設定核心內建解析器使用的伺服器。解析器何時參與，還取決於路由策略、出站設定，以及應用程式提交的是網域名稱還是 IP 位址。範例展示 hosts 靜態對應與 DNS 伺服器的基本結構，不代表加入這些欄位就能接管所有 DNS 流量。瀏覽器的加密 DNS、系統解析器與核心解析器可能同時存在。排查解析路徑時，應分別確認請求從何處發出、經由哪個出站傳送，再判斷是否符合預期。
{
"dns": {
"hosts": {
"domain:example.com": "192.0.2.1"
},
"servers": [
"https://1.1.1.1/dns-query"
],
"queryStrategy": "UseIPv4"
}
}policy 用來描述各使用者等級對應的連線策略，例如交握等待時間與閒置連線逾時。levels 中的數字鍵代表等級，不是伺服器編號；相關使用者設定也必須採用相同的 level，才能套用策略。範例中的時間單位為秒，數值僅供說明結構，不代表適用所有網路的最佳化建議。逾時值過短可能中斷較慢的交握或長連線。遇到連線中斷時，先確認記錄與網路狀態，再一次修改一個參數並比較結果。
{
"policy": {
"levels": {
"0": {
"handshake": 4,
"connIdle": 300,
"uplinkOnly": 2,
"downlinkOnly": 5
}
}
}
}訂閱由用戶端管理，不是 V2Ray 核心 JSON 的頂層鍵。用戶端會讀取訂閱內容，轉換成可執行的連線設定；更新訂閱也不等於升級核心。訂閱網址可能含有存取憑證，請避免在截圖或公開記錄中顯示。以下仍是有效的核心設定片段，用來說明最終設定中的出站位置，並非訂閱格式。片段只有直連出站，不能取代匯入訂閱；實際代理參數應由現有且有效的連線設定產生。
{
"outbounds": [
{
"tag": "direct",
"protocol": "freedom",
"settings": {}
}
]
}快速入門預覽
先建立一條可驗證的請求路徑，再逐步加入分流規則。每個步驟都保留明確的檢查點。
在 v2rayN 的訂閱群組中新增現有訂閱網址，填入方便辨識的備註，再執行更新訂閱。若使用單一分享連結，請從用戶端的剪貼簿匯入入口操作，不要把單一連結當作訂閱網址重複更新。v2rayNG 的操作入口位於訂閱群組設定與主畫面選單，基本流程相同：儲存來源、取得內容、確認匯入結果。
匯入後先確認清單中確實出現可選設定，並核對協定類型是否符合預期。若訂閱回傳空清單、格式錯誤或無法存取，應先處理內容取得問題，而非立即調整本機路由。訂閱可能含有存取憑證，排查截圖應遮蔽完整網址、使用者識別資訊與驗證欄位；回報問題時提供錯誤類型與操作步驟即可。
選取一項設定作為目前連線。清單中有設定不代表已啟用，更新成功也不代表遠端伺服器可連線。請先分別確認「內容已匯入」與「目前設定已選取」，後續的連線測試才有明確目標。
桌面版請先檢查參數設定中的監聽位址與連接埠，再選擇「自動設定系統代理」。這項操作會讓遵循系統代理設定的應用程式將請求傳送至本機用戶端；路由模式則決定請求進入核心後使用哪個出站。兩者屬於不同層次，不能只用「全域」一詞混為一談。變更路由不會讓忽略系統代理的應用程式自動開始使用代理。
日常分流可先使用用戶端預設模式，確認基本連線正常後再加入自訂規則。若使用瀏覽器代理擴充功能，擴充功能中的協定與連接埠必須和用戶端一致，避免擴充功能與系統設定互相覆蓋。Android 裝置則先確認系統連線權限，再檢查應用程式分流範圍，確保待測試的應用程式包含在預期範圍內。
如果電腦上還有另一款代理程式，請先結束該程式，或明確分配不同的連接埠。連接埠遭占用時，介面可能仍顯示既有設定，但核心無法正常監聽；這類問題應查看啟動記錄找出原因，而不是繼續更換訂閱。
啟動連線後，先用瀏覽器造訪已知可用的網頁，觀察是否能完成解析與載入，再查看用戶端記錄中的連線錯誤。單次延遲測試只能反映特定測試目標與方式，不能取代實際應用程式測試。網頁無法開啟時，依序檢查「應用程式代理設定 → 本機監聽 → 路由比對 → 遠端連線 → DNS 解析」，避免同時變更多項設定。
只有部分網站異常時，請比對網站使用的網域規則與位址規則；所有應用程式都異常時，優先檢查核心啟動狀態與系統代理。若涉及驗證或交握失敗，再核對裝置時間與連線參數。記錄可能包含目標網域與設定識別資訊，公開詢問前請移除與故障無關的敏感資料。
完成驗證後，記下目前可用的模式與連接埠，之後每次只調整一類設定。結束桌面用戶端前，可依實際需求清除系統代理，避免應用程式繼續將請求送往已關閉的本機連接埠。完整教學會逐一說明各檢查點的操作方式。
Project V · V2Fly · Xray
Project V 是以網路代理工具為核心發展的開源生態系，V2Ray 是其中的重要組成。V2Fly 社群延續 V2Ray 的維護與發展；Xray 以相關技術為基礎發展，也建立了自己的協定實作與功能擴充。這些核心有共同的設定概念，但並非同一個可執行程式，不應將核心名稱視為可任意互換的標籤。
閱讀設定時，先確認目前執行的核心，再核對該核心支援的欄位與協定組合。例如，VLESS 是代理協定，REALITY 是與連線安全相關的設定，兩者並非同一層次的替代選項。用戶端能識別分享連結，不代表所選核心必定支援其中每個參數；仍應檢查產生的設定與啟動結果。
v2rayN、v2rayNG 與 v2flyNG 均以開源方式提供程式碼。v2rayN 適用於桌面系統，透過圖形介面整合訂閱、伺服器選擇、路由與系統代理；v2rayNG 適用於 Android，採用 Xray 核心；v2flyNG 則提供以 V2Fly 核心為基礎的 Android 選項。開源描述的是程式碼與授權方式，不代表每款用戶端的功能完全相同。
圖形用戶端負責操作與設定管理，核心則負責協定處理與連線轉送。遇到介面操作問題，先查用戶端設定；遇到未知欄位或不支援的協定，則確認核心功能。區分這兩個層次，可避免混淆訂閱格式、介面選項與核心語法，也能理解為何同一份連線資訊在不同用戶端中的呈現方式不盡相同。
V2Fly 的 V2Ray 核心與 Xray 核心採用 MPL 2.0 授權。各用戶端專案也有各自的開源授權；散布、修改或組合使用時，應分別閱讀相關授權條款，不能以核心授權取代用戶端授權。對一般使用者而言，更直接的判斷依據是功能說明、版本更新紀錄，以及在實際裝置上的相容性。
社群維護涵蓋系統相容性、協定支援與問題修復，不代表每次更新都需要修改現有設定。閱讀更新說明時，請留意是否調整預設值、移除舊欄位或變更匯入方式。已有穩定設定時，先保留可還原的備份，再測試所需的新功能；不要將批次取代欄位當成通用的升級步驟。
更新用戶端會改變圖形介面與設定管理功能；更新核心會改變協定處理能力；更新訂閱則會取得遠端提供的新連線資訊。三者可能透過不同入口完成，更新頻率也可能不同。訂閱更新成功不會自動解決本機連接埠衝突，用戶端升級也無法讓已過期的遠端驗證參數恢復有效。
本手冊依設定項目與 JSON 鍵名編排內容，不依賴特定介面截圖。介面變更後，仍可從監聽位址、出站 tag、路由條件與解析伺服器等概念找到相關設定。需要安裝包時前往下載頁；需要理解參數之間的關聯時閱讀 JSON 手冊；若已能啟動但無法連線，則依教學中的分層檢查順序縮小問題範圍。
使用筆記與故障排除
從清單欄位到應用程式的請求路徑，依問題拆解設定，不將所有故障歸因於同一項設定。
說明節點清單中的延遲、流量倍率、地區標示與協定類型，並依日常瀏覽、影音與遊戲等情境提供選擇方向。先了解測試方式，再觀察實際應用表現，避免只依單一數值排序。
閱讀節點選擇說明 →整理訂閱網址過期、更新流量經過代理、憑證與格式錯誤等失敗原因，並示範兩款用戶端的定時自動更新設定。分辨網址無法存取與內容無法解析，依錯誤發生階段找出相應設定。
閱讀訂閱更新說明 →依序檢查系統代理模式、本機連接埠占用、時間同步、路由規則與節點可用性，逐步排除已連線卻無法上網的問題。保留可重現的測試條件，比同時修改多項設定更容易找出原因。
閱讀連線故障排除清單 →