v2rayN 設定教學

1. 匯入訂閱

訂閱網址是用來取得連線設定的連結，不是瀏覽器代理網址，也不是要填入系統網路設定的伺服器位址。請複製服務提供者標示的完整訂閱連結，勿將管理頁面、登入頁面或說明頁面的網址誤當成訂閱網址。若複製的內容前後帶有空格、引號或換行，貼上後請先檢查再儲存。

v2rayN：新增群組並更新

開啟主視窗上方的「訂閱群組」選單，進入「訂閱群組設定」並選擇新增。為群組填寫容易辨識的備註，再將訂閱連結貼到網址欄位。備註僅供本機辨識，不影響連線；更新時實際送出請求的是網址。儲存後關閉設定視窗，回到伺服器清單所在的主畫面。

再次開啟「訂閱群組」選單，執行更新訂閱。初次使用通常還沒有可用的代理連線，可先選擇不透過代理更新；不同版本可能顯示為「更新所有訂閱（不透過代理）」或類似名稱。若目前網路無法連上訂閱網址，請先確認網址是否可用，或使用已可用的連線再更新；尚未建立連線前，請勿反覆切換更新方式。

更新完成後，主清單中應會出現該群組的伺服器項目。點開群組查看內容，確認備註、協定類型等資訊符合預期。若沒有出現項目，請先查看更新提示：請求失敗通常需要檢查網路或網址；回傳內容無法解析，則需確認訂閱格式是否與客戶端相容。此時尚未進入連線階段，不必先調整路由。

v2rayNG：儲存網址後回到清單更新

在主畫面開啟側邊選單，進入「訂閱群組設定」，點選新增按鈕建立群組，填寫備註與訂閱網址後儲存。接著回到設定清單，從主畫面的選單執行「更新訂閱」。只儲存網址不代表設定已下載，必須確認清單中出現連線項目，才算完成匯入。

若取得的是單一連線分享連結，而非訂閱網址，可使用從剪貼簿匯入設定的功能。請勿混用這兩種匯入方式：單一連結通常會建立一筆設定，訂閱網址則用於持續更新一組設定。兩者差異請參閱名詞解釋中的訂閱與客戶端相關條目。匯入完成後，先選取一個項目，接著設定應用程式流量如何進入客戶端。

2. 選擇代理模式

這個階段要分清楚兩件事：應用程式是否將請求交給客戶端，以及客戶端收到請求後如何處理。前者是流量入口，後者是路由分流。「設定系統代理」不代表所有程式都會經過代理，「全域路由」也不代表所有程式都會自動進入客戶端。先決定入口，再選擇路由，較能避免連線成功但只有部分應用程式生效的誤判。

v2rayN：先使用系統代理

初次設定建議先使用系統代理作為入口，暫時不必啟用 TUN。找到主視窗或系統匣選單中的「系統代理」項目，確認「自動設定系統代理」與「清除系統代理」的位置。前者會將系統支援的代理設定指向客戶端的本機監聽連接埠；後者則會取消相關設定。此時先確認選單位置，等下一步確認核心正常啟動後再啟用。

瀏覽器通常會讀取系統代理，但部分應用程式使用自己的網路設定，或完全不遵循系統代理。為方便測試，請先使用未安裝額外代理擴充功能的瀏覽器。不要同時啟用系統代理，又在瀏覽器擴充功能中指定另一個連接埠，否則實際流量可能進入另一套設定，造成客戶端日誌與瀏覽器結果不一致。

接著查看「路由」選項。日常使用可先選擇包含直連與代理規則的預設，實際名稱以目前介面為準。需要隔離問題時，可暫時選擇讓已進入客戶端的請求一律透過代理的路由預設，確認後再還原分流。這裡調整的是出站決策，不會擴大系統代理可接收流量的應用程式範圍。

v2rayNG：檢查 VPN 模式與應用程式範圍

開啟設定，確認以 VPN 模式作為基本入口。此模式透過 Android 系統提供的 VPN 介面接收流量，不必逐一在瀏覽器填寫本機代理連接埠。若先前啟用了個別應用程式代理，請先確認清單設定代表「僅代理所選應用程式」還是「略過所選應用程式」；在不同模式下，相同的勾選項目可能有相反含義。初次測試時可暫時關閉自訂的個別應用程式限制，減少變因。

接著在路由設定中選擇適合的預設。目標是讓需要代理的請求符合代理出站規則，應直連的請求則依規則直連，而不是把「全域」視為連線成功的必要條件。請保持服務提供者要求的協定與傳輸參數不變，只選擇流量入口與路由預設。TUN、入站、出站等概念可先參閱名詞解釋；自訂規則請等基本連線測試完成後，再參考routing 欄位參考進行調整。

3. 連線並檢查啟動狀態

匯入清單不代表已使用其中某個項目，清單顯示測試結果也不代表應用程式的請求已經透過代理。連線前請確認目前作用中的設定，以及客戶端是否已依此設定啟動核心。先關閉其他正在接管網路的代理或 VPN 程式，避免系統代理設定反覆被覆寫，或 Android 端已有 VPN 佔用接管位置。

v2rayN：設定作用中伺服器

在伺服器清單中選取準備使用的項目，透過右鍵選單執行「設為作用中伺服器」；部分版本也可連按兩下項目完成操作。查看清單中的作用中標記與底部狀態資訊，確認選取的不是其他群組中同名的項目。如果客戶端正在執行，切換作用中伺服器通常會重新產生或載入設定；請等日誌顯示啟動完成後再測試連線。

開啟日誌區域，留意是否出現設定解析失敗、連接埠被占用或核心啟動失敗等提示。若連接埠被占用，請勿只是不斷點選重新啟動；先確認是否重複啟動客戶端，或本機其他程式正在監聽相同連接埠。關閉重複的程序後再啟動，通常比同時修改多個監聽連接埠更容易找出原因。

確認核心正常執行後，將「系統代理」設為「自動設定系統代理」。如果先前一直選擇「清除系統代理」，即使客戶端核心正在執行，瀏覽器仍可能直接連線，不會自動將請求送進客戶端。使用期間可將視窗最小化至系統匣，但請勿將結束客戶端與最小化混為一談；結束程式後，本機監聽服務也會停止。

v2rayNG：確認權限與執行狀態

點選設定清單中的目標項目，確認已顯示選取標記，再點選主畫面的連線按鈕。首次連線時，Android 系統會顯示 VPN 連線要求，請閱讀系統說明後確認。只有取得授權，客戶端才能透過此介面接收應用程式流量；若取消授權，請重新點選連線並完成確認，不必繼續修改訂閱。

啟動後查看客戶端連線狀態、系統 VPN 標示或常駐通知，並檢查日誌。系統標示代表流量接管介面已建立，不代表遠端伺服器一定可連線。若切換到其他應用程式後很快中斷，請檢查系統對客戶端的背景執行與電池使用限制，並依裝置設定允許持續執行。確認執行穩定後再測試實際連線，避免將背景程序遭終止誤判為節點問題。

4. 確認是否生效

測試時要同時確認應用程式的連線結果與客戶端處理路徑。單次延遲測試只能反映該測試方式對應的連線狀況，無法證明所有應用程式與網域都依預期處理。開啟先前選定的瀏覽器，前往預期會透過代理連線的網站並重新載入頁面，同時查看客戶端日誌是否出現相應請求。盡量使用新分頁，避免只看到快取內容。

比對連線結果與出站路徑

若日誌會顯示路由結果，請確認這次請求符合的是代理出站還是直連出站。使用分流模式時，部分網站走直連是正常情況，不能只憑某個頁面能正常開啟就認定代理已生效。請分別測試預期走代理與預期走直連的目標，並對照路由設定判讀結果。

若要進一步確認，可在同一個瀏覽器中開啟可信的出口 IP 查詢頁面，記錄啟用代理後的結果；在不影響其他工作的情況下，暫時關閉入口進行比較，再恢復連線。桌面端可清除系統代理後比較，Android 端則可停止 VPN 連線後比較。查詢頁面本身也可能被路由為直連，因此若出口 IP 沒有變化，請先查看該頁面符合的規則，不能直接判定所有代理請求都失敗。

最後測試實際需要使用的應用程式。若瀏覽器可正常連線，但某個桌面應用程式沒有變化，請優先確認該程式是否讀取系統代理，或是否有自己的代理設定；不要立即重新安裝客戶端。Android 端則要檢查個別應用程式清單是否排除了目標程式。確認入口涵蓋範圍不足，而且確實需要接管更多流量後，再考慮 TUN 等進階方式。

未生效時依固定順序檢查

第一步檢查入口：目前應用程式的請求是否出現在客戶端日誌中。完全沒有相關記錄時，先檢查系統代理、VPN 權限、瀏覽器擴充功能與個別應用程式範圍。第二步檢查路由：請求是否已進入客戶端，卻被送往直連或封鎖的出站路徑。第三步檢查連線：若已符合代理規則，卻發生逾時或交握失敗，請檢查作用中伺服器、網路連線、裝置時間與連線參數。第四步再檢查網域名稱解析，避免一開始就修改整份 DNS 設定。

若要嘗試其他項目，請使用相同的瀏覽器、測試目標與路由，每次只切換一台伺服器。記錄問題是無法解析、連線逾時還是憑證錯誤，會比反覆更新訂閱更有助於排查。分享日誌前，請遮蔽訂閱網址、使用者識別資訊、連線憑證及不想公開的瀏覽目標。

完成基本流程後，請保留這組可正常運作的設定，再逐項增加規則。後續更新訂閱通常會重新整理群組項目，手動修改的訂閱項目可能遭到覆寫；重要的自訂設定應透過客戶端提供的獨立設定入口管理。若要了解設定產生結果，請繼續閱讀config.json 設定欄位參考，依序檢查 inbounds、outbounds、routing 與 dns，初次連線時不必重寫整份設定。