適合初次執行 v2rayN，或已匯入節點卻仍無法連線的桌面使用者。依序完成安裝檔與資料夾、核心啟動、訂閱匯入、系統代理、連線測試及開機啟動；先確認瀏覽器能透過單一節點連線，再考慮 TUN 與自訂路由。文中的 10808、10809 僅為辨識設定的範例，實際連接埠請以用戶端顯示為準。
一、安裝檔與資料夾：先確認系統及處理器架構
v2rayN 是桌面用戶端，用來管理節點、訂閱、核心與系統代理；實際連線則由選用的 Xray-core、sing-box 等核心處理。下載用戶端不代表已取得可用節點。請另外準備訂閱網址或節點參數，並確認來源可信。
先到下載頁選擇作業系統與處理器架構。Windows 可在「設定」→「系統」→「系統資訊」查看系統類型；macOS 可從蘋果選單的「關於這台 Mac」查看晶片或處理器。Apple 晶片通常選擇 arm64 版本，Intel 處理器則選擇 x64 版本。不要只憑檔案大小判斷安裝檔是否適用。
| 檢查項目 | Windows | macOS |
|---|---|---|
| 存放位置 | 可攜版請完整解壓縮至目前使用者可寫入的資料夾，例如 D:\Tools\v2rayN | 依套件內的說明將應用程式放入「應用程式」資料夾，避免長期直接從磁碟映像檔執行 |
| 啟動方式 | 執行解壓縮資料夾中的主程式，不要直接在壓縮檔內連按兩下 | 從已安裝的應用程式位置啟動，初次使用先採一般使用者權限 |
| 相依元件 | 若出現缺少執行階段的提示，請依錯誤視窗安裝對應版本與架構 | Windows 桌面執行階段不適用於 macOS，請先確認 macOS 安裝檔與晶片架構 |
| 資料儲存 | 避免使用暫存資料夾、唯讀資料夾或會自動清理的資料夾 | 保留應用程式的資料資料夾；移動應用程式前，先確認設定檔的儲存位置 |
二、初次啟動：確認設定可儲存、核心可正常執行
第一次開啟時，先不要同時修改 DNS、路由、TUN 與連接埠。保留預設設定並查看主視窗記錄。介面能開啟，只代表圖形程式啟動成功；選好節點後，還要確認核心程序已正常啟動，且沒有連接埠遭占用或檔案遺失等錯誤。
-
完整解壓縮
Windows 請解壓縮壓縮檔內所有檔案與子資料夾；macOS 請依套件說明安裝。不要只複製主程式，也不要任意混用不同版本的核心資料夾。
-
檢查設定
前往「設定」→「參數設定」，確認本機監聽連接埠與目前核心的相關選項。不同平台和版本的子頁名稱可能不同，請記下畫面上顯示的值，不要照抄其他版本的截圖。
-
匯入節點
透過主畫面的「訂閱群組」選單管理訂閱，或使用「伺服器」選單中的剪貼簿匯入功能新增單一節點。匯入後請確認通訊協定、位址、連接埠與傳輸方式。
-
設為目前使用
在節點清單中選取一個節點，從右鍵選單選擇「設為活動伺服器」。接著查看記錄，確認所選核心已成功啟動，不要只看節點列是否反白。
-
儲存後重新開啟
暫時不要啟用開機啟動。正常結束用戶端後重新開啟，確認訂閱、節點與參數仍然存在。若設定消失，先檢查寫入權限與資料資料夾位置。
若記錄顯示找不到核心執行檔，請先確認安裝檔是否包含該核心、檔案是否完整，以及安全軟體是否將檔案隔離。不要只修改「核心類型」選項，就認定核心檔案已備妥；也不要在確認來源前還原遭封鎖的檔案。
三、訂閱與節點：匯入成功不代表連線成功
訂閱是取得節點設定的入口，不是代理監聽位址。完整訂閱連結可能包含存取權杖，請像密碼一樣妥善保管，避免張貼在公開留言，或在排錯截圖中完整顯示。節點名稱可自行修改，但通訊協定與傳輸參數必須符合伺服器設定。
- 新增群組：前往「訂閱群組」→「訂閱群組設定」新增項目，填寫備註與訂閱網址後儲存。若選單名稱不同，請以目前版本的訂閱管理入口為準。
- 更新訂閱：返回「訂閱群組」，選擇對應的更新訂閱功能。初次使用且尚無可用代理時，先嘗試直接連線更新；已有可用節點但直連更新失敗時，再嘗試透過代理更新。
- 確認結果：節點清單中應會出現個別伺服器項目。若清單為空，先確認訂閱請求是否成功，再檢查回傳內容是否為用戶端支援的訂閱格式。
- 選擇目前使用的節點：選取一個節點並設為活動伺服器，再執行連線測試。清單中有數十個節點，不代表目前已選好連線出口。
VMess 與 VLESS 是代理通訊協定，WebSocket 是傳輸方式，TLS 與 REALITY 則是與安全層相關的設定，彼此不能互換。手動輸入時，請一併確認伺服器位址、連接埠、使用者識別碼、傳輸類型與安全參數。例如 WebSocket 路徑 /ws 與 / 並不相同；TLS 的伺服器名稱也不一定等同於連線位址。
四、本機連接埠：分清瀏覽器入口與遠端連接埠
遠端伺服器連接埠與本機代理連接埠是兩回事。節點使用 443，不代表瀏覽器的本機代理也要填 443。瀏覽器連線至本機監聽入口，再由核心連線到遠端伺服器。以下兩張卡片是常見設定方式，不表示必須同時建立兩組監聽。
混合監聽範例
- 本機位址
127.0.0.1- 連接埠範例
10808- 支援的通訊協定
- HTTP 與 SOCKS，依實際入站設定而定
- 使用條件
- 用戶端明確顯示此連接埠為混合監聽
確認是混合連接埠後，HTTP 與 SOCKS 應用程式才可共用同一個連接埠。
分開監聽範例
- 本機位址
127.0.0.1- SOCKS 連接埠
10808- HTTP 連接埠
10809- 使用條件
- 目前設定確實分別啟用了兩個入口
舊版教學常使用這組分開的連接埠；實際設定前仍須確認目前用戶端顯示的值。
若記錄出現 address already in use，表示監聽位址或連接埠已遭占用。請先關閉重複執行的用戶端，再檢查其他代理程序。若確實需要更改連接埠，也必須同步更新系統代理與應用程式內的手動代理設定；只改用戶端一處，應用程式仍會連到舊連接埠。
- 單機使用時維持監聽於迴圈位址即可，初次連線不必開放區域網路存取。
127.0.0.1代表目前這台裝置。其他裝置填入此位址，無法連線至執行 v2rayN 的電腦。- 本機瀏覽器連線不需要在路由器設定連接埠轉送，也不應將本機代理入口直接公開至網際網路。
五、系統代理與 TUN：初次設定先選擇一種入口
節點已啟動但瀏覽器未使用代理，常見原因是尚未設定系統代理。可在 Windows 系統匣或 macOS 選單列開啟 v2rayN 選單，選擇「系統代理」→「自動設定系統代理」。此處的「自動設定」是用戶端選單中的操作，不應直接解讀為瀏覽器 PAC 指令碼模式。
系統代理
建議適合初次測試。用戶端會將本機代理入口寫入系統設定，讀取系統代理設定的瀏覽器或應用程式即可使用；不讀取此設定的應用程式仍可能直接連線。
適用情境：先測試網頁連線，並檢查節點與連接埠問題。
應用程式內設定代理
在單一應用程式中輸入本機 HTTP 或 SOCKS 位址與連接埠，方便指定應用程式測試。若已安裝瀏覽器代理擴充功能，請先確認其設定是否會覆蓋系統設定。
適用情境：只讓指定應用程式使用代理，或確認系統代理是否生效。
TUN 模式
透過虛擬網路介面接管流量，通常還會涉及權限、路由與 DNS。實際效果會受作業系統、核心與排除規則影響，不代表所有流量都必定經由代理出口。
適用情境：基本連線正常，但目標應用程式不讀取系統代理設定。
系統代理處理的是「應用程式如何連入核心」，路由分流處理的是「流量進入核心後如何送出」。即使啟用系統代理，路由規則仍可能讓部分目標直接連線。初次測試請保留預設路由，並選擇依目前規則應走代理的目標；不要用原本就會直連的網站判斷代理是否正常。
六、連線測試：從核心記錄到實際請求
節點延遲數值只代表該項測試有收到回應，不表示網頁、DNS 與傳輸層都運作正常。初次驗收請依下列順序進行，每次只變更一個條件，並記錄測試所用的節點、路由模式與本機連接埠。
- 檢查啟動：選定活動節點後，確認記錄中沒有設定解析失敗、核心結束或監聽連接埠遭占用等錯誤。
- 檢查入口：確認瀏覽器會讀取系統代理，或已在應用程式中明確指定啟用中的本機連接埠。
- 檢查請求：開啟依目前規則應使用代理的 HTTPS 網頁，確認是否連線成功，並留意記錄中的相關錯誤。
- 確認可重現：關閉並重新開啟瀏覽器，再正常重新啟動用戶端，確認連線可以恢復，而非只成功一次。
若本機已安裝可用的 curl，可略過瀏覽器設定，明確指定入口測試一次。以下範例僅適用於已確認 10808 是 SOCKS 或混合連接埠的情況；Windows 請使用 curl.exe，macOS 則可將命令名稱改為 curl。範例網域用來測試請求流程，最終是否經過代理仍由路由規則決定。
curl.exe --proxy socks5h://127.0.0.1:10808 --connect-timeout 10 --max-time 20 -I https://example.com/socks5h 表示由代理端解析目標網域；範例中的 10 秒是連線逾時上限，20 秒是整個請求的時間上限，並非實測延遲。若提示無法連線至本機連接埠，請先檢查核心與監聽狀態；若已連上本機連接埠但遠端交握失敗，再檢查節點參數、系統時間與網路連線。
七、開機啟動與常見問題：確認穩定後再設為自動執行
確認手動啟動、更新訂閱與瀏覽網頁都正常後，再前往「設定」→「參數設定」，尋找目前版本的開機啟動選項。macOS 也可在「系統設定」→「一般」→「登入項目」確認是否允許應用程式在登入時執行；不同系統版本的選單名稱可能略有差異。
- 只保留一種啟動方式：避免同時加入系統登入項目、捷徑與用戶端自動啟動，導致多個執行個體爭用同一個連接埠。
- 分清啟動與連線：開機時開啟用戶端，不保證核心已成功執行，也不保證系統代理已設定。
- 更新前先備份：先正常結束用戶端，再備份目前的設定與訂閱記錄；核心執行期間不要直接覆寫檔案。
- 重新啟動後確認：檢查活動節點是否保留、連接埠是否一致，以及瀏覽器是否仍能完成實際請求。
連按兩下後沒有視窗，一定要使用管理員權限嗎？
先確認系統匣或選單列是否已有執行中的執行個體，再檢查安裝檔架構與執行階段提示。Windows 一般使用系統代理通常不需要長期以管理員身分執行；只有明確需要虛擬網卡等功能時，才依目前版本要求授權。
macOS 顯示無法開啟，可以直接解除限制嗎？
先確認安裝檔來源、晶片架構與檔案是否完整。若應用程式來源可信但尚未獲系統認可，可查看「系統設定」→「隱私權與安全性」是否提供允許開啟的選項；若提示檔案已損毀或有風險，請先停止執行並重新取得可信的安裝檔，不要一次關閉所有系統安全機制。
訂閱已更新，為什麼還是無法上網？
先將一個節點設為活動伺服器，再檢查核心記錄，最後確認已執行「系統代理」→「自動設定系統代理」。訂閱下載成功只代表已取得設定，不能證明節點伺服器可連線，或本機代理已套用至瀏覽器。
關閉 v2rayN 後，一般網頁也無法開啟，該怎麼處理？
重新開啟用戶端並執行「清除系統代理」。若用戶端暫時無法啟動，請在系統網路代理設定中移除殘留的本機代理位址，同時檢查瀏覽器擴充功能是否仍強制使用舊連接埠，再重新測試直接連線。
初次安裝完成的標準是：設定能儲存、核心能啟動、單一節點能完成實際請求，且結束用戶端後可恢復直接連線。確認這四項都正常後，再逐步加入 TUN、特定應用程式需求或自訂路由；後續若出現問題，也更容易找出原因。