V2Ray 全平台
安裝與設定指南

一般準備：系統、架構與設定來源

確認安裝目標與用戶端適用範圍

V2Ray 是代理生態系中的技術名稱，不代表某一款特定圖形介面。用戶端負責儲存伺服器資料、更新訂閱、產生設定並呼叫核心；核心則負責實際的協定通訊、入站監聽與路由執行。v2rayN 適用於 Windows、macOS 和 Linux 桌面環境；v2rayNG 與 v2flyNG 適用於 Android。請先選擇平台，再挑選安裝套件；桌面程式不能解壓到手機後直接執行，也別把 Android 設定介面上的按鈕名稱當成桌面版操作步驟。

安裝前請記下作業系統、處理器架構，以及預計使用的套件格式。Windows 可在「設定 → 系統 → 關於」查看系統類型；macOS 可在「關於這台 Mac」查看晶片資訊；Linux 可執行下方指令查看機器架構與發行版；Android 則可查詢裝置規格或已安裝應用程式的架構資訊。作業系統支援的架構比處理器的行銷名稱更重要，尤其是使用相容層或較舊系統的裝置。下載頁提供的選項才是目前可用的套件，請勿只憑檔名印象選擇。

uname -m
cat /etc/os-release

Linux 顯示 x86_64 時通常選 x64；顯示 aarch64 時通常選 arm64。發行版資訊用來判斷 deb 或 rpm，不能用來判斷處理器架構。macOS 的 Apple Silicon 與 Intel 分別對應 arm64 和 x64。Android 的 arm64 套件僅適用於支援該應用程式架構的系統；若無法確認，請先閱讀Android 下載說明，再考慮通用版。

準備可匯入的連線資料

安裝用戶端並不會自動產生可用的伺服器。請準備由可信任的設定提供者提供的單一分享連結或訂閱網址，並確認資料仍在有效期限內。分享連結描述單一設定，訂閱網址則用來取得一組設定，兩者不能貼進同一種輸入欄位。訂閱網址有時包含存取憑證，應視為敏感資訊妥善保存；截圖、記錄檔和求助內容都不應留下完整網址、使用者識別資訊或認證欄位。

如果提供者提供多種協定或傳輸方案，請先選用與用戶端核心相容且說明完整的方案。位址、連接埠、協定、認證資訊、TLS 設定和傳輸參數共同構成連線條件，不能只複製伺服器網域名稱。瀏覽器能開啟某個網域，也不代表代理設定正確。初次使用時，先以明確的單一設定建立基準，再新增訂閱，有助於分辨訂閱取得問題與實際連線問題。

建立環境基準，避免同時修改多項設定

安裝前記下既有代理軟體、系統代理狀態、網路介面，以及是否已安裝虛擬網路工具。初次測試只啟用一個用戶端，避免兩個程式同時修改系統代理、監聽連接埠或預設路由。公司裝置的安全政策、受管理網路的存取規則，以及本機防火牆都可能限制虛擬介面或背景監聽；請先確認權限範圍，不要把關閉所有防護功能當成安裝步驟。

系統時間也是連線條件之一。時間偏差會影響憑證有效期判斷及部分認證程序，請先啟用系統自動校時。保留安裝前的網路狀態和一份設定備份，修改前先記下原始值。備份若包含伺服器憑證，應存放在只有本人能存取的位置，不可當成公開附件上傳。準備完成後，進入對應的平台章節即可；不必同時使用系統代理和 TUN 兩種流量接管方式。

macOS：晶片選擇、安裝與網路授權

依晶片選擇 v2rayN 安裝套件

在「關於這台 Mac」查看晶片資訊，再前往macOS 下載區。Apple Silicon 請選 arm64，Intel 請選 x64。不要根據螢幕尺寸或購買年份推測架構。某些相容環境可執行另一種架構的應用程式，但原生架構通常更容易判斷執行相依元件與權限問題。下載完成後開啟 dmg，依視窗指示將應用程式移至「應用程式」資料夾。

複製完成後，請從「應用程式」資料夾啟動 v2rayN，不要長期從磁碟映像檔中執行。磁碟映像檔是發佈媒介，卸載後其中的路徑便會消失，也可能影響應用程式的儲存與更新。首次啟動若出現系統安全提示，請確認檔案來源與提示內容，再依系統提供的授權方式處理。不要為了單一應用程式關閉整個系統的安全檢查，也不建議貼上來源不明的權限修改指令。

應用程式啟動後，先確認設定能否儲存、核心能否正常啟動。若介面能開啟，但隨附執行檔因權限或架構不符而無法執行，記錄檔通常會停在啟動階段。此時應先解決本機執行問題，不必修改遠端伺服器參數。系統更新後若原有授權有所變動，也應重新查看提示，不要直接複製舊電腦的權限狀態。

匯入設定與網路服務代理

複製分享連結後，從用戶端的剪貼簿入口匯入；或在訂閱群組中儲存訂閱網址並更新。macOS 剪貼簿可能保留先前的內容，匯入失敗時請確認複製的是完整連結，沒有附帶說明文字或換行。匯入完成後，設定目前使用的項目，再啟動核心。測試時選用明確會讀取系統代理的應用程式，盡量不要同時啟用具有獨立代理設定的瀏覽器擴充功能。

系統代理通常與特定網路服務綁定。Wi-Fi 和有線網路可能有不同的代理狀態，切換網路後應重新確認目前使用的服務，不要只查看用戶端選單。開啟系統網路設定，在正在使用的網路服務中查看代理選項，確認位址和連接埠指向用戶端實際監聽的位置。若裝置使用自動代理設定指令碼，也要確認手動代理與指令碼之間的套用順序。

系統要求授權修改代理設定時，請先確認要求是由目前的用戶端提出，再完成授權。拒絕授權不一定會影響核心的本機監聽，但應用程式不會自動使用這個入口。可先在應用程式內手動填入代理位址進行測試，確認連線正常後再處理系統設定。如此可將「無法寫入系統代理」與「核心無法連線至伺服器」分成兩個獨立問題。

TUN、DNS 與休眠後連線恢復

TUN 模式是否可用，取決於目前用戶端版本、核心能力與系統權限。啟用前請記下目前的網路服務和 DNS 設定，並關閉其他虛擬網路工具的流量接管。若介面要求提升權限或安裝輔助元件，請依目前版本的提示操作，不要將其他平台的驅動程式安裝步驟套用到 macOS。啟用後同時測試網域存取與本機網路資源，確認分流沒有改變原本需要直連的路徑。

DNS 問題可能只出現在單一應用程式。若瀏覽器啟用了獨立的安全 DNS，就不一定會使用系統或用戶端指定的解析路徑；因此一個瀏覽器失敗，不能直接證明所有 DNS 都失效。請先改用另一個應用程式比較，再檢查用戶端記錄檔中的網域解析與連線階段。使用 IP 位址連線至具有憑證的網站會改變憑證比對條件，不能視為等效的 TLS 測試。

scutil --proxy
scutil --dns

這兩個唯讀指令分別顯示目前的代理與 DNS 資訊，可用來對照圖形介面設定。輸出可能包含企業設定或本機網路資訊，分享前請移除敏感內容。電腦從休眠恢復、切換熱點或更換網路服務後，舊連線可能暫時失效；請先重新建立連線並確認服務狀態，再嘗試重新啟動核心，不必一開始就刪除整個應用程式資料夾。

結束程式與升級後的檢查

結束程式前，請還原由用戶端修改的代理狀態。如果程式異常關閉，目前的網路服務可能仍保留本機代理，導致瀏覽器連向已不存在的監聽入口。重新啟動用戶端可能有助於還原狀態；也可在系統設定中只移除本次新增的代理項目，避免覆蓋原有企業設定。升級後請確認應用程式路徑、權限、目前使用的設定和路由預設值；若同時更換晶片架構，請重新下載相符的套件，不要直接搬移舊的執行檔。

Android：v2rayNG 與 v2flyNG 設定

選擇用戶端、架構與安裝授權

Android 端建議優先使用 v2rayNG，其核心家族為 Xray；需要 V2Fly 核心設定時，可考慮 v2flyNG。選擇時應依設定所需功能與既有使用習慣，而非只比較名稱。兩款應用程式各自儲存設定和應用程式選項，安裝其中一款不會自動移轉另一款的資料。請先到Android 下載區確認套件入口與系統需求。

支援 arm64 應用程式架構的裝置通常選 arm64 套件；若無法確認架構，或安裝程式提示不相容，請再查看通用版說明。安裝套件解析失敗也可能是下載未完成、系統版本不符，或既有安裝的簽章不相容，不能只歸因於架構問題。允許目前的下載來源安裝應用程式時，請只授權實際使用的來源；安裝完成後可撤銷該權限。

如果系統提示簽章不符，請勿直接解除安裝既有用戶端。先確認舊應用程式的來源並匯出可還原的設定，因為解除安裝可能會刪除群組、手動項目和應用程式分流設定。匯出檔案含有連線憑證，應存放在私人位置。重新下載相同來源的正確套件，通常比盲目覆蓋更容易判斷問題；不同來源的安裝套件能否直接更新，應以系統實際提示為準。

剪貼簿與訂閱群組匯入

單一分享連結請從剪貼簿匯入；訂閱網址則在訂閱設定中新增項目，儲存後再更新。Android 剪貼簿可能會自動清除內容，複製後請盡快開啟用戶端，確認內容不是空白或網頁說明文字。首次更新失敗時，先記下錯誤發生在網址格式、連線、回應或解析階段，再判斷是否需要透過已可運作的設定取得訂閱。

在清單中選擇一筆設定作為目前使用項目，再點選連線。首次建立本機 VPN 通道時，系統會顯示授權對話框，這是 Android 用戶端接管流量所需的系統介面。授權後查看用戶端連線狀態和系統通知，再用一個應用程式測試。系統出現 VPN 圖示只代表通道已建立，不能證明遠端連線或網域解析已成功。

訂閱更新會依提供者傳回的內容更新項目。手動修改訂閱中的設定可能在下次更新後消失，若要長期保留調整，請複製成獨立項目並記下原始來源。不同用戶端對同一種分享格式的支援可能不同，尤其是包含較新傳輸欄位的設定；匯入成功後仍應檢查協定、TLS、傳輸類型及必要參數是否完整。

應用程式分流與背景執行

Android 用戶端主要透過系統 VPN 介面運作，不需要照搬桌面版的系統 HTTP 代理步驟。系統通常只允許一個 VPN 服務同時使用此介面，其他依賴相同介面的工具可能會取代目前連線。測試時請只保留一個流量接管程式，避免連線按鈕顯示成功後，立即被另一項服務接管。

設定應用程式分流前，請先確認目前模式是「僅代理所選應用程式」還是「略過所選應用程式」。這兩種清單的意思相反，勾選同一個應用程式會造成不同結果。先用一個測試應用程式確認，再擴大清單；修改清單後，請依用戶端提示重新建立連線。應用程式分流與網域路由屬於不同層次；某個應用程式被排除後，其流量可能根本不會進入核心的規則比對。

關閉螢幕後斷線，常與電池最佳化、背景執行限制或廠商的工作清理機制有關。先確認用戶端通知是否仍顯示、程序是否已被終止，再到系統應用程式設定中允許必要的背景執行。不要一開始就修改伺服器協定。行動網路與 Wi-Fi 切換時會重新建立連線；若只有某種網路失敗，請使用相同設定進行比對，不要同時修改節點與 DNS。

DNS、熱點與更新後檢查

系統私人 DNS、瀏覽器獨立解析和用戶端 DNS 設定可能形成不同的解析路徑。網域無法存取時，先查看記錄檔，並與中斷連線後的解析結果比較；不要把逐一更換隨機 DNS 位址當成固定做法。熱點分享的其他裝置也不一定會自動使用手機用戶端的通道；本機應用程式正常，不代表熱點裝置使用了相同出口。

更新用戶端後，請確認目前使用的項目、應用程式分流清單、路由模式和背景權限。系統升級可能重設部分權限，需重新檢查。v2rayNG 與 v2flyNG 的設定名稱可能不同，移轉時請依功能逐項對應，不要只匯入訂閱就認為所有行為都相同。選擇背景請參閱三款用戶端比較評測，首次連線步驟請查看快速入門教學。

代理與路由：入口、出口及規則順序

先確認流量是否進入核心

路由規則只會處理已進入核心的流量。系統代理負責提供應用程式本機代理入口；TUN 透過虛擬介面接管符合條件的網路流量；Android 應用程式清單則可決定哪些應用程式進入通道。如果應用程式根本沒有使用用戶端，修改 routing 不會改變它的行為。排查分流前，先確認應用程式入口與本機監聽設定一致，再檢查規則比對結果。

用戶端中的「全域」通常是指將進入用戶端的流量交由同一個出口處理，並不代表會強制接管裝置上的所有程式。「繞過中國大陸」、「黑名單」或「白名單」等名稱是用戶端的預設選項，實際行為取決於產生的規則與出口。不要只憑預設名稱推測所有網域的路徑；不同用戶端或版本中的同名預設也可能有規則差異。

本機 HTTP、SOCKS 或混合入站會將流量交給核心，outbounds 定義可用出口，routing.rules 則會將符合條件的流量導向出口標籤。標籤是用來參照的名稱，不是具有特殊功能的保留字。規則中的 outboundTag 必須與實際出口的 tag 相同，否則設定可能無法啟動，或無法依預期轉送流量。

規則比對與範例適用範圍

規則通常依序檢查，前面的符合項目會優先於後面的兜底規則。範圍太廣的規則若放在前面，會遮蔽更精確的規則。網域規則適合明確的服務範圍，IP 規則則適合私有網路或位址範圍；應用程式使用網域或直接使用 IP，也會影響可供比對的資訊。流量嗅探可補充部分目標資訊，但並非所有流量都能還原出可靠的網域。

以下提供一份可用來學習結構及測試本機監聽的完整設定。它只定義直連與阻斷出口，不包含遠端代理伺服器。所有入站流量預設直連；前往文件示範網域的流量則會被阻斷。執行前請確認連接埠未被占用。此範例適合用來理解欄位關係，不應直接貼上並覆蓋已可使用的伺服器設定。用戶端是否支援匯入完整設定，請以目前介面的入口為準。

{
  "log": {
    "loglevel": "warning"
  },
  "inbounds": [
    {
      "tag": "local-socks",
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks",
      "settings": {
        "auth": "noauth",
        "udp": true
      }
    }
  ],
  "outbounds": [
    {
      "tag": "direct",
      "protocol": "freedom",
      "settings": {}
    },
    {
      "tag": "block",
      "protocol": "blackhole",
      "settings": {}
    }
  ],
  "routing": {
    "domainStrategy": "IPIfNonMatch",
    "rules": [
      {
        "type": "field",
        "domain": ["domain:example.com"],
        "outboundTag": "block"
      },
      {
        "type": "field",
        "ip": [
          "10.0.0.0/8",
          "172.16.0.0/12",
          "192.168.0.0/16",
          "127.0.0.0/8"
        ],
        "outboundTag": "direct"
      }
    ]
  }
}

domain:example.com 會比對示範網域及其子網域；只比對完全相同的主機名稱，可使用 full: 寫法。未符合規則的流量通常會使用第一個出站，因此範例將直連放在最前面。若要設定代理分流，必須另外定義實際可用的代理出口，再讓對應規則參照該出口；新增一個名為 proxy 的標籤，並不會自動具備代理能力。

網域策略、資料檔與 DNS

IPIfNonMatch 表示網域規則未符合時，可解析目標網域並嘗試比對 IP 規則；它不代表每次要求都會先解析 IP。AsIs 與 IPOnDemand 的解析時機不同，選擇會影響可用的比對資訊與 DNS 要求。若不熟悉設定內容，請先保留用戶端預設值，並透過記錄檔確認問題，不要將網域策略當成通用加速選項。

geosite:cn、geoip:cn 和 geoip:private 依賴核心可讀取的資料檔與分類名稱，並非所有設定都內建這些資料。若缺少檔案或分類，請依用戶端支援的資源更新方式處理。上方範例明確列出私有網段，以避免依賴外部分類；但它並未涵蓋所有需要直連的位址，也未設定 IPv6 私有範圍，因此不能直接當作完整的正式環境分流範本。

驗證單條規則的實際行為

每次只新增一條規則，重新啟動或載入後確認核心正常啟動，再測試一個明確目標。比對連線記錄中的目標、入站標籤和出口標籤，不要只看網頁能否開啟。網站可能同時要求多個網域，首頁正常不代表所有資源都經過相同路徑。檢查完成後，記下規則用途與順序，避免日後更新預設值時無法說明既有規則。