適合初次使用 v2rayN，或從 Windows 轉換到 macOS 的使用者。依序完成「選對安裝檔 → 啟動核心 → 匯入設定 → 確認本機監聽 → 設定系統代理 → 測試連線」，先確認一個節點可正常使用，再設定分流及其他功能。文中的連接埠是明確標示的設定範例，不代表所有版本的預設值；選單名稱可能因桌面版介面而異，請以目前的設定頁面和執行記錄為準。
1. 選擇安裝檔：先確認作業系統與處理器
v2rayN 是桌面圖形化用戶端，負責管理節點、訂閱、路由及核心程序；實際處理代理連線的是核心。主視窗能開啟，只代表介面已成功啟動，無法據此判斷核心正在執行，也不代表瀏覽器流量已經透過代理。首次安裝時，請分別確認這幾個環節。
| 使用環境 | 選擇原則 | 初次檢查 |
|---|---|---|
| Windows x64 | 選擇相符的桌面版安裝檔；WPF 是 Windows 傳統介面，不是 macOS 安裝檔。 | 前往「設定」→「系統」→「系統資訊」確認系統類型，並查看安裝檔的執行需求。 |
| macOS Apple 晶片 | 選擇 arm64 版 DMG。 | 點選蘋果選單 →「關於這台 Mac」，確認晶片資訊。 |
| macOS Intel | 選擇 x64 版 DMG。 | 確認處理器類型及軟體要求的最低作業系統版本。 |
Windows 壓縮檔請先完整解壓縮至可寫入的資料夾，例如 C:\Tools\v2rayN，再啟動其中的主程式。不要直接從壓縮軟體的預覽畫面執行，也不要只把主程式單獨拖出來：核心、資源及其他相依檔案可能仍留在壓縮檔內。若下載的是安裝程式，請依照安裝精靈操作，不必硬套解壓縮流程。
在 macOS 開啟 DMG 後，將 App 拖曳至「應用程式」，退出磁碟映像，再從「應用程式」啟動。這樣可避免之後仍從暫存的掛載位置執行。跨裝置移轉時，請使用用戶端提供的匯入或備份功能；不要直接覆蓋另一個平台的整個程式資料夾，尤其要重新檢查核心路徑和檔案權限。
2. 初次啟動：五個步驟完成基本設定
先使用一般系統代理模式完成基本測試。TUN、複雜分流、自訂 DNS 和自動啟動可稍後再設定，避免同時變更多個變數。以下採用常見的選單名稱；若跨平台介面的入口位置不同，可在相關設定頁依欄位名稱尋找，不必拘泥於完全相同的按鈕排列。
-
啟動程式並查看記錄
開啟主程式，查看主視窗的記錄區域，確認沒有「找不到核心檔案」、「權限不足」或啟動後立即退出等錯誤。若缺少相依元件，請依目前安裝檔的說明補齊，不要從陌生網站單獨下載同名執行檔。
-
新增訂閱
前往「訂閱群組」→「訂閱群組設定」，新增群組，將訂閱網址填入 URL 欄位並儲存；接著從「訂閱群組」選單執行「更新全部訂閱（不透過代理）」。部分介面會將更新功能放在群組的右鍵選單中。
-
選取節點
更新後確認清單中出現節點，選取目標節點並按 Enter，或從右鍵選單執行「設為作用中伺服器」。確認目前的作用中項目，避免只選取表格列，卻沒有真正切換連線設定。
-
確認核心
開啟「設定」→「參數設定」中的「Core 類型」或相關核心設定頁面，確認目前協定使用的核心。儲存後查看重新啟動記錄；若此版本沒有這個選項，請以節點編輯頁和實際啟動記錄顯示的核心為準。
-
設定系統代理
在 Windows 的系統匣圖示選單中，從「系統代理」選擇「自動設定系統代理」；若跨平台介面提供狀態列入口，也可使用同名選項。macOS 若要求授權代理設定，請先閱讀提示，再到系統網路設定確認實際代理位址和連接埠。
訂閱無法直接連線更新時，只有在已有可用的作用中節點後，才適合嘗試「更新全部訂閱（透過代理）」。清單為空或核心尚未啟動時，直接切換這個選項通常無法解決初次匯入問題。單一節點的分享連結則使用「伺服器」→「從剪貼簿匯入分享連結」，不要將它當成可定期更新的訂閱網址。
3. 選擇核心：依節點參數判斷，不要憑名稱猜測效能
Project V 是相關代理技術的生態背景，V2Fly 與 Xray 則是不同的核心專案。v2rayN 是否能使用特定核心，取決於目前版本、安裝檔和設定入口是否支援。不要只因介面出現 VMess 或 VLESS，就認定任何核心都能處理節點的所有擴充參數。
Xray 核心
建議節點包含 VLESS、REALITY 或 Vision 參數時，優先確認 Xray 的適用條件與版本需求。保留訂閱提供的傳輸方式、安全層、伺服器名稱和 Flow 等欄位，不要將 VMess 節點直接改成 VLESS。
適用情況：伺服器明確要求使用 Xray，或節點採用相關擴充參數。
V2Fly 核心
如果目前的 v2rayN 版本提供此核心選項，且伺服器設定明確相容，可依需求使用。匯入 VMess 後仍須確認傳輸方式、安全層及核心版本；更換核心並非通用的修復方式。
適用情況：環境已有明確的 V2Fly 設定需求，且需要維持原有設定行為。
確認核心是否生效，應查看儲存設定後產生的啟動記錄和錯誤訊息，而非只看下拉選單。若出現欄位未知、無法解析設定或不支援某種安全設定，請先確認核心版本與節點參數是否相符；若顯示連線逾時，則應檢查網路連線、伺服器位址和連接埠。這是不同層面的問題。
- 每次只修改一項：先記下目前設定，再調整核心或節點參數，以便需要時還原。
- 優先保留訂閱欄位：自動匯入後，不要任意修改 SNI、傳輸路徑或公鑰。
- 介面與核心分開確認：升級介面不代表所有核心檔案也已更新，請以安裝檔說明和執行記錄為準。
4. 本機連接埠：分清代理入口與遠端伺服器
瀏覽器連線至電腦上的本機代理入口，再由核心連線到遠端伺服器。節點中的遠端連接埠，例如 443，不應填入系統代理的本機連接埠欄位。以下以一組便於排查的範例說明；實際值請以「設定」→「參數設定」中的本機監聽設定為準。
有些版本提供獨立的 SOCKS 和 HTTP 連接埠，有些則使用混合入口。確認該連接埠支援 HTTP 代理後，才能用來設定系統 HTTP/HTTPS 代理。不要照抄範例就假設連接埠已存在，也不要為了讓其他裝置連線，就直接將監聽範圍擴大到所有網路介面。
用戶端監聽設定範例
- 監聽位址
- 127.0.0.1
- SOCKS 入口
- 10808，請確認已啟用
- HTTP 入口
- 10809，請確認已啟用
- 區域網路存取
- 初次測試時請保持關閉
這是設定範例，不是固定預設值；混合入口請依目前版本的實際設定填寫。
系統代理設定確認
- 伺服器位址
- 127.0.0.1
- HTTP 連接埠
- 與用戶端的 HTTP 或混合入口相同
- HTTPS 請求
- 使用支援 CONNECT 的本機 HTTP 代理
- 退出後的處理方式
- 停用用戶端前，先清除相應的代理設定
HTTPS 代理欄位通常仍指向本機 HTTP 代理入口，不需要在迴路位址上部署憑證。
在 Windows 可前往「設定」→「網路和網際網路」→「Proxy」查看系統代理；在 macOS 可前往「系統設定」→「網路」→目前的網路服務→「詳細資訊」→「Proxy」檢查。若用戶端使用 PAC，請確認自動代理設定項目；若使用手動 HTTP 代理，則確認伺服器和連接埠，不要只檢查其中一種設定。
5. 測試連線：先測代理入口，再測瀏覽器
系統代理只會影響遵循系統代理設定的程式，不代表電腦上的所有流量都會被接管。路由規則則是在請求進入核心後，決定要直接連線或透過代理；「啟用系統代理」和「所有請求都經由遠端節點」是兩回事。首次測試時，請選擇確定會符合代理規則的目標，同時查看記錄。
- 確認作用中節點、核心啟動時間及本機監聽連接埠，先排除程序尚未啟動的可能。
- 使用明確指定代理的命令，測試本機入口到遠端目標的連線。
- 接著用瀏覽器造訪相同目標；若命令成功、瀏覽器卻失敗，請優先檢查系統代理和瀏覽器本身的設定。
- 基本連線穩定後，再逐項調整路由、DNS 和其他流量接管方式，每次變更後都重新測試。
以下命令假設已確認 127.0.0.1:10808 是 SOCKS 入口。socks5h 會將目標網域交由代理端解析，適合與由應用程式自行解析網域的情況比較；但單靠這項測試，無法證明整台電腦沒有其他 DNS 請求。
Windows PowerShell
Get-NetTCPConnection -LocalPort 10808 -State Listen
curl.exe --proxy socks5h://127.0.0.1:10808 --connect-timeout 10 --max-time 20 -I https://example.commacOS 終端機
lsof -nP -iTCP:10808 -sTCP:LISTEN
curl --proxy socks5h://127.0.0.1:10808 --connect-timeout 10 --max-time 20 -I https://example.com此處的 10 秒連線逾時和 20 秒總時限是診斷參數，不是實測延遲。若監聽檢查沒有結果，請先修復本機入口；若顯示拒絕連線，請檢查連接埠、程序和入口類型；收到 HTTP 回應表示該次請求已抵達目標並取得回應，但最終是直接連線還是透過代理，仍須搭配路由記錄判斷。若出現憑證錯誤，還需檢查系統時間和信任鏈，不要直接停用憑證驗證。
6. 常見問題：安全警示、連接埠衝突與退出後無法上網
Windows 安全軟體攔截時，可以直接允許嗎？
不要只憑檔名就認定是誤判。開啟「Windows 安全性」→「病毒與威脅防護」→「保護歷程記錄」，記下偵測名稱和遭封鎖的路徑，並確認下載來源、安裝檔內的檔案及發行說明。確認前不要停用整套防護，也不要將整個下載資料夾加入排除清單；若無法判斷，請先停止執行。
macOS 顯示無法驗證開發者時該怎麼辦？
先確認 App 來源及系統版本需求。若系統允許使用者確認是否開啟而顯示開發者驗證提示，可嘗試啟動後前往「系統設定」→「隱私權與安全性」，查看是否有「仍要打開」選項。若提示涉及惡意軟體風險，請停止操作並進一步查證，不要將所有安全警告都當成一般的首次啟動提示。
記錄出現 address already in use？
這表示監聽位址或連接埠發生衝突。在 Windows 可執行 netstat -ano | findstr :10808，在 macOS 可執行 lsof -nP -iTCP:10808 -sTCP:LISTEN，再依程序資訊確認占用者。先關閉重複啟動的用戶端；若要變更連接埠，儲存後重新啟動核心，並同步更新系統代理及應用程式的手動代理設定。
程式已退出，為什麼瀏覽器反而無法上網？
系統可能仍指向已停止運作的迴路代理。請重新開啟 v2rayN，透過「系統代理」→「清除系統代理」清除相關設定；若無法啟動，請在系統代理頁面停用相應的手動代理或 PAC。公司管理的裝置請先記錄原有設定，不要刪除組織佈署的代理設定。
節點顯示有延遲，網頁還是開不起來？
延遲測試只反映測試方式涵蓋的部分連線，無法取代實際應用程式的連線測試。請依前述的明確指定代理命令重新測試，再檢查作用中節點、路由規則是否命中、DNS 錯誤及瀏覽器代理設定。若多個節點都在相同步驟失敗，請優先檢查共用的本機設定，而不是反覆重新安裝用戶端。
7. 保存基準設定：更新或移轉前留下記錄
首次成功連線後，記下可正常運作的最小設定：用戶端與核心版本、作業系統版本、作用中節點所屬群組、監聽連接埠、系統代理方式和路由模式。日後升級遇到問題時，這些資訊比「昨天還能用」更有助於找出原因。跨平台移轉時請手動匯入並逐項確認，不要假設程式資料夾、權限或系統代理設定會自動同步。
- 更新前：使用目前用戶端提供的備份或匯出功能保存設定，並將訂閱憑證和備份檔案存放在安全的位置。
- 更新後：先重新測試原有節點和明確指定代理的命令，再啟用新功能；若發生異常，請保留第一筆錯誤記錄。
- 回報問題時：提供系統架構、核心啟動錯誤及重現步驟，並遮蔽訂閱網址、使用者識別資訊和節點憑證。
- 移轉後：重新確認本機連接埠、核心檔案位置、系統代理及防火牆提示，避免直接照搬另一台裝置的路徑。
完整的安裝驗收不只是「視窗能開啟」，還要確認核心能穩定啟動、本機入口正在監聽、明確指定代理的請求可正常使用、瀏覽器能依預期透過代理連線，以及退出後系統網路恢復正常。如需依錯誤狀況進一步排查，請前往問題診斷，依序檢查啟動、監聽、連線、解析和路由。