CONFIGURATION / FIELD INDEX
先釐清應用程式入口、核心設定與遠端服務，再找出需要修改的欄位。
用戶端視窗負責儲存伺服器資料、整理訂閱群組並產生執行設定；核心則負責接收入站連線、判斷路由並建立出站連線。兩者屬於不同的設定層級。修改系統代理不等於修改路由，更新訂閱也不等於更新核心。排查問題時，先判斷問題發生在哪一層，再查看相應的設定頁面或記錄，避免反覆重新安裝，或同時修改多個選項而增加干擾。
REFERENCE CATALOGUE
JSON 是理解設定結構的共同起點，但不代表同一個檔案可以直接跨核心通用。用戶端、核心與協定各有適用範圍，即使欄位名稱相同，也應核對欄位值與版本文件。
初次使用可先透過圖形介面完成訂閱與系統代理設定；需要調整網域分流、本機監聽或 DNS 行為時，再對照欄位手冊閱讀產生的設定。不要把完整執行設定當成一般訂閱連結匯入，也不要將用戶端備份檔誤當作核心設定檔。
查看 JSON 手冊 →路由處理的是已進入核心的流量。先為出站設定明確標籤，再讓規則依網域、位址或連接埠比對對應出口；多條規則重疊時，範圍較小的例外應排在前面。系統代理只會影響遵循該設定的應用程式，無法取代路由規則。網站走錯出口時，先查看符合的規則，再檢查預設出站與網域解析策略。相較於逐一切換伺服器，依規則分流能維持固定的流量走向，但仍需定期維護規則資料。
匯入訂閱可透過連結讀取伺服器資料，適合需要定期同步的設定集合。先新增群組並儲存訂閱網址，再執行更新；確認伺服器清單已顯示實際項目後，選取要使用的伺服器。更新失敗時，應分辨是連結過期、回傳內容格式不符，還是連線要求失敗，而非反覆匯入同一個網址。訂閱通常只更新所管理的伺服器資料，不會統一管理所有本機設定；監聽連接埠、系統代理與自訂路由仍須另外檢查。訂閱網址具有存取權限，不應公開分享。
用戶端介面顯示協定類型，不代表目前執行的核心支援該項目的所有選項。必須一併核對協定、傳輸方式、安全層與核心功能，尤其是使用特定安全機制的設定。v2rayNG 主要採用 Xray 核心，v2flyNG 則使用 V2Fly 核心；桌面用戶端的實際行為，取決於所選核心與設定。相較於只看伺服器名稱，核對這些結構欄位更能找出匯入成功卻無法連線的原因。切換核心前請保留原有設定，避免把相容性問題誤判為網路問題。
入站設定本機監聽位址、連接埠及接收連線的協定。僅供本機使用時，應優先保留迴路位址；需要從區域網路存取時，再配合防火牆與存取控制調整。流量識別可為部分連線補上目標網域資訊，協助路由比對，但不能取代完整的網域解析設定。相較於系統代理，入站屬於核心的接收層；若連接埠已被占用，即使能開啟用戶端視窗，入口也可能尚未建立。修改監聽連接埠後，記得同步更新手動填入該連接埠的應用程式。
DNS 設定決定核心如何查詢網域，但應用程式或作業系統可能仍使用各自的解析路徑。排查解析失敗時，先判斷要求由誰發出，再檢查解析伺服器是否可連線，以及查詢策略是否適合目前網路。路由中的網域策略會影響比對階段是否嘗試解析；出站的目標解析也可能另有設定，因此不能只修改一個伺服器位址，就認定所有流量都已改變。相較於直接使用 IP 位址連線，保留網域名稱有助於網域規則生效；是否採用則應依實際設定與核心行為判斷。
傳輸方式、安全層與伺服器身分驗證是不同的設定面向。使用 TLS 時，請確認伺服器名稱、憑證鏈與系統時間；使用 REALITY 時，應依伺服器端資料填寫相應參數，不要整段照搬 TLS 範例。遇到憑證錯誤時，先記錄具體錯誤並核對名稱與時間，不應把略過驗證當成一般解法。相較於只修改協定名稱，逐項核對傳輸欄位更能找出設定不一致之處；排查完成後也應再次檢查記錄，確認實際使用的是預期設定。
CLIENTS / PLATFORM DIRECTORY
先確認作業系統與處理器架構，再選擇用戶端及安裝套件格式。
桌面平台使用 v2rayN，Android 平台則依核心需求選擇 v2rayNG 或 v2flyNG。下載中心集中提供安裝套件入口與選擇說明，本頁不列出特定版本。首次安裝前，建議先查看系統資訊中的架構名稱；套件格式、處理器類型與圖形介面類型是不同面向。檔案能下載，不代表適用於目前裝置。
v2rayN 提供桌面版與經典 WPF 版兩種介面。桌面版採用跨平台介面，WPF 版則沿用經典桌面操作方式；選擇時先考量熟悉的介面與目前系統環境，不要把兩種介面誤認為不同協定。安裝後，透過圖形介面匯入訂閱、選取使用中的伺服器，再檢查本機監聽與系統代理。
已有設定的裝置，應先在用戶端備份資料，再決定是否切換介面。首次執行時若出現相依元件提示，請依指示確認執行環境；若發生連接埠占用，則查看記錄與監聽設定，不必直接重新安裝。關閉用戶端前停用系統代理，可避免應用程式繼續連往已停止的本機入口。安裝步驟請參閱初次使用教學。
前往下載v2rayN 安裝套件分為 Apple Silicon 與 Intel 版本。先在「關於這台 Mac」查看晶片或處理器資訊，再前往對應的下載入口；不要只憑裝置外觀或購買年份判斷。安裝後確認應用程式位於預期資料夾，並依系統實際提示完成首次開啟的安全檢查；啟動失敗不一定是網路連線問題。
匯入訂閱後，先確認已選取使用中的伺服器，再設定所需的代理方式。系統代理只對遵循系統設定的應用程式生效，部分程式需要在自身設定中填入代理資訊。從休眠狀態喚醒、切換網路或關閉用戶端後若發生連線異常，可先查看代理開關與本機入口是否一致，再檢查遠端連線記錄，避免同時修改多個層級。
前往下載v2rayNG 使用 Xray 核心，是下載中心優先推薦的 Android 用戶端；v2flyNG 使用 V2Fly 核心，是對應生態的替代選擇。較新的主流裝置通常選擇 arm64；無法確認裝置架構時，可查看通用套件入口與系統資訊。兩款用戶端使用不同核心，即使匯入相同資料，仍應確認核心是否支援相應的協定與傳輸選項。
首次建立連線時，須確認系統 VPN 授權。若裝置上已有其他 VPN 類應用程式在執行，應先確認是否有服務衝突。訂閱更新成功只代表已取得資料，不代表已選取使用中的伺服器或建立連線；連線後仍須根據記錄與實際連線狀況確認。若背景執行遭中斷，可查看系統電池管理設定；延遲測試結果不應作為判斷連線能否持續的唯一依據。
前往下載v2rayN 提供 deb 與 rpm 套件，並依處理器區分 x64 和 arm64。選擇時須同時確認發行版的套件系統與裝置架構，不能只看其中一項。桌面圖形用戶端也需要可用的圖形環境；套件管理工具提示缺少相依元件時，應先依目前發行版的說明補齊環境，再嘗試啟動應用程式。
不同桌面環境處理系統代理的方式可能不同，瀏覽器與其他應用程式也可能有各自的代理設定。匯入完成後，可先在目標應用程式中確認本機入口位址與連接埠，再逐層檢查系統設定。監聽預設應維持在本機範圍；確實需要區域網路存取時，再設定防火牆與權限。安裝成功、核心啟動，以及應用程式流量進入代理，應分別確認。
前往下載PROJECT V / CORE FAMILY
開源專案、執行核心與圖形用戶端，分別說明設定從何而來、連線如何處理，以及使用者在哪裡操作。
Project V 是以代理與網路工具為核心的開源專案生態，V2Ray 則是其中廣為使用的名稱。設定結構將入口、出口、路由、解析與策略分開描述：入站接收本機應用程式連線，出站定義連線目標的方式，路由則在兩者之間選擇路徑。理解這些層級，比記住特定按鈕的位置更有助於在不同用戶端間閱讀設定，也能協助判斷問題出在本機接收階段還是遠端連線階段。
圖形用戶端通常會依介面設定產生核心執行設定，因此不了解儲存機制前，不宜直接編輯產生的檔案。重新啟動、切換伺服器或更新設定後，這類修改可能會被覆蓋。若要長期保留自訂規則，應優先使用用戶端提供的規則管理或自訂設定入口，並記錄設定由哪一層管理。閱讀手冊時也要區分示範片段與完整檔案，單一欄位無法涵蓋整個連線流程。
V2Fly 社群延續 V2Ray 核心專案的開發與維護；Xray 則是以相關程式碼為基礎發展出的另一條核心路線。兩者的設定結構有共同背景，但協定能力、欄位細節與新增功能並非始終一致。REALITY 等特定功能須依實際核心支援情況判斷，不能因用戶端顯示某個名稱，就預設所有參數在另一個核心中也有效。
排查相容性時，應一併記錄用戶端名稱、執行核心、協定、安全層與傳輸方式。只說「使用 V2Ray」不足以重現問題。匯入後沒有項目，先檢查內容格式；核心無法啟動，查看欄位與相依元件；若核心已啟動但連線失敗，再核對伺服器端參數與網路環境。分階段檢查有助於對照記錄與操作，也能避免把所有錯誤都歸為同一種原因。
v2rayN、v2rayNG 與 v2flyNG 都是開源圖形用戶端。開源表示程式碼依各自專案的授權條款提供；使用、修改與再散布時，應遵守相應規定。用戶端程式碼、核心程式碼及隨附元件可能適用不同授權，不能以單一專案的授權概括所有元件。開源也不代表任何設定都適合實際用途；網路存取權限與服務使用規範仍須分別確認。
三款用戶端的重點是透過圖形介面管理設定與連線操作，並不提供遠端伺服器。安裝軟體後，仍須準備合法且可用的伺服器資料或訂閱內容。訂閱來源負責服務位址、有效期限與存取權限；用戶端則負責讀取及使用這些資料。本網站整理下載資訊與技術說明，不提供連線憑證；分享設定截圖或記錄前，請先移除訂閱網址、使用者識別資訊及其他存取資料。
用戶端更新主要涉及介面、設定產生邏輯與整合功能；核心更新涉及連線處理與協定實作；訂閱更新則是同步伺服器項目。三者不是同一項操作的不同名稱，也不能互相取代。訂閱失效時，升級用戶端未必有幫助；核心不支援某個欄位時，反覆更新訂閱也無法補足功能。更新前先釐清要解決的問題，再選擇相應的更新方式。
變更環境前，請保留可還原的設定備份，並記下原本使用中的伺服器、路由模式與監聽設定。更新後先確認能否正常啟動，再測試訂閱讀取與實際連線。自訂 JSON 尤其要留意欄位變更與預設行為差異；遇到錯誤時，應回頭查看具體記錄，不要一次停用所有驗證或刪除全部規則。下載中心提供安裝套件選擇，操作步驟與欄位說明分別收錄於教學和JSON 手冊。
建議閱讀順序：首次安裝先看教學，遇到陌生名稱時查閱術語表，需要修改設定時再依欄位查閱手冊。連線問題涉及多個層級時，保留最精簡的重現步驟，比反覆切換設定更容易找出原因。
TECHNICAL NOTES / RECENT ENTRIES
從代理模式、伺服器選擇與本機連接埠三個方向，釐清設定問題與連線問題。
技術筆記依實際操作情境整理，不必先讀完所有設定欄位。閱讀時先確認錯誤發生在哪個階段，再選擇相應文章：應用程式未經代理連線時，查看代理模式；不同伺服器表現不一時，查看選擇方式；核心無法監聽時，查看連接埠排查。單次測試只反映當下條件；修改設定後，應以相同方式重新測試並記錄前後差異。
使用系統內建指令找出占用本機監聽連接埠的程序，並說明如何在參數設定中修改 socks 與 http 連接埠，以及系統代理和瀏覽器需要同步調整的項目。
閱讀技術筆記 →說明實際連線延遲與 TCP 延遲測試的差異，並依倍率計費、地區距離，以及 VLESS、VMess、Trojan 等協定特性，整理挑選節點的判斷順序。
閱讀技術筆記 →說明系統代理開關與路由模式是兩個不同層級的設定，比較全域、繞過中國大陸與直連三種路由的流量走向，並依使用情境說明如何搭配。
閱讀技術筆記 →