v2rayN 使用教學：
匯入訂閱與連線驗證

依序執行「匯入訂閱 → 選擇代理模式 → 連線 → 驗證」。若已安裝用戶端並備妥可用訂閱，預留約 10 分鐘完成首次設定；先確認基本連線正常，再調整分流與 TUN。

開始前，請確認用戶端能正常開啟，並準備好可信來源提供的訂閱網址或單一節點分享連結。用戶端負責讀取設定並轉送流量，安裝程式本身不會附帶可直接使用的伺服器。訂閱網址可能包含存取憑證，請勿將完整網址貼到公開留言、截圖或線上解析工具。

01 · 匯入訂閱，確認節點已出現

先確認手上的內容類型。以 HTTPS 開頭、用來取得一組伺服器設定的網址，通常是訂閱網址；以 vmess://、vless://、trojan:// 或 ss:// 開頭的內容，通常是單一節點分享連結。兩者的匯入位置不同。請勿將服務商的登入頁面、訂單頁面或說明文件網址貼進訂閱欄位，即使這些網址也能用瀏覽器開啟。

在 v2rayN 桌面版新增群組

開啟主視窗，前往「訂閱群組」中的「訂閱群組設定」，新增一筆群組資料。備註可填寫方便辨識的名稱，例如「日常使用」；在網址欄貼上完整訂閱網址。貼上後請檢查網址開頭與結尾，確認沒有多出空格、換行或通訊軟體附加的標點。其他選項先保留預設值，儲存後返回主畫面。

接著在「訂閱群組」選單中執行更新訂閱。如果選單提供「透過代理更新」和「不透過代理更新」等選項，而目前尚未建立代理連線，請先嘗試不透過代理更新。等操作完成後，查看主視窗的節點清單。看到協定、位址或備註等項目，才表示訂閱內容已成功解析；只儲存群組名稱並不代表已匯入節點。

如果已有其他訂閱群組，可切換至剛新增的群組，避免把舊節點誤認為此次更新的結果。更新時若出現錯誤，先查看記錄中的具體原因：連線逾時、驗證失敗與內容解析失敗是不同問題。不要連續點選更新，也不要為了重試而新增多個相同群組，否則之後難以判斷目前使用的是哪份設定。

在 v2rayNG Android 版新增訂閱

從側邊選單進入「訂閱群組設定」，點選新增按鈕，填寫備註與訂閱網址後儲存。返回主畫面，開啟選單並執行更新訂閱；部分版本需要先切換至對應的訂閱群組。更新完成後，清單中應會出現節點項目。如果只看到空白群組，請先檢查更新結果，不要直接點選連線按鈕。

如果拿到的是單一分享連結，請先複製完整連結，再使用用戶端的「從剪貼簿匯入」功能。v2rayN 通常可在伺服器相關選單中找到此功能，v2rayNG 通常則位於主畫面的新增選單。匯入單一連結後，不會自動轉成可定期更新的訂閱；日後伺服器參數變更時，需重新匯入或依來源說明修改。

若更新失敗，先確認網址仍有效、裝置時間正確，並查看來源是否要求使用特定網路。若訂閱必須透過代理才能更新，就必須先有另一條可用連線，不能依賴尚未匯入的節點完成首次更新。詳細排查方式請見訂閱更新問題；此時先不要修改傳輸或驗證欄位。

02 · 選擇代理模式，先採用簡單設定

「代理模式」常被用來泛指兩種設定。第一種是連線方式，決定應用程式流量能否進入用戶端，例如系統代理、Android VPN 或桌面 TUN；第二種是路由規則，決定進入用戶端的流量要走代理、直連或封鎖。只修改路由規則，不會讓原本忽略系統代理的應用程式自動改用代理。首次設定時，請分開檢查這兩層，之後排查問題會容易許多。

v2rayN：先設定系統代理

桌面版先保持 TUN 關閉，在主視窗或系統匣選單中找到「系統代理」，選擇名稱類似「自動設定系統代理」的選項。此處的目標是將桌面環境的代理位址指向本機監聽連接埠，而不是啟動額外的網路接管功能。若介面另有 PAC 相關模式，首次驗證時先不要選用，以免增加需要排查的自動設定規則。

Linux 桌面環境對系統代理的處理方式不盡相同。如果用戶端顯示已設定，但系統設定中沒有相應變更，請開啟桌面環境的「網路代理」頁面確認。需要手動填寫時，位址請使用 127.0.0.1，連接埠則以用戶端參數設定中的實際監聽連接埠為準。只有本機連線支援 HTTP 或混合代理時，才能將該連接埠填入 HTTP、HTTPS 代理欄位；請勿只看連接埠號碼就猜測協定。

接著查看用戶端的路由選項，優先使用略過區域網路與私人位址的規則，保留連線至本機印表機、路由器管理頁面等位址的直連路徑。不同版本可能使用「略過區域網路」、「略過私人位址」或組合名稱，請先閱讀規則說明再選擇。暫時不要匯入複雜規則集，也不要同時調整 DNS、探測與傳輸參數。如此一來發生問題時，仍能清楚判斷是哪個步驟造成變更。

v2rayNG：先保留預設 VPN 連線

Android 版首次使用時，通常保留預設的 VPN 連線方式即可。路由先採用用戶端內建的基本規則，暫時不要啟用應用程式分流；若要啟用，請確認稍後用來驗證的瀏覽器已納入代理範圍。應用程式分流中的「僅代理所選應用程式」與「略過所選應用程式」意思相反；首次連線時若選錯，很容易發生用戶端已在執行，瀏覽器卻沒有請求記錄的情況。

這個階段先完成模式選擇，暫時不要更改進階設定。啟動連線時，系統會要求授予 VPN 權限。如果裝置上還有其他需要使用 VPN 介面的網路工具，請先停止它們，再測試 v2rayNG；系統通常無法讓同一使用者環境中的多個這類連線同時接管流量。

完成後請記下目前的設定組合：桌面版使用系統代理搭配基本路由，Android 版使用預設 VPN 連線搭配基本路由。下一步只更換節點並觀察連線，不要同時更換連線方式。每次只調整一個變數，才能判斷改善或錯誤的原因。

03 · 選擇節點並啟動用戶端連線

返回節點清單，先選擇一筆設定完整且來源明確的項目。節點備註只是名稱，不能代表實際可用性。清單中的 Ping 或 TCP 測試通常只檢查部分網路路徑；即使測試有結果，也不代表協定驗證、TLS 與目標連線都成功。若用戶端提供「真實連線測試」或類似功能，可優先用來篩選候選節點，但最後仍須透過實際應用程式完成驗證。

v2rayN：設定作用中伺服器並檢查記錄

在節點項目上開啟右鍵選單，使用「設為作用中伺服器」等相應功能；部分版本也可透過雙擊切換，請以介面提示為準。確認作用中標記已移至所選項目。v2rayN 通常會在切換後產生設定並啟動或重新載入核心，因此不一定會有獨立的「連線」按鈕。此時請查看視窗下方的記錄，確認沒有設定解析失敗、核心中止或監聽連接埠衝突等錯誤。

如果節點已啟用，但應用程式仍無法連線，請再次確認系統代理仍維持剛才選擇的狀態。作用中伺服器、核心執行狀態與系統代理狀態是三種不同資訊，不能以其中一項取代另外兩項。系統匣圖示或節點選取狀態只能作為輔助判斷，不能當成代理已生效的最終證據。

如果記錄顯示監聽連接埠已被占用，先確認是否重複啟動用戶端，或有其他代理工具正在監聽相同連接埠。不要直接結束不明的系統程序。關閉重複執行的用戶端後再試；若確實需要更改連接埠，必須同步修改系統代理與後續驗證指令。若記錄顯示驗證失敗、憑證錯誤或遠端拒絕連線，應核對節點來源與裝置時間，而不是反覆更換本機連接埠。

v2rayNG：點選連線並確認系統授權

在 Android 節點清單中點選目標項目，確認選取標記正確，再點選主畫面的連線按鈕。首次啟動時，系統會跳出 VPN 連線要求；確認要求來自 v2rayNG 後再授權。授權完成後返回用戶端，查看執行狀態與記錄。如果系統提示另一個 VPN 連線將被取代，請先確認目前網路工具的用途，再決定是否繼續。

連線後讓用戶端保持執行，先不要清除背景程序或啟用額外的省電限制。若測試時正常，鎖定螢幕一段時間後才中斷，再針對背景限制進行處理；首次設定時不要一次關閉所有電池管理選項。若要進行真實連線測試，可使用目前版本提供的選單操作；測試結果只適合比較相同條件下的候選節點，不宜跨網路或不同時間直接比較。

如果某個節點測試失敗，可以嘗試同一訂閱中的其他節點，並維持其他設定不變。若所有節點都出現相同錯誤，請優先檢查網路、系統時間、訂閱效期與用戶端記錄。不要把所有連線問題都歸因於路由規則，也不要在不清楚用途時刪除 TLS 或傳輸參數。

若啟動異常，請前往常見問題的故障排除分類。提供排查資訊時，請記錄操作時間、用戶端名稱與具體錯誤文字；截圖前遮住訂閱網址、伺服器憑證與分享連結。

04 · 驗證代理生效，並確認設定可還原

驗證分成兩個階段：先確認用戶端到伺服器的代理連線正常，再確認瀏覽器等目標應用程式確實使用這條連線。網頁能開啟只是一種現象，因為該頁面也可能透過直連或快取載入。更可靠的方式是同時觀察新請求、路由結果與用戶端記錄，不要只依賴圖示或單次測速。

使用瀏覽器送出新請求

在瀏覽器開啟新分頁，前往你有權存取、且依目前路由設定應走代理的 HTTPS 網頁。視需要重新整理頁面，避免只看到舊的快取內容。同時開啟用戶端記錄，查看相同時間的目標網域與連線項目。記錄應能協助判斷請求是否進入核心，以及使用代理或直連出站；部分版本預設記錄較精簡，可暫時提高至 info 層級，驗證結束後再還原原設定。

如果記錄顯示直連，不一定代表故障，也可能是目前規則預期的結果。若要檢查代理出口，可暫時選擇會將一般目標流量交由代理的全域代理路由，再送出一次新請求；測試完成後切回原規則。此處變更的是路由，不是將系統代理從關閉改為開啟；兩者仍須分別確認。不要使用區域網路裝置頁面驗證遠端代理，因為這類位址通常應採直連。

Android 版同樣要觀察瀏覽器請求與 v2rayNG 記錄。如果用戶端持續執行，但瀏覽器請求完全沒有對應記錄，請檢查該瀏覽器是否被應用程式分流排除。桌面版則請確認瀏覽器是否設定了獨立代理，或有擴充功能覆寫系統設定。只有目標應用程式使用正確的連線入口，後續調整節點才有意義。

透過終端機單獨驗證 HTTP 代理入口

桌面版可使用下列指令進行一次明確指定代理的測試。執行前，請在用戶端參數設定中確認本機連線支援 HTTP 或混合代理、監聽位址為本機，而且連接埠確實是 10808。若實際連接埠不同，請修改指令中的數字。指令會連線至範例網域，但不代表該網域依你的路由規則一定會透過遠端代理；仍須搭配記錄判斷出站方式。

curl -I --connect-timeout 10 --max-time 20 \
  -x http://127.0.0.1:10808 https://example.com

若看到目標網站傳回的 HTTP 回應標頭，表示本機代理入口與這次請求路徑可正常運作；回應狀態不必固定為某個數字。某些 HTTPS 代理輸出會先顯示通道建立回應，不能只看到這一行就認定目標請求已完成。請繼續查看後續回應及 curl 是否出錯。若連線遭拒，先檢查本機連接埠與核心執行狀態；若發生逾時，再搭配用戶端記錄排查遠端連線。

此指令使用明確指定的 -x 參數，因此成功只能證明指定的代理路徑可用，不能證明系統代理設定正確。反過來說，瀏覽器能連線但終端機的一般指令無法連線，也可能只是終端機程式不會讀取桌面系統代理。若要讓目前終端機中的常見 HTTP 工具讀取代理，可確認連接埠後設定環境變數：

export http_proxy=http://127.0.0.1:10808
export https_proxy=http://127.0.0.1:10808
curl -I --connect-timeout 10 --max-time 20 https://example.com

此處 https_proxy 的值仍以 http:// 開頭，表示用戶端提供的是 HTTP 代理入口，並不是在宣告目標網站所使用的協定。環境變數只會影響支援這些變數的程式，以及目前 shell 後續啟動的程序，不會接管所有軟體。測試時也請留意 no_proxy 或程式本身的代理設定是否略過了目標。

結束測試並確認可正常還原

驗證成功後，保留一個已確認可用的作用中節點與基本路由，再逐一嘗試應用程式分流、TUN 或自訂 DNS。每增加一項設定，都用相同方式重新檢查一次。設定欄位與完整範例集中在V2Ray 設定檔完整參考；首次連線不必逐段編輯 JSON。

暫時不需要使用代理時，桌面版請先在用戶端清除或還原系統代理，再結束程式；若系統代理是手動填寫，也要在桌面網路設定中還原。Android 版請點選停止連線，並確認 VPN 已中斷。若目前終端機設定過環境變數，可執行下列指令還原目前 shell；若曾將設定寫入 shell 啟動檔，還須手動刪除相關設定。

unset http_proxy https_proxy