FIRST RUN
首次連線
採用一般系統代理或標準連線入口，路由保留預設設定，先驗證基本鏈路。
// QUICK SETUP · 10 MIN
v2rayN 設定教學：從訂閱匯入到連線驗證
依固定順序完成四件事：匯入訂閱、選擇代理模式、建立連線、驗證結果。每一步都說明入口位置、正常介面應出現的內容，以及進入下一步前需要確認的狀態。
// PREPARATION
開始前檢查：客戶端、訂閱連結、本機網路
開始設定前，先確認客戶端可以正常開啟。桌面版啟動後應能看到主視窗或系統匣圖示，Android 版啟動後應進入設定清單頁面。首次執行時清單為空屬於正常狀態，因為客戶端尚未取得任何伺服器設定。此時不要反覆點擊連線按鈕，空清單中沒有可啟動的活動伺服器。
第二項準備工作是完整的訂閱連結。訂閱連結通常由服務提供者提供，應從連結開頭複製到結尾，不要遺漏字元，也不要連同說明文字、前後空格或換行一起複製。訂閱是伺服器設定的來源，客戶端負責讀取與更新這些設定；它不是單一伺服器名稱，也不是手動輸入的備註。若取得的是單一分享連結，匯入入口可能與訂閱管理入口不同，相關格式差異可前往疑難解答繼續確認。
最後確認本機原有網路可以正常瀏覽一般網頁。設定過程需要依賴本機網路讀取訂閱並建立連線；如果目前網路本身已中斷，客戶端日誌通常只會不斷出現逾時訊息。先處理基本網路，再進行後續訂閱與代理設定，可以減少多個問題疊加造成的誤判。
CLIENT
客戶端可以開啟
主視窗、設定清單或系統匣入口能正常顯示。
SUBSCRIPTION
訂閱連結完整
複製完整網址，不要包含說明文字與多餘空格。
NETWORK
基本網路正常
關閉客戶端連線時，一般網頁仍能正常開啟。
// STEP 01
匯入訂閱並更新伺服器清單
訂閱匯入分為兩個動作：先儲存訂閱網址，再主動執行一次更新。只完成儲存而沒有更新時，客戶端可能已記住訂閱資訊，但主介面的伺服器清單仍然是空的。因此本步驟的完成標準不是「訂閱視窗中有一筆記錄」，而是「主清單中已出現可選擇的伺服器設定」。
v2rayN 桌面版：新增訂閱群組
開啟 v2rayN 主視窗，在頂部選單中找到「訂閱群組」或名稱相近的訂閱管理入口，再進入訂閱群組設定。不同版本的選單排列可能略有差異，但入口通常同時包含群組管理與更新訂閱兩項功能。進入設定視窗後選擇新增，為訂閱填寫便於辨識的備註，例如依用途或提供者命名，然後將完整訂閱連結貼到網址欄。
儲存前再次檢查網址的開頭與結尾。網址欄中不應出現中文引號、空格或額外說明。儲存並關閉設定視窗後，回到訂閱選單，執行「更新全部訂閱」，或更新剛建立的群組。更新過程中可以開啟日誌區域查看結果。正常情況下，日誌會顯示讀取訂閱與處理設定的過程，之後主視窗的伺服器清單會出現多筆記錄，通常包含別名、網址、連接埠或協定類型等欄位。
訂閱群組
訂閱群組設定
新增並儲存
更新訂閱
v2rayNG Android 版：新增訂閱設定
開啟 v2rayNG 後進入頂部選單，在訂閱設定中新增一筆訂閱記錄。填寫名稱並貼上完整連結後儲存，接著返回設定清單，使用「更新訂閱」功能讀取伺服器設定。部分版本會在更新完成後自動返回清單，部分版本則會以短提示說明更新結果。只要設定清單出現可選取的項目，就可以繼續下一步。
如果更新後仍然是空的，先不要進入代理模式設定。重新開啟訂閱記錄，檢查連結是否被截斷，並確認目前網路可以連線到訂閱來源。也可以查看日誌中是否出現解析失敗、連線逾時或回傳內容為空等訊息。訂閱格式、單一分享連結與完整訂閱之間有許多差異，本頁不展開格式轉換；遇到這類情況，可在疑難解答中依「安裝設定」分類繼續排查。
伺服器設定進入清單後，下一步不是立刻反覆測試所有項目，而是先確認客戶端如何接管流量。代理模式會決定哪些應用程式使用連線，也會決定後續驗證時應觀察哪個狀態。
// STEP 02
選擇代理模式：先用預設範圍完成首次連線
代理模式可以理解為「哪些流量交由客戶端處理」。首次設定的目標是建立一條可驗證的連線，不需要一開始就調整複雜路由、TUN 參數或自訂規則。先使用客戶端提供的一般系統代理或標準連線方式完成測試，確認訂閱與伺服器可用後，再依實際需求細化分流規則。這樣可以將問題限制在較小範圍內。
桌面版先區分系統代理與路由規則
在 v2rayN 中，「系統代理」和「路由模式」負責不同工作。系統代理決定瀏覽器等遵循系統網路設定的程式是否將請求交給客戶端；路由模式則決定請求進入客戶端後採用直連、代理或阻斷等處理方式。初次使用時，可以在系統匣選單或主視窗相關選單中選擇自動設定系統代理，再保留一套預設規則路由。此時不要同時開啟多個第三方代理程式，以免不同程式重複修改同一個系統代理入口。
如果只啟動了核心，卻沒有啟用系統代理，客戶端日誌可能顯示運作正常，但瀏覽器流量仍依原路徑存取。這不一定表示伺服器設定錯誤，而是流量尚未交給客戶端。相反地，如果系統代理已開啟但客戶端核心沒有執行，瀏覽器可能直接顯示連線失敗。因此後續連線步驟需要同時確認「活動伺服器」、「執行狀態」與「系統代理狀態」。
Android 版使用標準連線入口
v2rayNG 的基本使用路徑更集中：先在設定清單中選擇伺服器，再點擊右下角連線按鈕。首次連線時，系統會顯示網路連線授權提示，確認後客戶端才能建立本機連線通道。若拒絕該提示，設定仍會保留在清單中，但連線無法進入工作狀態。完成授權後，狀態列通常會出現連線標誌，應用程式內按鈕的狀態也會改變。
路由設定建議先保留客戶端預設選項。預設規則適合用來判斷基本連線是否成立；自訂 domain、ip、geosite 規則以及更完整的 TUN 使用方式屬於進階設定，可在連線成功後閱讀系統教學。如果首次測試同時修改訂閱、路由、DNS 與傳輸參數，一旦失敗將很難判斷是哪一項造成結果變化。
AFTER VERIFIED
連線穩定後
再依應用程式範圍調整路由規則、DNS 行為與其他進階設定。
模式確定後，客戶端仍需要一台明確的活動伺服器。接下來從訂閱清單中選取設定，啟動連線，並透過狀態與日誌判斷啟動過程是否完整。
// STEP 03
選擇活動伺服器並建立連線
伺服器清單出現設定後，需要明確選取其中一項。清單中有設定不代表該設定已成為活動伺服器；尤其在首次匯入、切換訂閱群組或刪除舊設定後，客戶端可能仍沒有目前選項。選擇時先使用訂閱提供的預設推薦項目，不必一開始逐項修改傳輸參數。訂閱產生的協定、網址、連接埠與傳輸欄位應作為整體使用。
在 v2rayN 中設定活動伺服器
回到主視窗，在伺服器清單中單擊目標列，再使用 Enter、雙擊或右鍵選單中的「設為活動伺服器」操作。具體觸發方式會依版本而異，應查看清單中的選取標記、目前伺服器提示或視窗底部狀態資訊來判斷是否成功。確定活動伺服器後，啟動服務，並在系統代理選單中選擇前一步決定的自動設定方式。
接著開啟日誌區域。正常啟動時，日誌會先顯示載入設定，再顯示核心開始執行與建立本機監聽入口。日誌出現本機連接埠監聽資訊，表示客戶端已準備接收來自系統代理的請求。若啟動後立即停止，應重點查看停止前的第一則錯誤，而不是只看最後一行結束提示。連接埠被占用、設定欄位不完整及本機安全策略攔截，都可能使啟動過程提前結束。
在 v2rayNG 中啟動選取的設定
在設定清單中點擊目標項目，使其進入選取狀態，然後點擊右下角連線按鈕。首次連線確認系統授權後，等待按鈕與頂部狀態發生變化。建立連線後不要立即退出客戶端，先停留在目前頁面幾秒並查看日誌。若按鈕很快恢復為未連線狀態，表示啟動未能持續成功，需要開啟日誌查看原因。
訂閱中有多筆設定時，可以先測試一筆，失敗後再切換另一筆。切換前先停止目前連線，選取新設定後重新啟動，避免將舊連線的日誌與新連線混在一起。測試過程中不要手動改寫伺服器網址、使用者識別、傳輸方式或安全參數，因為任何欄位不匹配都可能導致連線無法建立。
活動伺服器已確認
清單中有選取項目，狀態區域能辨識目前設定。
客戶端持續執行
啟動後沒有立即停止，連線按鈕維持工作狀態。
日誌建立監聽
日誌完成載入設定，並開始接收本機請求。
客戶端顯示正在執行，只代表本機程序已啟動，最後仍要確認實際應用程式流量是否經過目前連線。最後一步會一起核對介面狀態、瀏覽器結果與日誌。
// STEP 04
驗證是否生效：交叉確認狀態、網頁與日誌
驗證連線不能只看按鈕顏色，也不能只看某個網頁是否開啟。較穩妥的方法是同時檢查三項：客戶端是否持續執行、要測試的應用程式是否使用目前代理入口、日誌是否出現與存取動作對應的新記錄。三項結果一致時，才能確認從應用程式到客戶端再到伺服器的完整路徑已正常運作。
先檢查客戶端與系統狀態
桌面版先查看活動伺服器是否仍存在、核心是否正在執行，以及系統代理選單是否維持自動設定狀態。如果瀏覽器在客戶端啟動前已開啟，可以建立新視窗，或完全關閉後重新開啟，讓瀏覽器重新讀取系統網路設定。Android 版則確認連線按鈕仍處於工作狀態、系統狀態列保留連線標誌，且未被電池管理立即終止背景執行。
再執行一次可觀察的網頁請求
開啟瀏覽器，先前往平時能正常開啟的網頁，確認啟用客戶端後基本存取沒有受到影響；再前往實際需要測試的目標頁面。測試時盡量關閉瀏覽器中的其他下載與自動重新整理頁面，讓日誌中的新請求更容易辨識。如果一般網頁也全部失敗，優先檢查系統代理是否指向未執行的本機連接埠，或客戶端是否在啟動後已停止。
發出網頁請求後立即回到客戶端日誌。正常情況下，日誌會新增接近目前存取時間的連線記錄。若瀏覽器報錯但日誌完全沒有新內容，通常表示流量沒有進入客戶端，應回到第二步檢查系統代理或連線授權。若日誌看得到請求，但隨後出現逾時或連線關閉，則表示流量已進入客戶端，排查重點應轉向目前伺服器設定、本機網路品質或訂閱狀態。
依固定順序處理失敗結果
第一，執行一次訂閱更新，確認設定不是舊記錄；第二，停止目前連線，切換同一訂閱中的另一台伺服器後重新啟動；第三，恢復預設路由設定，排除自訂規則對測試請求的影響；第四，暫時退出其他會修改系統代理或本機連接埠的工具；第五，重新檢查本機基本網路。每次只修改一項，並在修改後重複相同的網頁測試，才能知道是哪個步驟改變了結果。
如果日誌提示連接埠已被占用，需要關閉使用同一連接埠的程式，或在客戶端設定中改用未衝突的本機連接埠後重新啟動。若訂閱更新一直失敗，應返回訂閱設定核對連結，而不是繼續切換代理模式。若設定可以啟動但特定網頁的表現不同，可能涉及路由規則或 DNS 設定；這類問題可前往疑難解答查看相關項目，完整的路由與 DNS 原理則可在系統教學中深入了解。
| 觀察結果 | 說明 | 下一步 |
|---|---|---|
| 客戶端執行中，網頁正常，日誌新增請求 | 應用程式流量已進入客戶端，基本連線完成 | 保留目前設定，進入日常使用 |
| 客戶端執行中，網頁失敗，日誌沒有新請求 | 流量沒有進入客戶端 | 檢查系統代理、連線授權與應用程式代理設定 |
| 日誌出現請求，隨後連線逾時 | 本機入口正常，遠端鏈路尚未完成 | 更新訂閱並切換另一台伺服器測試 |
| 啟動後立即停止 | 客戶端未完成載入設定或監聽本機連接埠 | 查看停止前的第一則錯誤並處理連接埠衝突 |
// DAILY USE
日常使用：維持簡單的更新與切換順序
更新訂閱後再切換伺服器
伺服器清單需要定期從訂閱來源更新。更新前先停止目前連線，執行訂閱更新，確認清單重新整理後，再選擇活動伺服器並重新啟動。若更新後某筆舊設定消失，通常表示訂閱內容已調整，不應繼續依賴本機殘留記錄。
修改設定時一次只改一項
路由模式、DNS、本機連接埠與啟動行為都會影響最終結果。連線已可使用時，先記錄目前設定，再逐項調整並重複驗證。一次修改多個選項，會讓日誌變化難以對應具體原因。
切換網路後重新觀察狀態
裝置從一個網路切換到另一個網路後，原有連線可能需要重新建立。先停止再啟動客戶端，並查看日誌是否恢復請求記錄。不要直接將網路切換造成的短暫中斷判定為訂閱失效。
複雜設定請參閱系統教學
基本流程穩定後，再學習自訂路由、domain 與 ip 比對、geosite 規則、TUN 及日常維護。完整概念與設定關係集中在系統教學，本頁保留十分鐘入門所需的操作路徑。
// NEXT REFERENCE
需要繼續排查或深入設定
介面錯誤、訂閱為空與連線中斷可前往疑難解答；路由分流、TUN 與維護方法可繼續閱讀系統教學。