Linux SSH X11 Forwarding 失敗 "X11 forwarding request failed on channel 0" 兩大解法：X11UseLocalhost 與 IPv6 衝突

啟用 ssh -X 或 ForwardX11 yes 時出現 X11 forwarding request failed on channel 0，通常因兩大原因：X11UseLocalhost yes 綁定回環介面導致部分 X Client 失效、或 SSH Server 禁用 IPv6 但 X11 嘗試 IPv6 連線。本文提供兩針對性修復方案。

前置檢查

# Client 端
ssh -X user@host   # 或 -Y (Trusted)
# Server 端 /etc/ssh/sshd_config
X11Forwarding yes
# 重啟 sshd
systemctl restart sshd

方案一：關閉 X11UseLocalhost (綁定所有介面)

原因：OpenSSH 預設 X11UseLocalhost yes，將 X11 socket 綁定在 127.0.0.1，DISPLAY 設為 localhost:10.0。某些 X Client (舊版、跨網段、容器) 無法連接回環介面。

# /etc/ssh/sshd_config
X11Forwarding yes
X11UseLocalhost no   # 關鍵：綁定 0.0.0.0 (所有介面)
# 重啟
systemctl restart sshd
# 或針對性重啟
systemctl reload sshd

修改後 DISPLAY 變為 hostname:10.0，X Client 可經由實體 IP 連回 Server。

方案二：強制 SSH 僅用 IPv4 (解決 IPv6 衝突)

原因：Server 禁用 IPv6 (sysctl net.ipv6.conf.all.disable_ipv6=1)，但 SSH X11 轉發嘗試建立 IPv6 socket 失敗。

# /etc/ssh/sshd_config
AddressFamily inet   # 僅 IPv4 (inet6 為 IPv6, any 為雙棧)
# 重啟 sshd
systemctl restart sshd

注意：AddressFamily any (預設) 為雙棧；若 Server 確實無 IPv6，必須設 inet。

驗證修復

ssh -X user@host
echo $DISPLAY
# 應顯示 hostname:10.0 (方案一) 或 localhost:10.0 (方案二)
xclock &   # 測試圖形視窗彈出
xeyes &

Client 端參數微調

# ~/.ssh/config
Host *
    ForwardX11 yes
    ForwardX11Trusted yes   # 相當於 -Y, 繞過 SECURITY extension 延遲
    # 若仍失敗，嘗試指定 IP
    # ForwardX11Timeout 0   # 無期限

防火牆/SELinux 檢查

• Server 需開放 TCP 6000+ (通常 6010~6020) 供 X Client 連回 (方案一需)。
• SELinux: setsebool -P ssh_forward_x11 1 (RHEL/CentOS)。

替代方案：X11 轉發替代品

• xpra：持久化、可斷線重連、效能優於 SSH X11。
• VNC/RDP：完整桌面轉發。
• VS Code Remote SSH / JetBrains Gateway：IDE 級遠端開發，內建 X 轉發。

依據環境套用方案一或二 (或兩者兼用)，即可徹底解決 SSH X11 Forwarding 失敗問題。