setup / first connection
v2rayN 設定教學
從訂閱匯入到連線驗證
依固定順序完成四項操作：匯入訂閱、選擇代理模式、連線設定、驗證結果。每個步驟都說明入口位置、正常狀態，以及進入下一步前需要確認的內容。
before / setup
開始前準備
準備一個有效的訂閱網址，並確認用戶端已完成安裝。首次設定不需要手動編輯 config.json，也不必先調整進階路由欄位。
訂閱網址通常由服務提供者提供，用來讓用戶端讀取一組連線設定。複製時應保留完整網址，不要夾帶前後的空格、換行或說明文字。訂閱屬於個人設定資料，不適合貼到公開頁面、截圖或聊天記錄中。若手上只有單筆 VMess、VLESS 或其他分享連結，也可以使用用戶端的「從剪貼簿匯入」入口，但本頁以較常見的訂閱群組方式為主。
開啟用戶端後，先確認主介面能否正常顯示。v2rayN 桌面版通常會看到伺服器清單、功能表列以及視窗底部的狀態區域；v2rayNG Android 版通常會看到設定清單和連線控制區域。此時清單為空屬於正常情況，因為訂閱尚未寫入。若用戶端無法啟動、視窗開啟後立即關閉，或系統提示缺少執行環境，應先返回下載頁核對平台與安裝套件類型，再繼續本教學。
首次設定建議暫時保留用戶端的預設連接埠、預設 DNS 與預設路由規則。一次只修改一個關鍵項目，更容易判斷問題出在哪個環節。完成本頁四個步驟並確認基本連線有效後，再進入系統教學的路由分流章節調整網域規則、GeoSite、GeoIP 或 TUN 模式。
subscription / import
匯入訂閱
這個階段的目標不是立即連線，而是讓用戶端成功讀取訂閱，並在主清單中建立可選取的設定記錄。只有清單出現內容後，下一步的代理模式與連線操作才有明確對象。
v2rayN 桌面版：建立訂閱群組
開啟 v2rayN 主視窗，在頂端選單中找到「訂閱群組」或名稱相近的訂閱管理入口，接著進入「訂閱群組設定」。不同版本可能將入口放在「訂閱」選單下，也可能直接顯示為工具列按鈕。進入設定視窗後，點按新增，在備註或別名欄位填寫便於辨識的名稱，例如「常用訂閱」；在網址欄位貼上完整訂閱連結。名稱只用於本機辨識，不會影響連線結果。
填寫完成後點按確認或儲存，返回主視窗。此時只是儲存訂閱來源，伺服器清單不一定已經更新。再次開啟「訂閱群組」選單，執行「更新全部訂閱」，或選取剛建立的群組後執行更新。用戶端會讀取訂閱內容，並將解析出的記錄寫入伺服器清單。等待更新結束後，主視窗中應出現協定類型、位址、連接埠、別名等欄位；實際欄位數量會隨版本與視窗寬度變化。
如果更新後清單仍然是空的，先返回訂閱群組設定，檢查網址開頭和結尾是否含有空格，再確認訂閱群組處於啟用狀態。若狀態列顯示訂閱讀取失敗，不要持續修改代理模式，因為目前問題發生在取得設定的階段。可以先到服務提供者的管理頁面重新複製網址，再覆蓋原有內容並執行一次更新。更完整的訂閱錯誤分類請參閱系統教學中的訂閱管理。
v2rayNG Android 版：新增並更新訂閱
開啟 v2rayNG，進入側邊選單或右上角選單，找到「訂閱群組設定」。點按新增按鈕，在備註欄輸入群組名稱，在可選網址欄貼上訂閱連結，然後儲存。返回設定清單後，從選單中選擇「更新訂閱」。如果頁面中有多個訂閱群組，應先確認目前更新的是剛新增的群組，避免誤把舊群組的內容當成新訂閱結果。
更新完成後，設定清單會出現一筆或多筆記錄。每筆記錄通常會顯示名稱以及協定相關資訊。此時先不要點按連線按鈕，先確認清單不是空白，並檢查記錄名稱是否大致對應訂閱來源中的命名。若同一批記錄重複出現，通常是重複新增了相同網址，可以進入訂閱群組設定刪除多餘群組，再更新一次清單。
routing / mode
選擇代理模式
代理模式決定哪些流量交由目前的設定處理。首次使用建議從規則分流開始：常見的本地網站與區域網路位址維持直連，需要代理的請求再交給活動伺服器。這樣較容易兼顧存取範圍與日常應用程式的相容性。
先區分兩個容易混淆的設定
v2rayN 桌面版通常同時有「系統代理」和「路由模式」兩組設定。系統代理決定瀏覽器及遵循系統代理設定的應用程式是否將流量送入 v2rayN；路由模式則決定流量進入核心後，走代理出站、直連出站，還是阻斷出站。只修改路由模式卻未啟用系統代理，瀏覽器可能仍會直接存取；只啟用系統代理但選錯路由規則，則可能導致部分網站的結果與預期不符。
v2rayNG Android 版連線時會建立系統層級的本機連線通道，路由設定負責決定流量如何分配。介面中的「預先定義規則」、「路由設定」或名稱相近的選項，都屬於這個階段。首次使用不建議立即啟用複雜的分應用程式控制，也不建議匯入多套自訂規則。先用一套清楚且可重現的規則完成連線，確認成功後再逐項擴充。
三種常見模式怎麼選
在 v2rayN 中，先從路由設定選擇一套規則分流方案，再從系統匣圖示或主視窗的系統代理選單中選擇「自動設定系統代理」或意思相同的選項。不要選擇「清除系統代理」，因為這會讓大多數瀏覽器繞過用戶端。若只希望某個手動設定 SOCKS 或 HTTP 代理的程式使用 v2rayN，可以維持系統代理不變，但這種方式需要另外填寫本機監聽連接埠，不適合作為首次設定流程。
在 v2rayNG 中，進入設定中的路由設定，優先選擇用戶端提供的預先定義規則。返回主清單後，確認沒有同時啟用互相衝突的分應用程式規則。全域代理可以作為排查工具：如果規則分流下某個目標無法存取，而全域代理可以存取，問題較可能出在路由比對或規則資料；如果兩種模式都失敗，則應繼續檢查訂閱記錄、連線狀態與網路環境。
規則分流涉及 routing.rules、網域分類、IP 分類與出站標籤之間的關係。首次連線只需理解「比對後決定流向」這一點，不必在此展開所有欄位。需要自訂規則時，可前往路由分流系統教學逐段設定。
client / connect
連線設定
連線前需要完成兩個動作：選取一筆具體設定，並讓用戶端進入執行狀態。清單中有記錄不代表記錄已經在使用，活動項目、系統代理與核心執行狀態需要分別確認。
v2rayN 桌面版：設為活動伺服器
返回 v2rayN 主視窗，在伺服器清單中點選一筆記錄。首次測試時，優先選擇名稱清楚、來源明確的記錄，不要一次勾選多筆。選取後按 Enter，或使用右鍵選單中的「設為活動伺服器」。成功後，目前記錄通常會出現顏色、字型、選取標記或狀態列文字的變化，實際表現取決於用戶端版本。
接著檢查視窗底部或記錄區域。正常啟動時會看到核心開始執行、本機入站連接埠開始監聽等狀態資訊。這裡的連接埠通常由用戶端自動管理，首次使用不必手動修改。然後查看系統匣中的 v2rayN 圖示，確認系統代理處於自動設定狀態。若剛才已設定代理模式但之後重新啟動了用戶端，也應再檢查一次系統匣選單，避免系統代理狀態被手動切回直連。
若選取記錄後記錄立即出現連線失敗，不要快速輪換大量設定。先確認本機日期與時間正確，再在同一訂閱中選擇另一筆記錄進行一次對照。只有某一筆失敗時，問題較可能與該筆記錄有關；所有記錄都失敗時，應檢查訂閱是否過期、網路是否可用，以及本機連接埠是否衝突。連接埠衝突的定位方法請參閱系統教學的本機連接埠章節。
v2rayNG Android 版：選取設定並啟動
在 v2rayNG 設定清單中點按一筆記錄，讓它成為目前設定。被選取的記錄通常會出現單選標記或反白狀態。接著點按頁面底部的連線按鈕。首次啟動時，系統會顯示連線授權視窗，核對應用程式名稱後確認。授權只負責允許用戶端建立本機連線通道，不會取代訂閱設定本身。
連線成功後，底部按鈕狀態會改變，系統狀態區域也會出現連線中的標示。返回 v2rayNG 主介面，確認目前設定名稱仍是剛才選取的記錄。如果點按連線後很快恢復為未連線狀態，應開啟記錄查看最後幾行錯誤，而不是重複點按按鈕。常見原因包括設定不可用、切換網路後連線中斷、訂閱記錄參數不完整或系統時間偏差。
從無線網路切換到行動網路，或從行動網路切回無線網路後，既有連線可能需要重新建立。切換網路時先觀察用戶端狀態；若連線標示消失，返回主介面重新點按連線。不要同時執行多個負責相同系統代理工作的用戶端，否則應用程式流量可能被不同的本機連接埠重複接管，導致驗證結果不穩定。
network / verify
驗證代理是否生效
按鈕顯示已連線，只能表示用戶端進入執行狀態；最終驗證仍要看實際應用程式流量是否經過預期路徑。驗證應從新開啟的瀏覽器視窗開始，再延伸到其他應用程式。
先建立連線前後的對照
開啟新的瀏覽器視窗，透過搜尋引擎查詢「目前 IP 位址」，記錄頁面顯示的出口資訊。接著保持用戶端執行，重新整理查詢頁面或重新開啟一個視窗。若出口結果出現符合預期的變化，表示瀏覽器流量已進入用戶端。使用規則分流時，不同查詢頁面可能由不同規則處理，因此應結合用戶端記錄判斷，而不要只依賴單一頁面。
v2rayN 桌面版若顯示執行正常，但瀏覽器結果始終不變，優先檢查瀏覽器是否遵循系統代理。有些瀏覽器擴充功能會覆寫系統設定，也有些應用程式使用自己的代理參數。可以先關閉會改寫代理設定的瀏覽器擴充功能，再確認 v2rayN 系統匣選單中的系統代理狀態。如果瀏覽器曾手動填寫本機代理位址，應核對連接埠是否與用戶端目前的監聽連接埠一致。
v2rayNG Android 版連線後，可以先完全關閉瀏覽器再重新開啟，避免重用舊連線。若瀏覽器驗證正常而某個應用程式仍無法存取，應檢查該應用程式是否被分應用程式規則排除，或是否使用獨立的網路通道。不要立即修改訂閱內容，因為瀏覽器已成功表示訂閱、伺服器記錄與基礎連線鏈路大致正常，排查重點應轉向應用程式範圍與路由規則。
結合記錄判斷流量路徑
開啟用戶端記錄，接著在瀏覽器存取一個新頁面。正常情況下，記錄會新增連線資訊，並顯示目標網域、目標位址或比對到的出站標籤。記錄的價值在於區分「請求沒有進入用戶端」和「請求進入後連線失敗」：前者通常與系統代理、應用程式代理或連線授權有關；後者通常與伺服器記錄、路由規則、DNS 或網路環境有關。
如果記錄沒有任何新增內容，表示目前應用程式很可能沒有將流量交給用戶端。v2rayN 應再次核對系統代理開關與應用程式本身的代理設定；v2rayNG 應核對連線狀態以及分應用程式範圍。如果記錄有資訊，但出現逾時或無法建立連線，可以在同一訂閱中切換另一筆設定進行對照。切換時保持代理模式不變，避免同時改變兩個變數。
若網頁能夠開啟，但圖片、影片或部分網域載入失敗，常見原因是分流規則或 DNS 結果不一致。可以暫時改為全域代理進行一次對照：全域模式恢復正常，表示基礎連線可用，下一步應檢查規則比對；全域模式仍異常，則繼續檢查目前設定與網路狀態。完成對照後應恢復原定模式，避免長期將排查狀態當作日常設定。
確認其他應用程式是否符合預期
瀏覽器驗證通過後，再開啟一個平時需要連線的應用程式進行測試。v2rayN 的系統代理主要涵蓋遵循系統代理設定的程式，並不保證所有桌面程式都會自動使用；某些程式需要在自身設定中選擇「跟隨系統代理」，或手動填寫本機 HTTP、SOCKS 位址。需要接管更多類型的流量時，可以研究 TUN 模式，但應先閱讀系統教學中的 TUN 章節，了解權限、DNS 與路由變化後再啟用。
完成驗證的標準是：用戶端保持穩定執行，瀏覽器出口符合所選模式，記錄中能看到新請求，常用應用程式的存取範圍與預期一致。符合這些條件後，首次設定便已完成。之後更新訂閱時不必重做全部步驟，只需執行訂閱更新、確認活動記錄仍然存在，再進行一次簡短的連線驗證。
finish / checklist
首次設定完成檢查
依序核對以下狀態。前一項未通過時，先處理該項，不要跳到後面的進階設定。
-
訂閱清單中有設定
訂閱群組已儲存，更新操作可以正常完成，主清單中至少有一筆可選取的記錄。
-
代理模式與使用範圍一致
日常使用優先採用規則分流；排查規則時可短暫切換全域代理，測試結束後再恢復。
-
活動設定與執行狀態明確
v2rayN 已設定活動伺服器並啟用系統代理，或 v2rayNG 已選取設定並保持連線狀態。
-
完成實際流量驗證
瀏覽器出口、用戶端記錄與常用應用程式的存取結果能夠相互對應，而不是只觀察連線按鈕。
setup > completed
繼續設定路由與 TUN
首次連線完成後，再依實際需求學習訂閱維護、路由規則、DNS、TUN 模式與故障定位。系統教學按階段展開，不需要在首次設定時一次完成所有修改。
setup / quick answers
首次設定常見情況
訂閱更新成功，但清單裡沒有新增記錄，該怎麼辦？
先確認更新的是剛建立的訂閱群組，再檢查群組是否已啟用。接著重新複製完整訂閱網址，覆蓋舊網址並儲存。如果用戶端提示解析失敗，應向訂閱提供者確認網址狀態，不要透過修改代理模式來處理訂閱讀取問題。
為什麼用戶端顯示已連線，瀏覽器出口卻沒有變化？
v2rayN 需要確認系統代理已啟用，並檢查瀏覽器是否被擴充功能或手動代理設定覆寫。v2rayNG 可先完全關閉瀏覽器再重新開啟，接著檢查分應用程式規則。若用戶端記錄沒有新增請求，應優先排查流量是否進入用戶端。
規則分流和全域代理，哪一個適合長期使用？
日常使用通常選擇規則分流，讓不同目標依規則走直連或代理。全域代理較適合短時間對照測試，用來判斷問題是否來自路由比對。具體規則結構可在系統教學中繼續學習。
更新訂閱後需要重新設定所有選項嗎？
通常不需要。更新後確認原本的活動記錄是否仍存在，並檢查目前選取的設定。若訂閱提供者修改了記錄名稱或刪除了舊記錄，需要重新選取一筆設定，再執行一次連線與出口驗證。