V2Ray 全平台安裝設定指南

第一次連線可先參考快速入門教學。本指南依作業系統說明安裝、匯入與流量接管範圍;更換裝置、切換網路模式或遇到問題時,請從對應章節開始查閱。

通用準備工作

先確認作業系統、架構與安裝套件

桌面裝置建議使用 v2rayN;Android 建議優先使用採用 Xray 核心的 v2rayNG。只有在明確需要 v2fly 核心時,才選用 v2flyNG。先確認裝置目前使用的作業系統,再確認架構。裝置型號、購買年份、處理器品牌與系統架構是不同資訊:相同品牌可能採用不同架構,同一台裝置上的虛擬機也可能使用不同系統。若要安裝在虛擬機中,請查看虛擬機內的系統資訊,而非依照實體主機選擇套件。

前往安裝套件頁面,選擇對應平台,再依卡片標示的套件類型下載。請以該頁列出的系統需求為準:架構相符只代表選對建置版本,不代表目前的系統、執行環境與桌面環境都符合條件。第一次安裝時,建議保留預設的本機監聽設定,不開啟區域網路存取,也先不要設定開機時接管流量。如此一來,即使首次匯入失敗,也較容易區分是客戶端啟動問題,還是網路接管問題。

平台客戶端套件選擇依據接管方式
Windowsv2rayNx64 桌面版或 WPF 版系統代理;視需要啟用 TUN
macOSv2rayNApple Silicon 或 Intel網路服務的代理設定;視需要啟用 TUN
Linuxv2rayNLinux 發行版套件格式與處理器架構桌面或應用程式代理;視需要啟用 TUN
Androidv2rayNG、v2flyNGarm64 或通用版客戶端透過系統 VPN 介面接管流量

分辨訂閱網址、節點與本機設定

訂閱網址用來取得一組節點,應填入訂閱管理頁面;單一分享連結或 QR 碼則代表一個節點,應使用剪貼簿、掃描 QR 碼等單節點匯入方式。若將兩者混用,常見情況是訂閱更新一再顯示格式錯誤,或網址看似儲存成功,清單卻沒有新增項目。取得內容後,先確認來源提供的是哪一種,再確認所選客戶端是否能解析。其他軟體的完整設定檔也不能當成一般訂閱匯入。

訂閱網址可能包含存取憑證,應視同密碼保管。請勿貼到線上轉換網站、公開截圖或討論區貼文。所謂訂閱轉換,實際上是將一種節點描述轉換成另一種格式;它無法讓目標核心支援原本不支援的協定或傳輸參數。遇到格式不相容時,請先向設定提供者索取適用於該客戶端的訂閱,再決定是否需要轉移。匯出備份時也要確認是否包含訂閱網址、本機節點及存取憑證;能使用受保護的本機儲存空間,就不要公開分享。

記錄連線前後的狀態以供比較

連線前,先確認裝置可以正常上網,且系統日期、時間與時區正確。如果目前的網路需要登入網頁,請先完成登入。接著記下原有的系統代理、自動代理指令碼、工作用 VPN 與應用程式的個別代理設定。記錄下來不是為了清除原有設定,而是方便測試後還原。受管理的裝置應保留管理政策;如果不確定某項設定由誰維護,請勿直接覆寫。

選擇一個已獲授權且可重複開啟的 HTTPS 網址作為測試目標,再選一個平時需要直接連線的區域網路服務作為對照。第一次連線時,只選一個節點、一個應用程式和一種接管方式。客戶端記錄可用來確認本機入站請求及出站選擇;應用程式的實際回應則能確認服務是否可用。節點出現在清單中、核心成功啟動,以及目標收到回應,是三種不同結果。遇到異常時,請註明問題出現在哪個步驟,不要只寫「代理無法使用」。

已能正常連線的裝置適合保留作為參照。新裝置匯入相同訂閱後,先確認節點群組與測試目標一致,再比較兩台裝置的接管方式。如果兩台裝置都無法更新訂閱,先確認訂閱服務是否可連線;若只有新裝置失敗,優先檢查系統權限、應用程式設定與本機網路。不要先覆寫正常運作的裝置,否則會更難判斷問題出在哪個環節。

Windows:v2rayN 安裝與流量接管

選擇桌面版或 WPF 版

前往「設定 → 系統 → 系統資訊」查看系統類型,確認使用的是 x64 系統,再開啟Windows 安裝套件。桌面版採用跨平台介面;WPF 版則使用傳統 Windows 介面。兩種介面的選單配置可能不同;若依照其他介面的截圖找不到同名按鈕,請從訂閱管理、節點選擇與系統代理這三類功能尋找入口。日常使用時只執行一個客戶端:同時開啟兩個執行個體,可能搶占本機連接埠,也可能互相改寫代理設定。

請依下載頁標示的套件類型啟動安裝程式,或完整解壓縮後再執行其中的客戶端。不要只將主程式從壓縮檔中拖出來執行,核心與相關資源仍必須能被找到。第一次啟動時請使用一般帳戶,不要把長期以系統管理員身分執行當成標準安裝步驟。如果程式在主畫面出現前就結束,先查看系統提示與下載頁列出的執行環境需求。若主畫面已顯示,但核心啟動失敗,請檢查記錄,確認是缺少資源、存取遭拒,還是監聽連接埠已被占用。

更新訂閱並測試一個應用程式

前往訂閱群組管理頁面,新增一個容易辨識的群組,填入訂閱網址並儲存。切換到剛新增的群組,執行更新目前訂閱的操作,並確認新增項目確實屬於該群組。儲存時沒有錯誤訊息,只代表資料已寫入本機;成功更新才表示客戶端已取得並解析內容。選取一個節點並設為目前使用項目,再檢查記錄是否有啟動錯誤。如果舊群組的清單仍在,不要誤把舊項目當成這次更新的結果。

先從系統匣選擇「設定系統代理」,再使用預設會讀取系統代理的瀏覽器開啟測試目標。前往 Windows「網路和網際網路 → 代理」查看設定是否有變更,並比對客戶端顯示的本機代理位址與連接埠。啟用系統代理不代表所有程式都會走相同路徑:終端機、服務、部分下載工具,以及設有個別代理的瀏覽器,都可能依自己的設定連線。若瀏覽器正常、另一個應用程式失敗,請先檢查該應用程式的代理設定,不要立刻判定節點無法使用。

切換到 TUN 前,先排除重複的接管方式

只有在目標程式不遵循系統代理,或需要透過虛擬網路介面接管流量時,才測試 v2rayN TUN 模式。先退出其他會修改預設路由的代理工具,還原測試前的系統代理狀態,暫時只啟用一種新的接管模式。依照客戶端提示授予啟用虛擬網卡所需的權限。驗證時應一併查看記錄與應用程式結果:按鈕顯示已啟用,不一定代表路由已套用,尤其是在電腦從睡眠中喚醒、切換 Wi-Fi 與有線網路,或系統同時保留其他虛擬介面時。

如果啟用後可以連上網際網路,但印表機、檔案共享或內部網路服務變得無法存取,先關閉 TUN,確認是否立即恢復。若能恢復,再檢查區域網路前綴、網域名稱與規則優先順序,不要立刻擴大接管範圍。若關閉後仍無法正常上網,回到系統代理頁面,確認是否留下指向本機的連接埠或指令碼。手動還原時應以測試前的記錄為準:原本使用工作代理的裝置,不可直接把所有選項一律關閉。

透過監聽狀態找出連接埠衝突

記錄出現位址已被占用時,可在 PowerShell 查詢本機監聽中的通訊端。以下範例會列出狀態為監聽的連線;請將輸出中的本機連接埠與 v2rayN 設定頁面顯示的實際連接埠比較,不要依預設連接埠猜測。程序編號只能協助找出占用者,不能據此判定對方一定有問題。同一個程式也可能在不同位址上分別監聽。

Get-NetTCPConnection -State Listen |
  Select-Object LocalAddress, LocalPort, OwningProcess |
  Sort-Object LocalPort

確認占用連接埠的是仍在執行的舊執行個體時,請先從該執行個體的系統匣選單正常退出。如果占用者是必須保留的應用程式,請改用未被占用的本機連接埠,再同步更新曾手動設定代理的程式。修改後重新啟動連線,確認監聽項目是否出現,最後用一個應用程式再次測試。如果監聽正常但仍無法存取,請改查接管方式與出站記錄,不要繼續反覆更換連接埠。

macOS:v2rayN 安裝與網路服務設定

依處理器選擇磁碟映像檔

從 Apple 選單開啟「關於這台 Mac」。若資訊顯示 Apple 晶片,請選擇macOS 安裝套件中的 Apple Silicon 版本;若顯示 Intel 處理器,則選擇 Intel 版本。終端機視窗的運作情況不能用來判斷整台裝置的架構,因為終端機程序可能在相容環境中執行。開啟對應的磁碟映像檔,依照視窗指示將客戶端複製到「應用程式」資料夾,並從複製後的應用程式啟動,不要一直從已掛載的映像檔執行。確認程式可以開啟後,再退出磁碟映像檔。

如果系統阻止開啟,先確認提示是與安全政策、系統版本不相容,還是程式啟動後異常結束。只有在來源可確認且符合本機管理規定時,才依系統提示處理;若組織政策不允許啟動,請交由管理員處理,不要關閉系統層級的保護。程式視窗出現後,再查看應用程式記錄。只要問題仍發生在應用程式載入階段,就不必調整訂閱、代理或 DNS,這些設定無法修復二進位檔相容性問題。

透過目前使用的網路服務確認系統代理

在訂閱管理中新增群組並更新,接著選取一個節點。開啟客戶端的系統代理後,前往「系統設定 → 網路」,找到目前連線使用的服務,並開啟詳細資訊查看代理設定。Wi-Fi 與有線網路是不同的網路服務,可能各自保留先前的設定。接上外接網卡、拔除擴充底座,或從公司網路切換到家用網路後,舊服務的代理狀態不能代表目前使用的服務仍採取相同路徑。請以目前的網路服務與當下的記錄進行比對。

也可以在終端機執行下方的唯讀指令,查看系統目前回報的代理設定與網路服務順序。輸出可用來確認代理是否啟用、連接埠是否指向本機,有時也會顯示自動設定的相關項目;但這不代表每個應用程式都會採用這些設定。例如瀏覽器設定檔指定了個別代理,或終端機只讀取環境變數時,就必須分別確認實際的請求路徑。

scutil --proxy
networksetup -listnetworkserviceorder

如果客戶端記錄中沒有出現預期應用程式的入站請求,先完全退出並重新開啟該應用程式。有些程式會在初始化時讀取代理設定,持續執行中的程序可能仍沿用舊設定。同樣地,驗證代理已停止時不要只切換視窗;關閉客戶端的系統代理,並視需要退出相關程序後,確認目前的網路服務是否恢復原狀。如果看到組織部署的自動代理網址,請保留該設定,不要為了對照而刪除。

確認 TUN 啟動與睡眠喚醒後的狀態

如果系統代理已能滿足目標應用程式的需求,就不必為了讓介面狀態一致而啟用 TUN。需要接管不讀取代理設定的應用程式時,先停用系統代理,再依照 v2rayN 提示啟用虛擬網路介面。測試順序是先確認網域名稱能否存取,再測試需要區域網路的服務,最後正常退出客戶端後重新測試兩者。若只測試能否開啟外部網站,容易漏掉虛擬介面變更預設路由後造成的區域網路問題。

如果睡眠前運作正常、喚醒後卻失敗,先確認 Wi-Fi 是否已重新連線,以及客戶端記錄是否仍收到請求。Wi-Fi 尚未恢復時,應先處理網路連線與 IP 位址分配;若 Wi-Fi 已恢復,但應用程式沒有入站請求,再確認系統代理或虛擬路由是否仍有效。只有在確認舊連線已失效後,才關閉並重新啟用對應模式,觀察問題能否穩定重現。這樣有助於區分喚醒問題與訂閱中的節點切換。

分辨網域名稱探索、解析與服務連線

區域網路存取問題也應分層排查。先用已知可存取的裝置 IP 位址測試實際服務,再確認使用裝置名稱能否連線。如果 IP 位址可用、裝置名稱卻無法使用,應優先檢查名稱解析或本機服務探索,不要先修改遠端節點。若連已知裝置的 IP 位址也無法存取,再比較接管前後使用的介面與規則。遠端 DNS 服務通常不知道本機網路中的裝置名稱;即使外部 HTTPS 網站已能正常存取,也不能據此判定內部網路的名稱解析正常。

如果問題只發生在某個擴充底座或特定網路,請記錄目前的服務名稱、接管模式與測試目標類型。先停用最近的變更,切回已確認可用的設定,再依序重新測試。不要一次刪除所有網路服務與客戶端設定:即使症狀消失,也無法判斷是代理恢復了,還是系統改用了另一條可用網路。

Linux:v2rayN 安裝與桌面代理

Linux 發行版套件格式與架構

先確認發行版使用的套件管理系統,再確認裝置架構。Debian、Ubuntu 及採用相同套件系統的桌面發行版,通常選擇 deb;Fedora 與採用相應系統的發行版則選擇 rpm。不能因為安裝工具剛好能讀取另一種檔案,就把 deb 和 rpm 當成可互換的格式。Linux 安裝套件的主要版本是 x64,另有 arm64 版本。若發行版不在頁面列出的相容範圍內,不能只因套件格式相同就推定可以安裝。

uname -m
cat /etc/os-release

uname -m 回傳 x86_64 時,通常對應 x64 版本;回傳 aarch64 時,則對應 arm64 版本。在容器或特殊相容環境中,核心回報的架構不一定等同於使用者空間的套件架構,請再透過目標系統的套件管理器確認。讀取發行版資訊是為了選擇適用於本機的套件格式,不必修改任何欄位,也不必為了安裝一次而更換套件來源。

可以先使用桌面環境內建的套件安裝程式;使用命令列時,請在檔案所在目錄執行適用於該發行版的安裝指令。以下範例假設已將選定套件在本機重新命名為 v2rayn.deb 或 v2rayn.rpm,兩個指令擇一執行即可。套件管理器會嘗試處理相依性;若顯示相依套件無法滿足,請先確認系統版本與現有套件來源,不要使用強制忽略相依性的方式安裝。

# Debian / Ubuntu
sudo apt install ./v2rayn.deb

# Fedora
sudo dnf install ./v2rayn.rpm

使用目前的桌面帳戶匯入訂閱

安裝時需要提升權限,不代表日常執行客戶端也需要提升權限。第一次請從目前使用者的桌面工作階段啟動,再新增訂閱群組、更新並選取節點。若先前曾以提升權限的方式啟動,可能讀寫了另一份設定,因此在一般使用者帳戶下看到的清單自然不同。如果設定目錄發生權限錯誤,請先查看目錄位置與擁有者,不要遞迴放寬整個家目錄的權限。核心載入失敗時,請保留第一條錯誤訊息,不要只截取後續重複重試的提示。

桌面代理能否運作,取決於目前的工作階段。客戶端寫入桌面設定後,只有支援讀取該設定的應用程式才會使用代理。其他桌面環境、獨立執行的沙箱應用程式、以不同使用者身分啟動的程式,以及已開啟的終端機,可能沒有取得相同的代理設定。請先測試一般桌面瀏覽器,再分別測試目標程式;若只有目標程式失敗,可考慮使用該程式自己的代理設定,而不要認定整個桌面的代理開關失效。

明確測試本機代理

如果桌面應用程式與終端機的結果不同,可以讓終端機明確使用客戶端的 HTTP 或混合代理連接埠。下方指令會先讀取輸入,不會永久修改系統或 shell 設定。請輸入客戶端實際顯示的本機連接埠,不是節點的遠端連接埠;測試目標應使用已確認允許存取的網址。若只啟用 SOCKS 入站,就不適用以下以 HTTP 為例的測試。測試網址應支援 HEAD 請求,否則請改用一般 GET。

printf '本機 HTTP 或混合代理連接埠:'
IFS= read -r proxy_port
printf 'HTTPS 測試網址:'
IFS= read -r test_url
curl --noproxy '' --proxy "http://127.0.0.1:$proxy_port" \
  --head --max-time 15 -- "$test_url"

連線至本機遭拒時,先確認是否有程序正在監聽,以及連接埠類型是否相符。收到 HTTP 回應後,再搭配客戶端記錄判斷請求是經過代理、直接連線,還是遭到拒絕;單看狀態碼無法證明是哪一條出站完成連線。測試成功後,如果終端機中的一般工具仍然失敗,請查看該工具自己的網路設定,不要把一次明確指定參數的測試誤認為所有指令都已套用代理。

虛擬介面、預設路由與還原設定

測試 TUN 前,請確認核心支援虛擬網路介面、桌面工作階段具備客戶端所需權限,並記錄正常狀態下的預設路由與內部網路連線情況。容器、遠端桌面與受管理系統不一定能建立所需介面。不要透過以特殊權限啟動整個圖形工作階段來解決介面建立問題。啟用後若工作網路連線中斷,先停用本次新增的接管模式,再比較路由;不要在遠端工作階段中直接清空路由表。

網路管理器可能在重新連線時重新套用裝置設定,因此應分別測試首次啟用與正常重新連線的情況。若只有重新連線後失效,請記錄介面、網路環境與錯誤發生時間,先確認預設路由是否消失,再處理客戶端狀態。正常退出後,請分別檢查桌面代理、應用程式個別設定的代理與虛擬介面;還原其中一項,不會自動還原其他項目。

Android:v2rayNG 與 v2flyNG

客戶端與安裝套件架構

Android 安裝套件會先列出 v2rayNG,再列出 v2flyNG。v2rayNG 使用 Xray 核心,適合作為首選;只有在訂閱明確依賴 v2fly 核心時,才選擇 v2flyNG。兩者的操作介面有相似之處,但支援的協定、傳輸組合與匯入細節不能互相類推。確認裝置系統支援 arm64 應用程式時,選擇 arm64;不確定時,可先查閱裝置規格,再選擇通用版。處理器為 64 位元,不代表製造商安裝的系統一定支援相同的應用程式架構。

使用檔案管理器開啟安裝套件。如果系統要求授權目前來源安裝應用程式,只授予實際開啟檔案的應用程式安裝所需權限,完成後可在系統設定中撤銷。若無法覆蓋安裝,先確認是架構不相容、系統版本不符、裝置管理限制,還是新套件與現有應用程式不相容。不要直接解除安裝正在使用的應用程式:解除安裝後,本機節點、分應用程式清單與偏好設定可能不會保留。確認需要移轉後再備份。

更新訂閱並首次授權 VPN

開啟訂閱群組設定,新增網址與容易辨識的名稱。返回節點頁面更新訂閱,選取這次取得的一個節點,再啟動連線。剪貼簿匯入適用於單一分享連結;訂閱更新失敗時,不必把同一網址改用剪貼簿匯入。若記錄顯示在取得階段就失敗,先檢查目前網路能否連上訂閱服務;若已取得內容但沒有可用項目,再確認訂閱格式與核心支援情況。

第一次啟動時通常會顯示系統 VPN 授權提示。請確認發起連線的是剛選取的客戶端,再授予權限。此處使用系統提供的虛擬網路介面;在相同使用者環境中,其他使用該介面的工作 VPN、本機防火牆或過濾器,可能與客戶端互相衝突。如果先前設定過永遠開啟 VPN,請先確認該設定對應哪個應用程式。桌面上的「設定系統代理」不能直接套用成手機操作步驟,也不要同時啟動兩款客戶端來比較節點。

分應用程式接管與網路切換

第一次驗證時,先以一般接管範圍測試瀏覽器,不要立即加入分應用程式條件。確認可用後,再開啟分應用程式代理,確認介面設定的是「僅接管選取的應用程式」,還是「排除選取的應用程式」。各選一個應該接管與不應接管的應用程式再次測試。若瀏覽器可用、應用程式內的頁面卻失敗,請確認網路請求是由主應用程式、系統元件,還是實際開啟頁面的外部瀏覽器發出。依圖示判斷請求來源,很容易選錯應用程式清單。

Wi-Fi 正常、行動數據異常時,先在停用客戶端的對照狀態下,確認切換網路後一般網頁可以存取,再觀察連線是否重新建立。行動數據權限、流量節省設定與目前網路的連線條件都可能影響結果。不要只查看系統 VPN 圖示:圖示表示介面仍存在,不代表先前的遠端連線已沿用到新網路。記下切換前後出現的第一條錯誤,比連續按下重新連線更容易找出問題。

背景執行限制與常駐策略

如果鎖定螢幕後連線停止、亮起螢幕後又恢復,先檢查系統的電池與背景執行設定。若能穩定重現,再單獨調整目前客戶端的電池限制,並使用相同網路與相同鎖屏時間進行測試。不必解除所有應用程式的限制。「永遠開啟 VPN」是連線策略;「封鎖未經 VPN 的連線」則是另一層限制。後者可能在客戶端停止時也阻擋一般網路連線,還可能影響需要直接連線的應用程式。啟用前請先確認裝置政策與使用需求,不要用它來掩蓋背景執行遭停止的原因。

排查耗電問題時,請區分客戶端持續轉送流量、應用程式頻繁發出請求,以及網路不穩造成的反覆重新連線。可在電池用量頁面比較相同使用時段,測試期間固定網路與應用程式範圍。若要進一步檢查電池最佳化、廠商背景管理與分應用程式設定,請參閱v2rayNG 耗電與背景執行故障排除。

更換裝置後重新設定系統端選項

重新匯入訂閱主要是還原節點清單,不會替新裝置設定系統 VPN 授權、數據使用權限與分應用程式清單。更換裝置後,先建立最基本的連線,再新增背景執行與常駐條件,最後比較兩台裝置的應用程式存取結果。若只需移轉少量自建節點,可視需要分享單一連結;若還要保留路由與偏好設定,請先確認哪些項目能透過設定備份匯出,詳情請參閱多裝置設定同步。

路由分流與 DNS

接管方式、規則比對與出站

先分清楚「應用程式有沒有把請求交給客戶端」和「客戶端收到請求後會將它送往何處」。系統代理或 TUN 負責前者,路由規則負責後者。若應用程式的請求根本沒有進入客戶端,修改規則不會有任何影響。反過來說,若記錄顯示請求已收到、卻走錯出站,應先檢查規則順序、比對條件與預設行為,不必啟用另一種接管模式。

一般路由規則會依序比對,通常由第一條符合條件的規則決定出站。網域專用規則應放在可能提前比對到的廣泛規則之前。規則中的 outboundTag 參照設定中已存在的出站標籤,不是任意可辨識的中文名稱;direct、proxy、block 是常見的示意名稱,不能假設每份設定都使用這些標籤。沒有符合規則時,核心通常會使用第一個出站;圖形介面客戶端也可能另外產生備用規則。請檢查實際設定與記錄,不要只依介面上的模式名稱推斷。

先確認具體規則,再修改預設路徑

以下是可供 Xray 使用的網域規則片段,會比對精確網域 example.org,並交由已存在的 direct 出站處理。這是 routing.rules 陣列中的單一物件,不是完整設定檔。若要驗證規則順序,請先確認相應出站存在,再將規則放在測試設定的廣泛比對規則之前,並比較該網域與另一個測試目標的出站記錄。如果圖形介面客戶端提供路由編輯器,請填入對應欄位,不要把整個物件貼到只接受網域的輸入框。

{
  "type": "field",
  "domain": ["full:example.org"],
  "outboundTag": "direct"
}

網域規則只能比對核心取得的網域。若使用 IP 位址直接連線、應用程式先自行解析再連線,或虛擬介面只看到目的 IP,網域規則可能不會生效。部分設定可透過流量嗅探補充網域資訊,但能否辨識仍取決於流量與設定。若內部網路裝置需要直連,應先確認應用程式實際使用的是本機名稱還是特定位址,再選擇網域條件或適當範圍的 IP 條件;不宜一併排除整個無關的位址範圍。

確認由哪一端解析網域

V2Ray DNS 設定涉及多個環節:作業系統可能先進行解析,瀏覽器可能使用自己的安全 DNS,核心也可能為了路由判斷或建立出站連線而發出查詢。啟用遠端 DNS 不代表所有查詢都會交給它處理,TUN 也不會自動限制每個應用程式內建的解析器。排查時應先確認要驗證哪一類查詢,再比較記錄、應用程式設定與系統解析結果。外部網域與僅供內部網路使用的名稱通常需要不同的解析路徑;混用同一個解析端會讓問題更難釐清。

若網站只能透過網域名稱存取,不要用直接連線到網站 IP 位址作為 HTTPS 成功的判斷標準:憑證、虛擬主機與握手使用的伺服器名稱都可能依賴網域名稱。較可靠的做法是分別記錄網域解析是否成功、應用程式是否建立連線,以及核心最後選擇哪個出站。若應用程式快取造成干擾,可退出並重新開啟要測試的應用程式;不要把切換後立即出現的舊快取結果當成新設定已生效的證據。若要有系統地檢查查詢路徑,請參閱DNS 洩漏檢測與設定。

網域策略與 FakeDNS 的適用範圍

核心的路由網域策略會影響是否為 IP 規則執行解析。以 Xray 為例,AsIs 不會為路由比對主動將網域解析成 IP;IPIfNonMatch 則會在網域比對未命中時,再嘗試解析以檢查 IP 規則。路由為了比對而執行解析,與最終連線使用哪個位址,是兩種不同設定。切換策略可能改變解析時機與比對結果;調整後,應同時檢查原本預期直連與預期經代理的目標。

FakeDNS 會使用合成位址建立對應,再由接管流量的核心還原成網域名稱。這要求解析結果與後續連線都走互相配合的處理路徑。如果裝置取得合成位址,後續卻透過未受接管的路徑連線,就可能出現解析成功、連線失敗的情況。初次設定時,先確保一般解析與路由運作穩定;只有在明確需要網域映射時,再閱讀FakeDNS 原理與適用情境並個別驗證。還原設定時也要一併撤銷相關映射,再重新建立測試應用程式的連線。

常見設定問題

訂閱已儲存,為什麼節點清單還是空的?

確認問題發生在取得或解析階段

先確認目前選取的群組與更新對象一致。如果更新記錄顯示網域名稱無法解析、連線逾時或服務回傳異常狀態,表示問題仍在取得階段。使用裝置原有且已獲授權、能連上訂閱服務的網路再試一次;尚未匯入的節點無法用來連線取得訂閱。如果成功取得內容但格式不受支援,請向提供者確認回傳的是客戶端可辨識的訂閱,而不是登入頁面、錯誤訊息或其他軟體的完整設定檔。不要公開回應內容與原始網址,只記錄錯誤類型及發生時間。

如果清單先前正常,這次卻有部分項目消失,先確認目前是否選錯群組,再確認伺服器端是否替換節點或撤回部分項目。更新訂閱可能會覆蓋群組中原有的節點。需要獨立維護的手動設定,請保留在另一個群組,方便區分訂閱變動與本機修改。

節點測速有結果,為什麼應用程式還是連不上?

依測速類型解讀結果

V2Ray 節點測速可能只測試到伺服器的傳輸連線,也可能透過節點存取客戶端設定的測試網址。測試成功只代表該項測試通過,不能證明其他網域、應用程式或 DNS 設定也可用。先確認目前使用的節點就是剛才測試的節點,再從目標應用程式送出新的請求,記下時間並查看核心記錄。若沒有入站記錄,先檢查系統代理、虛擬介面或接管的應用程式範圍;若已有入站請求且出站符合預期,再檢查遠端連線與目標服務的回應。

不同測試網址、網路與測速類型所得到的結果,不適合直接比較。單次測試逾時,也不能據此判定整份訂閱失效。請在相同網路下選定相同測試網址重複驗證,記錄失敗是否總是發生在相同階段,再與已知可用的節點對照。

啟用 TUN 後所有網站都無法存取,該怎麼辦?

先還原已知可用的狀態,再單獨測試接管方式

先關閉這次啟用的 TUN,還原先前的直接連線或系統代理,並確認基本網路仍可使用。若還原後仍無法上網,請檢查目前網路是否已完成登入、客戶端退出後是否留下本機代理連接埠,以及裝置是否仍受常駐 VPN 政策限制。還原時應保留原有的工作網路設定。如果關閉 TUN 後立即恢復,再檢查虛擬介面的權限、其他網路工具是否爭用路由,以及解析所用的位址是否變得無法存取。

重新測試時只啟用 TUN,並維持節點與測試網址不變;先測試網域存取及原本需要直接連線的本機位址,再查看記錄。顯示「已啟用」只代表客戶端接受了操作;路由、介面、解析與出站都需要分別確認。

同一份訂閱在兩台裝置上結果不同,該先比較什麼?

統一客戶端、核心與驗證條件

先比較實際選取的節點、核心類型、網路、目標位址與測試時間。手機透過系統 VPN 介面接管流量,桌面裝置可能只設定系統代理;即使使用同一個節點,兩端應用程式的接管範圍仍不同。若匯入後有項目、連線時才出現參數錯誤,請確認目前核心是否支援該協定與傳輸設定。更換客戶端前,可先透過客戶端比較確認差異,再於其中一台裝置上進行單一變數測試。

若兩個應用程式都能正常使用,但仍需移轉規則,不要直接複製整套系統相關設定。相同的分流需求可以分別實作,但裝置的本機位址、代理連接埠、應用程式清單與權限對象都需要重新確認。與其要求所有選項完全一致,不如確認兩台裝置上需要直連與需要接管的服務是否都符合預期。

遇到憑證或握手錯誤時,該調整哪些設定?

保留憑證驗證,找出錯誤發生的位置

確認系統日期與時間正確,並分辨提示是來自瀏覽器正在存取的目標網站,還是客戶端與節點之間的握手。如果客戶端記錄出現錯誤,請確認匯入的節點位址、傳輸參數與伺服器名稱是否符合提供者的說明;如果是瀏覽器顯示錯誤,請確認測試網址是否正確、目前網路是否要求登入網頁,以及應用程式是否誤用了系統中殘留的代理設定。不要把關閉憑證驗證當成解決方法,這會掩蓋連線目標或設定資訊不一致的問題。

需要回報問題時,只提供作業系統、客戶端名稱、連線模式、重現步驟,以及已移除敏感資訊的第一條錯誤訊息。不要附上完整訂閱、節點分享連結或包含憑證的設定匯出檔。如果仍無法判斷問題從哪個步驟開始,可回到快速入門教學重新執行最基本的流程,再依本指南對應章節逐步增加設定。