v2rayN 快速入門
匯入訂閱與測試連線

開始前：確認訂閱與網路狀態

準備一組來自可信來源且仍在有效期限內的訂閱網址，並確認裝置可正常瀏覽一般網頁。用戶端負責讀取設定與轉送流量；安裝完成不代表已經有可用的伺服器。若只有用戶端，沒有訂閱或單一伺服器設定，請先取得有效設定再繼續。

訂閱網址與單一分享連結的用途不同：訂閱網址通常用來更新一組設定，單一分享連結則通常包含一台伺服器的資訊。兩者都能複製，不代表可以貼到同一個欄位。訂閱網址也可能包含存取憑證，請勿將完整網址、QR Code 或設定截圖貼到公開討論區。需要求助時，先遮蔽網址中的權杖、帳號資訊與伺服器驗證欄位。

開始操作前，先關閉其他正在接管流量的代理或 VPN 工具，維持目前的網路環境，暫時不要更換 DNS、路由檔案或核心。之後若發生問題，才容易判斷是否由這次設定造成。若不熟悉「訂閱」、「出站」、「路由」等術語，可先查閱術語手冊；本頁只介紹完成連線所需的設定。

第一步：匯入訂閱並更新設定

v2rayN：新增訂閱群組

開啟 v2rayN，在主視窗上方找到「訂閱群組」，進入「訂閱群組設定」或名稱相近的管理視窗，然後選擇新增。備註可填寫容易辨識的名稱，例如「日常訂閱」；網址欄則貼上完整的訂閱網址。確認網址前後沒有多餘空格、換行，或通訊軟體自動附加的標點，再儲存設定。此時只是新增訂閱來源，伺服器清單不一定會立刻出現內容。

返回主視窗，開啟「訂閱群組」選單並執行更新訂閱。如果選單提供一般更新與透過代理更新，初次連線通常先試一般更新，因為此時尚未建立可用的代理連線。等待更新完成後，查看訂閱提示與伺服器清單。成功後，清單應會顯示該訂閱提供的設定；只有群組名稱、清單仍是空的，不代表訂閱已匯入完成。

清單出現內容後，先確認設定名稱與所屬群組，確定它們來自剛新增的訂閱。暫時不必批次修改傳輸參數，也不需要先測試每筆設定的速度。如果更新失敗，先確認訂閱是否過期、網址是否完整，以及目前網路能否連線至訂閱服務。無效網址不會因為重複更新而修復，頻繁嘗試也可能觸發伺服器的存取限制。

v2rayNG：設定訂閱後返回清單更新

在 v2rayNG 主畫面開啟選單，進入「訂閱設定」，點選新增按鈕，填寫備註與訂閱網址後儲存。返回主畫面，再從選單選擇「更新訂閱」或「更新目前群組訂閱」，並等待更新結果。完成後，主清單應會顯示伺服器項目；若仍停留在訂閱編輯畫面，請先返回主清單，不要在網址欄重複貼上。

如果收到的是以 vmess://、vless:// 等格式開頭的單一分享連結，請使用用戶端的「從剪貼簿匯入」功能，而非新增訂閱網址。匯入 QR Code 也是相同原則：依照 QR Code 包含的內容，選擇對應的設定類型。請勿將訂閱網址填入手動設定視窗，當成伺服器網址使用。

第二步：選擇代理模式與路由

v2rayN：先使用系統代理

在 v2rayN 主視窗底部或系統匣的右鍵選單中找到「系統代理」，選擇「自動設定系統代理」。這會將系統代理指向用戶端的本機監聽位址，讓遵循系統代理設定的應用程式將請求交給 v2rayN。請勿誤選「清除系統代理」，也不要在初次設定時同時執行其他會修改系統代理的工具。

接著找到路由選擇功能。初次使用可先選擇「繞過中國大陸」之類的預設規則，但要留意這只是依規則選擇出站方式，並非所有連線都會經由遠端伺服器。若要確認特定目標確實透過代理，可在測試時暫時選擇會將流量送往代理出站的全域路由預設，測試後再恢復日常規則。不同版本的預設名稱可能不同，請先確認規則的用途再選擇。

系統代理與路由各自處理不同問題：系統代理決定應用程式是否將請求交給用戶端；路由則決定用戶端收到請求後使用哪個出站。將路由設為全域，不會讓所有程式自動遵循系統代理。命令列工具、部分遊戲或內建網路設定的軟體仍可能直接連線，不能只看模式名稱就認定它們已使用代理。

這次先不要啟用 TUN。TUN 涉及虛擬網路介面、權限與 DNS 接管，建議在基本連線測試通過後再設定。也不要為了「保險」同時啟用系統代理、TUN 和多個瀏覽器代理擴充功能；多層接管容易讓問題更難判斷。若確實需要接管不遵循系統代理的應用程式，請前往全平台使用說明查看各平台的 TUN 設定。

v2rayNG：確認 VPN 模式與應用程式範圍

v2rayNG 通常透過 Android 的 VPN 介面接管流量，不必照著桌面版教學尋找「自動設定系統代理」。請在設定中確認使用 VPN 模式，而非僅提供本機代理連接埠的模式。若先前修改過「依應用程式代理」，初次測試時建議先關閉，確保測試用的應用程式包含在接管範圍內；確認成功後，再依需求選擇應用程式。

接著檢查路由設定，保留自己看得懂的預設即可。若已啟用依應用程式代理，請確認目前選的是「只有勾選的應用程式使用代理」，還是「勾選的應用程式略過代理」；兩者的邏輯相反。此時先不要修改遠端 DNS 或自訂路由規則。確認模式後，再進入下一步選擇伺服器並啟動連線。

第三步：選擇伺服器並啟動連線

v2rayN：設為目前使用的伺服器並檢查記錄

在伺服器清單中選擇來源明確且仍可使用的設定，從右鍵選單將它設為目前使用的伺服器；部分版本也支援雙擊項目進行選取。查看清單中的目前使用標記，確認使用的是這筆設定，而不是只把反白選取移到該列。接著依畫面指示啟動或重新載入核心；部分版本會在切換目前使用的伺服器時自動完成。

開啟主視窗的記錄區，等待核心啟動結果。正常情況下，不應持續出現啟動失敗、設定解析失敗或連接埠已占用等錯誤。視窗能開啟、系統匣圖示仍顯示，只能代表圖形介面正在執行，不能單獨證明核心正常運作。若記錄明確指出啟動失敗，請先處理錯誤，不要立刻在瀏覽器中反覆重新整理。

遇到本機連接埠已占用時，先確認是否同時開啟第二個用戶端程序，或仍有其他代理工具在執行。關閉衝突程式後再試；若需要變更連接埠，也要同步檢查應用程式中手動填寫的代理連接埠。不同版本與裝置使用的本機監聽連接埠可能不同，請以目前用戶端設定顯示的數值為準。

v2rayNG：啟動並允許系統 VPN 連線要求

在 v2rayNG 主清單中點選要使用的伺服器，確認選取標記後，點選右下角的啟動按鈕。初次啟動時，Android 通常會顯示 VPN 連線要求；確認要求來自 v2rayNG 後，允許授權。拒絕授權就無法建立流量接管；反覆切換伺服器也無法取代這項系統權限。

啟動後查看應用程式內的狀態，以及系統狀態列或 VPN 設定中的連線提示。不同裝置顯示的圖示可能不同，請以系統實際狀態為準。若另一款 VPN 工具正在執行，先停止該工具，再重新啟動 v2rayNG。即使系統已顯示 VPN 正在執行，仍須測試遠端伺服器與網頁請求；本機接管成功不代表遠端連線也成功。

兩種用戶端都可以先用一筆設定進行測試。若連線逾時，先記下錯誤訊息，再換另一筆已知可用的設定比對；若所有設定都出現相同錯誤，請檢查訂閱期限、裝置時間是否自動同步、目前網路狀態與核心記錄。每次只調整一個條件並記錄結果，比同時更換協定、DNS 和路由更容易找出原因。

第四步：確認網頁與應用程式是否正常連線

先確認執行狀態，再送出實際請求

保持用戶端執行，開啟瀏覽器新分頁，前往一個依所選代理規則應透過代理連線、且目前可正常使用的 HTTPS 網頁。不要只反覆開啟已瀏覽過的頁面，因為快取可能讓頁面看似正常，實際上卻沒有建立新連線。再開啟一個預期應直接連線的一般網頁，確認目前設定沒有影響基本網路連線。

同時查看用戶端記錄或連線紀錄。部分版本只有在啟用相應的記錄層級後才會顯示目標請求，因此「沒有看到存取紀錄」本身不能直接判定失敗；若請求時出現網域解析失敗、連線逾時或驗證失敗，則可據此縮小排查範圍。驗證錯誤優先檢查伺服器設定與訂閱狀態，解析錯誤再檢查 DNS。不要把所有問題都歸咎於網路速度。

需要確認出口時，可在連線前後使用同一個可信的出口 IP 查詢網站進行比較。請確認查詢目標符合代理規則，否則在分流模式下顯示本地網路出口可能是預期結果。出口 IP 改變也不能證明所有應用程式都已接管；這只代表本次查詢請求的路徑有所變更，仍須測試實際要使用的軟體。

瀏覽器正常後，再測試目標應用程式

在 v2rayN 桌面版中，如果瀏覽器可以連線，但命令列或其他應用程式無法使用，先確認該應用程式是否遵循系統代理。若瀏覽器安裝了代理擴充功能，也要確認它沒有覆蓋系統設定。終端機的代理環境變數通常與系統代理不是同一個設定入口；不能只因為瀏覽器連線成功，就認定所有軟體都能使用。若要進一步排查這類差異，可閱讀瀏覽器與命令列分開排查指南。

在 v2rayNG Android 版中，如果只有部分應用程式無法使用，請返回依應用程式代理設定檢查涵蓋範圍，並確認裝置上沒有其他應用程式取代目前的 VPN 連線。如果前景使用正常，但鎖定螢幕一段時間後中斷，請再檢查系統對 v2rayNG 的背景執行與電池限制。初次連線尚未成功前，不要急著修改所有省電選項；先分辨是「始終無法連線」還是「背景執行後中斷」。

測試正常停止，保留可重複使用的設定

確認設定正常後，再測試一次停止流程。v2rayN 使用系統代理時，結束前先選擇「清除系統代理」，再關閉用戶端，避免瀏覽器繼續將請求傳送到已停止的本機連接埠。若用戶端提供結束時還原系統代理的選項，也請實際測試，不能只根據勾選狀態判斷結果。v2rayNG 則點選停止按鈕，確認系統 VPN 連線已結束。

停止後開啟一般網頁，確認原本的網路連線已恢復，再重新啟動用戶端測試一次。若「啟動後能用、停止後可恢復、再次啟動仍能用」，就完成了基本設定的完整測試。此時保留目前的訂閱群組、使用中的設定與路由選擇，再逐項新增依應用程式代理或自訂分流。每次修改後都重做相同測試，若發生問題便能還原到上一組正常設定。

下一步：依照實際問題查閱文件

如果目前使用正常，到這裡即可，不必為了設定完整而開啟所有進階選項。想了解系統代理與 TUN 的差異、路由比對方式或 DNS 的作用，可先查閱術語手冊；若需處理安裝權限、平台專屬設定與完整排查流程，再參閱全平台安裝與設定指南。

如果用戶端顯示執行正常，但網頁仍無法開啟，請保留目前設定，依序檢查節點是否可用、系統時間、DNS、路由與本機連接埠。可參考已連線但無法開啟網頁的排查清單繼續處理。求助時只提供已遮蔽敏感資訊的錯誤訊息，不要公開完整訂閱網址或伺服器憑證。