v2rayN 使用教學：
匯入訂閱與連線測試

開始前：用戶端與訂閱網址

先前往用戶端下載頁面，選擇適用於裝置的安裝檔，完成安裝後開啟主視窗。桌面版使用 v2rayN，Android 裝置使用 v2rayNG。初次啟動時，先確認視窗顯示正常且設定可以儲存；不要同時變更監聽連接埠、路由、DNS 與核心。保留初始設定，後續遇到問題時才有明確的比對依據。

用戶端不等於伺服器。安裝用戶端後，還需要有效的訂閱網址，或完整的伺服器分享連結。訂閱網址用來取得伺服器設定清單；分享連結通常包含單筆伺服器資料，兩者的匯入入口不同。本網站提供用戶端與設定說明，不提供訂閱網址，也不會建立伺服器帳號。尚未取得設定時，請先向設定提供者確認網址、有效期限及適用的用戶端。

訂閱連結可能包含存取憑證。複製時請保留完整內容，不要自行刪除問號後的參數，也不要貼到公開討論區或線上解析工具。若需要他人協助排查，請先隱去網址與憑證，再提供錯誤訊息。初次設定可預留約十分鐘，但訂閱是否有效、網路狀況與裝置權限都會影響實際所需時間。

一、匯入訂閱並更新清單

在 v2rayN 新增訂閱群組

複製訂閱網址後，開啟 v2rayN 主視窗中與「訂閱群組」相關的選單，進入「訂閱群組設定」。新增群組，在備註欄填入方便辨識的名稱，例如「日常設定」，並在網址欄貼上完整訂閱連結。檢查開頭與結尾是否多出空格或換行，也確認沒有一併複製說明文字，然後儲存。此時儲存的是訂閱來源，伺服器清單不一定會立即出現新項目。

返回主視窗，從訂閱選單更新訂閱。用戶端可能提供「透過代理更新」和「不透過代理更新」等選項。如果目前尚未建立可用連線，請先嘗試不透過代理更新；若訂閱網址必須經由既有代理才能存取，就需要先建立可用連線，再選擇透過代理更新。不要只因按鈕名稱不同就反覆切換，先查看更新結果中的具體錯誤。

更新完成後，切換到剛建立的訂閱群組，確認伺服器清單中已出現項目。檢查備註、協定類型、伺服器網址與連接埠是否有內容，不必急著批次測速。若清單中已有舊記錄，也要確認目前所在的群組，避免將其他群組的內容誤認為此次更新結果。訂閱更新成功只表示清單已取得並解析，不代表每一台伺服器都能連線。

如果更新失敗，先確認裝置可以正常連上網路，再檢查訂閱是否過期、網址是否遭截斷，以及系統時間是否正確。發生解析錯誤時，伺服器回傳的內容也可能是登入頁面或服務端提示，而不是用戶端能辨識的訂閱格式。請勿將錯誤頁面當成設定匯入。若要進一步排查，可參考訂閱更新失敗檢查清單。

v2rayNG 的操作方式

在 v2rayNG 開啟主畫面選單，進入訂閱群組設定，點選新增按鈕並填寫群組備註與訂閱網址。儲存後返回主畫面，再從選單更新訂閱。更新完成後，選擇對應群組查看伺服器項目。若取得的是單筆分享連結，請使用「從剪貼簿匯入」等設定匯入功能，不要填入訂閱網址欄位。無論採用哪種方式，都以清單中實際新增記錄為完成依據。

完成這個階段後，應至少能看到一筆可供選擇的伺服器記錄。先不要連線，下一步先確認應用程式透過哪個入口連入，以及連線進入核心後採用哪套路由規則。訂閱、節點與分享連結的詳細差異，請參閱名詞解釋。

二、選擇代理入口與路由模式

先了解系統代理與路由規則的差異

桌面版初次使用時，建議先採用系統代理入口，暫時不要啟用 TUN。系統代理會告知遵循此設定的應用程式，將請求交給本機代理位址。路由規則則決定已進入核心的連線要透過代理、直接連線，或使用其他輸出方式。這是兩個不同層級的設定；開啟系統代理，不代表每筆連線都會經由代理對外傳送。

在 v2rayN 中找到系統代理選單，常見入口位於視窗底部或系統匣的右鍵選單。先確認「設定系統代理」與「清除系統代理」的位置，等下一步確認核心正常啟動後再進行設定。不要混用瀏覽器個別設定的代理位址與系統代理，否則關閉其中一項後，另一項仍可能繼續影響瀏覽器請求。

接著找到路由選擇入口。初次使用時，可選擇用戶端提供的預設規則，例如用來區分常見直連目標與代理目標的規則。不同版本提供的預設名稱與具體規則可能不同，請查看所選項目的說明。若暫時使用「全域」類路由進行排查，也只能視為調整已進入核心的流量處理方式，不能據此認定所有應用程式的流量都已接管。

這次先不要新增自訂規則，也不要同時變更 DNS。保留用戶端隨附的設定，並記下目前選取的路由名稱。之後若遇到某個網站能開啟、另一個網站無法開啟，就能在相同規則下重現問題，而不會因多處變更而失去判斷依據。若要了解規則順序、網域比對與輸出標籤，請繼續閱讀JSON 手冊中的 routing 章節。

v2rayNG 透過系統 VPN 介面連線

v2rayNG 一般透過 Android 系統 VPN 介面接收流量，不必在手機的 Wi-Fi 設定中另外填入桌面版代理連接埠。初次連線時，先保留預設路由與應用程式範圍設定。如果曾啟用依應用程式設定代理，請確認瀏覽器是否包含在選定範圍內；範圍外的應用程式無法用來確認目前代理連線是否正常。

裝置上其他正在執行的 VPN 服務可能與這次連線衝突，請先處理既有連線，再啟動 v2rayNG。這一步的目標只是固定接入方式與規則，減少變因。完成後返回伺服器清單，下一步再選擇目前使用的伺服器並啟動服務。

三、選擇伺服器並啟動連線

在桌面版確認使用中的伺服器與核心記錄

在 v2rayN 的伺服器清單中選取一筆記錄，透過右鍵選單中的「設為活動伺服器」或類似功能啟用。部分版本也支援雙擊或使用快速鍵，請以目前介面提示為準。確認活動標記確實移至所選記錄，不要只看滑鼠反白：反白列可能只是目前選取項目，不一定是核心正在使用的伺服器。

切換活動伺服器通常會觸發設定產生與核心重新載入；若目前版本需要另外啟動或重新啟動服務，請使用對應選單。接著查看底部記錄區，確認沒有設定載入失敗、連接埠遭占用或核心停止等錯誤。記錄中出現監聽資訊，表示本機入口已建立，但還不足以證明遠端連線成功，最後仍須透過實際請求測試。

在設定中找到本機監聽連接埠，記下目前的 SOCKS 入口位址與連接埠。常見範例為 127.0.0.1:10808，但用戶端版本與過往設定可能會使數值不同，請以實際介面為準。不要將訂閱中的遠端伺服器連接埠直接填入瀏覽器代理設定；瀏覽器連線到的是本機用戶端，再由用戶端依設定連線至遠端伺服器。

如果記錄顯示連接埠遭占用，請檢查是否已開啟另一個用戶端，或其他本機代理程式。先關閉不需要的執行個體，再重新啟動目前的服務。若確實需要變更連接埠，請儲存新值，並同步修改所有手動填入該入口的應用程式。核心正常執行後，再選擇「設定系統代理」。此時請保持用戶端執行，不要立即關閉程式；關閉視窗是否會結束處理程序，取決於用戶端設定。

在 v2rayNG 確認連線授權

在 v2rayNG 清單中選取目標伺服器，確認活動標記後，點選主畫面的連線按鈕。首次啟動時，系統通常會顯示 VPN 連線要求；閱讀提示並確認後，系統才會建立對應介面。接著查看用戶端連線狀態與系統提示。若拒絕授權，服務便無法如預期接收應用程式流量；請重新發起連線並完成授權。

如果按鈕顯示已連線，但請求仍然失敗，請開啟記錄查看對應時間的錯誤，不要連續切換伺服器與核心。先記下所選記錄、路由模式與錯誤內容，再進入測試步驟。系統連線圖示只能表示介面正在執行，無法證明遠端伺服器已接受請求。

四、確認實際請求是否生效

比對瀏覽器結果與用戶端記錄

讓用戶端記錄視窗保持開啟，在瀏覽器中前往目前可用且允許存取的 HTTPS 網頁。優先使用自己熟悉的固定網址，重新整理或開啟新頁面，避免只查看已快取的內容。記下送出請求的時間，再查看記錄中是否出現對應目標或連線資料。頁面成功載入並有相符的請求記錄，比只看連線按鈕或延遲數字更能判斷連線狀況。

也要檢查請求使用的輸出方式。採用分流規則時，部分目標可能直接連線，這是規則正常運作的結果；不能把直連網頁成功開啟，當成代理輸出測試成功。記錄顯示的詳細程度取決於記錄層級；若沒有看到目標記錄，也可能是目前層級未記錄存取細節。確實需要暫時提高記錄層級時，測試後請恢復原設定；分享記錄前，務必隱去伺服器位址、訂閱連結及其他敏感內容。

如果用戶端內建連線測試成功，但瀏覽器沒有相應請求，請優先確認瀏覽器是否使用系統代理，以及是否有擴充功能或獨立代理設定覆蓋系統設定。若只有特定應用程式無法使用，先檢查該應用程式的代理支援與連線設定，不要立刻重新安裝用戶端。系統代理無法保證涵蓋所有程式；若確實需要擴大接入範圍，再參閱TUN 模式設定說明。

必要時單獨測試本機入口

熟悉終端機且裝置已提供 curl 時，可使用以下指令測試本機 SOCKS 入口。此指令假設本機連接埠為 10808；若介面顯示其他連接埠，請先替換。這裡使用保留的範例網域送出請求，測試結果仍會受到目標網站可用性與目前路由規則影響。

curl --proxy socks5h://127.0.0.1:10808 --connect-timeout 10 --max-time 20 -I https://example.com/

socks5h 會將目標主機名稱交由 SOCKS 代理端解析，適合用來區分這次請求與瀏覽器本身的解析行為。收到 HTTP 回應標頭，表示這條請求路徑有回應，但不代表請求一定透過代理對外傳送；仍須搭配路由與記錄判斷。如果顯示無法連線至本機位址，請先檢查監聽連接埠與服務狀態；若本機連線成功後才逾時，則檢查遠端伺服器、傳輸參數與網路狀況。

Android 版也採用相同方式測試：連線後在瀏覽器送出新請求，再返回 v2rayNG 查看記錄與測試結果。如果前景使用正常、鎖定螢幕後才發生異常，請再檢查系統電池管理是否限制背景服務。不要只為測試一次連線就變更所有背景權限；先確認問題確實與背景暫停有關，再依裝置設定調整。

保留有效設定並正確結束連線

確認請求路徑符合預期後，保留目前的活動伺服器、訂閱群組與路由設定。日後更新訂閱時，請確認原本的活動記錄是否仍在；清單變動後可能需要重新選擇。若要調整分流或 DNS，每次只變更一項，並重複相同的瀏覽測試。需要直接編輯欄位時，再前往V2Ray JSON 設定手冊；用戶端產生的設定欄位並非都需要手動維護。

桌面版結束使用前，先清除系統代理，再關閉用戶端，避免應用程式繼續連線至已停止監聽的本機連接埠。Android 版請使用 v2rayNG 的停止按鈕結束服務，並確認系統連線狀態已解除。完成後應有四項可確認的結果：訂閱已更新、代理入口與路由已設定、服務已啟動、實際請求已測試。任何一步失敗，都回到該步驟排查，不必從安裝開始重做。