rustdesk/doc.rustdesk.com
1
0
Fork 0
mirror of https://github.com/rustdesk/doc.rustdesk.com.git synced 2026-08-27 12:29:39 +00:00
Code Issues Packages Projects Releases Wiki Activity

remove opt-in Linux headless support

Browse Source 
Signed-off-by: fufesou <linlong1266@gmail.com>
This commit is contained in:
fufesou
2026-08-15 10:01:13 +08:00
parent d7de5fc3e9
commit e60ab07b37
45 changed files with 132 additions and 411 deletions
Download Patch File Download Diff File Expand all files Collapse all files
v3/src/content/post/zh-tw/rustdesk-connected-waiting-for-image.md
+4 -5
View File
@@ -14,7 +14,7 @@ faq:
- question: '為什麼 RustDesk 會顯示「已連線，等待影像中」？'
answer: '連線本身已經成功建立，但遠端主機並沒有產生可傳送的畫面。最常見的原因是沒有可供擷取的作用中顯示器——例如未接螢幕的無頭伺服器、已進入休眠或鎖定的螢幕，或是作業系統不允許 RustDesk 錄製的顯示器。只要修復擷取來源，畫面就會出現。'
- question: '在無頭電腦上，要如何修復 RustDesk 一直等待影像的問題？'
answer: '沒有接螢幕的主機沒有畫面緩衝區（framebuffer）可以擷取，因此 RustDesk 沒有任何內容可以傳送。你可以接上實體螢幕、插上便宜的 HDMI 模擬顯示器插頭讓 GPU 誤以為接了螢幕，或是在 Linux 上依照官方文件設定無頭環境（github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support）。喚醒螢幕或讓螢幕保持不休眠，就能解決大多數情況。'
answer: '沒有接螢幕的主機沒有畫面緩衝區（framebuffer）可以擷取，因此 RustDesk 沒有任何內容可以傳送。你可以接上實體螢幕，或插上便宜的 HDMI 模擬顯示器插頭，讓 GPU 誤以為接了螢幕。喚醒螢幕或讓螢幕保持不休眠，就能解決大多數情況。'
- question: '更改視訊編碼格式能修復黑畫面問題嗎？'
answer: '通常可以。在遠端連線工具列或設定中，你可以切換編碼格式——VP8、VP9、AV1，或是在硬體支援的情況下使用 H.264/H.265。如果遠端硬體無法編碼特定格式，畫面就會顯示空白或凍結，這時退回使用如 VP9 這類的軟體編碼格式，通常就能讓畫面恢復正常。'
- question: 'RustDesk 在某台電腦上能顯示畫面，換一台卻不行，這是為什麼？'
@@ -37,11 +37,10 @@ metadata:
目前回報最多的原因，是**無頭主機（headless machine）**——也就是沒有接螢幕、或螢幕處於休眠狀態下運作的伺服器、迷你主機或工作站。由於沒有作用中的顯示器，GPU 不會產生任何畫面緩衝區，因此 RustDesk 雖然連線成功，卻沒有任何內容可以傳送。這個狀況在 RustDesk 的問題追蹤系統中一再出現，包括[目標端螢幕關閉時出現黑畫面的回報](https://github.com/rustdesk/rustdesk/issues/9884)，以及長期存在的[「已連線，等待影像中」討論串](https://github.com/rustdesk/rustdesk/issues/222)。
有三種方式可以讓它有東西可以擷取：
有兩種方式可以讓它有東西可以擷取：
- **接上螢幕**，並確認螢幕已經開機且處於喚醒狀態。
- **使用 HDMI（或 DisplayPort）模擬顯示器插頭。** 這種價格低廉的轉接頭能讓 GPU 誤以為接了螢幕，進而持續產生畫面緩衝區供 RustDesk 擷取。這是無頭桌上型電腦與家用伺服器的標準解法。
- **在 Linux 上，依照官方文件設定無頭環境。** RustDesk 支援無頭 Linux 環境，但設定方式與一般桌面連線不同——詳見[無頭 Linux 支援 wiki](https://github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support)。
如果螢幕*確實*已經接上，那麼下一個可疑對象就是螢幕進入了休眠狀態。
@@ -49,7 +48,7 @@ metadata:
| 原因 | 現象 | 解決方法 |
| ------------------------- | ---------------------------------- | ------------------------------------------------------------------------------------------------ |
| 無頭主機／無顯示器 | 伺服器或迷你主機出現黑畫面 | 接上螢幕、加裝 HDMI 模擬插頭，或使用 Linux 無頭設定方式 |
| 無頭主機／無顯示器 | 伺服器或迷你主機出現黑畫面 | 接上螢幕或加裝 HDMI 模擬插頭 |
| 螢幕休眠／鎖定 | 先前正常，閒置後變黑畫面 | 喚醒螢幕；停用休眠／螢幕保護程式；macOS 可在系統設定中關閉螢幕休眠 |
| 缺少權限（macOS） | 連線成功，但畫面持續全黑 | 在隱私權與安全性中授予螢幕錄製權限；安裝可支援登入畫面的輔助程式 |
| 編碼格式不相容 | 畫面空白或凍結 | 切換編碼格式（VP8/VP9/AV1/H.264/H.265）；退回使用軟體編碼格式 |
@@ -83,7 +82,7 @@ RustDesk 可以用多種方式編碼串流，而預設編碼格式不見得適
### Linux 與 Wayland
在 Linux 上，**Wayland 的畫面擷取是透過 PipeWire 與 `xdg-desktop-portal` 進行的**：第一次使用時會跳出提示，要求你同意並選擇要擷取的顯示器——多數情況下系統會記住這項選擇，之後就不會再次提示——且必須在有作用中的登入工作階段內才能運作。這是 Wayland 的安全性設計，因此單靠這個機制無法涵蓋登入畫面（greeter）或真正的無頭主機——不過非互動式的 Wayland 擷取功能目前正在積極開發中（[PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)）。如果你在 Wayland 上看到空白畫面，通常只要接受 portal 的畫面分享提示，並確認 `xdg-desktop-portal` 與 PipeWire 已安裝且正在執行即可解決；若是無頭主機，請依照文件中的[無頭環境設定](https://github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support)進行。若發行版仍提供 X11/Xorg 工作階段，登入該工作階段也能繞過 portal 路徑——但由於愈來愈多發行版轉向僅支援 Wayland，修復 portal/PipeWire 路徑才是更長遠可靠的做法。
在 Linux 上，**Wayland 的畫面擷取是透過 PipeWire 與 `xdg-desktop-portal` 進行的**：第一次使用時會跳出提示，要求你同意並選擇要擷取的顯示器——多數情況下系統會記住這項選擇，之後就不會再次提示——且必須在有作用中的登入工作階段內才能運作。這是 Wayland 的安全性設計，因此單靠這個機制無法涵蓋登入畫面（greeter）——不過非互動式的 Wayland 擷取功能目前正在積極開發中（[PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)）。如果你在 Wayland 上看到空白畫面，通常只要接受 portal 的畫面分享提示，並確認 `xdg-desktop-portal` 與 PipeWire 已安裝且正在執行即可解決。若發行版仍提供 X11/Xorg 工作階段，登入該工作階段也能繞過 portal 路徑——但由於愈來愈多發行版轉向僅支援 Wayland，修復 portal/PipeWire 路徑才是更長遠可靠的做法。
### 網路與中繼伺服器