Debian XRDP連入GNOME 桌面環境

要讓 XRDP 成功連入 GNOME 桌面環境，在 Debian 上需要做一些設定，因為 XRDP 預設常常會啟動失敗或只顯示黑畫面。以下是完整步驟與最佳化建議：

🖥️ 安裝與設定 XRDP

安裝 XRDP
```
sudo apt update
sudo apt install xrdp -y
```
安裝完成後，服務會自動啟動並綁定在 TCP 3389 連接埠。
確認服務狀態
```
systemctl status xrdp
```
確保服務正在執行。

安裝 GNOME 桌面環境（若尚未安裝）

sudo apt install task-gnome-desktop

或最小化安裝：

sudo apt install gnome-shell

設定預設桌面環境
- 編輯 ~/.xsession 檔案，加入：
```
gnome-session
```
- 這樣 XRDP 會啟動 GNOME Session。
避免黑畫面問題
- GNOME 在 XRDP 下通常需要使用 Xorg 而非 Wayland。
- 修改 /etc/xrdp/startwm.sh，在最後一行加入：
```
exec gnome-session
```
- 或者直接指定：
```
exec /usr/bin/gnome-session --session=gnome
```
禁用 Wayland（必要時）
- 編輯 /etc/gdm3/custom.conf，取消註解並設為：
```
WaylandEnable=false
```
- 這樣 GDM3 會強制使用 Xorg，避免 XRDP 無法顯示。

降低解析度與色深：在 RDP 客戶端設定較低解析度與 16-bit 色深，可減少延遲。
啟用壓縮：XRDP 支援壓縮傳輸，能提升網路效能。
使用輕量 GNOME Session：
- 可以安裝 gnome-flashback，比完整 GNOME Shell 更輕量，適合遠端桌面。
- 指令：
```
sudo apt install gnome-session-flashback
```
  然後在 .xsession 中改為：
```
gnome-session --session=gnome-flashback-metacity
```
監控效能：使用 htop 或 systemd-analyze 來檢查 CPU/記憶體瓶頸。

問題	解法
黑畫面或無法登入	在 `~/.xsession` 指定 `gnome-session`，並禁用 Wayland
無法輸入中文	安裝 `fcitx5` 並在 GNOME Session 啟動時載入
延遲高、畫面卡頓	降低解析度與色深，或改用 `gnome-flashback`
登入後立即斷線	確認使用者家目錄有 `.xsession` 並正確設定 GNOME

👉 Juiwen，你擅長做 模組化 troubleshooting guide，這裡的流程可以整理成一份 XRDP → GNOME 啟動檢查表，包含：

要不要我幫你設計一個 XRDP-GNOME 故障排除 quick-reference 表，讓團隊快速定位問題並套用解法？