連線和路由故障排除

在更改超時、伺服器信任或系統設定之前查詢路徑的哪一部分發生故障。

從失敗層開始

正確讀取連線狀態

正在連線表示連線仍在建立；已連線描述 SSH/配置的狀態，並不代表所有遠端目標都接受連線。某個目標失敗時，應結合它的錯誤資訊和耗時排查。

藍色/紅色連線路徑箭頭說明方向和狀態，而不是測量的吞吐量。流量總計包括 SSH 協議開銷。暫時阻止的連線可以在其轉發流量被阻止時保持建立。

檢查日誌

開啟 日誌，搜尋連線配置或相關物件，然後過濾類別/級別。選擇一行以檢查詳細資訊。 自動滾動和自動換行影響可讀性；它們不會改變連線行為。

對於透明代理，還請檢查代理頁面的日誌和活動連線。關聯源、應用程式、目的地、規則/代理、協議和時間。空的過濾結果意味著沒有匹配的日誌條目，不能證明連線成功。

儘可能僅匯出相關時間範圍。在將匯出的日誌傳送給支援人員之前，檢查匯出的日誌中的私有地址、使用者名稱、路徑、令牌和其他敏感內容。

常見轉發問題

• 地址已在使用中： 另一個監聽器擁有該連接埠。選擇一個未使用的高位連接埠；不要盲目殺死不明程序。
• 遠端綁定仍然環回： 向伺服器管理員詢問 GatewayPorts clientspecified 和其他轉發限制。
• 錯誤的目的地： 請記住，本機轉發的遠端地址是從 SSH 伺服器解析的，而遠端轉發的本機目標是從您的 Mac 到達的。
• 只有一個對映失敗： 檢查該行的監聽器/目標和錯誤的行號。
• 儲存的更改無效： 儲存後重新連線；現有流可以保留其原始路由決策。

區域網和移動應用程式

正常工作的手機瀏覽器並不意味著所有手機應用程式都使用其手動 HTTP 代理。應用商店、下載、後臺服務和QUIC可以使用不同的路徑。首先確定請求是否到達 Mac 以及它匹配哪條規則。

對於 SOCKS5 UDP，保持客戶端的 TCP 控制連線開啟。 Python 程序不必從 SSH 啟動時永久可見； UDP 轉發時使用該中繼。僅短連線和正常關閉並不能證明存在故障。

安全地報告問題

在資訊頁面選擇反饋問題。提供應用和 macOS 版本、連線型別、預期與實際行為、大致失敗時間，並附上已脫敏的相關日誌及應用視窗截圖。

切勿包含密碼、私鑰、身分驗證程式碼、頒發的授權、真實備份或可用的二維碼/密碼對。提交前請參閱問題模板的安全提醒。