設定檔參考

V2Ray JSON 設定手冊

如果還沒完成安裝、匯入和首次連線,請先閱讀快速入門教學,依照圖形介面操作一次;若想了解某個選項會產生哪些欄位,或追查連線在哪個環節出錯,再回來查閱本手冊。本文以本機監聽、直連和封鎖為例,逐步說明用戶端交給核心的設定。

JSON 結構:從入口追到出口

設定檔的根節點是一個物件。可以把它想成核心啟動時讀取的連線說明,而不是用戶端介面各項設定的備份。inbounds 和 outbounds 是陣列,同一個程序可以登記多個入口和出口;routing、dns 和 policy 則是負責不同工作的物件。用戶端儲存的訂閱名稱、介面偏好或歷史測速結果,都不屬於這份說明。匯出設定前,先確認匯出的是用戶端設定、單一節點,還是某次啟動時交給核心的完整檔案。

完整基礎設定與局部範例的差異

以下是一份完整的本機基礎設定:應用程式將 SOCKS 請求送到迴圈位址,核心透過 freedom 出站直接連線至目標。這不是遠端節點設定,不需要伺服器位址或帳號。請透過用戶端支援的自訂設定入口載入副本;如果同一個連接埠已被其他程序占用,請先結束該程序,或在副本中改用未占用的連接埠,並同步修改測試應用程式的代理位址。後續章節中的程式碼多半是局部欄位,不要依序貼到這個檔案的末尾。

{
  "log": {
    "loglevel": "warning"
  },
  "inbounds": [
    {
      "tag": "local-socks",
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks",
      "settings": {
        "auth": "noauth",
        "udp": false
      }
    }
  ],
  "outbounds": [
    {
      "tag": "direct",
      "protocol": "freedom",
      "settings": {}
    }
  ]
}

有三個地方值得留意。第一,port 是數字,udp 是布林值,不要為了格式整齊而替兩者加上引號。第二,入站和出站都有 protocol 與 settings,但欄位的解讀方式取決於各自的協定;不能把 SOCKS 入站的認證欄位照搬到直連出站。第三,tag 是檔案內部的識別名稱,可以自行命名,但後續引用時必須完全一致。將 direct 改成其他名稱不會改變直連行為,卻可能讓仍引用舊名稱的規則失效。

閱讀順序不等於欄位排列順序

排查時先沿著連線流程追查:應用程式將請求交給某個入口,核心判斷可取得哪些目標資訊,再依規則選擇出口,最後由出口依自己的協定和解析策略建立後續連線。DNS 並非每條連線都固定經過的環節。請求一開始若帶的是數字位址,核心可能不必查詢;若應用程式先在本機解析,再交給 SOCKS,核心甚至可能看不到原始網域。連線策略則限制特定階段的等待與統計行為,不負責選擇路由。

根物件中各欄位的排列順序通常不影響意義,例如把日誌區塊移到檔案末尾,不會改變日誌涵蓋的連線範圍。但陣列中的順序可能左右結果:路由規則依序比對,預設出口則取決於出站陣列的第一個項目。合併設定時,物件和陣列要分開處理。根節點已有 outbounds 時,請修改原有陣列,不要再新增同名鍵;許多解析器會採用後面的值而不提示重複鍵,導致原本的出口在啟動後消失。

確認要在用戶端還是核心修改

桌面用戶端首選 v2rayN,請依作業系統和處理器架構前往用戶端下載頁選擇版本。Android 端則依所需核心選擇 v2rayNG 或 v2flyNG。圖形用戶端的標準範本可能在切換節點、重新啟動服務或更新訂閱時重新產生檔案;直接編輯暫存檔,即使一時生效,也不代表變更已儲存。先確認目前使用的是圖形設定還是自訂設定,再從對應入口儲存,之後重新開啟或再次匯出確認。

修改前先備份一份可完整還原的副本,並記下用戶端選用的核心。不同核心或設定版本中的同名欄位,不一定支援相同選項;借來的片段能用文字編輯器開啟,也不代表目前的核心能接受。嚴格的 JSON 使用雙引號,不支援註解、尾隨逗號或單引號。先檢查語法,再檢查欄位型別和本機監聽,最後實際測試一次請求。如此一來,便能分別處理檔案無法讀取、服務未啟動和連線行為不符預期等問題。

inbounds:監聽位址、連接埠與協定

入站設定描述核心如何接收連線,不是遠端伺服器的位置。判斷入站是否可用,至少要確認監聽位址、連接埠和入站協定彼此吻合。用戶端介面顯示「已連線」,也不能替應用程式完成這項確認:應用程式可能仍使用舊的代理連接埠,或是把 SOCKS 交握請求送到 HTTP 代理位址。要區分這些情況,先確認作業系統能否連上該連接埠,再檢查核心是否收到符合預期的代理請求。

分別提供 SOCKS 與 HTTP 入口

以下片段可用來取代基礎設定中的 inbounds 陣列。這裡替兩種代理分配不同連接埠,方便確認應用程式實際使用哪個入口。local-socks 留給明確支援 SOCKS 的應用程式,local-http 則供支援 HTTP 代理的應用程式使用。兩者可以共用同一個出站,也可以在路由中依入站標籤分別處理。連接埠號碼本身不代表協定,真正決定交握格式的是 protocol。

{
  "inbounds": [
    {
      "tag": "local-socks",
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks",
      "settings": {
        "auth": "noauth",
        "udp": false,
        "userLevel": 0
      }
    },
    {
      "tag": "local-http",
      "listen": "127.0.0.1",
      "port": 10809,
      "protocol": "http",
      "settings": {
        "userLevel": 0
      }
    }
  ]
}
欄位用途檢查項目
listen限制監聽所綁定的本機位址。代理位址中的位址部分。
port指定入站連接埠。應用程式設定的代理連接埠,以及連接埠是否已被占用。
protocol決定入口接受哪一種代理交握。應用程式選用的代理類型。
tag標記流量來源,供路由規則使用。規則中的 inboundTag。

迴圈位址、存取範圍與位址族

127.0.0.1 是本機的 IPv4 迴圈位址。範例未設定帳號,但仍將監聽限制在本機,避免其他裝置直接使用這個入口。不要只為了讓同一台電腦上的瀏覽器連線,就改成監聽所有網路介面;這會擴大存取範圍,卻無法修正代理類型設定錯誤。若應用程式位於虛擬機或另一個網路命名空間中,它看到的迴圈位址可能屬於自己的環境,與主機所在位置不同,因此不能直接照抄主機的代理位址。

本機應用程式使用 localhost 時,系統可能會優先嘗試 IPv6 迴圈位址。範例只綁定 IPv4,部分應用程式無法改用其他位址,因此本機也會連線失敗。排查時先明確填入 127.0.0.1,排除名稱解析和位址族選擇問題,再判斷是否真的需要新增另一種監聽。如果日誌在啟動階段就提示連接埠已被占用,應先確認是哪個程序占用,不要把更換監聽位址當成例行處理方式。某個用戶端啟動的舊程序,有時仍在替其他應用程式處理連線。

UDP 支援與網域識別是兩回事

SOCKS 入站允許 UDP,不代表所有 UDP 資料包都會進入核心。應用程式必須支援 SOCKS 的 UDP 轉送方式,出口也必須能處理這類流量;一般 HTTP 代理不會因此代替系統接管 UDP。驗證連線時先測試 TCP。只有在確認具體是哪個應用程式、哪種協定需要 UDP 後,再於可控環境中單獨測試。否則即使網頁能正常開啟,也無法據此判斷應用程式的即時通話、遊戲或傳統 DNS 查詢是否走同一條路徑。

部分入站支援在建立後續連線前識別流量中的目標資訊,常見設定是 sniffing。這有時能補上應用程式未直接提供的網域資訊,但無法從每個數字位址還原出唯一網站。能否讀取識別資訊取決於流量本身;識別到的名稱是否取代原目標,則由另一項設定決定。除錯時先使用本來就會把網域交給代理的應用程式,確認一般網域規則正常,再判斷是否需要依賴識別功能。不要同時開啟多個選項,否則無法判斷哪個設定生效。

outbounds:出口協定與預設行為

出站設定描述核心收到請求後要如何繼續處理。最容易驗證的兩種出站是 freedom 和 blackhole:前者由執行核心的電腦直接連線到目標,後者則會終止交由它處理的流量。出站名稱叫做 direct 或 blocked,不代表它因此具備任何特定功能;實際行為仍由 protocol 決定。先用這兩種結果明顯不同的出口確認路由,再加入需要遠端配合的連線,就能區分路由錯誤與節點交握錯誤。

使用兩個出口建立可觀察的對照

{
  "outbounds": [
    {
      "tag": "direct",
      "protocol": "freedom",
      "settings": {
        "domainStrategy": "AsIs"
      }
    },
    {
      "tag": "blocked",
      "protocol": "blackhole",
      "settings": {
        "response": {
          "type": "none"
        }
      }
    }
  ]
}

這段程式碼可用來取代基礎設定中的 outbounds 陣列。由於直連出站排在第一個項目,未符合規則的連線會走直連。封鎖出口即使列在陣列中,也不會自動處理任何網域;必須有規則將請求交給它,或將它設為預設出口。response.type 設為 none,表示不建立協定回應。應用程式可能顯示連線中斷、載入失敗或重試,而不是出現說明封鎖原因的網頁。看到失敗後仍須確認日誌記錄的出口選擇,不能單憑失敗就認定封鎖規則已生效。

第一個項目是預設出口,因此調整清單順序可能影響許多未寫入規則的服務。測試期間請保留明確的預設出口,新增規則時先只針對一個測試目標;若將封鎖出口改為預設出口,還得另外維護允許存取的目標。不要以為第一個出口失敗時,第二個出口就會自動接手。備援節點和故障轉移需要明確的選擇機制,一般出站陣列並不代表重試順序。

區分協定設定與傳輸設定

含遠端伺服器的出站通常也會設定 settings 和 streamSettings。前者放置各代理協定定義的參數,後者通常描述連線至伺服器所使用的傳輸方式與安全層。伺服器位址、連接埠、協定和識別資訊必須與伺服器端相符;傳輸類型、路徑、主機名稱和安全層要求也必須一併核對。協定名稱相同,不代表設定就相容。同一個網域可能部署多種服務,憑證使用的名稱也不一定等同於實際連線的位址。

匯入訂閱後,請先參照訂閱匯入教學,確認用戶端辨識出的協定與傳輸方式,不要把多個節點中看起來熟悉的欄位拼湊在一起。若要確認目前的核心是否支援某個選項,可以參考Xray 與 V2Fly 核心差異。在圖形介面更換核心後,請重新啟動實際連線並查看啟動資訊;只更改下拉式選單中的名稱,不足以證明執行中的程序已切換。

區分目標位址與伺服器位址

應用程式請求的目標,是它要存取的服務;遠端出站的伺服器位址,則是核心首先要連線的另一端。兩者都可能使用網域名稱,但不是同一次解析。以直連出站為例,AsIs 會保留位址形式,交由撥號階段處理,不代表要求內建 DNS 解析所有目標。使用遠端出站時,還要分別確認本機能否連上伺服器,以及遠端是否能存取最終目標。網站無法載入不代表伺服器位址一定寫錯;日誌記錄選中了出站,也不代表目標已傳回資料。

遇到逾時時,記錄「選中了哪個出口、出口連往哪裡、連線停在哪個階段」。如果基礎設定的直連也失敗,先檢查本機網路和目標服務;如果只有某個遠端出站失敗,再檢查傳輸方式和交握。參照v2rayN 節點逾時排查步驟時,建議使用同一個目標反覆測試。不要每次同時更換目標、核心和節點,否則無法判斷是哪項變更造成差異。

routing:比對順序與目標資訊

路由規則負責決定「將這個請求交給哪個已定義的出口」,並不會替請求修改代理協定。規則會依序檢查,第一條符合條件的規則取得選擇權,後續同類規則不會再接著比對。精確例外應排在範圍較廣的規則前面;若將能符合所有請求的規則放在最上方,再完整的網域清單也等於沒有設定。規劃時要明確指定預設出口,因為未符合任何規則時並非沒有結果,而是會回到出站陣列的第一個項目。

撰寫一條可單獨驗證的規則

{
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "inboundTag": ["local-socks"],
        "domain": ["full:example.org"],
        "outboundTag": "blocked"
      },
      {
        "type": "field",
        "inboundTag": ["local-socks"],
        "outboundTag": "direct"
      }
    ]
  }
}

將片段合併到已定義 direct 和 blocked 的設定中,並保留 local-socks 入站。第一條規則要求請求來自該入站,且目標網域必須完全等於 example.org;第二條則涵蓋此入站的其他流量。若另有 HTTP 入站,就不符合這兩條規則的來源條件,因此會回到預設出口。若將兩條規則對調,SOCKS 入站的請求就會全部先符合第二條的廣泛條件,精確規則因此不會有執行機會。

同一條規則中的不同條件欄位必須全部符合;同一欄位中的多個候選值則代表任一項符合即可。例如加入 network 並限定為 TCP,表示還必須符合網路類型,而不是「來自這個入口或使用 TCP」。若要讓兩種情境任一符合就能命中,通常應分別撰寫兩條規則,並指向同一個出口。不要只為了縮短檔案,就把兩條獨立規則硬合成一條,否則比對範圍可能從聯集變成交集。

依網域比對,還是依位址比對

full: 用於精確比對網域,不會涵蓋子網域。若要同時涵蓋根網域及其子網域,通常使用 domain:,並測試一個名稱相近但不應命中的網域。裸字串的比對範圍通常比想像中寬,不適合用來表達「只允許某個網域」;只有確實需要時才使用正規表示式,以免過於寬鬆的寫法連相似名稱也一併涵蓋。IP 規則應填入數字位址或網段,不能用網域名稱代替。若規則引用網域集或位址集,請確認目前的核心能找到對應資源,且資源中確實包含所需分類。

routing.domainStrategy 決定路由比對是否需要將網域解析為位址。AsIs 只使用目前已有的目標資訊,因此 IP 規則不會靠它主動解析網域。IPIfNonMatch 可在原本沒有比對結果時再查詢位址;這代表若廣泛的網域規則已先命中,IP 規則仍可能沒有機會執行。IPOnDemand 則可能在檢查 IP 條件時就發起解析。不要把這些策略當成效能預設值;先確認設計上需要依網域分類,還是必須依解析後的位址分類。

測試未命中,比測試命中更有參考價值

調整順序後,至少重新測試一個應被封鎖的主機、一個應直連的無關主機,以及一個名稱與規則相近但應排除的子網域。若應用程式先將網域解析成 IP,再把 IP 交給代理,沒有額外的識別資訊時,精確網域規則本來就無法命中。也要留意瀏覽器可能重用舊連線,或由網頁指令碼向多個主機送出請求。以單一請求作為測試基準,比查看整頁載入結果更容易判讀。

若出口確實如預期選中,但請求仍然失敗,就先保留這條路由,改為排查出站、DNS 或目標服務。若出口標籤拼錯,請檢查出口定義和規則,不要為了配合拼錯的名稱,另外新增一個重複出口。長期維護的設定可在最上方保留少量精確例外,接著依職責分組,最後明確指定預設路徑。每次變更都應能說明會影響哪些目標,以及哪些目標不應受到影響。

V2Ray DNS 設定:由誰解析、在哪裡解析

發現網域解析失敗時,第一步是確認由誰發起查詢。瀏覽器或作業系統可能在連上代理前就完成解析;核心可能為了路由比對或出站連線而呼叫內建解析器;遠端也可能負責最後一次查詢。設定中的 dns 物件描述的是核心自身的解析設定,不會自動取代作業系統 DNS,也不會強制所有應用程式停用內建解析功能。只修改這裡,但用戶端日誌沒有相應查詢,通常表示測試請求根本沒有到達這一層。

使用固定對應測試核心的解析流程

以下範例用於本機測試,不是通用的上網設定。準備一個綁定在 127.0.0.1 的本機 HTTP 服務,使用與代理入站不同的連接埠,例如 8000。以結構總覽中的完整基礎設定為底稿,將此處的 dns 加到根物件,再取代 outbounds。透過 SOCKS 將 demo.test 原樣交給核心,並造訪 http://demo.test:8000/。服務必須接受此主機名稱,或至少能在日誌中記錄收到的請求。此例會將保留測試網域指向迴圈位址,不需要外部解析服務回覆該名稱。

{
  "dns": {
    "hosts": {
      "demo.test": "127.0.0.1"
    },
    "servers": ["localhost"]
  },
  "outbounds": [
    {
      "tag": "direct",
      "protocol": "freedom",
      "settings": {
        "domainStrategy": "UseIP"
      }
    }
  ]
}

hosts 是核心解析器的靜態對應;servers 中的 localhost 表示使用本機系統的解析能力處理需要查詢的名稱,並不是要求有一台 DNS 服務監聽在迴圈位址。此處對直連出站使用 UseIP,目的是先取得網域的位址,因此可以觀察到前面的靜態對應。如果測試應用程式堅持自行先解析,可能會直接回報找不到網域;若交給核心的已經是 IP,即使連線成功,也沒有驗證這張靜態對應表。

不要把兩個同名策略當成同一個開關

路由物件中的 domainStrategy 控制比對階段如何補充目標資訊;出站設定中的同名欄位則控制該出站在連線前如何處理目標網域。只修改出站策略,無法讓先前未命中的路由規則重新比對。反過來說,為路由比對解析出某個 IP,也不保證後續連線一定使用剛才取得的位址,實際行為還取決於出站實作和設定。定位問題時一次只修改一層,再檢查出口名稱與最終目標,避免將兩處變更都歸因於同一個開關。

若使用特定解析伺服器,請先確認核心可從目前的網路存取它,再考慮分流查詢和回退。依網域指定伺服器,只是選擇查詢要送往哪裡,不等於指定應用程式連線使用的出站;兩者可能受不同規則影響。若解析伺服器使用網域名稱,也要想清楚該伺服器的網域要如何進行首次解析。若這一步依賴同一台尚未連通的伺服器,就可能形成循環,造成多個網域的查詢同時逾時。

從錯誤類型判斷下一步

網域不存在與請求逾時是不同的錯誤。前者表示收到可解讀的否定回應,可能是網域名稱寫錯、查詢送到不認識內部網域的解析器,或應該命中的靜態對應沒有被使用。後者表示等待期間沒有收到可用回應,應檢查解析路徑、網路連線和伺服器回應。即使查到位址後連線仍失敗,也要確認回傳的是 IPv4 還是 IPv6、網路能否連到該位址,以及比對規則是否讓請求改走另一個出口。

測試結果偶爾不一致時,請分別考量應用程式快取、系統快取、核心快取和已建立的連線。關閉頁面不一定會結束瀏覽器保留的連線;修改核心設定也不一定會清除應用程式的網域快取。最好重新發出獨立請求再測試,比對明確記錄的目標與結果,不要只靠重新整理次數判斷。若問題與系統代理交錯,請參閱連線後無法上網排查清單,先釐清入口問題,再縮小 DNS 排查範圍。

policy:交握、閒置與統計

策略不會決定要存取哪個網域、選擇哪個節點,也不等同於系統防火牆。policy.levels 會針對核心識別的使用者等級設定連線行為;policy.system 則包含系統層級的統計開關。這裡的等級不是系統帳戶權限,也不代表訂閱方案。入站或協定中的使用者參數負責選用等級,策略區塊則規定該等級的行為。若要確認某個等級為何沒有生效,應先確認目前連線使用的入口與協定實際套用了該等級。

為測試入站設定明確的等待時間

{
  "policy": {
    "levels": {
      "0": {
        "handshake": 8,
        "connIdle": 300,
        "uplinkOnly": 5,
        "downlinkOnly": 5
      }
    },
    "system": {
      "statsInboundUplink": true,
      "statsInboundDownlink": true
    }
  },
  "stats": {}
}

將這兩個頂層欄位合併到設定中,並使用前文設定了 userLevel: 0 的 SOCKS 入站進行測試。levels 的鍵是字串格式的等級編號,時間設定則使用數字,單位為秒。這些數值只是方便說明的範例,不是適用於所有網路的通用建議。實際受哪些設定影響,取決於協定的實作;也要分辨是核心處理入口時中止連線,還是遠端服務、應用程式或網路設備先結束連線。

欄位關注階段可觀察到的現象
handshake適用協定的初始交握。連線建立後,交握一直未完成。
connIdle連線一段時間沒有資料交換。連線期間運作正常,長時間閒置後中斷。
uplinkOnly下行結束後,上行仍可繼續的時間。只剩用戶端向目標傳送資料。
downlinkOnly上行結束後,下行仍可繼續的時間。傳送完成後,仍在等待讀取剩餘回應。

依連線階段判斷是否需要調整時間

交握時間太短,可能會讓速度較慢的連線還沒完成協商就遭到中止;但調長時間也無法修正連接埠填錯、目標拒絕連線或協定參數不符。閒置時間也不等於連線總存續時間。只要定期有資料傳送的工作階段,就不能單憑「已開啟幾秒」判斷是否達到閒置門檻。若要驗證,可先記下最後一筆資料的時間,再觀察連線是否在接近設定間隔時中止,並與應用程式和伺服器自身的閒置逾時設定比較。

單向剩餘時間容易被誤認為上傳或下載速度限制。實際上,它關注的是其中一個方向已結束後,另一個方向還能保留多久以處理資料。例如測試程式送出請求後關閉傳送方向,服務可能還需要一段時間才能準備好最後一部分回應;等待時間太短,最後內容可能來不及完整傳回。但如果測試程式直接關閉整條連線,延長這段時間也無法讓應用程式重新讀取資料。最好每次只調整一個欄位,並用可以重現中斷的請求再次測試。

統計開關、讀取方式與適用範圍

stats 會啟用統計元件,policy.system 中的兩個開關則允許累計入站的上行與下行流量。範例沒有設定對外提供統計資料的介面,也不會自動在用戶端介面新增圖表。圖形用戶端是否顯示這些資料、如何讀取以及何時歸零,取決於它的整合方式。使用者層級的統計另有等級設定,也需要協定能識別使用者;不能把未設定驗證的入站總流量直接拆分成每個本機應用程式的用量。

排查時應比較相同口徑的數據:累計值與速率不同,入站流量和出站流量也不一定完全相等。重新啟動程序前後的讀數不能視為同一段連續資料;用戶端切換設定時也可能啟動新的程序。若只想確認某次測試是否進入特定入站,優先查看該連線的標籤與日誌。若只為這次除錯開啟詳細統計或存取記錄,完成後請還原日常設定,不要為了讀取計數而額外開放網路監聽。

設定驗證與故障排除

有效的故障排除不是重設所有可疑選項,而是先保留問題現象,再進行範圍最小的對照測試。記下目前使用的核心、啟動時載入的設定來源、代理入口和重現問題的目標;若有多個用戶端或程序,也要確認日誌是由哪個程序寫入。依序確認「設定檔能載入、連接埠可連線、請求已到達核心、出口選擇符合預期、目標已回傳回應」。前一個條件尚未成立時,後續階段的異常資料即使看起來有關,也未必來自這次測試。

先檢查讀取錯誤,再檢查監聽失敗

核心無法讀取檔案時,優先查看啟動日誌中的第一條相關錯誤。若有行號,除了檢查該行,也要查看前一個項目的結尾逗號和外層括號:解析器通常會在遇到第一個無法繼續讀取的字元時回報錯誤,但不保證該字元就是原始錯誤所在。能解析為 JSON,只代表語法結構完整,不代表協定受支援、連接埠可用或引用標籤正確。如果切換到某份設定後,用戶端立刻回到中斷狀態,不必先更新訂閱或測速,應從啟動錯誤開始排查。

成功啟動後,也不要只確認是否存在同名程序。請確認程序實際綁定的位址和連接埠,並與測試請求填入的值比較。若顯示連線遭拒,先排查沒有監聽、代理位址填錯、位址族不同或程序啟停時間不一致等問題;若已連上本機連接埠但代理交握失敗,再確認該連接埠使用的是 SOCKS 還是 HTTP。若連接埠被其他程式占用,用戶端介面仍可能顯示正確的選項;只有啟動日誌和實際請求能證明是哪個程序在處理連線。

用單一請求重現問題並縮小範圍

如果系統已安裝 curl,可以在命令列使用以下請求驗證完整的基礎設定。socks5h 表示將網域交給 SOCKS 代理解析;--noproxy "" 可避免環境中的代理例外讓測試略過明確指定的代理。在將 example.org 導向封鎖出口的路由範例中,第一個請求應該失敗;第二個請求可作為未命中該網域規則的對照,但本機網路仍須能存取對應服務。第三個請求用於 DNS 章節的本機對應測試,必須先準備本機服務並載入該節設定。三個請求不需要在同一份設定下全部成功。

curl --noproxy "" --proxy socks5h://127.0.0.1:10808 --max-time 15 https://example.org/
curl --noproxy "" --proxy socks5h://127.0.0.1:10808 --max-time 15 https://example.com/
curl --noproxy "" --proxy socks5h://127.0.0.1:10808 --max-time 15 http://demo.test:8000/

若單獨發出的請求可以使用,但瀏覽器無法使用,應優先檢查瀏覽器自身的代理模式、連線重用、解析設定和系統代理例外;若兩者都失敗,先在日誌中找出這次測試的入站標籤與出口路徑。沒有看到請求,不一定代表請求沒進入核心,也可能是目前的日誌層級或用戶端顯示範圍未記錄存取細節。可暫時將基礎設定中的 loglevel 改為 info 後重試,必要時透過用戶端查看核心存取日誌,完成後再恢復平常使用的層級。

讓設定變更可重測、也可還原

處理複雜故障時,先從只包含一個入口和一個直連出口的副本開始。確認應用程式確實透過本機代理存取目標後,再加入能區分結果的路由規則;接著依需求加入解析或連線策略,最後才測試遠端出站。每次修改後都使用相同的協定、連接埠和目標重新測試,並保留一個理應不受修改影響的請求。如果出現新錯誤,只撤回剛才的變更並觀察是否恢復。這樣取得的是可用來判斷因果關係的線索,而不是一次碰巧成功的連線。

記錄可以簡化為入口、目標、出口、階段和結果五項。向他人說明問題時,只需保留錯誤類型、相關標籤和必要的欄位結構,不要直接貼出整份匯出的檔案。訂閱網址、帳號資訊、內部位址和詳細存取記錄都應移除;若設定片段經過刪改,也要說明哪些名稱只是測試用途。若錯誤發生在遠端傳輸階段,請依照節點逾時排查繼續處理;若只是首次設定入口和連線模式,回到快速入門教學會更有效率。