適合已安裝 v2rayN，準備匯入訂閱或排查連線問題的桌面使用者。依序了解伺服器清單、訂閱群組、流量入口、日誌與參數設定，釐清「已選取伺服器」、「核心已啟動」和「應用程式流量已進入代理」的差異，並建立一次只調整一個項目的排查流程。
主視窗區域：設定、入口與執行狀態
v2rayN 是桌面圖形化用戶端，可管理伺服器設定、呼叫代理核心，並提供系統代理等流量入口。伺服器清單中出現 VMess 或 VLESS 記錄，只代表設定已儲存，不表示核心已成功連線，更不代表瀏覽器正透過它連線。請一併查看介面清單、狀態列與日誌。
不同平台和介面版本的按鈕位置可能不同，選單名稱也可能略有差異。以下採用常見的中文桌面介面名稱；參數值請以本機介面和實際啟動日誌為準，不要將特定連接埠或核心視為所有安裝版本的固定預設值。
| 介面區域 | 主要用途 | 確認項目 |
|---|---|---|
| 伺服器清單 | 查看、編輯及選取伺服器 | 活動標記、協定、位址、連接埠、群組 |
| 訂閱群組 | 儲存訂閱來源、更新清單 | 更新範圍、更新方式、失敗訊息 |
| 系統代理與路由 | 決定流量如何進入及離開核心 | 系統代理狀態、目前路由設定 |
| 日誌面板 | 查看啟動、請求與錯誤記錄 | 錯誤時間、目標位址、錯誤類型 |
| 參數設定 | 調整本機監聽、日誌與執行方式 | 連接埠、監聽範圍、實際使用的核心 |
伺服器清單：選取項目不等於活動伺服器
點選某一列通常只是選取記錄，方便編輯、複製或測試。若要切換實際使用的伺服器，請在該列按右鍵，選擇「設為活動伺服器」，再確認活動標記與啟動日誌。不要只憑列背景顏色判斷連線目標，也別把延遲欄的數字當成目前連線狀態。
右鍵選單中的編輯功能可用來確認伺服器位址、伺服器端連接埠、使用者識別碼、傳輸方式和 TLS 等欄位。這些值必須與伺服器端一致；尤其別把本機監聽連接埠填進伺服器端連接埠。手動修改訂閱匯入的記錄，後續更新時可能會被覆蓋；若要長期調整，請先確認訂閱來源的管理方式。
- 設為活動伺服器：切換後先確認核心是否正常啟動，再測試瀏覽網頁。既有的長連線可能需要由應用程式重新建立。
- 編輯伺服器：排查時請逐項比對伺服器端資料。VMess 與 VLESS 所需欄位不同，不能只替換協定名稱。
- 複製或匯出：分享連結可能包含完整驗證資訊，請勿放入公開截圖、聊天室或問題回報內容。
- 多選操作：執行刪除、測試等批次操作前，先確認選取範圍。刪除群組記錄前，請保留可供還原的訂閱來源。
- 延遲與速度測試：TCP 連線測試不等於代理請求測試，測速結果也不等於日常使用體驗。請勿混用不同測試結果進行排序比較。
測試逾時不一定代表伺服器已失效。測試目標無法連線、目前 DNS 解析異常或測試方式不適用，都可能影響結果。請先選一筆設定明確的記錄，搭配日誌完成實際請求，再決定是否刪除。
訂閱群組：匯入、指定群組更新與透過代理更新
訂閱群組儲存的是設定來源及其管理資訊，並非網路線路本身。切換群組標籤通常只是篩選顯示的記錄，不代表活動伺服器已變更。建議依來源建立群組，避免將不同帳號或服務的記錄混在同一個群組名稱下。
-
建立群組
開啟「訂閱群組」→「訂閱群組設定」，新增群組並填入容易辨識的備註，以及服務提供者給的完整訂閱網址。若介面提供「+」按鈕，也可以從該處開啟新增視窗。
-
確認更新範圍
返回主視窗，切換至目標群組，並在「訂閱群組」選單中選擇更新目前訂閱的操作。初次排查時，先更新一個群組；確認內容和日誌正常後，再更新所有訂閱。
-
選擇更新方式
若來源可直接連線，請使用不經代理的更新方式；若直連失敗且已有可用伺服器，先將其設為活動伺服器，再選擇透過代理更新。若選單列出兩種操作，請確認選取正確項目。
-
確認匯入結果
確認清單是否已產生記錄，並查看協定、備註與所屬群組，再設為活動伺服器。更新後若清單變空，請先查看更新日誌及群組篩選條件，不要立即重複匯入。
透過代理更新需要目前可用的本機代理入口與連線路徑，無法憑空修復已失效的訂閱。若沒有任何可用伺服器，請先恢復訂閱來源的直連能力，或使用服務提供者另外提供的有效設定。訂閱網址通常含有帳號權杖，回報問題時只提供已遮蔽敏感資訊的網域與錯誤訊息。
系統代理與 TUN：先確認流量入口
「設定系統代理」和路由模式處理的是兩件事：前者讓遵循系統代理設定的應用程式將請求送至本機連接埠，後者則決定進入核心的請求要走哪個出口。即使選好了代理出口，若應用程式沒有將流量交給用戶端，調整路由也不會生效。
選擇流量入口：先用系統代理，再視需要測試 TUN
系統代理入口
- 在主視窗或系統匣選單的「系統代理」中選擇「自動設定系統代理」。
- 適合用來初步確認遵循系統代理的瀏覽器請求。
- 有些應用程式使用個別的代理設定，需另外檢查。
- Linux 桌面環境也要確認應用程式是否會讀取桌面代理設定。
TUN 入口
- 透過虛擬網路介面接管符合設定的流量；接管範圍會受路由與排除規則影響。
- 啟用前，請確認目前平台、權限及用戶端執行元件均符合需求。
- 初次測試時，先暫停其他同類網路接管工具，以減少路由衝突。
- 若發生異常，先關閉 TUN，改用已確認正常的系統代理連線路徑。
每次只測試一種入口。確認入口正常後再調整分流，才能分辨「請求未進入用戶端」或「進入後選錯出口」。
路由設定中的直連、代理、阻斷是出口決策，不等於介面上的訂閱群組。修改路由後，請對同一個測試目標重新發出請求，並在存取日誌確認命中的出口標籤。不要只憑某個網站能否開啟，就判定整套路由都已生效。
參數設定：先確認監聽連接埠與範圍
開啟「設定」→「參數設定」，優先確認本機監聽相關項目。不同版本可能將項目分在不同設定頁；以下兩張卡片是設定範例，不是固定預設值，也不是要直接照填的遠端伺服器參數。啟用混合監聽時，同一連接埠可同時接受 HTTP 與 SOCKS 請求；是否提供此模式，請以目前介面為準。
本機連線範例
- 監聽位址
- 127.0.0.1
- 範例連接埠
- 10808
- 入口類型
- 混合監聽，請確認已啟用
- 允許區域網路連線
- 關閉
本機應用程式請使用實際的監聽連接埠；若該連接埠已被占用，請改用未占用的連接埠，並同步更新應用程式設定。
日誌排查範例
- 日常日誌層級
- warning
- 暫時排查層級
- info
- 測試請求數量
- 對明確目標發出 1 次請求
- 排查完成後
- 還原原本的日誌層級
存取日誌與錯誤日誌可能分別設定；若只輸出 warning，看不到每次成功請求是正常現象。
「允許來自區域網路的連線」會擴大監聽範圍。僅供本機使用時不必啟用；若確實需要分享，還要確認防火牆、存取控制及所在網路是否可信。監聽所有網路介面與監聽 127.0.0.1 的暴露範圍不同，不要為了排查單機瀏覽器而隨意開放。
- 連接埠衝突：先關閉重複執行的用戶端，再修改本機連接埠。若瀏覽器使用手動代理，變更連接埠後也必須同步修改瀏覽器設定。
- 核心選擇：若設定中提供「Core 類型」或其他核心選項，請確認選用的核心支援目前設定。v2rayN 是管理介面，V2Ray 與 Xray 是不同核心，不能只看用戶端名稱判斷協定支援情況。
- 自動啟動：登入後啟動用戶端、自動選取伺服器及設定系統代理是不同動作。勾選啟動選項後，仍應重新登入確認實際狀態。
- 套用變更：儲存後依介面提示重新啟動核心或程式，再查看新的啟動日誌。請勿依據儲存前的日誌判斷新設定。
日誌面板：依序檢查啟動、入口與出口
排查時先記下問題發生時間，清除面板顯示後只執行一個動作，例如切換一次活動伺服器或開啟一次目標網頁。日誌面板可能同時顯示訂閱更新、用戶端執行狀態及核心輸出；請先分辨訊息來自哪一層，再判斷故障位置。
| 日誌線索 | 常見意義 | 下一步檢查 |
|---|---|---|
address already in use | 本機監聽位址或連接埠已被占用 | 關閉重複執行的程式，確認實際監聽連接埠 |
connection refused | 目標連接埠主動拒絕連線 | 確認目標是本機入口還是遠端服務，再檢查位址與連接埠 |
timeout | 某個階段未能在時限內完成 | 依目標與前後文判斷是 DNS、連線、TLS 或讀取逾時 |
no such host | 網域名稱解析失敗 | 檢查伺服器網域拼字、目前網路與 DNS 設定 |
與 certificate 相關的錯誤 | 憑證驗證或 TLS 參數可能不相符 | 檢查系統時間、伺服器憑證，以及設定要求的伺服器名稱 |
以下命令用於在 Windows 終端機測試本機 HTTP 代理入口。只有在實際監聽位址、連接埠與入口類型都符合範例時才執行；否則請先替換成這台電腦的設定。這是測試命令，不是實測結果，也不保證任何伺服器的效能。
curl.exe --proxy http://127.0.0.1:10808 --head --max-time 15 https://example.com/若命令顯示無法連線至 127.0.0.1，請先檢查核心與本機監聽，而不是更換遠端 DNS。若本機入口已收到請求，但接著出現遠端連線或 TLS 錯誤，請繼續檢查活動伺服器的設定與網路路徑。暫時提高日誌詳細程度後，回報問題前請移除訂閱權杖、使用者識別碼及其他驗證資訊。
常見問題：清單看似正常，實際使用卻不如預期
已經點選伺服器，為什麼瀏覽器還是直連？
先在目標項目上按右鍵，選擇「設為活動伺服器」，再確認「系統代理」→「自動設定系統代理」的狀態。若瀏覽器使用獨立代理設定或擴充功能控制代理，請檢查瀏覽器自己的入口設定；只點選清單項目並不會完成這些操作。
訂閱更新顯示成功，清單為什麼還是空的？
先切回全部群組並清除搜尋篩選，再確認目前檢視的是剛更新的群組。若仍沒有記錄，請查看更新日誌是否有解析失敗；來源若傳回網頁或不相容的內容，即使網路下載成功，也不代表伺服器設定已成功匯入。
有延遲數值，為什麼網頁還是打不開？
確認測試類型。TCP 連線成功只能表示該連線階段可連通，不能證明驗證、傳輸路徑和 TLS 設定都正確。將該伺服器設為活動項目後，實際發出一次請求，再查看同一時間的核心錯誤。
關閉用戶端後，瀏覽器反而無法上網？
重新開啟用戶端，在「系統代理」中選擇「清除系統代理」後再退出，並檢查系統網路代理設定。若曾使用手動代理，也請移除應用程式中指向本機連接埠的設定；本機核心關閉後，該連接埠便不再提供服務。
完整驗證一次應能回答四個問題：目前哪個伺服器是活動項目、應用程式請求進入哪個本機連接埠、核心選擇了哪個出口，以及日誌中的錯誤發生在哪個階段。先記下這四項再調整設定，比同時更新訂閱、切換核心和啟用 TUN 更容易找出原因。