v2rayN 初次安裝與設定教學：Windows、macOS 步驟與常見問題

選擇安裝套件：先確認作業系統與處理器架構

v2rayN 是桌面用戶端，介面負責管理設定，實際連線則由核心處理。能開啟主視窗，只代表介面已執行，不表示核心、節點和系統代理都已就緒。首次安裝請前往用戶端下載頁選擇適用平台，並確認處理器架構與套件說明。

Windows 可在「設定」→「系統」→「系統資訊」查看系統類型；macOS 可從 Apple 選單的「關於這台 Mac」查看晶片。Intel 與 AMD 的一般桌上型裝置通常選擇 x64；搭載 ARM 處理器的裝置則應優先選擇相應架構的套件。請勿將不同平台的核心檔案混放在同一個資料夾。

檔案位置：完整解壓縮後再啟動

Windows 壓縮檔請先完整解壓縮至固定資料夾，例如 D:\Apps\v2rayN，再執行其中的主程式。請勿從壓縮軟體的預覽視窗啟動，也不要只將主程式拖曳到桌面：核心、資源檔和執行相依項目可能仍留在壓縮檔中。

macOS 若下載的是磁碟映像檔或應用程式套件，請依套件說明將應用程式移至「應用程式」資料夾後再啟動；若提供的是壓縮檔，請先完成解壓縮。首次開啟時若出現系統安全性提示，請先確認下載來源與套件完整性，再前往「系統設定」→「隱私權與安全性」查看相關應用程式提示，請勿關閉整個系統的安全防護。

1. 固定資料夾

   Windows 請選擇目前使用者可寫入的資料夾；macOS 則依套件說明放置應用程式。避免使用暫存解壓縮資料夾，也不要在多個資料夾中保留同時執行的副本。

2. 首次啟動

   開啟主介面後，查看記錄或底部資訊區。若提示缺少執行環境，請依指示安裝符合架構的執行環境，切勿將任意動態程式庫複製到程式資料夾。

3. 確認核心

   前往「設定」→「參數設定」查看核心相關選項，並參照記錄確認實際啟動的核心。若提示找不到檔案，請檢查是否已完整解壓縮，以及所選核心對應的資料夾。

4. 匯入設定

   前往「訂閱群組」→「訂閱群組設定」，新增群組並填入訂閱網址；儲存後，在「訂閱群組」選單中執行更新訂閱。若選單名稱略有不同，請選擇更新相應群組的指令。

5. 選取伺服器

   在清單中選取一筆設定並設為使用中的伺服器，再檢查核心啟動記錄。清單中有節點，不代表已選定目前連線要使用的節點。

若核心檔案遭系統安全軟體隔離，請先確認下載來源，再查看隔離記錄並判斷是否還原。請勿關閉所有防護來掩蓋問題。更新或重新解壓縮前，先結束系統匣中的程式，並備份訂閱群組、路由規則和自訂設定。

訂閱與協定：匯入後檢查重要欄位

訂閱網址用來取得設定清單，不是本機代理位址。訂閱內容可能包含驗證資訊，分享螢幕截圖時請遮住完整網址、使用者識別資訊和密碼。若只有單一分享連結，可使用「伺服器」→「從剪貼簿匯入批次 URL」一類的匯入指令；請勿將分享連結填入系統代理的伺服器欄位。

• 先確認訂閱結果：更新後查看群組中是否出現設定，並檢查記錄是否顯示下載失敗、解析失敗或回傳空白內容。訂閱更新成功，不代表伺服器一定連得上。
• 再確認協定：VMess 與 VLESS 是不同協定；WebSocket 是傳輸方式，TLS 是連線安全設定，彼此不能取代。匯入後應保留伺服器要求的組合。
• 依設定選擇核心：VLESS 與 REALITY 等設定需要支援相應功能的核心及版本。Xray 與 V2Fly 的功能並不完全相同，請勿把切換核心當成通用的修復方法。
• 避免盲目修改參數：伺服器位址、連接埠、使用者識別資訊、傳輸路徑、SNI 和公鑰等資訊都必須與伺服器設定一致。訂閱已正確填入的欄位，不應照著其他教學截圖改寫。

監聽連接埠：統一用戶端與應用程式設定

本機監聽連接埠是瀏覽器、系統或命令列連線到 v2rayN 的入口，不是遠端伺服器的連接埠。前往「設定」→「參數設定」，找到本機監聽或入站相關設定，記下實際位址、連接埠及支援的代理類型。不同版本和舊設定可能使用不同連接埠，請勿只憑教學內容記憶來填寫。

以下兩張卡片假設你已確認目前有 127.0.0.1:10808 混合監聽，並同時接受 HTTP 與 SOCKS 要求。若用戶端採用分開監聽，請分別填入實際連接埠；不要只為了照抄範例，就強行將兩種入口改成相同連接埠。

僅供本機使用時，請保留迴路監聽，無須啟用允許區域網路連線。修改連接埠後，請讓核心重新載入設定，並同步更新手動設定代理的應用程式。若記錄出現 address already in use，先確認是否同時執行了兩個用戶端，再找出占用連接埠的程序，不要連續嘗試隨機連接埠。

系統代理：先驗證核心，再轉送應用程式流量

初次排查建議先不要啟用 TUN，只驗證本機代理連線。確認用戶端有可用節點且核心已開始監聽後，再從主視窗或系統匣選單的「系統代理」中選擇「自動設定系統代理」。這裡的「自動設定」是用戶端的選單動作，不代表要使用者手動填寫 PAC 指令碼網址。

• Windows：前往「設定」→「網路和網際網路」→「Proxy」確認代理位址與連接埠是否指向目前的監聽入口。受組織原則管理的裝置可能無法修改，請先確認管理規範。
• macOS：前往「系統設定」→「網路」→目前的網路服務→「詳細資訊」→「代理伺服器」檢查。部分系統版本需要授權才能修改網路代理設定，請留意權限提示。
• 適用範圍：系統代理不保證所有程式都會遵循。部分命令列工具、遊戲及自行設定代理的應用程式有各自的網路連線方式，不能根據單一應用程式的結果推斷所有流量。
• 結束順序：停止使用前，先清除系統代理再結束用戶端；若結束後網頁無法開啟，請優先確認系統代理是否仍指向本機連接埠。

使用明確指定代理的要求來隔離問題

Windows 可在 PowerShell 中使用下列指令；macOS 終端機請將 curl.exe 改為 curl。此範例要求本機 10808 接受 HTTP 代理。測試網址為 https://example.com/，僅用於確認連線，不是專用測速服務。

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

收到 HTTP 回應，表示這次要求已透過指定的代理入口送出，但不能據此判斷所有網站或 UDP 流量都能正常使用。若提示無法連線至本機連接埠，先檢查監聽狀態；若代理連線已建立，之後才出現 TLS 或遠端逾時，請搭配核心記錄檢查節點、系統時間與網路。若明確指定代理的要求正常，但瀏覽器仍無法使用，請檢查瀏覽器的個別代理設定、擴充功能及系統代理，不要立即重新安裝用戶端。

首次執行常見問題：依症狀縮小排查範圍

完成檢查：儲存可用設定，再進行進階調整

首次設定成功後，先記錄實際可用的設定，再考慮開機啟動、路由規則和 TUN。系統代理決定應用程式是否將連線交給用戶端；路由分流則決定已進入核心的連線要從哪個出口送出。兩者位於不同環節，啟用系統代理不代表所有目標都會透過遠端節點連線。

• 確認固定資料夾中的程式可再次啟動，且核心記錄沒有啟動錯誤。
• 記下使用中的訂閱群組、節點協定、所用核心與本機監聽連接埠；備份時請妥善保護訂閱憑證。
• 分別測試一項明確指定代理的要求，以及一次使用系統代理的瀏覽器連線。
• 測試清除系統代理後能否正常連線，避免下次結束用戶端後誤以為網路中斷。
• 每次只調整一項進階設定；保留修改前的路由、DNS 和入站設定，以便發生問題時逐項還原。

如需參考完整流程，請查看用戶端設定教學；若要了解 VMess、VLESS、傳輸方式與核心功能的差異，請參閱協定手冊。逐一確認「設定已匯入、核心已啟動、連接埠可連線、應用程式已使用代理」這四個狀態，比反覆重新下載安裝套件更容易找出問題。