確認用戶端已安裝且能正常開啟
桌面裝置使用 v2rayN，Android 裝置使用 v2rayNG。首次開啟時，系統可能會詢問網路存取權限；依照系統提示完成授權即可。若尚未安裝用戶端，請先前往安裝套件頁面選擇目前平台對應的版本。安裝完成後返回本頁，從匯入訂閱開始操作。
// QUICK START
v2rayN 使用教學：從訂閱匯入到連線驗證
依介面順序完成四個動作：匯入訂閱、選擇代理模式、連線節點、驗證存取。首次設定通常可在十分鐘內完成。
適用用戶端 v2rayN / v2rayNG
操作階段 4 步
建議時間約 10 分鐘
開始前檢查：用戶端、訂閱網址與本機網路
先確認三個基本條件，後續操作會更容易找出問題。
準備完整的訂閱網址
訂閱網址通常由服務提供者提供，是一段以 https:// 開頭的連結。複製時請保留完整內容，不要遺漏結尾參數，也不要把瀏覽器網址列中的登入頁面網址誤當成訂閱網址。訂閱連結可能包含帳戶識別資訊，建議只保存在自己的裝置與密碼管理工具中。
確認目前網路可以正常存取一般網頁
在用戶端建立連線之前，本機仍需要可用的基礎網路。先關閉舊的代理工具，再用瀏覽器開啟平時可以直接存取的網站。如果一般網頁也無法開啟，應先恢復 Wi-Fi、有線網路或行動網路連線。如此可將基礎網路故障與用戶端設定問題分開處理。
三個條件都符合後，讓訂閱網址保持可複製狀態，進入第一步。
匯入訂閱並建立伺服器清單
匯入訂閱的目的不只是儲存一條連結，而是讓用戶端讀取連結內容，並在伺服器清單中建立可選擇的節點。
v2rayN 桌面版操作
開啟 v2rayN 主視窗，在頂端選單中找到「訂閱群組」或類似的訂閱管理入口。選擇新增訂閱群組後，會出現名稱與網址輸入區域。名稱僅供本機辨識，可填寫服務名稱、用途或地區群組；在網址欄貼上剛才準備好的完整訂閱連結。檢查連結開頭與結尾沒有多餘空格後儲存。
儲存群組只是記錄訂閱來源，下一步還要執行更新。回到「訂閱群組」選單，選擇更新目前訂閱，或在群組清單中對剛建立的項目執行更新。用戶端會要求訂閱內容並解析伺服器設定。更新完成後，主視窗的伺服器清單應出現一筆或多筆記錄，常見欄位包括別名、位址、連接埠、協定、傳輸方式與訂閱群組。
如果清單原本已有其他伺服器，請先查看「訂閱群組」欄，確認新出現的記錄屬於剛新增的群組。不要只憑節點名稱判斷匯入結果，因為不同訂閱可能使用相似名稱。只要新群組下已出現伺服器記錄，此步驟就完成了，暫時不需要修改各節點的協定欄位。
v2rayNG Android 版操作
開啟 v2rayNG，進入側邊選單中的訂閱設定。點選新增按鈕，填寫方便辨識的備註名稱，再將完整訂閱網址貼到網址欄並儲存。返回訂閱清單後，確認剛新增的項目處於啟用狀態。接著執行「更新訂閱」，等待頂端提示更新完成。
更新成功後返回用戶端首頁，節點清單會顯示由訂閱解析出的伺服器。清單通常會標示節點名稱，目前選取的項目會呈現選取狀態。此時不要立刻反覆點選連線按鈕，先確認清單確實有內容，且訂閱更新沒有顯示解析失敗、網址無法使用或回傳內容為空等提示。
辨識正常匯入結果
正常結果應同時符合兩點：訂閱群組已儲存在用戶端中，伺服器清單也出現屬於該群組的節點。如果只有群組名稱而沒有伺服器記錄，表示用戶端尚未成功取得或解析訂閱內容；如果伺服器已經出現，就不必再次新增相同網址，否則容易產生重複群組與重複節點。
訂閱不是一次性匯入的檔案。伺服器端調整節點後，應在原有群組上執行更新，而不是重新建立同名群組。之後遇到所有節點都無法使用時，也可以先更新現有訂閱，再判斷是否屬於連線問題。現在伺服器清單已準備好，下一步是決定哪些流量交由用戶端處理。
選擇代理模式與路由範圍
代理模式決定用戶端如何接管應用程式流量；路由規則則決定接管後的請求要經過代理，還是維持直連。
首次設定先使用容易觀察的組合
第一次操作建議先選擇「系統代理＋規則分流」這個組合。系統代理會將遵循作業系統代理設定的應用程式交由 v2rayN 處理，規則分流則依網域、位址或預設規則決定請求出口。這個組合的影響範圍清楚，瀏覽器通常可直接用於驗證，也方便在發生問題時檢查系統代理是否已開啟。
「全域」通常表示絕大多數已接管的流量都經過目前節點；「規則」表示依路由規則區分直連與代理；「直連」則讓請求繞過代理。不同版本的介面可能使用「全域」「略過區域網路和中國大陸位址」「清除系統代理」等類似名稱。此處不需要逐一研究所有規則，只要先選擇用戶端提供的常用規則模式，並確保系統代理不是關閉狀態。
v2rayN 桌面版設定
在 v2rayN 主視窗底部狀態列或系統匣選單中找到「系統代理」選項，選擇自動設定系統代理或設定系統代理。完成後，狀態列的對應文字應從未啟用切換為已設定。接著開啟「路由」或「路由設定」，選擇現成的規則分流方案。儲存後返回主視窗，查看底部是否同時顯示目前的系統代理狀態與路由模式。
如果只打算讓單一支援代理設定的應用程式使用用戶端，也可以維持系統代理關閉，再由應用程式手動填寫本機代理連接埠。但這種方式需要額外確認協定類型與監聽連接埠，不適合作為首次上手方式。本教學先使用系統代理完成整條連線鏈路，確認正常後再考慮依應用程式個別設定。
v2rayNG Android 版設定
v2rayNG 建立連線時會透過系統網路連線設定接管流量，因此沒有與桌面版完全相同的「設定系統代理」按鈕。進入設定或路由設定，選擇用戶端提供的規則模式即可。首次使用可維持其他進階參數的預設值，不要同時修改本機 DNS、分應用程式代理、流量探測與底層傳輸選項，否則一旦失敗，很難判斷是哪項變更造成影響。
點選連線時，系統可能會跳出網路連線授權視窗。確認應用程式名稱無誤後允許連線，授權通常只會在首次使用或系統設定變更後出現。完成授權不代表節點一定可用，它只允許用戶端建立本機接管通道；實際連線狀態仍要在下一步透過按鈕狀態與執行日誌確認。
何時再考慮 TUN 模式
部分桌面應用程式不讀取系統代理，遊戲啟動器、命令列工具或採用獨立網路堆疊的軟體也可能繞過系統代理。此時可以進一步了解 TUN 模式，讓用戶端從更底層接管流量。不過 TUN 涉及虛擬網路介面、DNS 處理、管理員權限與路由優先順序，不適合在基礎連線尚未驗證時直接啟用。
正確順序是先用系統代理確認訂閱與節點可以運作，再根據特定應用程式是否仍無法被接管，決定是否切換至 TUN。關於 TUN、DNS 與平台特有設定的系統說明，可閱讀完整文件。本頁繼續沿用基礎模式，進入節點選擇與連線。
選擇節點並啟動連線
完成訂閱與模式設定後，需要指定一部作用中伺服器，再觀察核心是否成功載入該節點設定。
先選定一個節點
節點名稱通常包含地區、線路或用途說明，但名稱本身不能證明目前連線品質。首次驗證時，從訂閱清單中任選一個一般節點即可，不必連續測試整份清單。若服務提供者提供推薦線路，可優先選擇推薦項目；如果沒有說明，選擇地理距離相對較近的節點通常更方便完成基礎測試。
不要在連線過程中快速切換多個節點。每次更換作用中伺服器後，用戶端都需要重新載入設定並建立新連線，瀏覽器中的舊連線也可能暫時保留。頻繁切換會讓日誌混入多次啟動記錄，反而難以判斷某個節點是否真正失敗。
v2rayN 桌面版連線方式
在伺服器清單中點選目標節點，再透過右鍵選單選擇「設為作用中伺服器」；部分版本也支援雙擊直接設為作用中項目。作用中節點通常會出現顏色、圖示或列狀態變化。確認選擇後，從系統匣選單或主介面啟動服務，並維持上一步設定的系統代理狀態。
接著查看主視窗底部狀態列與日誌區域。正常啟動時，日誌會顯示載入設定、啟動核心與本機監聽相關記錄，狀態列會保留目前作用中伺服器的名稱。若日誌立即出現連接埠被占用、設定欄位錯誤或程序啟動失敗，表示連線尚未進入可驗證階段，應先處理對應錯誤，不要繼續重新整理瀏覽器。
如果視窗中看不到日誌區域，可從選單開啟日誌視窗或展開底部窗格。日誌用於確認程式執行到哪個步驟，不需要逐行理解。先留意最新幾行是否持續出現錯誤，以及錯誤是否在每次啟動時重複。偶爾出現一次連線重試不一定代表整體失敗，持續重複的同類錯誤才更值得檢查。
v2rayNG Android 版連線方式
在首頁節點清單中點選目標節點，使其成為目前選取項目。接著點選右下角的連線按鈕。首次連線出現系統授權提示時完成授權，按鈕狀態會隨連線過程變化，系統狀態區域也會出現正在執行的網路連線標示。返回節點清單後，目前節點應維持選取狀態；當執行時間或流量區域開始更新時，表示用戶端已進入工作狀態。
如果點選後立即恢復為未連線狀態，請開啟側邊選單中的日誌，查看最新啟動記錄。常見原因包括節點參數已變更、訂閱未更新、本機時間偏差過大、基礎網路切換，或目前節點暫時無法連線。先更新一次原有訂閱，再重新選擇節點連線；仍然失敗時，再換用同一訂閱中的另一個節點進行比對。
連線狀態與可存取狀態不是同一回事
用戶端顯示「已連線」通常表示本機接管通道與核心程序已啟動，但不等於每個目標網站都能成功開啟。節點遠端是否可連線、網域解析是否正常，以及應用程式是否讀取系統代理，都需要透過下一步驗證。現在先保持用戶端執行，不要結束系統匣程序，也不要切換代理模式。
驗證代理是否生效
驗證重點在於區分「用戶端已啟動」「應用程式已被接管」與「目標請求成功」這三個層次。
使用新的瀏覽器視窗測試
保持用戶端連線狀態，關閉用於前期檢查的舊頁面，再建立新的瀏覽器視窗。先開啟平時可以直接存取的網站，確認基礎網路沒有因代理設定而中斷；接著造訪需要目前節點處理的目標網站。使用新視窗可以減少舊連線、快取與已開啟頁面的背景請求對判斷結果造成影響。
如果兩類網站都能正常開啟，且用戶端日誌在造訪時出現新的連線記錄，表示訂閱、作用中節點、代理模式與應用程式接管已形成完整鏈路。此時不必繼續調整協定參數，可以將目前節點保留為常用伺服器，日後有需要時再更新訂閱。
透過日誌確認請求是否進入用戶端
當網頁無法開啟時，先觀察點選重新整理後日誌是否出現新記錄。如果日誌完全沒有變化，問題更可能位於應用程式接管階段：桌面版檢查系統代理是否仍為啟用狀態，Android 版檢查用戶端連線是否仍在執行。也可以完全結束瀏覽器後重新開啟，避免瀏覽器繼續沿用連線建立前的工作階段。
如果日誌出現目標網域或連線請求，但接著持續回報逾時、遠端拒絕或握手失敗，表示流量已進入用戶端，檢查重點應轉向節點狀態、訂閱是否過時與協定參數。先更新現有訂閱，再切換到同一群組中的另一個節點。一次只變更一個條件，測試結果才有比較價值。
如果部分網站正常、部分網站失敗，通常表示基礎連線已建立，差異可能來自路由規則、DNS 解析或目標服務本身。此時不建議重新安裝用戶端，也不需要刪除所有訂閱。記錄失敗網站、目前路由模式與日誌中的相關行，再前往疑難排解依故障類型繼續檢查。
依固定順序處理失敗
- 確認基礎網路：暫時中斷用戶端後，檢查一般網頁是否可以存取。基礎網路異常時，先恢復本機網路連線。
- 更新現有訂閱：不要重複建立群組，直接對目前群組執行更新，確認伺服器清單中仍有節點。
- 更換一個節點：維持代理模式不變，只替換作用中伺服器，再使用相同網站測試。
- 檢查接管狀態：桌面版查看系統代理，Android 版查看執行中的連線，確認應用程式流量確實進入用戶端。
- 閱讀最新日誌：只查看本次連線後的記錄，依據逾時、解析、連接埠或設定提示選擇下一項檢查。
這套順序由外而內逐層排除問題，能避免同時修改多項設定。若某一步恢復正常，就停止繼續變更並重新驗證。需要處理本機時間、連接埠衝突、DNS、TUN 或複雜路由時，再進入完整文件查閱對應章節。
完成基礎連線後的日常操作
維持設定簡單，訂閱更新、節點切換與日誌檢查就足以應付多數日常使用情境。
更新訂閱
節點名稱、位址或參數發生變更時，請在原有訂閱群組上執行更新。更新後確認作用中伺服器仍然存在；若原節點已被移除，從新清單中選擇一個節點即可。重複新增相同網址會增加整理清單的成本。
切換節點
先將新節點設為作用中伺服器，等待用戶端完成重新載入，再使用新的瀏覽器視窗測試。切換期間短暫中斷屬於連線重建過程，不要連續點選多個節點。
結束連線
桌面版結束前，先關閉系統代理或從系統匣選單停止服務，再結束用戶端程序。Android 版使用連線按鈕中斷目前連線。如此可讓系統網路狀態明確恢復為直連路徑。
保留排查資訊
發生異常時，記錄用戶端名稱、目前模式、節點群組、發生時間與最新日誌提示。清楚的背景資訊比反覆重新安裝更有助於找出問題，也方便在疑難排解中找到對應分支。