各平台用戶端安裝與設定

一般準備：先確認三項資訊

開始前，請分別確認裝置、用戶端和連線資料。作業系統決定安裝檔，處理器架構決定程式能否執行，訂閱內容則決定用戶端能否產生有效設定，三者無法互相取代。下載用戶端不會自動取得可用伺服器；成功匯入一筆資料，也不代表遠端服務仍然有效。先確認輸入條件，後續遇到問題才不必反覆重新安裝。

確認系統、架構與核心需求

桌面平台建議使用 v2rayN。Windows 下載頁提供桌面版與經典 WPF 版，兩者主要差異在介面與執行環境，並非不同的訂閱帳戶。macOS 請依 Apple Silicon 或 Intel 晶片選擇安裝檔；Linux 則要確認處理器架構與發行版套件格式。不要只看副檔名猜測架構，也不要嘗試在手機上開啟桌面版安裝檔。

Android 優先使用 Xray 核心的 v2rayNG。若現有設定明確適用於 V2Fly，可考慮使用 v2flyNG。核心不是介面主題，而是負責解析設定、處理協定及建立連線。需要 REALITY 等特定功能的連線資料，必須由相容的核心支援。兩款用戶端的匯入選單相似，不代表所有欄位都能互換。

也請確認裝置時間已自動同步、磁碟有足夠的安裝空間，且系統允許安裝目前來源的應用程式。時間誤差過大可能影響憑證驗證及部分認證流程。初次排查請使用穩定的一般網路，並避免同時啟用多個代理或 VPN 工具，以免無法判斷流量實際經過哪個入口。

分辨訂閱網址與單筆分享連結

訂閱網址通常是可更新的網路連結，會回傳多筆連線資料；單筆分享連結則描述一組伺服器設定。複製時請取得完整文字，避免包含通訊軟體附帶的說明、引號或換行。瀏覽器中看到的帳戶管理頁面不一定是訂閱介面；網頁網址能正常開啟，也不代表適合貼到「訂閱群組」的網址欄位。

訂閱網址可能包含帳戶憑證，請當作密碼保管。不要貼到公開討論區、放進錯誤截圖，或上傳含有網址的設定備份。向他人說明問題時，提供錯誤類型、操作步驟和用戶端名稱即可。若網址已外洩，請透過原服務的帳戶管理功能重設，不要只在用戶端刪除群組。

若已在使用舊版用戶端，請先透過介面的匯出或備份功能保存設定，並記下訂閱群組名稱、目前伺服器、路由預設值及本機監聽連接埠。備份請存放在自己能掌控的位置。遷移時先匯入一組訂閱並完成驗證，再處理其他群組；一次複製所有設定，可能連同舊連接埠衝突、過期規則和失效連結一起帶過去。

建立可重現的驗證基準

初次連線只選一台伺服器，先關閉 TUN，使用預設路由和系統代理。記錄用戶端是否成功啟動核心，再確認瀏覽器是否使用系統代理，最後測試目標網頁能否開啟。每次只變更一個條件，接著重做相同檢查。如此一來，就能區分安裝錯誤、連線資料錯誤和流量接管問題，不必憑「好像比較快」判斷設定是否正確。

只有在需要重現問題時才暫時開啟記錄，完成後恢復日常記錄層級。分享前請遮蔽位址、使用者識別資訊和訂閱憑證。故障紀錄最好寫明「執行了哪個步驟、畫面出現什麼、接著發生什麼」，不要只截取紅色錯誤提示。若想先完成最簡流程，請前往快速入門教學；本手冊後續章節會說明各平台的差異。

Windows：v2rayN 安裝與流量接管

Windows 的操作順序是選擇安裝檔、完成首次啟動、匯入訂閱，再啟用系統代理。請先不要一次開啟所有選項。用戶端視窗出現，只代表介面程式已成功執行；核心是否啟動、本機連接埠是否正在監聽，以及瀏覽器是否使用代理，都需要分別確認。遇到問題時依序退回上一個步驟，比直接更換伺服器更容易找出原因。

選擇桌面版或經典 WPF 版

前往Windows 下載頁，依需求選擇 v2rayN 桌面版或經典 WPF 版。桌面版使用跨平台介面，經典 WPF 版則保留熟悉的 Windows 桌面配置。兩個版本的選單位置可能不同，本文會以「訂閱群組」、「系統代理」、「路由設定」等功能名稱指引；實際文字請以目前介面為準，不依賴固定按鈕位置。

依照安裝精靈完成安裝，並從開始功能表或安裝目錄啟動。若系統提示缺少執行環境，請先確認提示中的元件名稱和架構，再依應用程式指示處理；不要從不明網站下載單獨的動態程式庫放進程式目錄。安裝檔無法啟動時，請檢查系統安全性提示、檔案是否下載完整，以及裝置是否受應用程式安裝政策限制。

初次使用以一般權限執行即可。系統代理通常不需要系統管理員權限；TUN 則可能需要提高權限或額外的網路元件。不要為了省去一次授權，就讓所有網路程式長期以系統管理員身分啟動。若程式能開啟，但核心立刻結束，請先查看記錄是否提到連接埠遭占用、檔案路徑無法寫入或核心啟動失敗，再處理對應原因。

建立群組並更新訂閱

在「訂閱群組」中新增群組，填入容易辨識的名稱，再貼上完整訂閱網址。儲存後執行更新，並確認更新的是目前群組。匯入單筆分享連結時，請使用從剪貼簿匯入的功能，不要將整段分享文字填入訂閱網址欄位。兩種方式產生的項目可能相似，但只有訂閱群組會保留後續批次更新的來源。

更新完成後，先清除伺服器清單中的關鍵字篩選，再確認已選取正確群組。清單空白不一定代表下載失敗，也可能是篩選條件隱藏了所有結果。選取一台伺服器並設為目前使用項目，確認協定名稱符合預期。若有許多同名項目，請按來源群組整理，不要只憑名稱尾端文字判斷連線資料是否相同。

訂閱更新失敗時，先確認網址是否被截斷、是否誤複製帳戶網頁，再查看具體錯誤訊息。某些訂閱需要透過現有代理才能存取；這時應先確認既有連線可正常使用，再選擇透過代理更新。沒有任何有效連線時，不要反覆切換更新方式。詳細判斷方式請參閱訂閱更新失敗排查清單。

系統代理、TUN 與 Windows 特有問題

在「系統代理」中選擇「自動設定系統代理」，再用會遵循系統設定的瀏覽器測試。「清除系統代理」會撤銷用戶端寫入的系統代理；「不變更系統代理」只是保留現況，不等於關閉代理。若先前有其他工具設定代理，切換至「不變更」仍可能沿用舊位址，因此排查時請查看系統設定中的實際值。

瀏覽器可用但部分應用程式無法連線時，先確認該程式是否會讀取系統代理。確實需要接管流量時，再啟用 TUN，依提示授權並查看虛擬網卡和核心記錄。啟用後若整台裝置斷網，請立即關閉 TUN，回到已驗證的系統代理基準，接著逐項檢查虛擬網卡、路由衝突及其他網路工具；不要同時修改 DNS 和多組路由規則。

電腦從睡眠狀態喚醒後失效，可能是網路介面變更或其他工具覆寫了設定。先重新選取目前使用的伺服器，再套用系統代理。異常結束後若瀏覽器無法開啟網頁，請到 Windows 的代理設定確認本機位址；用戶端已關閉時，指向其連接埠的代理自然無法回應。手動還原前，先確認該設定不是組織管理政策。

成功連線後，再設定開機啟動、自動更新訂閱和預設路由。防火牆提示涉及監聽範圍時，請先限制為僅本機使用，不必為了讓瀏覽器連線而開放區域網路存取。若記錄顯示連接埠遭占用，請關閉舊執行個體，或在用戶端設定中改用未占用的連接埠；手動設定代理的應用程式也要同步修改，避免兩端入口不一致。

macOS：晶片選擇與網路權限

在 macOS 使用 v2rayN，請先確認晶片型號，再完成安裝和系統授權。應用程式能啟動、選單列顯示狀態，以及系統網路請求確實使用代理，是三件不同的事。桌面系統可能同時有無線、有線及其他虛擬介面；切換網路後，請重新確認目前介面的代理狀態，不要只看用戶端的開關位置。

依晶片型號安裝並完成首次開啟

開啟系統的「關於這台 Mac」，查看「晶片」或「處理器」。Apple Silicon 請選擇 arm64 安裝檔，Intel 請選擇 x64 安裝檔，並從macOS 下載頁下載對應版本。不要只根據裝置外觀或購買時間猜測。通常以原生架構為佳；若下載錯誤架構而無法執行，請先更換正確的安裝檔，不要再疊加相容層嘗試。

開啟下載的磁碟映像，依視窗指示將應用程式拖移至「應用程式」，再從該位置啟動。不要長期直接從已掛載的安裝映像執行，否則更新、檔案位置和退出後的行為容易混淆。若已有舊版，請先正常結束舊執行個體再替換，避免一個視窗來自舊位置，另一個啟動入口卻指向新位置。

若系統阻止首次開啟，請先確認檔案來源和應用程式名稱，再依「隱私權與安全性」中針對該應用程式的提示處理。不要為了開啟單一應用程式而關閉整個系統的安全機制。受管理的裝置可能禁止使用者自行允許執行，這時應由裝置管理方處理。出現授權視窗時，也請確認要求授權的是剛啟動的應用程式，而非其他背景程式。

匯入訂閱並確認目前使用項目

開啟 v2rayN 的訂閱群組功能，新增群組並儲存網址，再執行更新。若從瀏覽器複製文字後匯入失敗，請先貼到自己掌控的本機文字編輯區確認內容完整，不要將憑證提交給線上轉換工具。訂閱可能回傳錯誤網頁；收到內容不代表解析成功，請以用戶端的更新結果為準。

更新後選取目標群組、清除清單篩選條件，再設定目前使用的伺服器。初次驗證請使用預設產生的設定，不要馬上修改傳輸參數或安全設定。原始資料中的伺服器名稱、連線位址和憑證驗證名稱未必相同；因為名稱相似就手動互換欄位，可能讓畫面看起來正常，實際建立加密連線時卻失敗。

多組訂閱可分別命名，先驗證其中一組，再逐步加入其他群組。手動更新穩定後，再設定自動更新間隔；休眠期間錯過更新不一定是故障，喚醒後可手動更新一次。若仍看到舊項目，不要先批次刪除所有內容，請確認是否有另外匯入的項目，以及目前查看的是否為剛更新的群組。

檢查系統代理與 TUN 授權

啟用自動設定系統代理後，請在系統設定的「網路」中選擇目前使用的網路服務，查看詳細設定中的代理資訊。不同系統版本的選單位置可能不同，但檢查對象始終是目前使用的網路服務。若先前設定了自動代理指令碼，請先記錄原值，避免用戶端接管後無法還原原本的工作環境。

先使用會遵循系統代理的瀏覽器驗證。部分應用程式有獨立代理設定，也有些連線不會讀取系統代理；這不代表訂閱遺失。需要擴大流量接管範圍時，再嘗試啟用 TUN，並依應用程式和系統提示處理權限。授權後若未生效，請查看記錄確認是否真的建立虛擬介面，不要只看開關是否已開啟。

從無線網路切換至有線網路，或從睡眠狀態恢復連線時，先確認基礎網路能否正常取得位址，再重新套用代理。若只在特定網路環境失敗，請使用同一台伺服器和同一路由進行比對。公共網路可能需要先完成一般登入程序；網路認證尚未完成時，即使核心已成功啟動，也無法取代這一步。

結束應用程式前，先撤銷由它設定的系統代理，或確認應用程式正常結束時會依設定還原。若異常結束後無法開啟網頁，請進入目前網路服務的代理設定，確認是否仍指向已停止的本機入口。保留原本必要的工作設定，不要一鍵清除所有網路服務。其他共通問題請參閱常見問題，不必將每次網路變更都視為安裝損壞。

Linux：套件格式、桌面代理與權限

Linux 發行版、桌面環境和權限機制差異很大。本章以圖形桌面上的 v2rayN 為主，先透過系統軟體安裝程式安裝套件，再於用戶端設定訂閱和代理。請區分套件管理工具負責安裝檔案、桌面環境負責部分系統代理設定，而核心與網路介面負責實際連線；這三類問題不能混為一談。

確認發行版套件格式與處理器架構

從Linux 下載頁選擇安裝檔。使用 deb 套件的發行版請選 deb，使用 rpm 套件的發行版請選 rpm；也要分辨 x64 和 arm64。套件格式與處理器架構是兩個不同條件，只符合其中一項仍可能無法安裝。可在系統的「關於」或硬體資訊中查看架構，不要只憑裝置品牌判斷。

使用發行版內建的軟體安裝程式開啟套件，閱讀相依性與權限提示後再安裝。若提示缺少相依套件，請先確認發行版支援範圍和軟體來源狀態，再使用系統提供的修復功能。不要強行略過相依性檢查，也不要直接複製其他發行版的底層執行程式庫，否則後續更新和移除將失去可靠依據。

安裝後從應用程式選單啟動，不要預設以系統管理員身分執行整個圖形程式。一般使用者與管理員的設定通常存放在不同位置，混用可能導致「剛匯入的訂閱不見了」或設定目錄權限異常。若曾以提高權限的方式執行，請先確認目前使用者能否正常寫入自己的應用程式設定，再繼續遷移。

匯入訂閱並確認桌面代理範圍

在訂閱群組中新增網址並儲存，更新後再從清單選取目前使用的伺服器。若複製貼上的內容不完整，請檢查剪貼簿是否混入終端機換行、網頁說明或全形符號。首次連線不要修改進階傳輸參數。訂閱解析成功後仍無法連線，應查看核心記錄，而非一再匯入同一網址。

開啟系統代理後，進入桌面環境的網路代理設定，確認代理模式和本機入口。不同桌面環境讀取系統代理的方式不一；部分應用程式只讀取自身設定，另一些程式則依賴啟動時的環境變數。因此瀏覽器可以使用，不代表背景服務、沙箱應用程式或命令列程式也會採用相同代理。

若圖形應用程式提供獨立代理設定，請依用戶端畫面顯示的監聽位址、連接埠和協定填寫。不要將 SOCKS 入口填入只接受 HTTP 代理的欄位，也不要把訂閱網址當成代理伺服器位址。修改後重新啟動該應用程式再測試，避免舊執行程序繼續使用啟動時快取的網路設定。

TUN 權限、介面衝突與還原順序

需要接管更多應用程式時，再啟用 TUN。這涉及虛擬網路介面、路由和應用程式所需的網路權限，實際授權方式請依用戶端和發行版的提示處理。若介面已開啟，但記錄顯示建立介面失敗，請先處理權限和執行環境，不要歸咎於遠端伺服器，也不要直接放寬整個應用程式目錄的存取權限。

啟用 TUN 前，請先關閉其他同類網路工具，並確認系統沒有必須保留的特殊路由。容器、虛擬機和遠端辦公網路可能使用獨立網段，與新的流量接管規則互相衝突。無法存取區域網路服務時，先關閉 TUN 確認是否恢復，再加入必要的直連規則；不要一次變更所有介面的預設路由。

若退出後系統代理仍未還原，請透過桌面環境的網路設定恢復先前記錄的模式。若關閉 TUN 後仍有異常，請查看用戶端是否已正常停止相關程序，再檢查其他工具是否接管網路。遠端桌面裝置尤其要謹慎；調整路由前，請確保有本機還原方式，避免修改後失去管理連線。

最後再設定登入時啟動和自動更新訂閱。桌面工作階段尚未建立就啟動圖形用戶端，可能無法使用桌面代理服務；無線網路尚未連線就更新訂閱，也可能暫時失敗。先確認手動啟動、手動更新及結束後還原都正常，再啟用自動化，才能區分工作階段順序與連線資料問題。

Android：匯入、VPN 授權與背景執行

Android 優先使用 v2rayNG；需要 V2Fly 核心時再選擇 v2flyNG。兩者的安裝和匯入流程大致相同，但核心功能不可混用。手機上的連線按鈕通常透過系統 VPN 介面接管流量，與桌面端「為瀏覽器設定系統代理」並非同一種操作。了解這項差異，就不必反覆尋找「系統代理」設定。

選擇架構並完成安裝

前往Android 下載頁；較新的主流裝置通常優先選擇 arm64。不確定架構或出現不相容提示時，可考慮通用版，並確認裝置符合系統需求。通用版涵蓋更多處理器架構，但不會讓舊系統自動符合應用程式的執行條件。不要把「安裝失敗」直接判定為訂閱或伺服器問題。

開啟安裝檔時，系統可能要求允許目前使用的瀏覽器或檔案管理員安裝應用程式。只授權這次實際使用的來源，安裝完成後可視需要關閉權限。更新既有應用程式前，請先保存必要設定；若系統提示簽章不一致，不要立刻解除安裝，先確認安裝來源是否與原應用程式相同，因為解除安裝可能同時刪除本機資料。

首次開啟後，先確認應用程式能正常進入主畫面，再匯入連線資料。部分裝置的安全性或工作設定檔政策會限制 VPN 功能；應用程式安裝成功，不代表系統允許建立 VPN。若裝置由組織管理，請依管理政策使用，不要反覆重新安裝以繞過限制。系統時間也應保持自動同步。

訂閱群組、分享匯入與目前設定

在訂閱群組設定中新增名稱和訂閱網址，儲存後執行更新；選單名稱會因用戶端和介面版本而異，請依功能尋找。若取得的是單筆分享連結，請使用從剪貼簿匯入或相應的掃描功能，不要將帳戶管理網頁貼成訂閱。匯入項目出現後，點選要使用的設定，將其設為目前項目。

清單中有項目，不代表目前選取正確。更新後名稱可能相同，請先確認所屬群組、協定和設定來源。若訂閱內容使用 Xray 專屬功能，請在相容的用戶端中驗證；不要為了消除解析錯誤而隨意刪除安全欄位。需要了解差異時，請閱讀Xray 與 V2Fly 核心選型說明。

訂閱更新顯示成功但清單空白時，請檢查群組是否顯示及篩選條件，再查看更新記錄。若回傳的是登入頁面或錯誤頁，通常換用戶端無法解決網址本身的問題。網路無法連線時，可換用正常網路重測，但請維持訂閱網址不變；每次同時更換網路、網址和用戶端，將失去判斷依據。

VPN 流量接管、應用程式分流與背景限制

點選連線後，系統首次會顯示 VPN 連線要求；確認要求來自正確的應用程式後再授權。狀態列出現 VPN 圖示，只代表系統已建立該介面，不保證遠端伺服器可用。接著請用瀏覽器開啟目標網頁，並查看用戶端記錄。具有獨立 VPN 的工作應用程式可能互相衝突；同一使用者環境通常只能有一個一般 VPN 服務處於連線狀態。

Android 不需要再套用桌面端的系統代理步驟。若只有部分應用程式未走代理，請查看用戶端是否啟用了應用程式分流，以及清單代表「只代理選取的應用程式」還是「略過選取的應用程式」；兩種模式的意思相反。修改後請中斷並重新連線，再重新開啟目標應用程式，避免舊連線仍沿用原路徑。

鎖定螢幕後斷線，請先檢查系統的電池最佳化、背景活動和自動啟動設定。不同裝置的設定位置各異，請只針對目前使用的用戶端逐項調整，不要關閉整台裝置的省電功能。將應用程式留在最近使用清單中不一定足夠；允許背景執行也無法修復無效訂閱，因此先確認前景連線穩定，再排查背景行為。

在無線網路和行動網路之間切換後，先確認一般網路可開啟普通網頁，再重新連線。若已啟用系統的「一律開啟 VPN」或「中斷時封鎖其他連線」，用戶端結束後可能造成整台裝置無法上網。排查時先了解這兩項設定的作用，再決定是否暫時關閉。恢復正常後，依實際需求重新設定，避免將系統封鎖行為誤判為用戶端無回應。

代理與路由：分辨入口和出口

代理設定可分成兩層：第一層決定應用程式的請求如何進入用戶端，第二層決定請求進入後從哪個出口送出。系統代理和 TUN 主要處理第一層，路由規則則主要處理第二層。啟用 TUN 不代表所有請求都會走代理出口；選擇直連規則也不代表流量沒有經過用戶端。先釐清整條路徑，再討論「全域」或「略過」等選項名稱。

系統代理三種狀態與 TUN 的範圍

「自動設定系統代理」會讓遵循系統設定的應用程式指向本機入口；「清除系統代理」會撤銷相關設定；「不變更系統代理」則保留現有狀態。三者並非連線品質等級。若本機核心已停止，但系統仍指向其連接埠，瀏覽器就會連線失敗。若系統代理已清除，即使核心仍在執行，瀏覽器也可能直接連上網路。

TUN 透過虛擬網路介面接收符合接管條件的流量，適合不讀取系統代理的應用程式，但也會帶來權限、路由與 DNS 協同問題。特定環境下兩種方式可以並用，但初次排查時不建議一起啟用。先確認系統代理路徑正常，再加入 TUN；若發生問題，就能明確判斷是否來自新增的流量接管層。

先使用預設值，再新增最少必要規則

初次使用時，先選擇用戶端提供的合適路由預設值，確認基本連線正常後，再處理特定網站或區域網路服務。規則通常依序比對，前面的寬鬆規則可能會遮蔽後面更精確的規則。新增規則後，請檢查規則位置、比對類型和出口名稱。只把網域加入清單卻選錯出口，結果仍會與預期相反。

geosite:cn 表示引用相應的網域集合，geoip:private 表示引用私有位址集合；兩者都需要執行環境提供相應的規則資料，並非在所有設定中都自然有效。direct 通常只是設定作者為直連出口指定的標籤，只有確實存在同名出口時，規則引用才有作用；不能將標籤視為核心保留的自動出口。

區域網路印表機、家用儲存裝置或路由器管理頁無法使用時，請先檢查私有位址是否設為直連，以及目標名稱是否解析到正確的本機位址。區域網路探索也可能涉及廣播或多點傳送，不完全等同於開啟網頁。不要因裝置清單空白就將所有請求改為直連，請分別測試直接輸入位址和自動探索功能。

一併檢查 DNS 與驗證方式

網域規則需要用戶端知道請求的目標名稱，位址規則則依賴目標位址。應用程式自行解析、使用加密解析，或只向代理傳送位址時，比對條件可能改變。DNS 設定也會受到用戶端接管方式影響。網域無法存取時，請先檢查解析結果和路由記錄，不要立刻關閉憑證驗證或隨意替換所有解析伺服器。

瀏覽器的安全 DNS、系統解析、用戶端 DNS 和 TUN 的 DNS 接管可能同時存在。請先記錄由哪一層負責解析，再逐一變更。若變更後只有瀏覽器行為不同，請檢查瀏覽器的獨立設定；若所有應用程式都失敗，則回頭檢查系統網路和流量接管層。解析快取可能影響複測，修改後可重新啟動目標應用程式以建立新連線。

驗證規則時，固定一個目標和一台目前使用的伺服器，每次只修改一條規則，觀察新請求使用哪個出口。網頁快取、既有長連線和連線重用都可能讓結果延遲顯現。先關閉目標應用程式再重新開啟，必要時重新連線用戶端，不要只連續重新整理同一頁面。請確認記錄中的目標和出口符合實際測試時間，避免誤讀舊記錄。

「全域」在不同用戶端中可能指流量接管，也可能指路由預設值；描述問題時請寫明具體選單和選項。規則數量多不代表更準確；請記下每條自訂規則的用途，發生異常時才能依新增順序逐步回復。日常只需處理明確的網站和應用程式需求，不必同時啟用所有可見的進階選項。

設定檔：從入口讀到路由

圖形用戶端通常會依伺服器、訂閱和路由設定產生執行設定。介面中的單一選項可能同時影響設定檔中的多個欄位。閱讀設定有助於判斷問題，但直接修改執行檔不一定能保存變更：切換伺服器、更新訂閱或重新啟動核心時，用戶端可能重新產生設定。需要長期保留的設定，應優先透過介面或專用的自訂設定入口管理。

認識主要欄位與標籤引用

inbounds 定義接收本機請求的入口，包含監聽位址、連接埠和入口協定；outbounds 定義請求送出時使用的出口；routing 則決定請求與出口的對應關係。入口連接埠不是遠端伺服器連接埠；若將兩者對調，可能導致本機應用程式無法連線，或核心嘗試連到錯誤位置。

tag 是用於引用的名稱，在同一份設定中應保持清楚且不重複。路由中的 outboundTag 必須指向已定義的出口，大小寫也應一致。log 控制記錄行為，dns 定義核心相關的解析設定；這些欄位無法補上缺少的出口，更無法自動修正訂閱中的錯誤認證資訊。

透過可執行的直連設定理解結構

以下是一份 Xray 直連示範設定，只在本機迴路位址開放 SOCKS 入口，並將請求交由直連出口處理。它不包含遠端代理服務，也不會將流量傳送至訂閱伺服器。此範例用於理解設定結構，不應覆蓋用戶端已產生的正式設定；若要使用，請透過支援自訂設定的入口另行儲存並選取。

{
  "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"
    }
  ],
  "routing": {
    "rules": [
      {
        "type": "field",
        "inboundTag": ["local-socks"],
        "outboundTag": "direct"
      }
    ]
  }
}

範例中的監聽連接埠必須未被其他程式占用。若用戶端現有核心已使用相同連接埠，請停止舊設定，或在獨立設定中改用其他連接埠，並同步修改測試應用程式的入口。此處採用僅本機監聽且不需認證的組合，是因為連線範圍限於本裝置；未經評估，不要將監聽位址改為所有網路介面。

這段設定中的 SOCKS 入口不能直接當作 HTTP 代理使用。瀏覽器或其他應用程式若明確支援 SOCKS，請填入本機位址和相應連接埠；只接受 HTTP 代理的欄位不能套用相同協定。入口支援 UDP，不代表整條連線都能使用；應用程式、流量接管方式和實際出口都必須支援相應傳輸。

修改範圍與錯誤復原

JSON 物件的鍵名必須使用雙引號；標準 JSON 不支援任意插入註解，最後一個成員後也不能多加逗號。布林值和數字不應因複製習慣而一律加上引號。若發生解析錯誤，先檢查記錄指出的行列附近，常見原因是括號、引號或逗號有誤；結構尚未通過解析前，不要繼續調整網路參數。

結構合法只是第一步。核心還會檢查欄位、協定和引用關係，之後才會嘗試連線。將錯誤分為「文字解析失敗」、「設定驗證失敗」和「建立連線失敗」三類，可大幅縮小排查範圍。若記錄指出未知欄位或不支援的安全模式，請先確認目前核心類型和設定來源，不要為了勉強啟動而刪除關鍵欄位。

使用 TLS 或 REALITY 時，伺服器位址、驗證名稱和其他協商參數用途各異，請依連線資料正確填寫。不要將伺服器憑證驗證問題當成一般開關故障，更不要為了消除錯誤而長期關閉驗證。請先檢查裝置時間、連線資料是否過期，以及所選核心是否支援相應功能，再向資料提供者確認參數。

自訂設定通常不會自動沿用圖形介面的所有選項。介面中變更路由，不一定會改動獨立設定中的規則；反過來，編輯檔案也不一定會更新伺服器清單。若要深入了解各區段的關係，可繼續閱讀設定檔 JSON 結構詳解；先確認設定來源和生效位置，再決定修改方式。

設定常見問題：依失敗位置排查

排錯時，先說清楚「哪個步驟失敗」，再選擇檢查項目。安裝失敗屬於執行環境問題；訂閱失敗屬於資料取得或解析問題；核心啟動失敗屬於本機設定問題；啟動後無法開啟網頁，才需要檢查流量路徑和遠端連線。以下依常見現象整理，先恢復最基本的可用狀態，再逐項加回進階設定，避免反覆切換碰運氣。

訂閱失敗、清單空白或協定不相容

訂閱更新逾時時，先檢查基礎網路，再確認網址完整，以及是否需要透過既有代理存取。若已收到內容但解析失敗，請查看回傳內容是否為錯誤網頁，以及目前用戶端是否支援該格式。連結失效、帳戶狀態變更和用戶端版本過舊都可能造成失敗；請依具體提示判斷，不能只憑「昨天還能用」排除資料來源問題。

更新成功卻看不到項目時，先清除關鍵字篩選，檢查目前群組和隱藏狀態，再確認更新的是哪個群組。不要立刻刪除所有群組重新建立。若同時有多組訂閱，可先停用不相關群組，減少同名項目的干擾；整理方式請參閱v2rayN 訂閱群組與篩選說明。

出現不支援的協定或欄位時，先確認設定所需的核心。更換介面主題、修改連接埠或啟用 TUN 都不會增加協定支援能力。桌面使用 v2rayN 時，請檢查目前設定對應的核心類型；Android 則依 Xray 或 V2Fly 需求選擇相應用戶端。遷移後先測試一筆設定，確認可用再匯入其他資料。

顯示連線成功，網頁仍無法開啟

先確認用戶端只是啟動了核心，還是已產生實際請求記錄。若沒有請求進入核心，請檢查系統代理、應用程式的獨立代理或 TUN 接管範圍；若有請求但連線失敗，再檢查遠端位址、認證、傳輸和 DNS。狀態列的連線圖示只反映本機狀態，不能取代目標網站的連線測試。

所有網域都無法連線，但部分直接位址可存取時，可將 DNS 列為排查方向，但不能因此直接下結論。加密網站通常需要網域和憑證相符；直接用位址開啟時出現憑證提示，並非有效的等價測試。請根據記錄中的解析錯誤、請求目標和出口判斷，不要為了完成測試而忽略憑證警告。

只有一個網站無法使用時，請維持同一份設定，測試其他正常目標，再檢查該網站的路由、應用程式快取和遠端限制。只有一個應用程式失敗時，請確認它是否使用系統代理，或遭應用程式分流規則排除。若更換伺服器後恢復，請記下差異再繼續判斷；單次成功不能證明所有設定都正確。

啟用 TUN 後整台裝置斷網，請先關閉 TUN、移除目前測試新增的接管層，回到先前可用的系統代理方式。接著檢查權限、虛擬介面、其他 VPN 工具和 DNS 接管，每次只恢復一項。若透過遠端連線管理裝置，請先保留本機還原方式，不要在唯一的管理連線上連續嘗試修改路由。

結束用戶端、更新與跨裝置遷移

結束用戶端後無法開啟網頁，請檢查系統是否仍指向已停止的本機代理。先還原原有系統代理狀態，再確認基礎網路。Android 也要檢查一律開啟 VPN 和中斷時封鎖連線等選項。不要一開始就重設裝置網路，因為這可能同時清除無線網路、工作網路及其他需要保留的設定。

升級後出現異常，先正常結束舊執行個體，再確認新的啟動入口和設定目錄。不要同時保留兩個自動啟動項目。若使用自訂設定，請確認新核心是否仍支援原有欄位；若使用訂閱產生設定，先用預設選項重新驗證。保留備份後再遷移，避免更新時清掉唯一可還原的設定。

跨裝置遷移時，優先轉移訂閱來源和必要規則，不要直接複製整份系統流量接管設定。本機連接埠、監聽位址、權限和介面名稱可能因新裝置而異。新裝置先完成單筆連線驗證，再加入群組、自動更新和分流。確認舊裝置不再使用後，請撤銷其系統代理和自動啟動設定，避免留下難以辨識的背景狀態。

需要進一步求助時，請整理作業系統、用戶端名稱、核心類型、失敗步驟、已遮蔽敏感資訊的錯誤文字，以及是否啟用 TUN。不要附上完整訂閱網址或帳戶憑證。其他獨立問題請參閱常見問題；若尚未成功連線過，請返回快速入門教學，從預設設定重新完成主要流程。