v2rayN 初次安裝與設定：Windows、macOS 解壓與啟動、核心及權限問題

本文重點

本文適合第一次使用 v2rayN 的 Windows 與 macOS 使用者。依序完成「選擇安裝檔、移至固定資料夾、確認核心啟動、匯入設定、設定系統代理」，先建立一般代理連線，再考慮 TUN 模式。若啟動失敗，可從記錄、檔案路徑和本機監聽連接埠找出問題，不要將所有故障都歸咎於節點。

一、選擇安裝檔：先確認作業系統，再確認處理器

v2rayN 是用來管理設定的用戶端介面，實際代理連線由核心負責。下載後能開啟主程式，不代表核心已完整安裝或設定已可使用。首次安裝時請保留安裝檔提供的資料夾結構；不要只把主程式複製到桌面，也不要混用不同發行套件中的檔案。

Windows 可在「設定」→「系統」→「系統資訊」查看「系統類型」；macOS 可從蘋果選單→「關於這台 Mac」查看「晶片」或「處理器」。Apple 晶片選 ARM64，Intel 處理器選 x64。Windows ARM 裝置請勿將 x64 套件視為原生 ARM64 版本，能否執行仍取決於系統的相容性。

Windows 桌面版

建議

首次安裝建議從下載頁選擇 Windows 桌面版。依照頁面說明分辨安裝程式與壓縮檔：安裝程式依照精靈完成安裝，壓縮檔則須完整解壓後再執行。

適用對象：首次安裝、希望使用跨平台桌面介面的 Windows 使用者。

Windows WPF 版

保留傳統 Windows 介面。若已習慣這種介面，可選擇此版本；請勿直接用桌面版的設定檔覆蓋 WPF 版資料夾，遷移前先備份。

適用對象：熟悉傳統 Windows 選單與視窗配置的使用者。

macOS 桌面版

依處理器選擇 ARM64 或 x64。下載 DMG 後先開啟映像檔，將應用程式拖曳至「應用程式」，再從該資料夾啟動；請勿長期直接從已掛載的映像檔執行。

適用對象：使用 Apple 晶片或 Intel 處理器 Mac 的使用者。

二、Windows 解壓與首次啟動：使用固定資料夾並保留完整檔案

以下步驟適用於以壓縮檔發佈的版本。若下載的是安裝程式，請先完成安裝，不要將安裝程式當成壓縮檔處理。使用一般系統代理不需要先啟用 TUN，也不應將「一律以系統管理員身分執行」當作所有啟動故障的通用解法。

完整解壓

在壓縮檔上按右鍵→「全部解壓縮」，解壓至目前帳戶有寫入權限的固定資料夾，例如 D:\Tools\v2rayN。不要在壓縮軟體的預覽視窗中直接開啟主程式；解壓至暫存位置可能造成設定檔與核心不在同一個資料夾。
執行主程式

開啟解壓後的資料夾，執行 v2rayN.exe。請保留同一資料夾中的相依檔案與子資料夾；若要在桌面建立入口，請建立捷徑，不要移動執行檔。
檢查執行階段

若出現要求安裝 .NET Desktop Runtime 的對話方塊，請依提示確認所需的執行階段版本與架構。不同發行套件是否內含執行階段並不相同，請勿只因看到 .NET 字樣就任意安裝其他架構的版本。
匯入訂閱

在主介面選擇「訂閱群組」→「訂閱群組設定」，新增群組並填入網址，儲存後再從「訂閱群組」選單更新。不同版本的介面可能使用「新增」或「+」按鈕；請填入訂閱群組的網址欄位，而非單一節點的編輯欄位。
選取伺服器

更新後，從伺服器清單選取一項，並在右鍵選單中選擇「設為作用中伺服器」以啟用。接著查看主介面的記錄區，確認沒有「啟動程序失敗」、「檔案不存在」或連接埠繫結錯誤，再設定系統代理。

三、macOS 權限設定：分辨應用程式遭封鎖與核心執行失敗

首次開啟應用程式時出現的系統提示，與代理核心啟動失敗是兩種不同問題。前者發生在應用程式啟動時；後者通常可從應用程式記錄中查看相關檔案。若已顯示應用程式視窗，但連線按鈕沒有反應，請繼續檢查記錄，而不是反覆將整個應用程式移出再拖回「應用程式」。

先完成複製：將應用程式移至「應用程式」，退出下載映像檔，再從 Finder 開啟應用程式。若使用壓縮檔發佈，請先解壓至固定位置，不要從下載預覽中執行。
處理首次封鎖：確認下載來源後，在 Finder 中按住 Control 鍵並按一下應用程式→「打開」。若系統仍然封鎖，請前往「系統設定」→「隱私權與安全性」查看相關提示；確認是這次下載的應用程式後，才選擇「仍要打開」。不同系統版本的按鈕可能有所不同。
查看核心錯誤：記錄中的 permission denied 表示執行權限或存取權限有問題；bad CPU type in executable 則表示架構不相符。兩者應採用不同的修復方式。
按需授權：若變更系統代理時出現授權提示，請先確認應用程式名稱再操作。首次測試一般代理不需要為了排錯而授予「完整磁碟存取」權限。

不要照抄會遞迴移除整個資料夾安全屬性的終端機指令，也不要一概認為「應用程式已損壞」就必須繞過系統限制。請先重新下載符合處理器架構的發行套件，再檢查系統提示；受機構管理的裝置也可能受到組織政策限制，請洽管理員確認。

四、核心檔案位置：以記錄中的啟動路徑為準

v2rayN 用來管理伺服器與設定，Xray、V2Fly 等核心則負責執行對應設定。協定名稱與核心名稱屬於不同層級。VLESS 搭配 REALITY 需要使用支援此組合的核心；不能因為兩種核心都能處理部分代理協定，就認為可以任意互換。

Windows 檢查項目

主程式: v2rayN.exe
核心範例: Xray 執行檔通常名為 xray.exe
常見資料夾: 發行套件的 bin 子資料夾及其中的核心子資料夾
路徑依據: 記錄中實際嘗試啟動的檔案路徑

資料夾結構會因發行套件而異；請勿依照舊教學手動建立同名資料夾。

macOS 檢查項目

應用程式位置: /Applications 中的應用程式套件
核心範例: Xray 執行檔通常沒有 .exe 副檔名
架構相符: ARM64 或 x64，需符合所選的發行套件
錯誤判斷依據: 記錄中的執行路徑、權限錯誤與架構錯誤

應用程式套件內的資源與使用者資料夾可能分開存放，請以目前使用的發行套件和啟動記錄為準。

若要確認核心選擇，請開啟「設定」→「參數設定」，查看目前介面提供的核心選項；部分介面會標示為「Core 類型」，也可能依協定分別設定。若沒有錯誤，請勿反覆更換核心。若記錄明確指出找不到核心，請優先重新完整安裝相應的發行套件，或使用用戶端提供的核心更新功能；不要將任意下載的執行檔改名後放入資料夾。

檔案不存在：依照記錄中的路徑尋找檔案，確認是否解壓遺漏、遭安全軟體隔離，或更新過程中斷。
設定解析失敗：查看錯誤指出的欄位名稱，確認節點協定與核心支援範圍；這不是開啟系統代理就能修復的問題。
缺少資料檔案：若路由規則引用 geoip.dat 或 geosite.dat，也請確認核心使用的資源位置中有這些資料檔案。

五、系統代理與連接埠：先確認本機入口正常

核心正常啟動後，請在主介面的「系統代理」選單中選擇「自動設定系統代理」。系統代理會讓遵循系統設定的應用程式將請求交給本機代理；路由規則則決定請求進入核心後要經由代理或直接連線。選擇「全域」路由不會自動接管所有應用程式，也不能取代系統代理設定。

在「設定」→「參數設定」中確認本機監聽連接埠；相關欄位可能位於基本設定頁。以下使用 127.0.0.1:10808 作為排查範例，並非所有安裝版本的預設值。執行前請替換為介面顯示的實際連接埠，並確認該連接埠提供 HTTP 或混合代理入口。

檢查是否有程式正在監聽

Windows 請在 PowerShell 執行第一行指令，macOS 請在終端機執行第二行指令。出現監聽記錄只能表示有程序占用該連接埠，還需確認該程序是否為此次啟動的核心。

# Windows PowerShell
Get-NetTCPConnection -State Listen -LocalPort 10808 |
  Select-Object LocalAddress, LocalPort, OwningProcess

# macOS 終端機
lsof -nP -iTCP:10808 -sTCP:LISTEN

沒有監聽記錄：返回用戶端記錄，檢查核心是否未啟動、連接埠設定是否未儲存，或設定檔是否產生失敗。
記錄出現 address already in use：先關閉重複執行的用戶端，再檢查占用連接埠的程序。確認來源前，請勿直接結束不熟悉的系統程序。
變更監聽連接埠後：重新啟動核心並重新套用系統代理設定，避免系統仍指向舊的連接埠。

明確指定代理進行測試

以下請求用來確認 HTTP 代理入口是否能接受連線。Windows 請使用 curl.exe，macOS 請使用 curl。目標網址僅供連線測試；若路由將該網址設為直接連線，即使收到成功回應，也不能證明遠端代理節點可用。

# Windows
curl.exe --proxy http://127.0.0.1:10808 --connect-timeout 10 -I https://example.com/

# macOS
curl --proxy http://127.0.0.1:10808 --connect-timeout 10 -I https://example.com/

六、首次安裝常見問題與結束使用後的設定還原

按兩下後沒有視窗，是不是安裝失敗？

先查看工作列通知區域或 macOS 選單列，確認程式是否已在執行。Windows 使用者可再到工作管理員檢查是否有重複程序；若出現執行階段提示，請依提示處理。不要連續按兩下開啟多個程序，否則後啟動的核心可能遇到連接埠占用。

訂閱更新失敗，需要先重新安裝嗎？

不需要先重新安裝。請確認輸入的是完整訂閱網址，而非單一的 vmess:// 或 vless:// 分享連結；單一連結應透過剪貼簿匯入功能加入。接著檢查系統日期與時間，並依據記錄區分逾時、憑證錯誤及伺服器拒絕。分享排錯截圖前，請遮住訂閱網址與帳密資料。

測速有結果，網頁還是無法開啟？

測速有結果不代表瀏覽器已使用系統代理。請依序檢查核心記錄、本機監聽狀態、系統代理位址及瀏覽器擴充功能。若明確指定代理的請求成功、瀏覽器卻失敗，請優先檢查應用程式入口；若兩者都失敗，再檢查節點、路由與 DNS 錯誤。

關閉 v2rayN 後，一般網頁也無法開啟？

請先重新開啟用戶端，在「系統代理」中選擇「清除系統代理」，再正常退出。Windows 可前往「設定」→「網路和網際網路」→「Proxy」檢查手動代理設定；macOS 可前往「系統設定」→「網路」→目前使用的網路→「詳細資訊」→「代理伺服器」檢查是否有殘留設定。修改前請記錄原本設定，請勿隨意刪除組織管理的代理設定。

完成首次設定後，記下三項資訊即可：程式實際所在資料夾、目前啟用的核心，以及本機監聽位址與連接埠。下次遇到故障時，從這三項資訊和記錄開始檢查，一次只修改一項設定。升級前請備份用戶端提供的設定資料；不要將包含訂閱帳密的完整設定檔直接貼到公開討論區。