CLIENT SETTINGS
先分清伺服器參數、路由規則與系統代理。三者分別決定連線目標、請求使用的出口，以及哪些應用程式會將流量交給用戶端。下方為設定項目示意，實際選單可能隨用戶端更新而有所調整。
在 v2rayN 的「訂閱分組 → 訂閱分組設定」新增分組，填入方便辨識的備註與訂閱網址，儲存後再更新。不同來源的伺服器清單分開管理，可避免更新時混淆。首次連線尚未建立時，先試試「更新訂閱（不透過代理）」；只有在已有可用代理，且訂閱網址必須透過代理存取時，才選擇透過代理更新。分享連結通常包含單一伺服器設定，訂閱網址則用來取得一組設定，請使用對應的匯入入口。更新後先確認清單中已出現項目，再選擇伺服器進行測試。
路由分流會將請求導向直連、代理或封鎖出口，不會更改伺服器連線參數。先使用內建路由方案建立可用的基礎設定，再到路由設定中新增網域或位址規則。規則通常依序由上而下比對，具體網域應排在較廣泛的規則之前。「IPIfNonMatch」表示網域規則未命中時，解析位址後再比對 IP 規則，可能增加 DNS 查詢負擔。路由處理的是流量進入核心後的去向，與單純切換系統代理不同；若應用程式沒有使用代理，即使規則正確也不會生效。
瀏覽器等遵循系統代理設定的應用程式，可先使用「自動設定系統代理」。這會設定系統代理入口，但不代表所有程式都會使用該入口。若應用程式忽略系統代理，再評估是否使用 Tun；此模式透過虛擬網路介面接管流量，通常需要管理員權限，並涉及路由與 DNS 設定。初次排查時，不要同時執行多個接管網路的工具，以免設定互相覆蓋。關閉用戶端前，請確認是否需要「清除系統代理」。Android 端則要留意系統 VPN 授權，以及其他 VPN 類應用程式是否占用相同介面。
Xray 與 V2Fly 有部分共同的生態背景，但協定擴充、設定欄位與功能支援並不完全相同。要遷移雙核心設定時，應先確認目標用戶端實際提供哪些核心選項，而非只看分享連結能否匯入。v2rayNG 使用 Xray，v2flyNG 則採用 V2Fly 路線；兩者是分別安裝的用戶端，不是透過同一個按鈕切換。桌面版也應以目前版本提供的核心選項為準。更換核心後重新啟動服務，先查看啟動記錄，再測試連線；若出現未知欄位，應先處理相容性問題，而非反覆切換路由。
PLATFORM SELECTOR
挑選安裝檔時，先確認作業系統與處理器架構，再選擇安裝格式。桌面平台使用 v2rayN，Android 建議先查看 v2rayNG；需要相容 V2Fly 核心時，可考慮 v2flyNG。下載頁整理了各平台的下載入口與安裝需求。
初次安裝可先查看桌面版，它採用跨平台介面；熟悉傳統視窗配置的使用者，也可以選擇 WPF 版。兩種介面都需要正確的伺服器設定，不能只憑介面外觀判斷是否支援某種協定。安裝前請前往系統「設定 → 系統 → 系統資訊」確認系統類型，再從下載頁選擇對應的架構版本。
啟動後先匯入一組可用設定並選擇伺服器，再設定系統代理與路由模式。一般瀏覽器確認可正常連線後，再評估是否需要 Tun。若啟用 Tun 時出現權限不足提示，請依照提示以所需權限重新啟動，不要連續修改伺服器連接埠。更換安裝資料夾前請先備份設定，避免清理資料夾時遺失訂閱分組與自訂路由。
前往下載 →在 Apple 選單中開啟「關於這台 Mac」：顯示 Apple 晶片的裝置請選擇 Apple Silicon 安裝檔，顯示 Intel 處理器的裝置則選擇 Intel 安裝檔。選錯架構可能導致無法啟動，或需要額外的相容環境。安裝完成後先啟動用戶端，確認介面與記錄檔視窗都能正常開啟，再匯入訂閱。
若程式已成功啟動，但瀏覽器仍未透過代理連線，請先核對目前網路服務的代理設定，再檢查瀏覽器是否使用獨立的代理擴充功能。無線網路與有線網路可能使用不同的系統設定。遇到系統安全性提示時，先確認下載來源與提示內容，再依照系統提供的授權方式操作；不要將關閉系統防護當作一般安裝步驟。
前往下載 →多數較新的 Android 手機適用 arm64 套件；若不確定裝置架構，或安裝時明確提示套件不相容，可查看通用版。建議優先選擇採用 Xray 核心的 v2rayNG；需要相容 V2Fly 核心時，再考慮 v2flyNG。兩款用戶端的分組、應用程式設定與連線狀態各自獨立儲存，安裝另一款後仍需重新確認設定。
首次連線時會出現系統 VPN 授權提示，確認後用戶端才能透過該介面接管流量。若正在使用其他 VPN 類工具，請先中斷連線再測試。若螢幕亮起時可用、鎖定後便中斷，通常可檢查電池最佳化、背景活動限制與省電策略。應用程式分流也可能排除特定程式，因此瀏覽器可用不代表每個應用程式都會走相同出口。
前往下載 →先確認發行版使用的套件格式：Debian、Ubuntu 等系統通常選擇 deb，Fedora 等系統通常選擇 rpm；接著確認 x64 或 arm64 架構。套件格式與處理器架構是兩回事，請勿混為一談。圖形用戶端需要合適的桌面執行環境；精簡系統或僅提供遠端終端機的環境，應先確認是否能執行圖形介面。
不同桌面環境的系統代理實作方式各有差異。設定自動代理後，請確認應用程式是否讀取桌面代理設定；終端機程式也可能需要另外設定代理。Tun 涉及虛擬介面與權限，請依目前發行版及用戶端的需求設定。核心無法啟動時，先查看記錄中的連接埠占用、資源路徑或權限錯誤，避免將執行環境問題誤判為訂閱失效。
前往下載 →下載用戶端只完成本機工具的準備。連線仍需要有效的伺服器參數或訂閱網址；用戶端安裝檔本身不會提供可用伺服器。訂閱網址可能包含存取憑證，截圖、求助或分享記錄檔前，請先遮蔽網址與身分資訊。
查看所有用戶端 →PROJECT V / CORE / CLIENT
了解用戶端與核心各自負責的工作，有助於避免遷移設定時誤判。介面負責管理參數，核心負責執行網路連線；訂閱服務提供參數，路由規則決定請求的去向。這些環節出錯時，檢查入口各不相同。
Project V 是以網路代理工具為核心的開源專案體系，V2Ray 是其中常見的核心名稱。V2Fly 延續相關社群的開發路線，維護 V2Ray 核心及配套功能。日常所說的「V2Ray 用戶端」，通常是指具有圖形介面的管理工具，而非獨立執行的核心程式。區分兩者，才能判斷功能是由介面選單設定，還是取決於底層核心是否支援。
核心通常負責入站監聽、出站連線、路由比對與 DNS 等處理。圖形用戶端則將這些選項整理成伺服器編輯欄位、訂閱分組與參數設定。使用者儲存介面選項後，用戶端會產生或調整核心所需的設定，再啟動服務。因此，匯入成功只代表介面能識別連結，不代表遠端參數正確，也不代表核心已成功執行。
Xray 從 V2Ray 生態發展而來，在協定與傳輸能力方面持續演進。VLESS、VMess、Trojan 等名稱代表不同協定，REALITY 則涉及連線安全機制，不能將這些標籤都視為可互換的節點類型。伺服器使用哪種組合，本機就必須搭配相符的協定、傳輸方式、安全參數與核心功能。
遷移設定時，請優先逐項核對位址、連接埠、使用者識別碼、傳輸方式、TLS 或 REALITY 參數。部分欄位只能由特定核心使用，而且用戶端介面未必提供所有選項。若出現「未知欄位」或不支援的安全類型，應先確認相容性。任意清除 SNI、關閉憑證驗證或改寫傳輸路徑，可能讓原本明確的問題更難排查。
v2rayN 是桌面圖形用戶端，適合在同一個視窗中管理伺服器、訂閱、系統代理與路由。v2rayNG 適用於 Android，透過系統 VPN 介面接管應用程式流量，並採用 Xray 核心；v2flyNG 則提供另一種選擇，適合需要 V2Fly 核心的 Android 使用情境。三個專案的功能更新時程各不相同，不能直接將某款用戶端的選單路徑套用到另一款。
這三款用戶端皆以 GPL-3.0 授權開源，核心與附加元件則須分別查閱各自的授權說明。開源授權規定程式碼的使用、修改與再散布條件，不能取代伺服器服務條款，也不會決定連線品質。用戶端軟體可以免費使用，但伺服器、訂閱或其他網路服務是否收費，仍應依照服務提供者的規定。
用戶端更新可能同時變更介面、設定產生方式與核心功能。升級前請保留訂閱分組、自訂路由與重要參數，並記下目前可正常連線的設定。更新後，先使用相同伺服器、路由與網路進行測試，再逐項啟用新功能。如此便能分辨問題來自更新變更或伺服器本身波動，而不必一次更動所有條件。
查看更新說明時，優先留意設定遷移、系統需求、核心調整與已知問題，不要只比較版本號。遇到異常時，記錄檔中的第一條錯誤通常比後續重複訊息更有參考價值。尋求協助前，可整理作業系統平台、用戶端類型、操作步驟與已排除的情況，但請移除訂閱網址、使用者識別碼及其他連線憑證。詳細流程請參閱排查手冊。
TECHNICAL NOTES
技術筆記依各項設定深入說明。若已能正常連線，只需調整流量去向，請先查看路由規則；若用戶端提示服務啟動失敗，則先檢查記錄檔與設定錯誤。啟動錯誤尚未排除前，不要反覆更換分流方案。
核心啟動失敗時，該如何看懂記錄檔中的錯誤訊息？本文依照連接埠占用、JSON 語法錯誤、未知欄位與 geo 檔案缺失四種情況，逐一說明定位與修復方式。先排除啟動問題，再測試伺服器連線。
閱讀技術筆記 →以中國大陸網站直連、境外網站走代理、封鎖廣告網域為目標，逐步設定路由規則集。搭配規則順序與網域策略判斷請求去向，避免範圍過廣的規則提前命中，導致後續特定規則無法生效。
閱讀技術筆記 →了解 domain:、full:、regexp:、geosite:、geoip: 等比對方式，以及由上而下的規則優先順序。新增自訂網域前，先確認比對範圍，再檢查規則所參照的資料檔是否可用。
閱讀技術筆記 →