remove opt-in Linux headless support

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
@@ -553,21 +553,6 @@ Immer Software-Rendering verwenden.
| :------: | :------: | :------: | :------: | | :------: | :------: | :------: | :------: |
| N | Y, N | N | `allow-always-software-render=N` | | N | Y, N | N | `allow-always-software-render=N` |
### allow-linux-headless
Eingehende Verbindung zulassen, wenn keine Displays vorhanden sind.
Diese Option erfordert eine Desktop-Umgebung, Xorg-Server und GDM, siehe [PR 3902](https://github.com/rustdesk/rustdesk/pull/3902).
**Ort**:
1. **Desktop** Einstellungen → Allgemein → Sonstiges → Linux headless zulassen
2. **Mobil**
| Installation erforderlich | Werte | Standard | Beispiel |
| :------: | :------: | :------: | :------: |
| Y | Y, N | N | `allow-linux-headless=N` |
### enable-hwcodec ### enable-hwcodec
Hardware-Kodierung aktivieren, um das Bild flüssiger zu machen. Hardware-Kodierung aktivieren, um das Bild flüssiger zu machen.
@@ -563,21 +563,6 @@ Always use software rendering.
| :------: | :------: | :------: | :------: | | :------: | :------: | :------: | :------: |
| N | Y, N | N | `allow-always-software-render=N` | | N | Y, N | N | `allow-always-software-render=N` |
### allow-linux-headless
Allow incoming connection if there's no displays.
This option requires desktop environment, Xorg server and GDM, see [PR 3902](https://github.com/rustdesk/rustdesk/pull/3902).
**Location**:
1. **Desktop** Settings → General → Other → Allow Linux headless
2. **Mobile**
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
| Y | Y, N | N | `allow-linux-headless=N` |
### enable-hwcodec ### enable-hwcodec
Enable hardware encoding to make the picture smoother. Enable hardware encoding to make the picture smoother.
@@ -553,21 +553,6 @@ Siempre usar renderizado por software.
| :------: | :------: | :------: | :------: | | :------: | :------: | :------: | :------: |
| N | Y, N | N | `allow-always-software-render=N` | | N | Y, N | N | `allow-always-software-render=N` |
### allow-linux-headless
Permitir conexión entrante si no hay pantallas.
Esta opción requiere entorno de escritorio, servidor Xorg y GDM, ver [PR 3902](https://github.com/rustdesk/rustdesk/pull/3902).
**Ubicación**:
1. **Escritorio** Configuración → General → Otro → Permitir Linux headless
2. **Móvil**
| Instalación requerida | Valores | Predeterminado | Ejemplo |
| :------: | :------: | :------: | :------: |
| Y | Y, N | N | `allow-linux-headless=N` |
### enable-hwcodec ### enable-hwcodec
Habilita codificación por hardware para hacer la imagen más fluida. Habilita codificación por hardware para hacer la imagen más fluida.
@@ -553,21 +553,6 @@ Utilise toujours le rendu logiciel.
| :------: | :------: | :------: | :------: | | :------: | :------: | :------: | :------: |
| N | Y, N | N | `allow-always-software-render=N` | | N | Y, N | N | `allow-always-software-render=N` |
### allow-linux-headless
Autorise la connexion entrante s'il n'y a pas d'écrans.
Cette option nécessite un environnement de bureau, un serveur Xorg et GDM, voir [PR 3902](https://github.com/rustdesk/rustdesk/pull/3902).
**Emplacement** :
1. **Bureau** Paramètres → Général → Autre → Autoriser Linux headless
2. **Mobile**
| Installation requise | Valeurs | Défaut | Exemple |
| :------: | :------: | :------: | :------: |
| Y | Y, N | N | `allow-linux-headless=N` |
### enable-hwcodec ### enable-hwcodec
Active l'encodage matériel pour rendre l'image plus fluide. Active l'encodage matériel pour rendre l'image plus fluide.
@@ -553,21 +553,6 @@ Usa sempre il rendering software.
| :------: | :------: | :------: | :------: | | :------: | :------: | :------: | :------: |
| N | Y, N | N | `allow-always-software-render=N` | | N | Y, N | N | `allow-always-software-render=N` |
### allow-linux-headless
Consenti connessione in ingresso se non ci sono display.
Questa opzione richiede ambiente desktop, server Xorg e GDM, vedi [PR 3902](https://github.com/rustdesk/rustdesk/pull/3902).
**Posizione**:
1. **Desktop** Impostazioni → Generale → Altro → Consenti Linux headless
2. **Mobile**
| Installazione richiesta | Valori | Predefinito | Esempio |
| :------: | :------: | :------: | :------: |
| Y | Y, N | N | `allow-linux-headless=N` |
### enable-hwcodec ### enable-hwcodec
Abilita codifica hardware per rendere l'immagine più fluida. Abilita codifica hardware per rendere l'immagine più fluida.
@@ -553,21 +553,6 @@ ar, bg, ca, cs, da, de, el, en, eo, es, et, fa, fr, he, hr, hu, id, it, ja, ko,
| :------: | :------: | :------: | :------: | | :------: | :------: | :------: | :------: |
| N | Y, N | N | `allow-always-software-render=N` | | N | Y, N | N | `allow-always-software-render=N` |
### allow-linux-headless
ディスプレイがない場合の着信接続を許可します。
このオプションはデスクトップ環境、Xorgサーバー、GDMが必要です。[PR 3902](https://github.com/rustdesk/rustdesk/pull/3902)を参照してください。
**場所**
1. **デスクトップ** 設定 → 一般 → その他 → Linux headlessを許可
2. **モバイル**
| インストール必要 | 値 | デフォルト | 例 |
| :------: | :------: | :------: | :------: |
| Y | Y, N | N | `allow-linux-headless=N` |
### enable-hwcodec ### enable-hwcodec
画像をより滑らかにするためにハードウェアエンコーディングを有効にします。 画像をより滑らかにするためにハードウェアエンコーディングを有効にします。
@@ -562,21 +562,6 @@ ar, bg, ca, cs, da, de, el, en, eo, es, et, fa, fr, he, hr, hu, id, it, ja, ko,
| :------: | :------: | :------: | :------: | | :------: | :------: | :------: | :------: |
| N | Y, N | N | `allow-always-software-render=N` | | N | Y, N | N | `allow-always-software-render=N` |
### allow-linux-headless
디스플레이 없음일 경우 수신 연결을 허용합니다.
이 옵션은 데스크톱 환경, Xorg 서버 및 GDM을 필요로 하며, [PR 3902](https://github.com/rustdesk/rustdesk/pull/3902)를 참조하십시오.
**위치**:
1. **데스크톱** 설정 → 일반 → 기타 → Linux headless 허용
2. **모바일**
| 설치 필요 | 값 | 기본값 | 예시 |
| :------: | :------: | :------: | :------: |
| Y | Y, N | N | `allow-linux-headless=N` |
### enable-hwcodec ### enable-hwcodec
하드웨어 인코딩을 활성화하여 그림을 더 부드럽게 만듭니다. 하드웨어 인코딩을 활성화하여 그림을 더 부드럽게 만듭니다.
@@ -554,21 +554,6 @@ Zawsze używaj renderowania programowego.
| :------: | :------: | :------: | :------: | | :------: | :------: | :------: | :------: |
| N | Y, N | N | `allow-always-software-render=N` | | N | Y, N | N | `allow-always-software-render=N` |
### allow-linux-headless
Zezwól na połączenia przychodzące, jeśli nie ma wyświetlaczy.
Ta opcja wymaga środowiska graficznego, serwera Xorg i GDM, zobacz [PR 3902](https://github.com/rustdesk/rustdesk/pull/3902).
**Lokalizacja**:
1. **K. stacjonarny** Ustawienia → Ogólne → Inne → Zezwól na obsługę Linuxa bez monitora
2. **Smartfon**
| Wymagana instalacja | Wartości | Domyślne | Przykład |
| :------: | :------: | :------: | :------: |
| Y | Y, N | N | `allow-linux-headless=N` |
### enable-hwcodec ### enable-hwcodec
Włącz kodowanie sprzętowe, aby obraz był płynniejszy. Włącz kodowanie sprzętowe, aby obraz był płynniejszy.
@@ -553,21 +553,6 @@ Sempre usar renderização por software.
| :------: | :------: | :------: | :------: | | :------: | :------: | :------: | :------: |
| N | Y, N | N | `allow-always-software-render=N` | | N | Y, N | N | `allow-always-software-render=N` |
### allow-linux-headless
Permitir conexão de entrada se não houver displays.
Esta opção requer ambiente desktop, servidor Xorg e GDM, veja [PR 3902](https://github.com/rustdesk/rustdesk/pull/3902).
**Localização**:
1. **Desktop** Configurações → Geral → Outro → Permitir Linux headless
2. **Móvel**
| Instalação necessária | Valores | Padrão | Exemplo |
| :------: | :------: | :------: | :------: |
| Y | Y, N | N | `allow-linux-headless=N` |
### enable-hwcodec ### enable-hwcodec
Habilita codificação por hardware para tornar a imagem mais suave. Habilita codificação por hardware para tornar a imagem mais suave.
@@ -554,21 +554,6 @@ Folosește întotdeauna rendering software.
| :------: | :------: | :------: | :------: | | :------: | :------: | :------: | :------: |
| N | Y, N | N | `allow-always-software-render=N` | | N | Y, N | N | `allow-always-software-render=N` |
### allow-linux-headless
Permite conexiuni primite dacă nu există display-uri (headless).
Această opțiune necesită mediu desktop, server Xorg și GDM, vezi [PR 3902](https://github.com/rustdesk/rustdesk/pull/3902).
**Locație**:
1. **Desktop** Settings → General → Other → Allow Linux headless
2. **Mobile**
| Install required | Values | Default | Example |
| :------: | :------: | :------: | :------: |
| Y | Y, N | N | `allow-linux-headless=N` |
### enable-hwcodec ### enable-hwcodec
Activează encodarea hardware pentru a face imaginea mai fluidă. Activează encodarea hardware pentru a face imaginea mai fluidă.
@@ -554,21 +554,6 @@ ar, bg, ca, cs, da, de, el, en, eo, es, et, fa, fr, he, hr, hu, id, it, ja, ko,
| :------: | :------: | :------: | :------: | | :------: | :------: | :------: | :------: |
| 否 | Y, N | N | `allow-always-software-render=N` | | 否 | Y, N | N | `allow-always-software-render=N` |
### allow-linux-headless
如果没有显示器,允许传入连接。
此选项需要桌面环境、Xorg服务器和GDM,请参阅[PR 3902](https://github.com/rustdesk/rustdesk/pull/3902)。
**位置**
1. **桌面** 设置 → 常规 → 其他 → 允许Linux无头模式
2. **移动端**
| 安装需要 | 值 | 默认值 | 示例 |
| :------: | :------: | :------: | :------: |
| 是 | Y, N | N | `allow-linux-headless=N` |
### enable-hwcodec ### enable-hwcodec
启用硬件编码以使画面更流畅。 启用硬件编码以使画面更流畅。
@@ -554,21 +554,6 @@ ar, bg, ca, cs, da, de, el, en, eo, es, et, fa, fr, he, hr, hu, id, it, ja, ko,
| :------: | :------: | :------: | :------: | | :------: | :------: | :------: | :------: |
| 否 | Y, N | N | `allow-always-software-render=N` | | 否 | Y, N | N | `allow-always-software-render=N` |
### allow-linux-headless
如果沒有顯示器,允許傳入連接。
此選項需要桌面環境、Xorg伺服器和GDM,請參閱[PR 3902](https://github.com/rustdesk/rustdesk/pull/3902)。
**位置**
1. **桌面** 設定 → 一般 → 其他 → 允許Linux無頭模式
2. **行動裝置**
| 安裝需要 | 值 | 預設值 | 範例 |
| :------: | :------: | :------: | :------: |
| 是 | Y, N | N | `allow-linux-headless=N` |
### enable-hwcodec ### enable-hwcodec
啟用硬體編碼以使畫面更流暢。 啟用硬體編碼以使畫面更流暢。
@@ -14,7 +14,7 @@ faq:
- question: 'لماذا تظهر رسالة «متصل، في انتظار الصورة» في RustDesk؟' - question: 'لماذا تظهر رسالة «متصل، في انتظار الصورة» في RustDesk؟'
answer: 'تم إنشاء الجلسة بنجاح، لكن الجهاز البعيد لا يُنتج صورة للشاشة لإرسالها. السبب الأكثر شيوعًا هو عدم وجود شاشة عرض نشطة يمكن التقاطها – كأن يكون الجهاز خادمًا بلا شاشة (headless) متصلة، أو تكون الشاشة قد دخلت في وضع السكون أو القفل، أو لا يسمح نظام التشغيل لـ RustDesk بتسجيل الشاشة. بمجرد إصلاح مصدر الالتقاط، تظهر الصورة.' answer: 'تم إنشاء الجلسة بنجاح، لكن الجهاز البعيد لا يُنتج صورة للشاشة لإرسالها. السبب الأكثر شيوعًا هو عدم وجود شاشة عرض نشطة يمكن التقاطها – كأن يكون الجهاز خادمًا بلا شاشة (headless) متصلة، أو تكون الشاشة قد دخلت في وضع السكون أو القفل، أو لا يسمح نظام التشغيل لـ RustDesk بتسجيل الشاشة. بمجرد إصلاح مصدر الالتقاط، تظهر الصورة.'
- question: 'كيف أُصلح مشكلة «انتظار الصورة» في RustDesk على جهاز بلا شاشة (headless)؟' - question: 'كيف أُصلح مشكلة «انتظار الصورة» في RustDesk على جهاز بلا شاشة (headless)؟'
answer: 'الجهاز الذي لا توجد به شاشة متصلة لا يملك إطار عرض (framebuffer) يمكن التقاطه، لذا لا يكون لدى RustDesk ما يرسله. وصّل شاشة حقيقية، أو استخدم وصلة HDMI وهمية (dummy plug) رخيصة تجعل بطاقة الرسومات (GPU) تعتقد أن هناك شاشة متصلة، أو استخدم على أنظمة Linux الإعداد الموثّق للتشغيل بلا شاشة (github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support). إيقاظ الشاشة أو إبقاؤها مستيقظة يحل معظم الحالات.' answer: 'الجهاز الذي لا توجد به شاشة متصلة لا يملك إطار عرض (framebuffer) يمكن التقاطه، لذا لا يكون لدى RustDesk ما يرسله. وصّل شاشة حقيقية، أو استخدم وصلة HDMI وهمية (dummy plug) رخيصة تجعل بطاقة الرسومات (GPU) تعتقد أن هناك شاشة متصلة. إيقاظ الشاشة أو إبقاؤها مستيقظة يحل معظم الحالات.'
- question: 'هل يؤدي تغيير برنامج ترميز الفيديو (codec) إلى حل مشكلة الشاشة السوداء؟' - question: 'هل يؤدي تغيير برنامج ترميز الفيديو (codec) إلى حل مشكلة الشاشة السوداء؟'
answer: 'غالبًا، نعم. يمكنك من شريط أدوات الجلسة البعيدة أو من الإعدادات تبديل برنامج الترميز – VP8 أو VP9 أو AV1 أو H.264/H.265 حيثما يدعمها العتاد. فبرنامج الترميز الذي لا يستطيع عتاد الجهاز البعيد ترميزه يُظهر صورة فارغة أو متجمدة، والعودة إلى برنامج ترميز برمجي مثل VP9 يعيد الصورة عادةً.' answer: 'غالبًا، نعم. يمكنك من شريط أدوات الجلسة البعيدة أو من الإعدادات تبديل برنامج الترميز – VP8 أو VP9 أو AV1 أو H.264/H.265 حيثما يدعمها العتاد. فبرنامج الترميز الذي لا يستطيع عتاد الجهاز البعيد ترميزه يُظهر صورة فارغة أو متجمدة، والعودة إلى برنامج ترميز برمجي مثل VP9 يعيد الصورة عادةً.'
- question: 'تظهر الصورة في RustDesk على جهاز كمبيوتر ولا تظهر على آخر. ما السبب؟' - question: 'تظهر الصورة في RustDesk على جهاز كمبيوتر ولا تظهر على آخر. ما السبب؟'
@@ -37,11 +37,10 @@ metadata:
السبب الأكثر ورودًا في التقارير على الإطلاق هو **جهاز بلا شاشة (headless)** – خادم أو حاسوب مصغّر (mini-PC) أو محطة عمل تعمل بلا شاشة متصلة، أو بشاشة في وضع السكون. فمع غياب شاشة عرض نشطة، لا تُنتج بطاقة الرسومات (GPU) أي إطار عرض (framebuffer)، فيتصل RustDesk لكن لا يكون لديه ما يرسله. يتكرر هذا النمط مرارًا في متتبع المشكلات (issue tracker) الخاص بـ RustDesk، بما في ذلك [تقارير عن شاشات سوداء تحديدًا عندما تكون شاشة الجهاز الهدف مطفأة](https://github.com/rustdesk/rustdesk/issues/9884) و[سلسلة النقاش الطويلة حول «متصل، في انتظار الصورة»](https://github.com/rustdesk/rustdesk/issues/222). السبب الأكثر ورودًا في التقارير على الإطلاق هو **جهاز بلا شاشة (headless)** – خادم أو حاسوب مصغّر (mini-PC) أو محطة عمل تعمل بلا شاشة متصلة، أو بشاشة في وضع السكون. فمع غياب شاشة عرض نشطة، لا تُنتج بطاقة الرسومات (GPU) أي إطار عرض (framebuffer)، فيتصل RustDesk لكن لا يكون لديه ما يرسله. يتكرر هذا النمط مرارًا في متتبع المشكلات (issue tracker) الخاص بـ RustDesk، بما في ذلك [تقارير عن شاشات سوداء تحديدًا عندما تكون شاشة الجهاز الهدف مطفأة](https://github.com/rustdesk/rustdesk/issues/9884) و[سلسلة النقاش الطويلة حول «متصل، في انتظار الصورة»](https://github.com/rustdesk/rustdesk/issues/222).
توجد ثلاث طرق لتزويده بما يمكن التقاطه: توجد طريقتان لتزويده بما يمكن التقاطه:
- **وصّل شاشة** وتأكد من أنها مُشغَّلة ومستيقظة. - **وصّل شاشة** وتأكد من أنها مُشغَّلة ومستيقظة.
- **استخدم وصلة HDMI وهمية (أو DisplayPort).** هذه المهايئات الرخيصة تجعل بطاقة الرسومات تعتقد أن هناك شاشة متصلة، فتستمر في إنتاج إطار عرض يلتقطه RustDesk. وهذا هو الحل القياسي لأجهزة سطح المكتب والخوادم المنزلية التي تعمل بلا شاشة. - **استخدم وصلة HDMI وهمية (أو DisplayPort).** هذه المهايئات الرخيصة تجعل بطاقة الرسومات تعتقد أن هناك شاشة متصلة، فتستمر في إنتاج إطار عرض يلتقطه RustDesk. وهذا هو الحل القياسي لأجهزة سطح المكتب والخوادم المنزلية التي تعمل بلا شاشة.
- **على أنظمة Linux، اتّبع المسار الموثّق للتشغيل بلا شاشة.** يدعم RustDesk إعدادات Linux التي تعمل بلا شاشة، لكن الإعداد يختلف عن جلسة سطح مكتب عادية – راجع [صفحة ويكي دعم Linux بلا شاشة](https://github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support).
وإذا كانت هناك شاشة متصلة _بالفعل_، فالمشتبه به التالي هو أنها دخلت في وضع السكون. وإذا كانت هناك شاشة متصلة _بالفعل_، فالمشتبه به التالي هو أنها دخلت في وضع السكون.
@@ -49,7 +48,7 @@ metadata:
| السبب | المؤشر | الحل | | السبب | المؤشر | الحل |
| ---------------------------------- | -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | | ---------------------------------- | -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| بلا شاشة (headless) / لا توجد شاشة | شاشة سوداء على خادم أو حاسوب مصغّر | وصّل شاشة، أو أضف وصلة HDMI وهمية، أو استخدم مسار Linux بلا شاشة | | بلا شاشة (headless) / لا توجد شاشة | شاشة سوداء على خادم أو حاسوب مصغّر | وصّل شاشة، أو أضف وصلة HDMI وهمية |
| الشاشة في وضع السكون / القفل | كانت تعمل سابقًا، ثم اسودّت بعد فترة خمول | أيقظ الشاشة؛ عطّل وضع السكون/شاشة التوقف؛ وعلى macOS أوقف سكون الشاشة من الإعدادات | | الشاشة في وضع السكون / القفل | كانت تعمل سابقًا، ثم اسودّت بعد فترة خمول | أيقظ الشاشة؛ عطّل وضع السكون/شاشة التوقف؛ وعلى macOS أوقف سكون الشاشة من الإعدادات |
| صلاحية مفقودة (macOS) | يتصل لكن الشاشة سوداء دائمًا | امنح صلاحية «تسجيل الشاشة» في الخصوصية والأمان؛ ثبّت المساعد الخاص بشاشة تسجيل الدخول | | صلاحية مفقودة (macOS) | يتصل لكن الشاشة سوداء دائمًا | امنح صلاحية «تسجيل الشاشة» في الخصوصية والأمان؛ ثبّت المساعد الخاص بشاشة تسجيل الدخول |
| عدم توافق برنامج الترميز | صورة فارغة أو متجمدة | بدّل برنامج الترميز (VP8 / VP9 / AV1 / H.264 / H.265)؛ ارجع إلى برنامج ترميز برمجي | | عدم توافق برنامج الترميز | صورة فارغة أو متجمدة | بدّل برنامج الترميز (VP8 / VP9 / AV1 / H.264 / H.265)؛ ارجع إلى برنامج ترميز برمجي |
@@ -83,7 +82,7 @@ metadata:
### Linux وWayland ### Linux وWayland
على أنظمة Linux، **يمر التقاط الشاشة عبر Wayland بواسطة PipeWire وبوابة `xdg-desktop-portal`**: إذ تطلب هذه البوابة موافقتك لاختيار شاشة العرض في المرة الأولى – وفي معظم الحالات يُحفظ اختيارك فلا تُطلب الموافقة مجددًا – وتعمل ضمن جلسة تسجيل دخول نشطة. وهذا تصميم أمني خاص بـ Wayland، لذلك فهو لا يغطي بمفرده شاشة الترحيب (greeter) أو جهازًا بلا شاشة فعليًا – وإن كان العمل على التقاط Wayland دون إشراف قيد التطوير النشط ([طلب الدمج رقم 15420](https://github.com/rustdesk/rustdesk/pull/15420)). إذا واجهت شاشة فارغة على Wayland، فالحل عادةً هو قبول رسالة مشاركة الشاشة من البوابة، والتأكد من تثبيت وتشغيل `xdg-desktop-portal` وPipeWire؛ وعلى جهاز بلا شاشة، استخدم [إعداد التشغيل بلا شاشة](https://github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support) الموثّق. كما أن تسجيل الدخول إلى جلسة X11/Xorg يتجنب مسار البوابة أيضًا حيثما لا تزال التوزيعة توفر هذا الخيار – لكن مع تحوّل كثير من التوزيعات إلى الاعتماد على Wayland حصرًا، يصبح إصلاح مسار البوابة/PipeWire هو النهج الأكثر ثباتًا على المدى الطويل. على أنظمة Linux، **يمر التقاط الشاشة عبر Wayland بواسطة PipeWire وبوابة `xdg-desktop-portal`**: إذ تطلب هذه البوابة موافقتك لاختيار شاشة العرض في المرة الأولى – وفي معظم الحالات يُحفظ اختيارك فلا تُطلب الموافقة مجددًا – وتعمل ضمن جلسة تسجيل دخول نشطة. وهذا تصميم أمني خاص بـ Wayland، لذلك فهو لا يغطي بمفرده شاشة الترحيب (greeter) – وإن كان العمل على التقاط Wayland دون إشراف قيد التطوير النشط ([طلب الدمج رقم 15420](https://github.com/rustdesk/rustdesk/pull/15420)). إذا واجهت شاشة فارغة على Wayland، فالحل عادةً هو قبول رسالة مشاركة الشاشة من البوابة، والتأكد من تثبيت وتشغيل `xdg-desktop-portal` وPipeWire. كما أن تسجيل الدخول إلى جلسة X11/Xorg يتجنب مسار البوابة أيضًا حيثما لا تزال التوزيعة توفر هذا الخيار – لكن مع تحوّل كثير من التوزيعات إلى الاعتماد على Wayland حصرًا، يصبح إصلاح مسار البوابة/PipeWire هو النهج الأكثر ثباتًا على المدى الطويل.
### الشبكة وخادم التحويل ### الشبكة وخادم التحويل
+6 -14
View File
@@ -4,7 +4,7 @@ lang: 'ar'
translationKey: 'rustdesk-for-linux' translationKey: 'rustdesk-for-linux'
draft: false draft: false
title: 'RustDesk لنظام Linux: سطح المكتب البعيد مفتوح المصدر' title: 'RustDesk لنظام Linux: سطح المكتب البعيد مفتوح المصدر'
excerpt: 'ثبّت RustDesk وشغّله على Linux: حزم .deb و.rpm وFlatpak وAppImage، الفرق بين X11 وWayland، الوصول بلا رأس (headless) والوصول غير المراقَب، واستضافة الخادم ذاتيًا.' excerpt: 'ثبّت RustDesk وشغّله على Linux: حزم .deb و.rpm وFlatpak وAppImage، الفرق بين X11 وWayland، الوصول غير المراقَب، واستضافة الخادم ذاتيًا.'
image: '~/assets/images/blog/rustdesk-for-linux-og.webp' image: '~/assets/images/blog/rustdesk-for-linux-og.webp'
category: 'أدلة' category: 'أدلة'
tags: ['RustDesk', 'Linux', 'الاستضافة الذاتية'] tags: ['RustDesk', 'Linux', 'الاستضافة الذاتية']
@@ -12,21 +12,19 @@ author: 'RustDesk Team'
slug: 'rustdesk-for-linux-ar' slug: 'rustdesk-for-linux-ar'
faq: faq:
- question: 'هل يعمل RustDesk على Wayland؟' - question: 'هل يعمل RustDesk على Wayland؟'
answer: 'نعم — يتمتع RustDesk بواحد من أقوى مستويات دعم Wayland بين جميع أدوات سطح المكتب البعيد، بما في ذلك مشاركة الشاشات المتعددة التي أُضيفت في الإصدار 1.4.3. على Wayland، يلتقط RustDesk الشاشة عبر PipeWire وبوابة سطح المكتب XDG، والتي تعرض مربع حوار للموافقة يطلب منك اختيار الشاشة المطلوبة — وفي معظم الحالات يُحفظ الاختيار فلا يُطلب منك تكراره — ويعمل الالتقاط ضمن الجلسة الرسومية النشطة المسجَّل الدخول إليها. خطوة الموافقة هذه هي جزء من تصميم Wayland الأمني، تشترك فيها كل تطبيقات مشاركة الشاشة وليس RustDesk وحده. أما بالنسبة إلى الأجهزة التي تحتاج إلى وصول قبل تسجيل الدخول أو وصول غير مراقَب بالكامل، فاستخدم حاليًا إعداد الشاشة الافتراضية بلا رأس (أو جلسة X11 إن كانت التوزيعة لا تزال توفرها، إذ إن عدة توزيعات تتجه إلى الاعتماد على Wayland حصرًا)؛ أما الالتقاط الكامل غير المراقَب على Wayland فهو قيد التطوير النشط (راجع github.com/rustdesk/rustdesk/pull/15420).' answer: 'نعم — يتمتع RustDesk بواحد من أقوى مستويات دعم Wayland بين جميع أدوات سطح المكتب البعيد، بما في ذلك مشاركة الشاشات المتعددة التي أُضيفت في الإصدار 1.4.3. على Wayland، يلتقط RustDesk الشاشة عبر PipeWire وبوابة سطح المكتب XDG، والتي تعرض مربع حوار للموافقة يطلب منك اختيار الشاشة المطلوبة — وفي معظم الحالات يُحفظ الاختيار فلا يُطلب منك تكراره — ويعمل الالتقاط ضمن الجلسة الرسومية النشطة المسجَّل الدخول إليها. خطوة الموافقة هذه هي جزء من تصميم Wayland الأمني، تشترك فيها كل تطبيقات مشاركة الشاشة وليس RustDesk وحده. أما بالنسبة إلى الأجهزة التي تحتاج إلى وصول قبل تسجيل الدخول أو وصول غير مراقَب بالكامل، فاستخدم حاليًا جلسة X11 إن كانت التوزيعة لا تزال توفرها، إذ إن عدة توزيعات تتجه إلى الاعتماد على Wayland حصرًا؛ أما الالتقاط الكامل غير المراقَب على Wayland فهو قيد التطوير النشط (راجع github.com/rustdesk/rustdesk/pull/15420).'
- question: 'ما الحزمة التي يجب تثبيتها على Linux؟' - question: 'ما الحزمة التي يجب تثبيتها على Linux؟'
answer: 'استخدم حزمة .deb على Debian وUbuntu وLinux Mint، وحزمة .rpm على Fedora وRHEL وopenSUSE، أو Flatpak من Flathub للحصول على نسخة معزولة (sandboxed) وواسعة التوافق، أو ملف AppImage المحمول كخيار احتياطي بملف واحد. تقوم حزمتا .deb و.rpm بتسجيل خدمة systemd وتشغيلها تلقائيًا بحيث يستمر عمل RustDesk بعد إعادة التشغيل؛ أما Flatpak وAppImage فلا يفعلان ذلك افتراضيًا.' answer: 'استخدم حزمة .deb على Debian وUbuntu وLinux Mint، وحزمة .rpm على Fedora وRHEL وopenSUSE، أو Flatpak من Flathub للحصول على نسخة معزولة (sandboxed) وواسعة التوافق، أو ملف AppImage المحمول كخيار احتياطي بملف واحد. تقوم حزمتا .deb و.rpm بتسجيل خدمة systemd وتشغيلها تلقائيًا بحيث يستمر عمل RustDesk بعد إعادة التشغيل؛ أما Flatpak وAppImage فلا يفعلان ذلك افتراضيًا.'
- question: 'لماذا يظهر جهاز Linux بلا رأس (headless) الخاص بي شاشة سوداء؟'
answer: 'عندما لا تكون هناك أي شاشة متصلة بالجهاز، لا يقوم X ولا Wayland بتخصيص ذاكرة إطار (framebuffer)، وبالتالي لا يكون هناك ما يلتقطه RustDesk، فتظهر لدى الطرف المشاهِد شاشة سوداء أو شاشة بانتظار الصورة. وصّل قابسًا وهميًا من نوع HDMI أو DisplayPort، أو اضبط شاشة افتراضية باستخدام برنامج مثل xserver-xorg-video-dummy أو VKMS، أو فعّل وضع RustDesk الاختياري للعمل بلا رأس على Linux ليُنشأ لك شاشة افتراضية تلقائيًا.'
- question: 'هل يمكنني استضافة خادم RustDesk ذاتيًا على Linux؟' - question: 'هل يمكنني استضافة خادم RustDesk ذاتيًا على Linux؟'
answer: 'نعم. خادم RustDesk (عمليتا hbbs لتعريف الهوية والربط (ID/rendezvous) وhbbr للترحيل (relay)) مصمم لنظام Linux، وهو الأسلوب المعتاد لتشغيله. يعمل خادم المجتمع المجاني ومفتوح المصدر إلى أجل غير مسمى دون أي تكلفة، بينما تضيف نسخة Server Pro وحدة تحكم ويب، ومجموعات أجهزة، ومولّد عميل مخصص العلامة التجارية. ويمكن تثبيت كلتا النسختين على جهاز افتراضي (VM) عادي يعمل بنظام Linux أو على خادم فعلي (bare-metal).' answer: 'نعم. خادم RustDesk (عمليتا hbbs لتعريف الهوية والربط (ID/rendezvous) وhbbr للترحيل (relay)) مصمم لنظام Linux، وهو الأسلوب المعتاد لتشغيله. يعمل خادم المجتمع المجاني ومفتوح المصدر إلى أجل غير مسمى دون أي تكلفة، بينما تضيف نسخة Server Pro وحدة تحكم ويب، ومجموعات أجهزة، ومولّد عميل مخصص العلامة التجارية. ويمكن تثبيت كلتا النسختين على جهاز افتراضي (VM) عادي يعمل بنظام Linux أو على خادم فعلي (bare-metal).'
metadata: metadata:
description: 'RustDesk على Linux من الألف إلى الياء: اختيار الحزمة المناسبة لكل توزيعة ولوحات ARM، التقاط الشاشة عبر Wayland وX11، إعداد الوضع بلا رأس، وتشغيل خادمك الخاص.' description: 'RustDesk على Linux من الألف إلى الياء: اختيار الحزمة المناسبة لكل توزيعة ولوحات ARM، التقاط الشاشة عبر Wayland وX11، وتشغيل خادمك الخاص.'
keywords: 'RustDesk لنظام Linux، RustDesk أوبونتو، RustDesk وWayland، RustDesk وX11، تثبيت RustDesk على Linux' keywords: 'RustDesk لنظام Linux، RustDesk أوبونتو، RustDesk وWayland، RustDesk وX11، تثبيت RustDesk على Linux'
--- ---
لم يحظَ مستخدمو Linux يومًا بخيارات وفيرة من أدوات سطح المكتب البعيد الجيدة، فالأدوات المتاحة غالبًا ما تكون إما منتجات تجارية مغلقة المصدر أو حزم VNC قديمة الطراز. أما RustDesk فيحتل موقعًا مختلفًا: فهو برنامج سطح مكتب بعيد مفتوح المصدر مرخّص بموجب AGPL، يعمل بشكل أصلي على جميع التوزيعات الرئيسية، ويمكنك توجيهه للعمل مع خادم تستضيفه بنفسك. هذا المزيج — كود قابل للتدقيق، وعميل Linux أصلي، وبنية تحتية قابلة للاستضافة الذاتية — هو ما جعل RustDesk أحد أبرز الإجابات التي يلجأ إليها من يبحث عن سطح مكتب بعيد مفتوح المصدر لنظام Linux. لم يحظَ مستخدمو Linux يومًا بخيارات وفيرة من أدوات سطح المكتب البعيد الجيدة، فالأدوات المتاحة غالبًا ما تكون إما منتجات تجارية مغلقة المصدر أو حزم VNC قديمة الطراز. أما RustDesk فيحتل موقعًا مختلفًا: فهو برنامج سطح مكتب بعيد مفتوح المصدر مرخّص بموجب AGPL، يعمل بشكل أصلي على جميع التوزيعات الرئيسية، ويمكنك توجيهه للعمل مع خادم تستضيفه بنفسك. هذا المزيج — كود قابل للتدقيق، وعميل Linux أصلي، وبنية تحتية قابلة للاستضافة الذاتية — هو ما جعل RustDesk أحد أبرز الإجابات التي يلجأ إليها من يبحث عن سطح مكتب بعيد مفتوح المصدر لنظام Linux.
يتناول هذا الدليل طريقة تثبيت RustDesk، والنقطة الوحيدة التي تُربك الجميع عادة (الفرق بين X11 وWayland)، وكيفية تفعيل الوصول غير المراقَب والوصول بلا رأس، وموقع الخادم من هذه الصورة. يتناول هذا الدليل طريقة تثبيت RustDesk، والنقطة الوحيدة التي تُربك الجميع عادة (الفرق بين X11 وWayland)، وكيفية تفعيل الوصول غير المراقَب، وموقع الخادم من هذه الصورة.
## تثبيت RustDesk على Linux ## تثبيت RustDesk على Linux
@@ -53,7 +51,7 @@ metadata:
**Wayland: يمكن القول إن RustDesk يمتلك أقوى دعم لـ Wayland بين جميع أدوات سطح المكتب البعيد.** يدعم RustDesk بروتوكول Wayland منذ الإصدار 1.2.0، وما زال يوسّع هذا الدعم باستمرار. ولأن مُركِّبات (compositors) Wayland لا تسمح بالوصول المباشر إلى ذاكرة الإطار، يلتقط RustDesk الشاشة عبر خدمة `xdg-desktop-portal` ومكتبة [PipeWire](https://deepwiki.com/rustdesk/rustdesk/6.3.1-wayland-support)، ويحقن الإدخال عبر وحدة نواة النظام `uinput`. وينتج عن تصميم Wayland نفسه أمران يسريان على كل أدوات مشاركة الشاشة على Wayland، وليس RustDesk فقط: **Wayland: يمكن القول إن RustDesk يمتلك أقوى دعم لـ Wayland بين جميع أدوات سطح المكتب البعيد.** يدعم RustDesk بروتوكول Wayland منذ الإصدار 1.2.0، وما زال يوسّع هذا الدعم باستمرار. ولأن مُركِّبات (compositors) Wayland لا تسمح بالوصول المباشر إلى ذاكرة الإطار، يلتقط RustDesk الشاشة عبر خدمة `xdg-desktop-portal` ومكتبة [PipeWire](https://deepwiki.com/rustdesk/rustdesk/6.3.1-wayland-support)، ويحقن الإدخال عبر وحدة نواة النظام `uinput`. وينتج عن تصميم Wayland نفسه أمران يسريان على كل أدوات مشاركة الشاشة على Wayland، وليس RustDesk فقط:
- **موافقة عند كل اتصال.** تعرض البوابة (portal) مربع حوار يطلب منك اختيار الشاشة المراد مشاركتها. هذه ميزة أمنية مقصودة في تصميم Wayland، وليست خللًا في RustDesk — فلا يمكن لتطبيق يعمل في الخلفية أن يبدأ تسجيل شاشتك خلسةً. تدعم الإصدارات 4 وما بعدها من البوابة ما يُعرف بـ"رمز الاستعادة" (restore token) بحيث لا يُطلب منك التأكيد في كل مرة، لكن أول عملية مشاركة تتطلب نقرة على الشاشة. - **موافقة عند كل اتصال.** تعرض البوابة (portal) مربع حوار يطلب منك اختيار الشاشة المراد مشاركتها. هذه ميزة أمنية مقصودة في تصميم Wayland، وليست خللًا في RustDesk — فلا يمكن لتطبيق يعمل في الخلفية أن يبدأ تسجيل شاشتك خلسةً. تدعم الإصدارات 4 وما بعدها من البوابة ما يُعرف بـ"رمز الاستعادة" (restore token) بحيث لا يُطلب منك التأكيد في كل مرة، لكن أول عملية مشاركة تتطلب نقرة على الشاشة.
- **الجلسة النشطة فقط.** الالتقاط على Wayland مرتبط بالجلسة الرسومية التي جرى تسجيل الدخول إليها. التقاط شاشة الترحيب (greeter) الخاصة بتسجيل الدخول على Wayland غير مدعوم حتى الآن — وهو قيد التطوير النشط ([طلب السحب رقم 15420](https://github.com/rustdesk/rustdesk/pull/15420)). للوصول قبل تسجيل الدخول حاليًا، استخدم إعداد الشاشة الافتراضية بلا رأس أدناه، أو جلسة X11 على التوزيعات التي لا تزال توفرها. - **الجلسة النشطة فقط.** الالتقاط على Wayland مرتبط بالجلسة الرسومية التي جرى تسجيل الدخول إليها. التقاط شاشة الترحيب (greeter) الخاصة بتسجيل الدخول على Wayland غير مدعوم حتى الآن — وهو قيد التطوير النشط ([طلب السحب رقم 15420](https://github.com/rustdesk/rustdesk/pull/15420)). للوصول قبل تسجيل الدخول حاليًا، استخدم جلسة X11 على التوزيعات التي لا تزال توفرها.
يستمر دعم Wayland في التحسّن — فعلى سبيل المثال، [أضاف الإصدار RustDesk 1.4.3](https://ubuntuhandbook.org/index.php/2025/10/rustdesk-released-1-4-3-with-multi-monitor-for-wayland-virtual-mouse/) (أكتوبر 2025) دعم مشاركة الشاشات المتعددة على Wayland. لكن إذا اتصلت وظهرت لك شاشة سوداء على جهاز يعمل بـ Wayland، فالسبب في الغالب هو عدم اكتمال مسار البوابة وPipeWire. مقالنا المخصص بعنوان [RustDesk متصل لكنه بانتظار الصورة](/ar/blog/rustdesk-connected-waiting-for-image-ar) يشرح تحديدًا حالة الشاشة السوداء على Wayland. يستمر دعم Wayland في التحسّن — فعلى سبيل المثال، [أضاف الإصدار RustDesk 1.4.3](https://ubuntuhandbook.org/index.php/2025/10/rustdesk-released-1-4-3-with-multi-monitor-for-wayland-virtual-mouse/) (أكتوبر 2025) دعم مشاركة الشاشات المتعددة على Wayland. لكن إذا اتصلت وظهرت لك شاشة سوداء على جهاز يعمل بـ Wayland، فالسبب في الغالب هو عدم اكتمال مسار البوابة وPipeWire. مقالنا المخصص بعنوان [RustDesk متصل لكنه بانتظار الصورة](/ar/blog/rustdesk-connected-waiting-for-image-ar) يشرح تحديدًا حالة الشاشة السوداء على Wayland.
@@ -63,21 +61,15 @@ metadata:
1. ثبّت RustDesk عبر حزمة `.deb` أو `.rpm` كي يُسجَّل خدمة systemd، أو انقر على **Enable Service** (تفعيل الخدمة) داخل التطبيق. 1. ثبّت RustDesk عبر حزمة `.deb` أو `.rpm` كي يُسجَّل خدمة systemd، أو انقر على **Enable Service** (تفعيل الخدمة) داخل التطبيق.
2. في RustDesk، عيّن **كلمة مرور دائمة** قوية ضمن إعدادات الاتصال (ويُفضَّل أيضًا تفعيل المصادقة الثنائية). 2. في RustDesk، عيّن **كلمة مرور دائمة** قوية ضمن إعدادات الاتصال (ويُفضَّل أيضًا تفعيل المصادقة الثنائية).
3. للوصول قبل تسجيل الدخول أو عبر جلسات مستخدمين متعددة، استخدم إعداد الشاشة الافتراضية بلا رأس أدناه (وتنطبق هنا الفجوة الخاصة بشاشة ترحيب Wayland المذكورة أعلاه).
من حقائق Wayland التي ينبغي التخطيط لها: نظام البوابة القائم على الموافقة، والمذكور في قسم Wayland أعلاه، يجعل الالتقاط غير المراقَب بالكامل أصعب مقارنةً بـ X11، إلى أن يصدر دعم الوصول غير المراقَب الجاري تطويره حاليًا. لذا خطّط لاستخدام إعداد الشاشة الافتراضية بلا رأس للأجهزة التي تُدار من دون تدخل بشري.
## Linux بلا رأس: الخوادم التي لا تملك شاشة ## Linux بلا رأس: الخوادم التي لا تملك شاشة
من الحالات الشائعة جدًا على Linux وجود جهاز لا تتصل به أي شاشة إطلاقًا — كخادم منزلي، أو جهاز مختبر، أو جهاز افتراضي (VM). والمشكلة هنا ليست في RustDesk، بل في مكدّس الرسومات (graphics stack): فمن دون شاشة موصولة، لا يقوم X ولا Wayland بتخصيص ذاكرة إطار على الإطلاق، وبالتالي لا توجد فعليًا أي صورة لالتقاطها، فتظهر لك شاشة سوداء. من الحالات الشائعة جدًا على Linux وجود جهاز لا تتصل به أي شاشة إطلاقًا — كخادم منزلي، أو جهاز مختبر، أو جهاز افتراضي (VM). والمشكلة هنا ليست في RustDesk، بل في مكدّس الرسومات (graphics stack): فمن دون شاشة موصولة، لا يقوم X ولا Wayland بتخصيص ذاكرة إطار على الإطلاق، وبالتالي لا توجد فعليًا أي صورة لالتقاطها، فتظهر لك شاشة سوداء.
توجد ثلاث طرق لمنحه شيئًا يمكن عرضه: توجد طريقتان لمنحه شيئًا يمكن عرضه:
- **قابس وهمي (dummy plug)** — جهاز HDMI/DisplayPort فعلي رخيص الثمن مخصص للتشغيل بلا رأس، يجعل بطاقة الرسومات (GPU) تعتقد أن هناك شاشة متصلة. - **قابس وهمي (dummy plug)** — جهاز HDMI/DisplayPort فعلي رخيص الثمن مخصص للتشغيل بلا رأس، يجعل بطاقة الرسومات (GPU) تعتقد أن هناك شاشة متصلة.
- **مشغّل شاشة افتراضية** — مثل `xserver-xorg-video-dummy` على X11، أو خيار على مستوى النواة (kernel) مثل VKMS. - **مشغّل شاشة افتراضية** — مثل `xserver-xorg-video-dummy` على X11، أو خيار على مستوى النواة (kernel) مثل VKMS.
- **وضع RustDesk الاختياري للعمل بلا رأس** — فعّله باستخدام الأمر `sudo rustdesk --option allow-linux-headless Y`. وبحسب [صفحة ويكي دعم Linux بلا رأس](https://github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support)، فإن هذا الوضع معطَّل افتراضيًا، وقد جرى اختباره بشكل أساسي على Ubuntu مع GNOME، ويتطلب حزمًا مثل `xserver-xorg-video-dummy` و`lightdm`. يمكنك جلب معرّف الجهاز (ID) باستخدام `sudo rustdesk --get-id`، وتعيين كلمة مرور باستخدام `sudo rustdesk --password <password>`.
لا يزال الوضع بلا رأس غير مكتمل الصقل في بعض التفاصيل، لذا تعامل معه على أنه يعمل، لكن بحذر، لا كحل جاهز بالكامل.
## استضافة خادم RustDesk ذاتيًا على Linux ## استضافة خادم RustDesk ذاتيًا على Linux
@@ -58,7 +58,7 @@ metadata:
| ------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | ------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| Windows | التثبيت، مع إبقاء الخدمة قيد التشغيل (تبدأ مع تشغيل الجهاز) | ينقطع الملف التنفيذي المحمول عند تسجيل الخروج/UAC؛ استخدم برنامج التثبيت | | Windows | التثبيت، مع إبقاء الخدمة قيد التشغيل (تبدأ مع تشغيل الجهاز) | ينقطع الملف التنفيذي المحمول عند تسجيل الخروج/UAC؛ استخدم برنامج التثبيت |
| macOS | التثبيت، وتعيين كلمة مرور دائمة، ومنح الأذونات | يجب منح إذنَي تسجيل الشاشة (Screen Recording) وإمكانية الوصول (Accessibility)؛ يتطلب الالتقاط عند شاشة تسجيل الدخول تثبيت البرنامج المساعد | | macOS | التثبيت، وتعيين كلمة مرور دائمة، ومنح الأذونات | يجب منح إذنَي تسجيل الشاشة (Screen Recording) وإمكانية الوصول (Accessibility)؛ يتطلب الالتقاط عند شاشة تسجيل الدخول تثبيت البرنامج المساعد |
| Linux | تثبيت حزمة الخدمة | يحتاج Wayland إلى جلسة نشطة؛ وللوصول قبل تسجيل الدخول استخدم إعداد الشاشة الافتراضية بلا واجهة، أو X11 حيث لا تزال إحدى التوزيعات توفره | | Linux | تثبيت حزمة الخدمة | يحتاج Wayland إلى جلسة نشطة؛ وللوصول قبل تسجيل الدخول استخدم X11 حيث لا تزال إحدى التوزيعات توفره |
| Android | تعيين كلمة مرور دائمة؛ وتفعيل الالتقاط | يجب أن تكون الشاشة نشطة (awake)؛ وامنح موافقة التقاط الشاشة (MediaProjection) وإذن الإدخال | | Android | تعيين كلمة مرور دائمة؛ وتفعيل الالتقاط | يجب أن تكون الشاشة نشطة (awake)؛ وامنح موافقة التقاط الشاشة (MediaProjection) وإذن الإدخال |
### Windows ### Windows
@@ -71,7 +71,7 @@ metadata:
### Linux ### Linux
ثبّت RustDesk بحيث يعمل مكوّن الخدمة فيه عند الإقلاع. وبالنسبة إلى جهاز يتوقف عند شاشة الترحيب لتسجيل الدخول، لا يستطيع Wayland حتى الآن التقاط شاشة الترحيب هذه — وهذا قيد في تصميم Wayland نفسه (وليس قيدًا في RustDesk) يعمل فريق RustDesk بنشاط على تجاوزه ([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). على جهاز بلا شاشة (headless)، استخدم إعداد الشاشة الافتراضية؛ أما على جهاز مكتبي، فلا تزال جلسة X11/Xorg تتولى الأمر حيثما توفرها إحدى التوزيعات، رغم أن عددًا منها يتجه إلى الاعتماد على Wayland حصرًا. راجع [RustDesk لنظام Linux](/ar/blog/rustdesk-for-linux-ar) لمزيد من التفاصيل. ثبّت RustDesk بحيث يعمل مكوّن الخدمة فيه عند الإقلاع. وبالنسبة إلى جهاز يتوقف عند شاشة الترحيب لتسجيل الدخول، لا يستطيع Wayland حتى الآن التقاط شاشة الترحيب هذه — وهذا قيد في تصميم Wayland نفسه (وليس قيدًا في RustDesk) يعمل فريق RustDesk بنشاط على تجاوزه ([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). على جهاز مكتبي، لا تزال جلسة X11/Xorg تتولى الأمر حيثما توفرها إحدى التوزيعات، رغم أن عددًا منها يتجه إلى الاعتماد على Wayland حصرًا. راجع [RustDesk لنظام Linux](/ar/blog/rustdesk-for-linux-ar) لمزيد من التفاصيل.
## الخطوة 3: النشر على نطاق واسع بعميل مُهيَّأ مسبقًا ## الخطوة 3: النشر على نطاق واسع بعميل مُهيَّأ مسبقًا
@@ -14,7 +14,7 @@ faq:
- question: 'Warum zeigt RustDesk „Connected, waiting for image" an?' - question: 'Warum zeigt RustDesk „Connected, waiting for image" an?'
answer: 'Die Sitzung wurde erfolgreich aufgebaut, aber der Remote-Rechner erzeugt kein Bildschirmbild, das gesendet werden könnte. Der häufigste Grund ist ein fehlendes aktives Display zum Erfassen etwa ein Headless-Server ohne Monitor, ein Bildschirm im Ruhezustand oder gesperrt, oder ein Display, das das Betriebssystem RustDesk nicht aufzeichnen lässt. Beheben Sie die Erfassungsquelle, und das Bild erscheint.' answer: 'Die Sitzung wurde erfolgreich aufgebaut, aber der Remote-Rechner erzeugt kein Bildschirmbild, das gesendet werden könnte. Der häufigste Grund ist ein fehlendes aktives Display zum Erfassen etwa ein Headless-Server ohne Monitor, ein Bildschirm im Ruhezustand oder gesperrt, oder ein Display, das das Betriebssystem RustDesk nicht aufzeichnen lässt. Beheben Sie die Erfassungsquelle, und das Bild erscheint.'
- question: 'Wie behebe ich „waiting for image" bei RustDesk auf einem Headless-Rechner?' - question: 'Wie behebe ich „waiting for image" bei RustDesk auf einem Headless-Rechner?'
answer: 'Ein Rechner ohne Monitor hat keinen Framebuffer, den man erfassen könnte, sodass RustDesk nichts zu senden hat. Schließen Sie einen echten Monitor an, stecken Sie einen günstigen HDMI-Dummy-Stecker ein, der die GPU glauben lässt, ein Display sei angeschlossen, oder nutzen Sie unter Linux das dokumentierte Headless-Setup (github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support). Das Aufwecken oder dauerhafte Wachhalten des Displays löst die meisten Fälle.' answer: 'Ein Rechner ohne Monitor hat keinen Framebuffer, den man erfassen könnte, sodass RustDesk nichts zu senden hat. Schließen Sie einen echten Monitor an oder stecken Sie einen günstigen HDMI-Dummy-Stecker ein, der die GPU glauben lässt, ein Display sei angeschlossen. Das Aufwecken oder dauerhafte Wachhalten des Displays löst die meisten Fälle.'
- question: 'Behebt ein Wechsel des Video-Codecs den schwarzen Bildschirm?' - question: 'Behebt ein Wechsel des Video-Codecs den schwarzen Bildschirm?'
answer: 'Oft ja. In der Symbolleiste der Remote-Sitzung oder in den Einstellungen können Sie den Codec wechseln VP8, VP9, AV1 oder, sofern die Hardware es unterstützt, H.264/H.265. Ein Codec, den die Remote-Hardware nicht kodieren kann, zeigt ein leeres oder eingefrorenes Bild, und ein Wechsel zurück zu einem Software-Codec wie VP9 stellt das Bild meist wieder her.' answer: 'Oft ja. In der Symbolleiste der Remote-Sitzung oder in den Einstellungen können Sie den Codec wechseln VP8, VP9, AV1 oder, sofern die Hardware es unterstützt, H.264/H.265. Ein Codec, den die Remote-Hardware nicht kodieren kann, zeigt ein leeres oder eingefrorenes Bild, und ein Wechsel zurück zu einem Software-Codec wie VP9 stellt das Bild meist wieder her.'
- question: 'RustDesk zeigt das Bild auf einem PC, auf einem anderen aber nicht. Woran liegt das?' - question: 'RustDesk zeigt das Bild auf einem PC, auf einem anderen aber nicht. Woran liegt das?'
@@ -37,11 +37,10 @@ Die Sitzung ist verbunden, aber es gibt keinen Framebuffer, den RustDesk erfasse
Mit Abstand die am häufigsten gemeldete Ursache ist ein **Headless-Rechner** etwa ein Server, Mini-PC oder eine Workstation , der ganz ohne angeschlossenen Monitor läuft oder dessen Display sich im Ruhezustand befindet. Ohne aktives Display erzeugt die GPU keinen Framebuffer, sodass RustDesk zwar eine Verbindung herstellt, aber nichts zu senden hat. Dieses Muster taucht im RustDesk-Issue-Tracker immer wieder auf, unter anderem in [Berichten über schwarze Bildschirme speziell dann, wenn der Monitor des Zielgeräts ausgeschaltet ist](https://github.com/rustdesk/rustdesk/issues/9884) sowie im langjährigen [„Connected, waiting for image“-Thread](https://github.com/rustdesk/rustdesk/issues/222). Mit Abstand die am häufigsten gemeldete Ursache ist ein **Headless-Rechner** etwa ein Server, Mini-PC oder eine Workstation , der ganz ohne angeschlossenen Monitor läuft oder dessen Display sich im Ruhezustand befindet. Ohne aktives Display erzeugt die GPU keinen Framebuffer, sodass RustDesk zwar eine Verbindung herstellt, aber nichts zu senden hat. Dieses Muster taucht im RustDesk-Issue-Tracker immer wieder auf, unter anderem in [Berichten über schwarze Bildschirme speziell dann, wenn der Monitor des Zielgeräts ausgeschaltet ist](https://github.com/rustdesk/rustdesk/issues/9884) sowie im langjährigen [„Connected, waiting for image“-Thread](https://github.com/rustdesk/rustdesk/issues/222).
Es gibt drei Wege, um etwas zum Erfassen bereitzustellen: Es gibt zwei Wege, um etwas zum Erfassen bereitzustellen:
- **Einen Monitor anschließen** und sicherstellen, dass er eingeschaltet und aktiv ist. - **Einen Monitor anschließen** und sicherstellen, dass er eingeschaltet und aktiv ist.
- **Einen HDMI- (oder DisplayPort-)Dummy-Stecker verwenden.** Diese günstigen Adapter gaukeln der GPU vor, dass ein Display angeschlossen ist, sodass sie weiterhin einen Framebuffer rendert, den RustDesk abgreifen kann. Das ist die Standardlösung für Headless-Desktops und Heimserver. - **Einen HDMI- (oder DisplayPort-)Dummy-Stecker verwenden.** Diese günstigen Adapter gaukeln der GPU vor, dass ein Display angeschlossen ist, sodass sie weiterhin einen Framebuffer rendert, den RustDesk abgreifen kann. Das ist die Standardlösung für Headless-Desktops und Heimserver.
- **Unter Linux den dokumentierten Headless-Weg nutzen.** RustDesk unterstützt Headless-Setups unter Linux, wobei sich die Konfiguration von einer normalen Desktop-Sitzung unterscheidet siehe das [Wiki „Headless Linux Support“](https://github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support).
Ist _tatsächlich_ ein Monitor angeschlossen, liegt der nächste Verdacht nahe: Er ist in den Ruhezustand gegangen. Ist _tatsächlich_ ein Monitor angeschlossen, liegt der nächste Verdacht nahe: Er ist in den Ruhezustand gegangen.
@@ -49,7 +48,7 @@ Ist _tatsächlich_ ein Monitor angeschlossen, liegt der nächste Verdacht nahe:
| Ursache | Anzeichen | Lösung | | Ursache | Anzeichen | Lösung |
| ------------------------------------ | ---------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ------------------------------------ | ---------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Headless / kein Display | Schwarzer Bildschirm bei Server oder Mini-PC | Monitor anschließen, HDMI-Dummy-Stecker verwenden oder den Linux-Headless-Weg nutzen | | Headless / kein Display | Schwarzer Bildschirm bei Server oder Mini-PC | Monitor anschließen oder HDMI-Dummy-Stecker verwenden |
| Bildschirm im Ruhezustand / gesperrt | Hat vorher funktioniert, nach Leerlauf schwarz | Bildschirm aufwecken; Ruhezustand/Bildschirmschoner deaktivieren; unter macOS den Ruhezustand des Displays in den Einstellungen ausschalten | | Bildschirm im Ruhezustand / gesperrt | Hat vorher funktioniert, nach Leerlauf schwarz | Bildschirm aufwecken; Ruhezustand/Bildschirmschoner deaktivieren; unter macOS den Ruhezustand des Displays in den Einstellungen ausschalten |
| Fehlende Berechtigung (macOS) | Verbindet, aber dauerhaft schwarz | Bildschirmaufnahme unter „Datenschutz & Sicherheit“ erlauben; Helper für den Anmeldebildschirm installieren | | Fehlende Berechtigung (macOS) | Verbindet, aber dauerhaft schwarz | Bildschirmaufnahme unter „Datenschutz & Sicherheit“ erlauben; Helper für den Anmeldebildschirm installieren |
| Codec-Konflikt | Leeres oder eingefrorenes Bild | Codec wechseln (VP8 / VP9 / AV1 / H.264 / H.265); auf Software-Codec ausweichen | | Codec-Konflikt | Leeres oder eingefrorenes Bild | Codec wechseln (VP8 / VP9 / AV1 / H.264 / H.265); auf Software-Codec ausweichen |
@@ -83,7 +82,7 @@ Manche GPUs am häufigsten betrifft es NVIDIA-Konfigurationen vertragen
### Linux und Wayland ### Linux und Wayland
Unter Linux **läuft die Wayland-Bildschirmerfassung über PipeWire und das `xdg-desktop-portal`**: Beim ersten Mal erscheint eine Zustimmungsabfrage zur Auswahl eines Displays in den meisten Fällen wird die Wahl gespeichert, sodass die Abfrage danach nicht mehr erscheint und funktioniert innerhalb einer aktiven Anmeldesitzung. Das ist ein Sicherheitskonzept von Wayland, das für sich genommen weder den Greeter (Anmeldebildschirm) noch ein System ganz ohne Display abdeckt die unbeaufsichtigte Erfassung unter Wayland befindet sich jedoch in aktiver Entwicklung ([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). Erhalten Sie unter Wayland ein leeres Bild, besteht die Lösung meist darin, die Bildschirmfreigabe-Abfrage des Portals zu bestätigen und zu prüfen, ob `xdg-desktop-portal` und PipeWire installiert sind und laufen; auf einem Rechner ganz ohne Display nutzen Sie die dokumentierte [Headless-Konfiguration](https://github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support). Die Anmeldung in einer X11-/Xorg-Sitzung umgeht den Portal-Pfad ebenfalls, sofern eine Distribution diese Option noch anbietet da jedoch immer mehr Distributionen ausschließlich auf Wayland setzen, ist die Behebung des Portal-/PipeWire-Pfads der zukunftssicherere Ansatz. Unter Linux **läuft die Wayland-Bildschirmerfassung über PipeWire und das `xdg-desktop-portal`**: Beim ersten Mal erscheint eine Zustimmungsabfrage zur Auswahl eines Displays in den meisten Fällen wird die Wahl gespeichert, sodass die Abfrage danach nicht mehr erscheint und funktioniert innerhalb einer aktiven Anmeldesitzung. Das ist ein Sicherheitskonzept von Wayland, das für sich genommen den Greeter (Anmeldebildschirm) nicht abdeckt die unbeaufsichtigte Erfassung unter Wayland befindet sich jedoch in aktiver Entwicklung ([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). Erhalten Sie unter Wayland ein leeres Bild, besteht die Lösung meist darin, die Bildschirmfreigabe-Abfrage des Portals zu bestätigen und zu prüfen, ob `xdg-desktop-portal` und PipeWire installiert sind und laufen. Die Anmeldung in einer X11-/Xorg-Sitzung umgeht den Portal-Pfad ebenfalls, sofern eine Distribution diese Option noch anbietet da jedoch immer mehr Distributionen ausschließlich auf Wayland setzen, ist die Behebung des Portal-/PipeWire-Pfads der zukunftssicherere Ansatz.
### Netzwerk und Relay ### Netzwerk und Relay
+6 -14
View File
@@ -4,7 +4,7 @@ lang: 'de'
translationKey: rustdesk-for-linux translationKey: rustdesk-for-linux
draft: false draft: false
title: 'RustDesk für Linux: Der Open-Source-Remote-Desktop' title: 'RustDesk für Linux: Der Open-Source-Remote-Desktop'
excerpt: 'RustDesk unter Linux installieren und betreiben: .deb, .rpm, Flatpak und AppImage, X11 vs. Wayland, Headless- und unbeaufsichtigter Zugriff sowie Self-Hosting des Servers.' excerpt: 'RustDesk unter Linux installieren und betreiben: .deb, .rpm, Flatpak und AppImage, X11 vs. Wayland, unbeaufsichtigter Zugriff sowie Self-Hosting des Servers.'
image: ~/assets/images/blog/rustdesk-for-linux-og.webp image: ~/assets/images/blog/rustdesk-for-linux-og.webp
category: 'Anleitungen' category: 'Anleitungen'
tags: ['RustDesk', 'Linux', 'Selbst-Hosting'] tags: ['RustDesk', 'Linux', 'Selbst-Hosting']
@@ -12,21 +12,19 @@ author: RustDesk Team
slug: 'rustdesk-fur-linux-der-open-source-remote-desktop' slug: 'rustdesk-fur-linux-der-open-source-remote-desktop'
faq: faq:
- question: 'Funktioniert RustDesk unter Wayland?' - question: 'Funktioniert RustDesk unter Wayland?'
answer: 'Ja — RustDesk bietet eine der stärksten Wayland-Unterstützungen aller Remote-Desktop-Tools, einschließlich des in 1.4.3 hinzugefügten Multi-Monitor-Sharings. Unter Wayland erfasst RustDesk den Bildschirm über PipeWire und das XDG-Desktop-Portal, das einen Zustimmungsdialog zur Auswahl eines Displays anzeigt — in den meisten Fällen wird die Wahl gespeichert, sodass Sie nicht erneut gefragt werden — und arbeitet innerhalb der aktiven, angemeldeten Sitzung. Dieser Zustimmungsschritt ist ein Sicherheitskonzept von Wayland, das für jede Screensharing-App gilt. Für den Zugriff vor dem Login oder auf vollständig unbeaufsichtigten Rechnern nutzen Sie derzeit das Headless-Setup mit virtuellem Display (oder eine X11-Sitzung, sofern eine Distribution noch eine anbietet, da mehrere zu einem reinen Wayland-Betrieb wechseln); die vollständig unbeaufsichtigte Wayland-Erfassung befindet sich in aktiver Entwicklung (siehe github.com/rustdesk/rustdesk/pull/15420).' answer: 'Ja — RustDesk bietet eine der stärksten Wayland-Unterstützungen aller Remote-Desktop-Tools, einschließlich des in 1.4.3 hinzugefügten Multi-Monitor-Sharings. Unter Wayland erfasst RustDesk den Bildschirm über PipeWire und das XDG-Desktop-Portal, das einen Zustimmungsdialog zur Auswahl eines Displays anzeigt — in den meisten Fällen wird die Wahl gespeichert, sodass Sie nicht erneut gefragt werden — und arbeitet innerhalb der aktiven, angemeldeten Sitzung. Dieser Zustimmungsschritt ist ein Sicherheitskonzept von Wayland, das für jede Screensharing-App gilt. Für den Zugriff vor dem Login oder auf vollständig unbeaufsichtigten Rechnern nutzen Sie derzeit eine X11-Sitzung, sofern eine Distribution noch eine anbietet, da mehrere zu einem reinen Wayland-Betrieb wechseln; die vollständig unbeaufsichtigte Wayland-Erfassung befindet sich in aktiver Entwicklung (siehe github.com/rustdesk/rustdesk/pull/15420).'
- question: 'Welches Paket sollte ich unter Linux installieren?' - question: 'Welches Paket sollte ich unter Linux installieren?'
answer: 'Nutzen Sie das .deb-Paket unter Debian, Ubuntu und Linux Mint, das .rpm-Paket unter Fedora, RHEL und openSUSE, das Flatpak von Flathub für einen sandboxed, breit kompatiblen Build oder das portable AppImage als Einzeldatei-Fallback. Die .deb- und .rpm-Pakete registrieren und starten einen systemd-Dienst, sodass RustDesk Neustarts übersteht; Flatpak und AppImage tun dies standardmäßig nicht.' answer: 'Nutzen Sie das .deb-Paket unter Debian, Ubuntu und Linux Mint, das .rpm-Paket unter Fedora, RHEL und openSUSE, das Flatpak von Flathub für einen sandboxed, breit kompatiblen Build oder das portable AppImage als Einzeldatei-Fallback. Die .deb- und .rpm-Pakete registrieren und starten einen systemd-Dienst, sodass RustDesk Neustarts übersteht; Flatpak und AppImage tun dies standardmäßig nicht.'
- question: 'Warum zeigt mein Headless-Linux-Rechner einen schwarzen Bildschirm?'
answer: 'Ohne angeschlossenen Monitor legen weder X noch Wayland jemals einen Framebuffer an, sodass es für RustDesk nichts zu erfassen gibt und der Viewer einen schwarzen Bildschirm oder die Meldung „Warten auf Bild“ anzeigt. Schließen Sie einen Dummy-HDMI-/DisplayPort-Stecker an, richten Sie ein virtuelles Display wie xserver-xorg-video-dummy oder VKMS ein, oder aktivieren Sie den optionalen Headless-Modus von RustDesk unter Linux, damit automatisch ein virtuelles Display für Sie erstellt wird.'
- question: 'Kann ich den RustDesk-Server unter Linux selbst hosten?' - question: 'Kann ich den RustDesk-Server unter Linux selbst hosten?'
answer: 'Ja. Der RustDesk-Server (die Prozesse hbbs für ID/Rendezvous und hbbr für das Relay) ist für Linux gebaut, und das ist der Standardweg, ihn zu betreiben. Der kostenlose Open-Source-Community-Server läuft unbegrenzt kostenlos, und Server Pro ergänzt zusätzlich eine Web-Konsole, Gerätegruppen und einen Generator für individuelle Clients. Beide lassen sich auf einer gewöhnlichen Linux-VM oder Bare-Metal-Hardware installieren.' answer: 'Ja. Der RustDesk-Server (die Prozesse hbbs für ID/Rendezvous und hbbr für das Relay) ist für Linux gebaut, und das ist der Standardweg, ihn zu betreiben. Der kostenlose Open-Source-Community-Server läuft unbegrenzt kostenlos, und Server Pro ergänzt zusätzlich eine Web-Konsole, Gerätegruppen und einen Generator für individuelle Clients. Beide lassen sich auf einer gewöhnlichen Linux-VM oder Bare-Metal-Hardware installieren.'
metadata: metadata:
description: 'RustDesk unter Linux, von A bis Z: Paketwahl für jede Distribution und jedes ARM-Board, Wayland- und X11-Erfassung, Headless-Setup und der Betrieb eines eigenen Servers.' description: 'RustDesk unter Linux, von A bis Z: Paketwahl für jede Distribution und jedes ARM-Board, Wayland- und X11-Erfassung und der Betrieb eines eigenen Servers.'
keywords: 'RustDesk für Linux, RustDesk Ubuntu, RustDesk Wayland, RustDesk X11, RustDesk Linux installieren' keywords: 'RustDesk für Linux, RustDesk Ubuntu, RustDesk Wayland, RustDesk X11, RustDesk Linux installieren'
--- ---
Linux-Nutzer hatten nie eine große Auswahl an guten Remote-Desktop-Tools, und die wenigen, die es gibt, sind meist entweder Closed-Source-Kommerzprodukte oder in die Jahre gekommene VNC-Stacks. RustDesk positioniert sich anders: Es ist ein Open-Source-Remote-Desktop-Client unter AGPL-Lizenz, läuft nativ auf allen wichtigen Distributionen, und Sie können ihn mit einem selbst gehosteten Server verbinden. Diese Kombination auditierbarer Code, nativer Linux-Client und selbst hostbare Infrastruktur macht RustDesk zu einer der ersten Adressen, wenn jemand nach einem Open-Source-Remote-Desktop für Linux fragt. Linux-Nutzer hatten nie eine große Auswahl an guten Remote-Desktop-Tools, und die wenigen, die es gibt, sind meist entweder Closed-Source-Kommerzprodukte oder in die Jahre gekommene VNC-Stacks. RustDesk positioniert sich anders: Es ist ein Open-Source-Remote-Desktop-Client unter AGPL-Lizenz, läuft nativ auf allen wichtigen Distributionen, und Sie können ihn mit einem selbst gehosteten Server verbinden. Diese Kombination auditierbarer Code, nativer Linux-Client und selbst hostbare Infrastruktur macht RustDesk zu einer der ersten Adressen, wenn jemand nach einem Open-Source-Remote-Desktop für Linux fragt.
Dieser Leitfaden zeigt, wie Sie RustDesk installieren, erklärt den einen Punkt, über den alle stolpern (X11 versus Wayland), wie Sie unbeaufsichtigten und Headless-Zugriff zum Laufen bringen, und wo der Server ins Spiel kommt. Dieser Leitfaden zeigt, wie Sie RustDesk installieren, erklärt den einen Punkt, über den alle stolpern (X11 versus Wayland), wie Sie unbeaufsichtigten Zugriff zum Laufen bringen, und wo der Server ins Spiel kommt.
## RustDesk unter Linux installieren ## RustDesk unter Linux installieren
@@ -53,7 +51,7 @@ Das ist der wichtigste Punkt, den Sie über RustDesk unter Linux verstehen sollt
**Wayland: RustDesk bietet wohl die stärkste Unterstützung aller Remote-Desktop-Tools.** RustDesk unterstützt Wayland seit Version 1.2.0 und baut diese Unterstützung stetig aus. Da Wayland-Compositors keinen direkten Framebuffer-Zugriff erlauben, erfasst RustDesk den Bildschirm über den Dienst `xdg-desktop-portal` und [PipeWire](https://deepwiki.com/rustdesk/rustdesk/6.3.1-wayland-support) und injiziert Eingaben über das Kernel-Modul `uinput`. Aus dem Design von Wayland selbst ergeben sich zwei Konsequenzen sie gelten für jedes Wayland-Screensharing-Tool, nicht nur für RustDesk: **Wayland: RustDesk bietet wohl die stärkste Unterstützung aller Remote-Desktop-Tools.** RustDesk unterstützt Wayland seit Version 1.2.0 und baut diese Unterstützung stetig aus. Da Wayland-Compositors keinen direkten Framebuffer-Zugriff erlauben, erfasst RustDesk den Bildschirm über den Dienst `xdg-desktop-portal` und [PipeWire](https://deepwiki.com/rustdesk/rustdesk/6.3.1-wayland-support) und injiziert Eingaben über das Kernel-Modul `uinput`. Aus dem Design von Wayland selbst ergeben sich zwei Konsequenzen sie gelten für jedes Wayland-Screensharing-Tool, nicht nur für RustDesk:
- **Zustimmung pro Verbindung.** Das Portal zeigt einen Dialog, in dem Sie auswählen, welcher Bildschirm freigegeben wird. Das ist eine bewusste Sicherheitsfunktion von Wayland, kein Fehler von RustDesk eine Hintergrundanwendung kann nicht klammheimlich die Bildschirmaufnahme starten. Portal v4 und neuer unterstützen ein „Restore Token“, sodass Sie nicht jedes Mal erneut gefragt werden, aber die erste Freigabe erfordert einen Klick auf dem Bildschirm. - **Zustimmung pro Verbindung.** Das Portal zeigt einen Dialog, in dem Sie auswählen, welcher Bildschirm freigegeben wird. Das ist eine bewusste Sicherheitsfunktion von Wayland, kein Fehler von RustDesk eine Hintergrundanwendung kann nicht klammheimlich die Bildschirmaufnahme starten. Portal v4 und neuer unterstützen ein „Restore Token“, sodass Sie nicht jedes Mal erneut gefragt werden, aber die erste Freigabe erfordert einen Klick auf dem Bildschirm.
- **Nur aktive Sitzung.** Die Wayland-Erfassung ist an die angemeldete grafische Sitzung gebunden. Die Erfassung des Wayland-Login-Greeters wird noch nicht unterstützt sie befindet sich in aktiver Entwicklung ([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). Für den Zugriff vor dem Login nutzen Sie derzeit die weiter unten beschriebene Headless-/virtuelle-Display-Konfiguration oder eine X11-Sitzung auf Distributionen, die noch eine anbieten. - **Nur aktive Sitzung.** Die Wayland-Erfassung ist an die angemeldete grafische Sitzung gebunden. Die Erfassung des Wayland-Login-Greeters wird noch nicht unterstützt sie befindet sich in aktiver Entwicklung ([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). Für den Zugriff vor dem Login nutzen Sie derzeit eine X11-Sitzung auf Distributionen, die noch eine anbieten.
Die Wayland-Unterstützung wird laufend verbessert RustDesk 1.4.3 (Oktober 2025) hat beispielsweise [Multi-Monitor-Sharing für Wayland hinzugefügt](https://ubuntuhandbook.org/index.php/2025/10/rustdesk-released-1-4-3-with-multi-monitor-for-wayland-virtual-mouse/). Wenn Sie sich jedoch verbinden und auf einem Wayland-System einen schwarzen Bildschirm sehen, liegt das fast immer daran, dass der Portal-/PipeWire-Pfad nicht erfüllt ist. Unser ausführlicher Beitrag [RustDesk verbunden, aber wartet auf Bild](/de/blog/rustdesk-connected-waiting-for-image-der-komplette-leitfaden-zur) geht speziell auf den Fall des schwarzen Bildschirms unter Wayland ein. Die Wayland-Unterstützung wird laufend verbessert RustDesk 1.4.3 (Oktober 2025) hat beispielsweise [Multi-Monitor-Sharing für Wayland hinzugefügt](https://ubuntuhandbook.org/index.php/2025/10/rustdesk-released-1-4-3-with-multi-monitor-for-wayland-virtual-mouse/). Wenn Sie sich jedoch verbinden und auf einem Wayland-System einen schwarzen Bildschirm sehen, liegt das fast immer daran, dass der Portal-/PipeWire-Pfad nicht erfüllt ist. Unser ausführlicher Beitrag [RustDesk verbunden, aber wartet auf Bild](/de/blog/rustdesk-connected-waiting-for-image-der-komplette-leitfaden-zur) geht speziell auf den Fall des schwarzen Bildschirms unter Wayland ein.
@@ -63,21 +61,15 @@ Unbeaufsichtigter Zugriff bedeutet, sich mit einem Rechner zu verbinden, vor dem
1. Installieren Sie über `.deb` oder `.rpm`, damit der systemd-Dienst registriert wird, oder klicken Sie in der App auf **Dienst aktivieren**. 1. Installieren Sie über `.deb` oder `.rpm`, damit der systemd-Dienst registriert wird, oder klicken Sie in der App auf **Dienst aktivieren**.
2. Legen Sie in RustDesk unter den Verbindungseinstellungen ein starkes **dauerhaftes Passwort** fest (und aktivieren Sie idealerweise die Zwei-Faktor-Authentifizierung). 2. Legen Sie in RustDesk unter den Verbindungseinstellungen ein starkes **dauerhaftes Passwort** fest (und aktivieren Sie idealerweise die Zwei-Faktor-Authentifizierung).
3. Für den Zugriff vor oder unabhängig von Benutzeranmeldungen nutzen Sie die weiter unten beschriebene Headless-Konfiguration mit virtuellem Display (die oben erwähnte Lücke beim Wayland-Greeter gilt auch hier).
Eine Wayland-Realität, die Sie einplanen sollten: Das im Wayland-Abschnitt beschriebene zustimmungsbasierte Portal macht eine vollständig unbeaufsichtigte Erfassung schwieriger als unter X11 zumindest bis die in Entwicklung befindliche Unterstützung für unbeaufsichtigten Zugriff verfügbar ist. Planen Sie deshalb für Rechner ohne Aufsicht mit dem Headless-Setup mit virtuellem Display.
## Headless-Linux: Server ohne Monitor ## Headless-Linux: Server ohne Monitor
Ein sehr häufiger Linux-Anwendungsfall ist ein Rechner ganz ohne angeschlossenes Display ein Heimserver, eine Labormaschine, eine VM. Hier liegt das Problem nicht bei RustDesk, sondern beim Grafik-Stack: Ohne angeschlossenen Monitor legen weder X noch Wayland jemals einen Framebuffer an, sodass es buchstäblich kein Bild zu erfassen gibt und Sie einen schwarzen Bildschirm sehen. Ein sehr häufiger Linux-Anwendungsfall ist ein Rechner ganz ohne angeschlossenes Display ein Heimserver, eine Labormaschine, eine VM. Hier liegt das Problem nicht bei RustDesk, sondern beim Grafik-Stack: Ohne angeschlossenen Monitor legen weder X noch Wayland jemals einen Framebuffer an, sodass es buchstäblich kein Bild zu erfassen gibt und Sie einen schwarzen Bildschirm sehen.
Drei Möglichkeiten, ihm etwas zum Rendern zu geben: Zwei Möglichkeiten, ihm etwas zum Rendern zu geben:
- **Ein Dummy-Stecker** ein günstiger physischer HDMI-/DisplayPort-„Headless“-Dongle, der die GPU glauben lässt, es sei ein Monitor angeschlossen. - **Ein Dummy-Stecker** ein günstiger physischer HDMI-/DisplayPort-„Headless“-Dongle, der die GPU glauben lässt, es sei ein Monitor angeschlossen.
- **Ein virtueller Display-Treiber** `xserver-xorg-video-dummy` unter X11 oder eine Option auf Kernel-Ebene wie VKMS. - **Ein virtueller Display-Treiber** `xserver-xorg-video-dummy` unter X11 oder eine Option auf Kernel-Ebene wie VKMS.
- **Der optionale Headless-Modus von RustDesk** aktivieren Sie ihn mit `sudo rustdesk --option allow-linux-headless Y`. Laut dem [Wiki zur Headless-Linux-Unterstützung](https://github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support) ist er standardmäßig deaktiviert, wird vor allem unter Ubuntu mit GNOME getestet und setzt Pakete wie `xserver-xorg-video-dummy` und `lightdm` voraus. Die ID des Rechners können Sie mit `sudo rustdesk --get-id` abrufen und ein Passwort mit `sudo rustdesk --password <password>` festlegen.
Der Headless-Modus hat noch Ecken und Kanten betrachten Sie ihn eher als „funktioniert, mit Sorgfalt“ denn als schlüsselfertige Lösung.
## Den RustDesk-Server unter Linux selbst hosten ## Den RustDesk-Server unter Linux selbst hosten
@@ -58,7 +58,7 @@ Sobald RustDesk als Dienst läuft, wird es geladen, bevor sich überhaupt jemand
| --------- | --------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | --------- | --------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Windows | Installieren; Dienst aktiv halten (startet mit dem Rechner) | Portable EXE bricht bei Abmeldung/UAC ab; Installationsprogramm verwenden | | Windows | Installieren; Dienst aktiv halten (startet mit dem Rechner) | Portable EXE bricht bei Abmeldung/UAC ab; Installationsprogramm verwenden |
| macOS | Installieren, dauerhaftes Passwort festlegen, Berechtigungen erteilen | Bildschirmaufnahme und Bedienungshilfen müssen erteilt werden; Erfassung am Anmeldebildschirm erfordert den installierten Helper | | macOS | Installieren, dauerhaftes Passwort festlegen, Berechtigungen erteilen | Bildschirmaufnahme und Bedienungshilfen müssen erteilt werden; Erfassung am Anmeldebildschirm erfordert den installierten Helper |
| Linux | Das Dienstpaket installieren | Wayland benötigt eine aktive Sitzung; für den Zugriff vor der Anmeldung die Headless-Virtual-Display-Einrichtung nutzen, oder X11, sofern eine Distribution das noch anbietet | | Linux | Das Dienstpaket installieren | Wayland benötigt eine aktive Sitzung; für den Zugriff vor der Anmeldung X11 nutzen, sofern eine Distribution das noch anbietet |
| Android | Dauerhaftes Passwort festlegen; Erfassung aktivieren | Bildschirm muss aktiv sein; Zustimmung zur Bildschirmerfassung (MediaProjection) und Eingabeberechtigung erteilen | | Android | Dauerhaftes Passwort festlegen; Erfassung aktivieren | Bildschirm muss aktiv sein; Zustimmung zur Bildschirmerfassung (MediaProjection) und Eingabeberechtigung erteilen |
### Windows ### Windows
@@ -71,7 +71,7 @@ macOS setzt für Bildschirmaufnahme und Eingabe Berechtigungen voraus. Öffnen S
### Linux ### Linux
Installieren Sie RustDesk so, dass die Dienstkomponente beim Booten startet. Bei einem Rechner, der am Login-Greeter steht, kann Wayland den Greeter noch nicht erfassen eine Einschränkung des Wayland-Designs (keine Beschränkung von RustDesk), an deren Behebung RustDesk aktiv arbeitet ([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). Bei einer Headless-Maschine nutzen Sie die Virtual-Display-Konfiguration; auf einem Desktop übernimmt das weiterhin eine X11/Xorg-Sitzung, sofern eine Distribution eine solche noch anbietet auch wenn mehrere inzwischen ausschließlich auf Wayland setzen. Details finden Sie unter [RustDesk für Linux](/de/blog/rustdesk-fur-linux-der-open-source-remote-desktop). Installieren Sie RustDesk so, dass die Dienstkomponente beim Booten startet. Bei einem Rechner, der am Login-Greeter steht, kann Wayland den Greeter noch nicht erfassen eine Einschränkung des Wayland-Designs (keine Beschränkung von RustDesk), an deren Behebung RustDesk aktiv arbeitet ([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). Auf einem Desktop übernimmt das weiterhin eine X11/Xorg-Sitzung, sofern eine Distribution eine solche noch anbietet auch wenn mehrere inzwischen ausschließlich auf Wayland setzen. Details finden Sie unter [RustDesk für Linux](/de/blog/rustdesk-fur-linux-der-open-source-remote-desktop).
## Schritt 3: Rollout im großen Maßstab mit einem vorkonfigurierten Client ## Schritt 3: Rollout im großen Maßstab mit einem vorkonfigurierten Client
@@ -15,7 +15,7 @@ faq:
- question: 'Why does RustDesk say "Connected, waiting for image"?' - question: 'Why does RustDesk say "Connected, waiting for image"?'
answer: "The session established successfully, but the remote machine is not producing a screen image to send. The most common reason is that there is no active display to capture — a headless server with no monitor, a screen that has gone to sleep or locked, or a display the OS won't let RustDesk record. Fix the capture source and the image appears." answer: "The session established successfully, but the remote machine is not producing a screen image to send. The most common reason is that there is no active display to capture — a headless server with no monitor, a screen that has gone to sleep or locked, or a display the OS won't let RustDesk record. Fix the capture source and the image appears."
- question: 'How do I fix RustDesk waiting for image on a headless computer?' - question: 'How do I fix RustDesk waiting for image on a headless computer?'
answer: 'A machine with no monitor has no framebuffer to capture, so RustDesk has nothing to send. Attach a real monitor, plug in an inexpensive HDMI dummy plug that makes the GPU think a display is connected, or on Linux use the documented headless setup (github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support). Waking or keeping the display awake resolves most cases.' answer: 'A machine with no monitor has no framebuffer to capture, so RustDesk has nothing to send. Attach a real monitor or plug in an inexpensive HDMI dummy plug that makes the GPU think a display is connected. Waking or keeping the display awake resolves most cases.'
- question: 'Does changing the video codec fix the black screen?' - question: 'Does changing the video codec fix the black screen?'
answer: 'Often, yes. In the remote session toolbar or settings you can switch codecs — VP8, VP9, AV1, or H.264/H.265 where hardware supports them. A codec the remote hardware cannot encode will show a blank or frozen image, and falling back to a software codec such as VP9 usually restores the picture.' answer: 'Often, yes. In the remote session toolbar or settings you can switch codecs — VP8, VP9, AV1, or H.264/H.265 where hardware supports them. A codec the remote hardware cannot encode will show a blank or frozen image, and falling back to a software codec such as VP9 usually restores the picture.'
- question: 'RustDesk shows the image on one PC but not another. Why?' - question: 'RustDesk shows the image on one PC but not another. Why?'
@@ -38,11 +38,10 @@ The session connected, but there is no framebuffer to capture. On a remote machi
By far the most reported cause is a **headless machine** — a server, mini-PC, or workstation running with no monitor attached, or with the display asleep. With no active display, the GPU produces no framebuffer, so RustDesk connects but has nothing to send. This pattern shows up repeatedly in the RustDesk issue tracker, including [reports of black screens specifically when the target's monitor is off](https://github.com/rustdesk/rustdesk/issues/9884) and the long-running ["Connected, waiting for image" thread](https://github.com/rustdesk/rustdesk/issues/222). By far the most reported cause is a **headless machine** — a server, mini-PC, or workstation running with no monitor attached, or with the display asleep. With no active display, the GPU produces no framebuffer, so RustDesk connects but has nothing to send. This pattern shows up repeatedly in the RustDesk issue tracker, including [reports of black screens specifically when the target's monitor is off](https://github.com/rustdesk/rustdesk/issues/9884) and the long-running ["Connected, waiting for image" thread](https://github.com/rustdesk/rustdesk/issues/222).
Three ways to give it something to capture: Two ways to give it something to capture:
- **Attach a monitor** and make sure it's powered on and awake. - **Attach a monitor** and make sure it's powered on and awake.
- **Use an HDMI (or DisplayPort) dummy plug.** These inexpensive adapters make the GPU believe a display is connected, so it keeps rendering a framebuffer for RustDesk to grab. This is the standard fix for headless desktops and home servers. - **Use an HDMI (or DisplayPort) dummy plug.** These inexpensive adapters make the GPU believe a display is connected, so it keeps rendering a framebuffer for RustDesk to grab. This is the standard fix for headless desktops and home servers.
- **On Linux, use the documented headless path.** RustDesk supports headless Linux setups, but the configuration differs from a normal desktop session — see the [Headless Linux Support wiki](https://github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support).
If a monitor _is_ attached, the next suspect is that it went to sleep. If a monitor _is_ attached, the next suspect is that it went to sleep.
@@ -50,7 +49,7 @@ If a monitor _is_ attached, the next suspect is that it went to sleep.
| Cause | Signal | Fix | | Cause | Signal | Fix |
| ------------------------------ | ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | | ------------------------------ | ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| Headless / no display | Black screen on a server or mini-PC | Attach a monitor, add an HDMI dummy plug, or use the Linux headless path | | Headless / no display | Black screen on a server or mini-PC | Attach a monitor or add an HDMI dummy plug |
| Screen asleep / locked | Worked earlier, black after idle | Wake the screen; disable sleep/screensaver; on macOS stop the display sleeping in Settings | | Screen asleep / locked | Worked earlier, black after idle | Wake the screen; disable sleep/screensaver; on macOS stop the display sleeping in Settings |
| Missing permission (macOS) | Connects, permanent black | Grant Screen Recording in Privacy & Security; install the helper for the login screen | | Missing permission (macOS) | Connects, permanent black | Grant Screen Recording in Privacy & Security; install the helper for the login screen |
| Codec mismatch | Blank or frozen image | Switch codec (VP8 / VP9 / AV1 / H.264 / H.265); fall back to a software codec | | Codec mismatch | Blank or frozen image | Switch codec (VP8 / VP9 / AV1 / H.264 / H.265); fall back to a software codec |
@@ -84,7 +83,7 @@ Some GPUs — NVIDIA configurations come up most often — clash with RustDesk's
### Linux and Wayland ### Linux and Wayland
On Linux, **Wayland screen capture goes through PipeWire and the `xdg-desktop-portal`**: it prompts for consent to pick a display the first time — in most cases the choice is remembered, so it does not prompt again — and works inside an active login session. That is a Wayland security design, so by itself it does not cover the greeter or a truly headless box — though unattended Wayland capture is in active development ([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). If you get a blank screen on Wayland, the fix is usually to accept the portal's screen-share prompt and confirm `xdg-desktop-portal` and PipeWire are installed and running; on a headless box, use the documented [headless configuration](https://github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support). Logging into an X11/Xorg session also avoids the portal path where a distribution still offers one — but as many distributions move to Wayland-only, fixing the portal/PipeWire path is the more future-proof approach. On Linux, **Wayland screen capture goes through PipeWire and the `xdg-desktop-portal`**: it prompts for consent to pick a display the first time — in most cases the choice is remembered, so it does not prompt again — and works inside an active login session. That is a Wayland security design, so by itself it does not cover the greeter — though unattended Wayland capture is in active development ([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). If you get a blank screen on Wayland, the fix is usually to accept the portal's screen-share prompt and confirm `xdg-desktop-portal` and PipeWire are installed and running. Logging into an X11/Xorg session also avoids the portal path where a distribution still offers one — but as many distributions move to Wayland-only, fixing the portal/PipeWire path is the more future-proof approach.
### Network and relay ### Network and relay
+6 -14
View File
@@ -4,7 +4,7 @@ lang: en
translationKey: rustdesk-for-linux translationKey: rustdesk-for-linux
draft: false draft: false
title: 'RustDesk for Linux: The Open-Source Remote Desktop' title: 'RustDesk for Linux: The Open-Source Remote Desktop'
excerpt: 'Install and run RustDesk on Linux: .deb, .rpm, Flatpak and AppImage, X11 vs Wayland, headless and unattended access, and self-hosting the server.' excerpt: 'Install and run RustDesk on Linux: .deb, .rpm, Flatpak and AppImage, X11 vs Wayland, unattended access, and self-hosting the server.'
image: ~/assets/images/blog/rustdesk-for-linux-og.webp image: ~/assets/images/blog/rustdesk-for-linux-og.webp
category: Guides category: Guides
tags: tags:
@@ -14,21 +14,19 @@ tags:
author: RustDesk Team author: RustDesk Team
faq: faq:
- question: 'Does RustDesk work on Wayland?' - question: 'Does RustDesk work on Wayland?'
answer: 'Yes — RustDesk has among the strongest Wayland support of any remote-desktop tool, including multi-monitor sharing added in 1.4.3. On Wayland it captures the screen through PipeWire and the XDG desktop portal, which shows a consent dialog to pick a display — in most cases the choice is remembered, so you are not asked again — and works within the active logged-in session. That consent step is a Wayland security design shared by every screen-sharing app. For pre-login or fully unattended machines today, use the headless virtual-display setup (or an X11 session where a distribution still offers one, since several are moving to Wayland-only); full unattended Wayland capture is in active development (see github.com/rustdesk/rustdesk/pull/15420).' answer: 'Yes — RustDesk has among the strongest Wayland support of any remote-desktop tool, including multi-monitor sharing added in 1.4.3. On Wayland it captures the screen through PipeWire and the XDG desktop portal, which shows a consent dialog to pick a display — in most cases the choice is remembered, so you are not asked again — and works within the active logged-in session. That consent step is a Wayland security design shared by every screen-sharing app. For pre-login or fully unattended machines today, use an X11 session where a distribution still offers one, since several are moving to Wayland-only; full unattended Wayland capture is in active development (see github.com/rustdesk/rustdesk/pull/15420).'
- question: 'Which package should I install on Linux?' - question: 'Which package should I install on Linux?'
answer: 'Use the .deb on Debian, Ubuntu and Linux Mint, the .rpm on Fedora, RHEL and openSUSE, the Flatpak from Flathub for a sandboxed, broadly compatible build, or the portable AppImage as a single-file fallback. The .deb and .rpm packages register and start a systemd service so RustDesk survives reboots; the Flatpak and AppImage do not by default.' answer: 'Use the .deb on Debian, Ubuntu and Linux Mint, the .rpm on Fedora, RHEL and openSUSE, the Flatpak from Flathub for a sandboxed, broadly compatible build, or the portable AppImage as a single-file fallback. The .deb and .rpm packages register and start a systemd service so RustDesk survives reboots; the Flatpak and AppImage do not by default.'
- question: 'Why does my headless Linux box show a black screen?'
answer: "With no monitor attached, X or Wayland never allocates a framebuffer, so there is nothing for RustDesk to capture and the viewer shows a black or waiting-for-image screen. Attach a dummy HDMI/DisplayPort plug, configure a virtual display such as xserver-xorg-video-dummy or VKMS, or enable RustDesk's opt-in Linux headless mode so a virtual display is created for you."
- question: 'Can I self-host the RustDesk server on Linux?' - question: 'Can I self-host the RustDesk server on Linux?'
answer: 'Yes. The RustDesk server (the hbbs ID/rendezvous and hbbr relay processes) is built for Linux and is the standard way to run it. The free open-source community server runs indefinitely at no cost, and Server Pro adds a web console, device groups and a custom client generator on top. Both install on a plain Linux VM or bare-metal host.' answer: 'Yes. The RustDesk server (the hbbs ID/rendezvous and hbbr relay processes) is built for Linux and is the standard way to run it. The free open-source community server runs indefinitely at no cost, and Server Pro adds a web console, device groups and a custom client generator on top. Both install on a plain Linux VM or bare-metal host.'
metadata: metadata:
description: 'RustDesk on Linux, end to end: package choices for every distro and ARM board, Wayland and X11 capture, headless setup, and running your own server.' description: 'RustDesk on Linux, end to end: package choices for every distro and ARM board, Wayland and X11 capture, and running your own server.'
keywords: 'RustDesk for Linux, RustDesk Ubuntu, RustDesk Wayland, RustDesk X11, RustDesk Linux install' keywords: 'RustDesk for Linux, RustDesk Ubuntu, RustDesk Wayland, RustDesk X11, RustDesk Linux install'
--- ---
Linux users have never had a huge choice of good remote desktop tools, and the ones that exist are usually either closed-source commercial products or aging VNC stacks. RustDesk sits in a different spot: it is an open-source remote desktop client licensed under the AGPL, it runs natively on all the major distributions, and you can point it at a server you host yourself. That combination — auditable code, native Linux client, and self-hostable infrastructure — is why RustDesk has become one of the go-to answers when someone asks for an open-source remote desktop for Linux. Linux users have never had a huge choice of good remote desktop tools, and the ones that exist are usually either closed-source commercial products or aging VNC stacks. RustDesk sits in a different spot: it is an open-source remote desktop client licensed under the AGPL, it runs natively on all the major distributions, and you can point it at a server you host yourself. That combination — auditable code, native Linux client, and self-hostable infrastructure — is why RustDesk has become one of the go-to answers when someone asks for an open-source remote desktop for Linux.
This guide covers how to install it, the one thing that trips everyone up (X11 versus Wayland), how to get unattended and headless access working, and where the server fits in. This guide covers how to install it, the one thing that trips everyone up (X11 versus Wayland), how to get unattended access working, and where the server fits in.
## Installing RustDesk on Linux ## Installing RustDesk on Linux
@@ -55,7 +53,7 @@ This is the single most important thing to understand about RustDesk on Linux, b
**Wayland: RustDesk has arguably the strongest support of any remote-desktop tool.** RustDesk has supported Wayland since version 1.2.0 and has kept extending it. Because Wayland compositors don't allow direct framebuffer access, RustDesk captures the screen through the `xdg-desktop-portal` service and [PipeWire](https://deepwiki.com/rustdesk/rustdesk/6.3.1-wayland-support), and injects input via the kernel's `uinput` module. Two consequences follow from Wayland's own design — and they apply to every Wayland screen-sharing tool, not just RustDesk: **Wayland: RustDesk has arguably the strongest support of any remote-desktop tool.** RustDesk has supported Wayland since version 1.2.0 and has kept extending it. Because Wayland compositors don't allow direct framebuffer access, RustDesk captures the screen through the `xdg-desktop-portal` service and [PipeWire](https://deepwiki.com/rustdesk/rustdesk/6.3.1-wayland-support), and injects input via the kernel's `uinput` module. Two consequences follow from Wayland's own design — and they apply to every Wayland screen-sharing tool, not just RustDesk:
- **Consent per connection.** The portal shows a dialog asking you to select which display to share. That is a deliberate Wayland security feature, not a RustDesk bug — a background app cannot silently start recording your screen. Portal v4 and newer support a "restore token" so you aren't re-prompted every single time, but the first share requires an on-screen click. - **Consent per connection.** The portal shows a dialog asking you to select which display to share. That is a deliberate Wayland security feature, not a RustDesk bug — a background app cannot silently start recording your screen. Portal v4 and newer support a "restore token" so you aren't re-prompted every single time, but the first share requires an on-screen click.
- **Active session only.** Wayland capture is tied to the logged-in graphical session. Capturing the Wayland login greeter isn't supported yet — it's in active development ([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). For pre-login access today, use the headless/virtual-display configuration below, or an X11 session on distributions that still provide one. - **Active session only.** Wayland capture is tied to the logged-in graphical session. Capturing the Wayland login greeter isn't supported yet — it's in active development ([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). For pre-login access today, use an X11 session on distributions that still provide one.
Wayland support keeps improving — RustDesk 1.4.3 (October 2025) [added multi-monitor sharing for Wayland](https://ubuntuhandbook.org/index.php/2025/10/rustdesk-released-1-4-3-with-multi-monitor-for-wayland-virtual-mouse/), for example. But if you connect and see a black screen on a Wayland box, that is almost always the portal/PipeWire path not being satisfied. Our dedicated write-up on [RustDesk connected but waiting for image](/blog/rustdesk-connected-waiting-for-image) walks through the Wayland black-screen case specifically. Wayland support keeps improving — RustDesk 1.4.3 (October 2025) [added multi-monitor sharing for Wayland](https://ubuntuhandbook.org/index.php/2025/10/rustdesk-released-1-4-3-with-multi-monitor-for-wayland-virtual-mouse/), for example. But if you connect and see a black screen on a Wayland box, that is almost always the portal/PipeWire path not being satisfied. Our dedicated write-up on [RustDesk connected but waiting for image](/blog/rustdesk-connected-waiting-for-image) walks through the Wayland black-screen case specifically.
@@ -65,21 +63,15 @@ Unattended access means connecting to a machine with nobody sitting in front of
1. Install via `.deb` or `.rpm` so the systemd service is registered, or click **Enable Service** in the app. 1. Install via `.deb` or `.rpm` so the systemd service is registered, or click **Enable Service** in the app.
2. In RustDesk, set a strong **permanent password** under the connection settings (and ideally enable two-factor authentication). 2. In RustDesk, set a strong **permanent password** under the connection settings (and ideally enable two-factor authentication).
3. For access before or across user logins, use the headless virtual-display configuration below (the Wayland greeter gap covered above applies here).
One Wayland reality to plan for: the consent-based portal described in the Wayland section makes fully unattended capture harder than on X11 until the in-development unattended support lands, so plan on the headless virtual-display setup for hands-off machines.
## Headless Linux: servers with no monitor ## Headless Linux: servers with no monitor
A very common Linux use case is a box with no display attached at all — a home server, a lab machine, a VM. Here the problem isn't RustDesk, it's the graphics stack: with no monitor plugged in, X or Wayland never allocates a framebuffer, so there is literally no image to capture and you get a black screen. A very common Linux use case is a box with no display attached at all — a home server, a lab machine, a VM. Here the problem isn't RustDesk, it's the graphics stack: with no monitor plugged in, X or Wayland never allocates a framebuffer, so there is literally no image to capture and you get a black screen.
Three ways to give it something to render: Two ways to give it something to render:
- **A dummy plug** — a cheap physical HDMI/DisplayPort "headless" dongle that makes the GPU think a monitor is attached. - **A dummy plug** — a cheap physical HDMI/DisplayPort "headless" dongle that makes the GPU think a monitor is attached.
- **A virtual display driver**`xserver-xorg-video-dummy` on X11, or a kernel-level option like VKMS. - **A virtual display driver**`xserver-xorg-video-dummy` on X11, or a kernel-level option like VKMS.
- **RustDesk's opt-in headless mode** — enable it with `sudo rustdesk --option allow-linux-headless Y`. Per the [Headless Linux Support wiki](https://github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support) it is disabled by default, tested mainly on Ubuntu with GNOME, and expects packages like `xserver-xorg-video-dummy` and `lightdm`. You can fetch the machine's ID with `sudo rustdesk --get-id` and set a password with `sudo rustdesk --password <password>`.
Headless mode is still rough around the edges, so treat it as "works, with care" rather than turnkey.
## Self-hosting the RustDesk server on Linux ## Self-hosting the RustDesk server on Linux
@@ -60,7 +60,7 @@ Once RustDesk runs as a service, it loads before anyone logs in, which is what l
| -------- | ----------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | | -------- | ----------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| Windows | Install; keep the service running (starts with the machine) | Portable exe drops on logout/UAC; use the installer | | Windows | Install; keep the service running (starts with the machine) | Portable exe drops on logout/UAC; use the installer |
| macOS | Install, set permanent password, grant permissions | Screen Recording and Accessibility must be granted; login-screen capture needs the helper installed | | macOS | Install, set permanent password, grant permissions | Screen Recording and Accessibility must be granted; login-screen capture needs the helper installed |
| Linux | Install the service package | Wayland needs an active session; for pre-login use the headless virtual-display setup, or X11 where a distro still offers one | | Linux | Install the service package | Wayland needs an active session; for pre-login use X11 where a distro still offers one |
| Android | Set permanent password; enable capture | Screen must be awake; grant the screen-capture (MediaProjection) consent and input permission | | Android | Set permanent password; enable capture | Screen must be awake; grant the screen-capture (MediaProjection) consent and input permission |
### Windows ### Windows
@@ -73,7 +73,7 @@ macOS gates screen capture and input behind permissions. After installing, open
### Linux ### Linux
Install RustDesk so its service component runs at boot. For a machine that sits at the login greeter, Wayland can't capture the greeter yet — a Wayland design (not a RustDesk limit) that RustDesk is actively working to close ([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). On a headless box, use the virtual-display configuration; on a desktop, an X11/Xorg session still handles it where a distribution provides one, though several are moving to Wayland-only. See [RustDesk for Linux](/blog/rustdesk-for-linux) for the details. Install RustDesk so its service component runs at boot. For a machine that sits at the login greeter, Wayland can't capture the greeter yet — a Wayland design (not a RustDesk limit) that RustDesk is actively working to close ([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). On a desktop, an X11/Xorg session still handles it where a distribution provides one, though several are moving to Wayland-only. See [RustDesk for Linux](/blog/rustdesk-for-linux) for the details.
## Step 3: Deploy at scale with a pre-configured client ## Step 3: Deploy at scale with a pre-configured client
@@ -14,7 +14,7 @@ faq:
- question: '¿Por qué RustDesk dice "Conectado, esperando imagen"?' - question: '¿Por qué RustDesk dice "Conectado, esperando imagen"?'
answer: 'La sesión se estableció correctamente, pero el equipo remoto no está generando una imagen de pantalla para enviar. La causa más común es que no hay ninguna pantalla activa que capturar: un servidor sin monitor, una pantalla que ha entrado en reposo o se ha bloqueado, o una pantalla que el sistema operativo no permite que RustDesk grabe. Soluciona el origen de la captura y la imagen aparecerá.' answer: 'La sesión se estableció correctamente, pero el equipo remoto no está generando una imagen de pantalla para enviar. La causa más común es que no hay ninguna pantalla activa que capturar: un servidor sin monitor, una pantalla que ha entrado en reposo o se ha bloqueado, o una pantalla que el sistema operativo no permite que RustDesk grabe. Soluciona el origen de la captura y la imagen aparecerá.'
- question: '¿Cómo soluciono que RustDesk se quede esperando imagen en un equipo sin monitor?' - question: '¿Cómo soluciono que RustDesk se quede esperando imagen en un equipo sin monitor?'
answer: 'Un equipo sin monitor no tiene framebuffer que capturar, así que RustDesk no tiene nada que enviar. Conecta un monitor real, instala un conector HDMI simulador económico que haga creer a la GPU que hay una pantalla conectada, o en Linux utiliza la configuración sin monitor documentada (github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support). Activar la pantalla o evitar que entre en reposo resuelve la mayoría de los casos.' answer: 'Un equipo sin monitor no tiene framebuffer que capturar, así que RustDesk no tiene nada que enviar. Conecta un monitor real o instala un conector HDMI simulador económico que haga creer a la GPU que hay una pantalla conectada. Activar la pantalla o evitar que entre en reposo resuelve la mayoría de los casos.'
- question: '¿Cambiar el códec de vídeo soluciona la pantalla negra?' - question: '¿Cambiar el códec de vídeo soluciona la pantalla negra?'
answer: 'A menudo, sí. En la barra de herramientas de la sesión remota o en la configuración puedes cambiar de códec: VP8, VP9, AV1 o H.264/H.265 donde el hardware lo admita. Un códec que el hardware remoto no puede codificar mostrará una imagen en blanco o congelada, y volver a un códec por software como VP9 suele restaurar la imagen.' answer: 'A menudo, sí. En la barra de herramientas de la sesión remota o en la configuración puedes cambiar de códec: VP8, VP9, AV1 o H.264/H.265 donde el hardware lo admita. Un códec que el hardware remoto no puede codificar mostrará una imagen en blanco o congelada, y volver a un códec por software como VP9 suele restaurar la imagen.'
- question: 'RustDesk muestra la imagen en un PC pero no en otro. ¿Por qué?' - question: 'RustDesk muestra la imagen en un PC pero no en otro. ¿Por qué?'
@@ -37,11 +37,10 @@ La sesión se conectó, pero no hay ningún framebuffer que capturar. En un equi
Con diferencia, la causa más reportada es un **equipo sin monitor (headless)**: un servidor, un mini-PC o una estación de trabajo que funciona sin monitor conectado, o con la pantalla en reposo. Sin una pantalla activa, la GPU no genera ningún framebuffer, así que RustDesk se conecta pero no tiene nada que enviar. Este patrón aparece repetidamente en el rastreador de incidencias de RustDesk, incluidos [informes de pantallas negras específicamente cuando el monitor del equipo de destino está apagado](https://github.com/rustdesk/rustdesk/issues/9884) y el extenso [hilo sobre "Conectado, esperando imagen"](https://github.com/rustdesk/rustdesk/issues/222). Con diferencia, la causa más reportada es un **equipo sin monitor (headless)**: un servidor, un mini-PC o una estación de trabajo que funciona sin monitor conectado, o con la pantalla en reposo. Sin una pantalla activa, la GPU no genera ningún framebuffer, así que RustDesk se conecta pero no tiene nada que enviar. Este patrón aparece repetidamente en el rastreador de incidencias de RustDesk, incluidos [informes de pantallas negras específicamente cuando el monitor del equipo de destino está apagado](https://github.com/rustdesk/rustdesk/issues/9884) y el extenso [hilo sobre "Conectado, esperando imagen"](https://github.com/rustdesk/rustdesk/issues/222).
Tres maneras de darle algo que capturar: Dos maneras de darle algo que capturar:
- **Conecta un monitor** y asegúrate de que esté encendido y activo. - **Conecta un monitor** y asegúrate de que esté encendido y activo.
- **Usa un conector HDMI (o DisplayPort) simulador.** Estos adaptadores económicos hacen que la GPU crea que hay una pantalla conectada, de modo que sigue renderizando un framebuffer para que RustDesk lo capture. Esta es la solución estándar para equipos de escritorio sin monitor y servidores domésticos. - **Usa un conector HDMI (o DisplayPort) simulador.** Estos adaptadores económicos hacen que la GPU crea que hay una pantalla conectada, de modo que sigue renderizando un framebuffer para que RustDesk lo capture. Esta es la solución estándar para equipos de escritorio sin monitor y servidores domésticos.
- **En Linux, usa la ruta sin monitor documentada.** RustDesk admite configuraciones de Linux sin monitor, pero la configuración difiere de una sesión de escritorio normal; consulta el [wiki de compatibilidad con Linux sin monitor](https://github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support).
Si __ hay un monitor conectado, el siguiente sospechoso es que haya entrado en reposo. Si __ hay un monitor conectado, el siguiente sospechoso es que haya entrado en reposo.
@@ -49,7 +48,7 @@ Si _sí_ hay un monitor conectado, el siguiente sospechoso es que haya entrado e
| Causa | Señal | Solución | | Causa | Señal | Solución |
| ------------------------------------- | ------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ------------------------------------- | ------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Sin monitor (headless) | Pantalla negra en un servidor o mini-PC | Conecta un monitor, añade un conector HDMI simulador o usa la ruta sin monitor de Linux | | Sin monitor (headless) | Pantalla negra en un servidor o mini-PC | Conecta un monitor o añade un conector HDMI simulador |
| Pantalla en reposo o bloqueada | Funcionaba antes, negra tras inactividad | Activa la pantalla; desactiva el reposo/salvapantallas; en macOS evita que la pantalla entre en reposo desde Configuración | | Pantalla en reposo o bloqueada | Funcionaba antes, negra tras inactividad | Activa la pantalla; desactiva el reposo/salvapantallas; en macOS evita que la pantalla entre en reposo desde Configuración |
| Falta de permiso (macOS) | Conecta, pantalla negra permanente | Concede el permiso de Grabación de pantalla en Privacidad y seguridad; instala el ayudante para la pantalla de inicio de sesión | | Falta de permiso (macOS) | Conecta, pantalla negra permanente | Concede el permiso de Grabación de pantalla en Privacidad y seguridad; instala el ayudante para la pantalla de inicio de sesión |
| Códec incompatible | Imagen en blanco o congelada | Cambia de códec (VP8 / VP9 / AV1 / H.264 / H.265); usa un códec por software como alternativa | | Códec incompatible | Imagen en blanco o congelada | Cambia de códec (VP8 / VP9 / AV1 / H.264 / H.265); usa un códec por software como alternativa |
@@ -83,7 +82,7 @@ Algunas GPU —las configuraciones NVIDIA son las que más aparecen— entran en
### Linux y Wayland ### Linux y Wayland
En Linux, **la captura de pantalla en Wayland pasa por PipeWire y el `xdg-desktop-portal`**: la primera vez solicita consentimiento para elegir una pantalla —en la mayoría de los casos la elección se recuerda, así que no vuelve a preguntar— y funciona dentro de una sesión de inicio de sesión activa. Se trata de un diseño de seguridad propio de Wayland, así que por sí solo no cubre la pantalla de bienvenida (greeter) ni un equipo realmente sin monitor, aunque la captura desatendida en Wayland está en desarrollo activo ([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). Si obtienes una pantalla en blanco en Wayland, la solución suele ser aceptar el aviso de compartir pantalla del portal y confirmar que `xdg-desktop-portal` y PipeWire están instalados y en ejecución; en un equipo sin monitor, usa la [configuración sin monitor documentada](https://github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support). Iniciar sesión en una sesión X11/Xorg también evita la ruta del portal donde una distribución todavía la ofrezca, pero como muchas distribuciones avanzan hacia Wayland exclusivamente, solucionar la ruta del portal/PipeWire es el enfoque más preparado para el futuro. En Linux, **la captura de pantalla en Wayland pasa por PipeWire y el `xdg-desktop-portal`**: la primera vez solicita consentimiento para elegir una pantalla —en la mayoría de los casos la elección se recuerda, así que no vuelve a preguntar— y funciona dentro de una sesión de inicio de sesión activa. Se trata de un diseño de seguridad propio de Wayland, así que por sí solo no cubre la pantalla de bienvenida (greeter), aunque la captura desatendida en Wayland está en desarrollo activo ([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). Si obtienes una pantalla en blanco en Wayland, la solución suele ser aceptar el aviso de compartir pantalla del portal y confirmar que `xdg-desktop-portal` y PipeWire están instalados y en ejecución. Iniciar sesión en una sesión X11/Xorg también evita la ruta del portal donde una distribución todavía la ofrezca, pero como muchas distribuciones avanzan hacia Wayland exclusivamente, solucionar la ruta del portal/PipeWire es el enfoque más preparado para el futuro.
### Red y relé ### Red y relé
+6 -14
View File
@@ -4,7 +4,7 @@ lang: 'es'
translationKey: 'rustdesk-for-linux' translationKey: 'rustdesk-for-linux'
draft: false draft: false
title: 'RustDesk para Linux: el escritorio remoto de código abierto' title: 'RustDesk para Linux: el escritorio remoto de código abierto'
excerpt: 'Instala y ejecuta RustDesk en Linux: .deb, .rpm, Flatpak y AppImage, X11 frente a Wayland, acceso headless y desatendido, y alojamiento propio del servidor.' excerpt: 'Instala y ejecuta RustDesk en Linux: .deb, .rpm, Flatpak y AppImage, X11 frente a Wayland, acceso desatendido y alojamiento propio del servidor.'
image: '~/assets/images/blog/rustdesk-for-linux-og.webp' image: '~/assets/images/blog/rustdesk-for-linux-og.webp'
category: 'Guías' category: 'Guías'
tags: ['RustDesk', 'Linux', 'Autoalojamiento'] tags: ['RustDesk', 'Linux', 'Autoalojamiento']
@@ -12,21 +12,19 @@ author: 'RustDesk Team'
slug: 'rustdesk-para-linux-el-escritorio-remoto-de-codigo-abierto' slug: 'rustdesk-para-linux-el-escritorio-remoto-de-codigo-abierto'
faq: faq:
- question: '¿RustDesk funciona en Wayland?' - question: '¿RustDesk funciona en Wayland?'
answer: 'Sí: RustDesk cuenta con uno de los soportes de Wayland más sólidos de cualquier herramienta de escritorio remoto, incluida la compartición multimonitor añadida en la versión 1.4.3. En Wayland, captura la pantalla a través de PipeWire y el portal de escritorio XDG, que muestra un cuadro de diálogo de consentimiento para elegir una pantalla —en la mayoría de los casos la elección se recuerda, por lo que no se vuelve a preguntar— y funciona dentro de la sesión gráfica activa con el usuario conectado. Ese paso de consentimiento forma parte del diseño de seguridad de Wayland y lo comparten todas las aplicaciones de compartición de pantalla. Para equipos previos al inicio de sesión o totalmente desatendidos, utiliza hoy la configuración headless con pantalla virtual (o una sesión X11 donde la distribución todavía la ofrezca, ya que varias están migrando a Wayland exclusivamente); la captura de Wayland totalmente desatendida está en desarrollo activo (consulta github.com/rustdesk/rustdesk/pull/15420).' answer: 'Sí: RustDesk cuenta con uno de los soportes de Wayland más sólidos de cualquier herramienta de escritorio remoto, incluida la compartición multimonitor añadida en la versión 1.4.3. En Wayland, captura la pantalla a través de PipeWire y el portal de escritorio XDG, que muestra un cuadro de diálogo de consentimiento para elegir una pantalla —en la mayoría de los casos la elección se recuerda, por lo que no se vuelve a preguntar— y funciona dentro de la sesión gráfica activa con el usuario conectado. Ese paso de consentimiento forma parte del diseño de seguridad de Wayland y lo comparten todas las aplicaciones de compartición de pantalla. Para equipos previos al inicio de sesión o totalmente desatendidos, utiliza hoy una sesión X11 donde la distribución todavía la ofrezca, ya que varias están migrando a Wayland exclusivamente; la captura de Wayland totalmente desatendida está en desarrollo activo (consulta github.com/rustdesk/rustdesk/pull/15420).'
- question: '¿Qué paquete debo instalar en Linux?' - question: '¿Qué paquete debo instalar en Linux?'
answer: 'Usa el .deb en Debian, Ubuntu y Linux Mint, el .rpm en Fedora, RHEL y openSUSE, el Flatpak de Flathub para una compilación en sandbox ampliamente compatible, o el AppImage portátil como alternativa de archivo único. Los paquetes .deb y .rpm registran e inician un servicio systemd para que RustDesk sobreviva a los reinicios; el Flatpak y el AppImage no lo hacen de forma predeterminada.' answer: 'Usa el .deb en Debian, Ubuntu y Linux Mint, el .rpm en Fedora, RHEL y openSUSE, el Flatpak de Flathub para una compilación en sandbox ampliamente compatible, o el AppImage portátil como alternativa de archivo único. Los paquetes .deb y .rpm registran e inician un servicio systemd para que RustDesk sobreviva a los reinicios; el Flatpak y el AppImage no lo hacen de forma predeterminada.'
- question: '¿Por qué mi equipo Linux headless muestra una pantalla en negro?'
answer: 'Sin un monitor conectado, X o Wayland nunca asignan un framebuffer, por lo que no hay nada que RustDesk pueda capturar y el visor muestra una pantalla en negro o de espera de imagen. Conecta un conector ficticio HDMI/DisplayPort, configura una pantalla virtual como xserver-xorg-video-dummy o VKMS, o activa el modo headless opcional de RustDesk para Linux para que se cree una pantalla virtual automáticamente.'
- question: '¿Puedo alojar yo mismo el servidor de RustDesk en Linux?' - question: '¿Puedo alojar yo mismo el servidor de RustDesk en Linux?'
answer: 'Sí. El servidor de RustDesk (los procesos hbbs de ID/rendezvous y hbbr de retransmisión) está creado para Linux y es la forma estándar de ejecutarlo. El servidor comunitario gratuito y de código abierto funciona indefinidamente sin coste, y Server Pro añade además una consola web, grupos de dispositivos y un generador de clientes personalizados. Ambos se instalan en una VM Linux normal o en un host físico (bare-metal).' answer: 'Sí. El servidor de RustDesk (los procesos hbbs de ID/rendezvous y hbbr de retransmisión) está creado para Linux y es la forma estándar de ejecutarlo. El servidor comunitario gratuito y de código abierto funciona indefinidamente sin coste, y Server Pro añade además una consola web, grupos de dispositivos y un generador de clientes personalizados. Ambos se instalan en una VM Linux normal o en un host físico (bare-metal).'
metadata: metadata:
description: 'RustDesk en Linux, de principio a fin: opciones de paquetes para cada distribución y placa ARM, captura en Wayland y X11, configuración headless y cómo ejecutar tu propio servidor.' description: 'RustDesk en Linux, de principio a fin: opciones de paquetes para cada distribución y placa ARM, captura en Wayland y X11, y cómo ejecutar tu propio servidor.'
keywords: 'RustDesk para Linux, RustDesk Ubuntu, RustDesk Wayland, RustDesk X11, instalar RustDesk en Linux' keywords: 'RustDesk para Linux, RustDesk Ubuntu, RustDesk Wayland, RustDesk X11, instalar RustDesk en Linux'
--- ---
Los usuarios de Linux nunca han tenido una gran variedad de buenas herramientas de escritorio remoto, y las que existen suelen ser productos comerciales de código cerrado o anticuadas soluciones basadas en VNC. RustDesk ocupa un lugar distinto: es un cliente de escritorio remoto de código abierto con licencia AGPL, funciona de forma nativa en todas las distribuciones principales, y puedes apuntarlo a un servidor alojado por ti mismo. Esa combinación —código auditable, cliente nativo para Linux e infraestructura que puedes alojar tú mismo— es la razón por la que RustDesk se ha convertido en una de las respuestas de referencia cuando alguien busca un escritorio remoto de código abierto para Linux. Los usuarios de Linux nunca han tenido una gran variedad de buenas herramientas de escritorio remoto, y las que existen suelen ser productos comerciales de código cerrado o anticuadas soluciones basadas en VNC. RustDesk ocupa un lugar distinto: es un cliente de escritorio remoto de código abierto con licencia AGPL, funciona de forma nativa en todas las distribuciones principales, y puedes apuntarlo a un servidor alojado por ti mismo. Esa combinación —código auditable, cliente nativo para Linux e infraestructura que puedes alojar tú mismo— es la razón por la que RustDesk se ha convertido en una de las respuestas de referencia cuando alguien busca un escritorio remoto de código abierto para Linux.
Esta guía explica cómo instalarlo, el aspecto que suele confundir a todo el mundo (X11 frente a Wayland), cómo lograr que funcionen el acceso desatendido y headless, y qué papel juega el servidor en todo esto. Esta guía explica cómo instalarlo, el aspecto que suele confundir a todo el mundo (X11 frente a Wayland), cómo lograr que funcione el acceso desatendido y qué papel juega el servidor en todo esto.
## Instalación de RustDesk en Linux ## Instalación de RustDesk en Linux
@@ -53,7 +51,7 @@ Esto es lo más importante que hay que entender sobre RustDesk en Linux, porque
**Wayland: es posible que RustDesk tenga el soporte más sólido de cualquier herramienta de escritorio remoto.** RustDesk es compatible con Wayland desde la versión 1.2.0 y no ha dejado de ampliar ese soporte. Como los compositores de Wayland no permiten el acceso directo al framebuffer, RustDesk captura la pantalla a través del servicio `xdg-desktop-portal` y [PipeWire](https://deepwiki.com/rustdesk/rustdesk/6.3.1-wayland-support), e inyecta la entrada mediante el módulo `uinput` del kernel. De este diseño propio de Wayland se derivan dos consecuencias, que se aplican a cualquier herramienta de compartición de pantalla en Wayland, no solo a RustDesk: **Wayland: es posible que RustDesk tenga el soporte más sólido de cualquier herramienta de escritorio remoto.** RustDesk es compatible con Wayland desde la versión 1.2.0 y no ha dejado de ampliar ese soporte. Como los compositores de Wayland no permiten el acceso directo al framebuffer, RustDesk captura la pantalla a través del servicio `xdg-desktop-portal` y [PipeWire](https://deepwiki.com/rustdesk/rustdesk/6.3.1-wayland-support), e inyecta la entrada mediante el módulo `uinput` del kernel. De este diseño propio de Wayland se derivan dos consecuencias, que se aplican a cualquier herramienta de compartición de pantalla en Wayland, no solo a RustDesk:
- **Consentimiento por conexión.** El portal muestra un cuadro de diálogo que te pide seleccionar qué pantalla compartir. Se trata de una característica de seguridad deliberada de Wayland, no de un fallo de RustDesk: una aplicación en segundo plano no puede empezar a grabar tu pantalla de forma silenciosa. El portal v4 y versiones posteriores admiten un «token de restauración» para que no se te vuelva a pedir confirmación cada vez, pero la primera compartición requiere un clic en pantalla. - **Consentimiento por conexión.** El portal muestra un cuadro de diálogo que te pide seleccionar qué pantalla compartir. Se trata de una característica de seguridad deliberada de Wayland, no de un fallo de RustDesk: una aplicación en segundo plano no puede empezar a grabar tu pantalla de forma silenciosa. El portal v4 y versiones posteriores admiten un «token de restauración» para que no se te vuelva a pedir confirmación cada vez, pero la primera compartición requiere un clic en pantalla.
- **Solo sesión activa.** La captura en Wayland está ligada a la sesión gráfica con el usuario conectado. Capturar la pantalla de bienvenida (greeter) de Wayland aún no es compatible; está en desarrollo activo ([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). Para acceso previo al inicio de sesión, utiliza por ahora la configuración headless/pantalla virtual que se explica más abajo, o una sesión X11 en las distribuciones que todavía la ofrezcan. - **Solo sesión activa.** La captura en Wayland está ligada a la sesión gráfica con el usuario conectado. Capturar la pantalla de bienvenida (greeter) de Wayland aún no es compatible; está en desarrollo activo ([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). Para acceso previo al inicio de sesión, utiliza por ahora una sesión X11 en las distribuciones que todavía la ofrezcan.
El soporte de Wayland no deja de mejorar: RustDesk 1.4.3 (octubre de 2025), por ejemplo, [añadió la compartición multimonitor para Wayland](https://ubuntuhandbook.org/index.php/2025/10/rustdesk-released-1-4-3-with-multi-monitor-for-wayland-virtual-mouse/). Pero si te conectas y ves una pantalla en negro en un equipo con Wayland, casi siempre se debe a que no se cumple correctamente la vía del portal/PipeWire. Nuestro artículo específico sobre [RustDesk conectado pero esperando la imagen](/es/blog/rustdesk-conectado-esperando-imagen-guia-completa-de-solucion) repasa en detalle el caso de pantalla en negro en Wayland. El soporte de Wayland no deja de mejorar: RustDesk 1.4.3 (octubre de 2025), por ejemplo, [añadió la compartición multimonitor para Wayland](https://ubuntuhandbook.org/index.php/2025/10/rustdesk-released-1-4-3-with-multi-monitor-for-wayland-virtual-mouse/). Pero si te conectas y ves una pantalla en negro en un equipo con Wayland, casi siempre se debe a que no se cumple correctamente la vía del portal/PipeWire. Nuestro artículo específico sobre [RustDesk conectado pero esperando la imagen](/es/blog/rustdesk-conectado-esperando-imagen-guia-completa-de-solucion) repasa en detalle el caso de pantalla en negro en Wayland.
@@ -63,21 +61,15 @@ El acceso desatendido significa conectarse a un equipo sin que haya nadie sentad
1. Instala mediante `.deb` o `.rpm` para que se registre el servicio systemd, o haz clic en **Habilitar servicio** dentro de la aplicación. 1. Instala mediante `.deb` o `.rpm` para que se registre el servicio systemd, o haz clic en **Habilitar servicio** dentro de la aplicación.
2. En RustDesk, define una **contraseña permanente** segura en la configuración de conexión (e, idealmente, activa la autenticación de dos factores). 2. En RustDesk, define una **contraseña permanente** segura en la configuración de conexión (e, idealmente, activa la autenticación de dos factores).
3. Para acceder antes del inicio de sesión o entre distintas sesiones de usuario, utiliza la configuración headless con pantalla virtual que se explica más abajo (aquí se aplica la limitación de la pantalla de bienvenida de Wayland mencionada antes).
Una realidad de Wayland que conviene prever: el portal basado en consentimiento descrito en la sección de Wayland hace que la captura totalmente desatendida sea más difícil que en X11, al menos hasta que llegue el soporte desatendido que está en desarrollo. Así que, para equipos sin intervención humana, cuenta con la configuración headless de pantalla virtual.
## Linux headless: servidores sin monitor ## Linux headless: servidores sin monitor
Un caso de uso muy habitual en Linux es un equipo sin ninguna pantalla conectada: un servidor doméstico, una máquina de laboratorio, una VM. Aquí el problema no es RustDesk, sino la pila gráfica: sin un monitor conectado, X o Wayland nunca asignan un framebuffer, así que literalmente no hay ninguna imagen que capturar y obtienes una pantalla en negro. Un caso de uso muy habitual en Linux es un equipo sin ninguna pantalla conectada: un servidor doméstico, una máquina de laboratorio, una VM. Aquí el problema no es RustDesk, sino la pila gráfica: sin un monitor conectado, X o Wayland nunca asignan un framebuffer, así que literalmente no hay ninguna imagen que capturar y obtienes una pantalla en negro.
Hay tres formas de darle algo que renderizar: Hay dos formas de darle algo que renderizar:
- **Un conector ficticio (dummy plug)**: un adaptador físico económico HDMI/DisplayPort «headless» que hace creer a la GPU que hay un monitor conectado. - **Un conector ficticio (dummy plug)**: un adaptador físico económico HDMI/DisplayPort «headless» que hace creer a la GPU que hay un monitor conectado.
- **Un controlador de pantalla virtual**: `xserver-xorg-video-dummy` en X11, o una opción a nivel de kernel como VKMS. - **Un controlador de pantalla virtual**: `xserver-xorg-video-dummy` en X11, o una opción a nivel de kernel como VKMS.
- **El modo headless opcional de RustDesk**: actívalo con `sudo rustdesk --option allow-linux-headless Y`. Según la [wiki de soporte de Linux headless](https://github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support), está desactivado de forma predeterminada, se prueba principalmente en Ubuntu con GNOME, y requiere paquetes como `xserver-xorg-video-dummy` y `lightdm`. Puedes obtener el ID del equipo con `sudo rustdesk --get-id` y establecer una contraseña con `sudo rustdesk --password <password>`.
El modo headless todavía tiene algunas asperezas, así que considéralo como «funciona, con cuidado» más que como una solución llave en mano.
## Alojamiento propio del servidor de RustDesk en Linux ## Alojamiento propio del servidor de RustDesk en Linux
@@ -58,7 +58,7 @@ Una vez que RustDesk se ejecuta como servicio, se carga antes de que nadie inici
| ---------- | -------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ---------- | -------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Windows | Instálalo; mantén el servicio en ejecución (se inicia con el equipo) | El exe portátil se desconecta al cerrar sesión/UAC; usa el instalador | | Windows | Instálalo; mantén el servicio en ejecución (se inicia con el equipo) | El exe portátil se desconecta al cerrar sesión/UAC; usa el instalador |
| macOS | Instálalo, establece la contraseña permanente, concede los permisos | Deben concederse Grabación de Pantalla y Accesibilidad; la captura en la pantalla de inicio de sesión necesita el helper instalado | | macOS | Instálalo, establece la contraseña permanente, concede los permisos | Deben concederse Grabación de Pantalla y Accesibilidad; la captura en la pantalla de inicio de sesión necesita el helper instalado |
| Linux | Instala el paquete del servicio | Wayland necesita una sesión activa; para el acceso previo al inicio de sesión usa la configuración de pantalla virtual sin interfaz gráfica, o X11 donde una distribución todavía lo ofrezca | | Linux | Instala el paquete del servicio | Wayland necesita una sesión activa; para el acceso previo al inicio de sesión usa X11 donde una distribución todavía lo ofrezca |
| Android | Establece la contraseña permanente; habilita la captura | La pantalla debe estar activa; concede el consentimiento de captura de pantalla (MediaProjection) y el permiso de entrada | | Android | Establece la contraseña permanente; habilita la captura | La pantalla debe estar activa; concede el consentimiento de captura de pantalla (MediaProjection) y el permiso de entrada |
### Windows ### Windows
@@ -71,7 +71,7 @@ macOS restringe la captura de pantalla y la entrada detrás de permisos. Despué
### Linux ### Linux
Instala RustDesk para que su componente de servicio se ejecute al arrancar. En un equipo que permanece en la pantalla de bienvenida de inicio de sesión, Wayland todavía no puede capturar esa pantalla —una limitación de diseño de Wayland (no de RustDesk) que el equipo de RustDesk está trabajando activamente para resolver ([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). En un equipo sin interfaz gráfica (headless), usa la configuración de pantalla virtual; en un equipo de escritorio, una sesión X11/Xorg todavía se encarga de ello donde una distribución ofrezca una, aunque varias se están moviendo exclusivamente a Wayland. Consulta [RustDesk para Linux](/es/blog/rustdesk-para-linux-el-escritorio-remoto-de-codigo-abierto) para más detalles. Instala RustDesk para que su componente de servicio se ejecute al arrancar. En un equipo que permanece en la pantalla de bienvenida de inicio de sesión, Wayland todavía no puede capturar esa pantalla —una limitación de diseño de Wayland (no de RustDesk) que el equipo de RustDesk está trabajando activamente para resolver ([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). En un equipo de escritorio, una sesión X11/Xorg todavía se encarga de ello donde una distribución ofrezca una, aunque varias se están moviendo exclusivamente a Wayland. Consulta [RustDesk para Linux](/es/blog/rustdesk-para-linux-el-escritorio-remoto-de-codigo-abierto) para más detalles.
## Paso 3: Despliega a gran escala con un cliente preconfigurado ## Paso 3: Despliega a gran escala con un cliente preconfigurado
@@ -14,7 +14,7 @@ faq:
- question: 'Pourquoi RustDesk affiche-t-il « Connected, waiting for image » ?' - question: 'Pourquoi RustDesk affiche-t-il « Connected, waiting for image » ?'
answer: "La session s'est établie avec succès, mais la machine distante ne produit aucune image d'écran à envoyer. La cause la plus fréquente est l'absence d'affichage actif à capturer — un serveur headless sans moniteur, un écran passé en veille ou verrouillé, ou un affichage que le système d'exploitation refuse de laisser RustDesk enregistrer. Corrigez la source de capture et l'image apparaît." answer: "La session s'est établie avec succès, mais la machine distante ne produit aucune image d'écran à envoyer. La cause la plus fréquente est l'absence d'affichage actif à capturer — un serveur headless sans moniteur, un écran passé en veille ou verrouillé, ou un affichage que le système d'exploitation refuse de laisser RustDesk enregistrer. Corrigez la source de capture et l'image apparaît."
- question: 'Comment résoudre le « waiting for image » de RustDesk sur un ordinateur headless ?' - question: 'Comment résoudre le « waiting for image » de RustDesk sur un ordinateur headless ?'
answer: "Une machine sans moniteur n'a aucun framebuffer à capturer, donc RustDesk n'a rien à envoyer. Branchez un véritable moniteur, installez un adaptateur HDMI factice (dummy plug) peu coûteux qui fait croire au GPU qu'un écran est connecté, ou, sous Linux, utilisez la configuration headless documentée (github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support). Réveiller l'écran ou l'empêcher de se mettre en veille résout la plupart des cas." answer: "Une machine sans moniteur n'a aucun framebuffer à capturer, donc RustDesk n'a rien à envoyer. Branchez un véritable moniteur ou installez un adaptateur HDMI factice (dummy plug) peu coûteux qui fait croire au GPU qu'un écran est connecté. Réveiller l'écran ou l'empêcher de se mettre en veille résout la plupart des cas."
- question: "Changer le codec vidéo permet-il de corriger l'écran noir ?" - question: "Changer le codec vidéo permet-il de corriger l'écran noir ?"
answer: "Souvent, oui. Dans la barre d'outils de la session distante ou dans les paramètres, vous pouvez changer de codec — VP8, VP9, AV1, ou H.264/H.265 lorsque le matériel le permet. Un codec que le matériel distant ne peut pas encoder affichera une image vide ou figée, et revenir à un codec logiciel comme VP9 rétablit généralement l'image." answer: "Souvent, oui. Dans la barre d'outils de la session distante ou dans les paramètres, vous pouvez changer de codec — VP8, VP9, AV1, ou H.264/H.265 lorsque le matériel le permet. Un codec que le matériel distant ne peut pas encoder affichera une image vide ou figée, et revenir à un codec logiciel comme VP9 rétablit généralement l'image."
- question: "RustDesk affiche l'image sur un PC mais pas sur un autre. Pourquoi ?" - question: "RustDesk affiche l'image sur un PC mais pas sur un autre. Pourquoi ?"
@@ -37,11 +37,10 @@ La session est connectée, mais il n'y a aucun framebuffer à capturer. Sur une
La cause la plus signalée, de loin, est une **machine headless** — un serveur, un mini-PC ou une station de travail fonctionnant sans moniteur branché, ou avec l'affichage en veille. Sans affichage actif, le GPU ne produit aucun framebuffer, donc RustDesk se connecte mais n'a rien à envoyer. Ce schéma revient sans cesse dans le suivi des problèmes de RustDesk, y compris des [signalements d'écrans noirs précisément lorsque le moniteur de la cible est éteint](https://github.com/rustdesk/rustdesk/issues/9884) et le [fil de discussion « Connected, waiting for image »](https://github.com/rustdesk/rustdesk/issues/222), qui dure depuis longtemps. La cause la plus signalée, de loin, est une **machine headless** — un serveur, un mini-PC ou une station de travail fonctionnant sans moniteur branché, ou avec l'affichage en veille. Sans affichage actif, le GPU ne produit aucun framebuffer, donc RustDesk se connecte mais n'a rien à envoyer. Ce schéma revient sans cesse dans le suivi des problèmes de RustDesk, y compris des [signalements d'écrans noirs précisément lorsque le moniteur de la cible est éteint](https://github.com/rustdesk/rustdesk/issues/9884) et le [fil de discussion « Connected, waiting for image »](https://github.com/rustdesk/rustdesk/issues/222), qui dure depuis longtemps.
Trois façons de lui donner quelque chose à capturer : Deux façons de lui donner quelque chose à capturer :
- **Branchez un moniteur** et assurez-vous qu'il est allumé et actif. - **Branchez un moniteur** et assurez-vous qu'il est allumé et actif.
- **Utilisez un adaptateur HDMI (ou DisplayPort) factice.** Ces adaptateurs peu coûteux font croire au GPU qu'un écran est connecté, ce qui le pousse à continuer de générer un framebuffer que RustDesk peut capturer. C'est la solution standard pour les postes headless et les serveurs personnels. - **Utilisez un adaptateur HDMI (ou DisplayPort) factice.** Ces adaptateurs peu coûteux font croire au GPU qu'un écran est connecté, ce qui le pousse à continuer de générer un framebuffer que RustDesk peut capturer. C'est la solution standard pour les postes headless et les serveurs personnels.
- **Sous Linux, utilisez le chemin headless documenté.** RustDesk prend en charge les postes Linux headless, mais la configuration diffère d'une session de bureau normale — voir le [wiki Headless Linux Support](https://github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support).
Si un moniteur _est_ bien branché, le prochain suspect est qu'il s'est mis en veille. Si un moniteur _est_ bien branché, le prochain suspect est qu'il s'est mis en veille.
@@ -49,7 +48,7 @@ Si un moniteur _est_ bien branché, le prochain suspect est qu'il s'est mis en v
| Cause | Symptôme | Solution | | Cause | Symptôme | Solution |
| --------------------------------- | -------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | --------------------------------- | -------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Headless / pas d'affichage | Écran noir sur un serveur ou un mini-PC | Branchez un moniteur, ajoutez un adaptateur HDMI factice, ou utilisez le chemin headless Linux | | Headless / pas d'affichage | Écran noir sur un serveur ou un mini-PC | Branchez un moniteur ou ajoutez un adaptateur HDMI factice |
| Écran en veille / verrouillé | Fonctionnait avant, noir après inactivité | Réveillez l'écran ; désactivez la veille/l'économiseur d'écran ; sous macOS, empêchez la mise en veille de l'affichage dans les Réglages | | Écran en veille / verrouillé | Fonctionnait avant, noir après inactivité | Réveillez l'écran ; désactivez la veille/l'économiseur d'écran ; sous macOS, empêchez la mise en veille de l'affichage dans les Réglages |
| Autorisation manquante (macOS) | Se connecte, écran noir permanent | Accordez l'enregistrement d'écran dans Confidentialité et sécurité ; installez l'assistant pour l'écran de connexion | | Autorisation manquante (macOS) | Se connecte, écran noir permanent | Accordez l'enregistrement d'écran dans Confidentialité et sécurité ; installez l'assistant pour l'écran de connexion |
| Incompatibilité de codec | Image vide ou figée | Changez de codec (VP8 / VP9 / AV1 / H.264 / H.265) ; revenez à un codec logiciel | | Incompatibilité de codec | Image vide ou figée | Changez de codec (VP8 / VP9 / AV1 / H.264 / H.265) ; revenez à un codec logiciel |
@@ -83,7 +82,7 @@ Certains GPU — les configurations NVIDIA reviennent le plus souvent — entren
### Linux et Wayland ### Linux et Wayland
Sous Linux, **la capture d'écran Wayland passe par PipeWire et le `xdg-desktop-portal`** : il demande le consentement pour choisir un affichage la première fois — dans la plupart des cas, le choix est mémorisé, donc l'invite ne réapparaît pas — et fonctionne au sein d'une session de connexion active. Il s'agit d'une conception de sécurité propre à Wayland, qui ne couvre donc pas, par nature, l'écran de connexion (greeter) ni une machine véritablement headless — même si la capture Wayland sans surveillance est en développement actif ([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). Si vous obtenez un écran vide sous Wayland, la solution consiste généralement à accepter l'invite de partage d'écran du portail et à vérifier que `xdg-desktop-portal` et PipeWire sont installés et en cours d'exécution ; sur une machine headless, utilisez la [configuration headless](https://github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support) documentée. Se connecter à une session X11/Xorg évite aussi le chemin du portail, là où une distribution en propose encore une — mais comme de nombreuses distributions passent au tout-Wayland, corriger le chemin portail/PipeWire est l'approche la plus pérenne. Sous Linux, **la capture d'écran Wayland passe par PipeWire et le `xdg-desktop-portal`** : il demande le consentement pour choisir un affichage la première fois — dans la plupart des cas, le choix est mémorisé, donc l'invite ne réapparaît pas — et fonctionne au sein d'une session de connexion active. Il s'agit d'une conception de sécurité propre à Wayland, qui ne couvre donc pas, par nature, l'écran de connexion (greeter) — même si la capture Wayland sans surveillance est en développement actif ([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). Si vous obtenez un écran vide sous Wayland, la solution consiste généralement à accepter l'invite de partage d'écran du portail et à vérifier que `xdg-desktop-portal` et PipeWire sont installés et en cours d'exécution. Se connecter à une session X11/Xorg évite aussi le chemin du portail, là où une distribution en propose encore une — mais comme de nombreuses distributions passent au tout-Wayland, corriger le chemin portail/PipeWire est l'approche la plus pérenne.
### Réseau et relais ### Réseau et relais
+6 -14
View File
@@ -4,7 +4,7 @@ lang: 'fr'
translationKey: 'rustdesk-for-linux' translationKey: 'rustdesk-for-linux'
draft: false draft: false
title: 'RustDesk pour Linux : le bureau à distance open source' title: 'RustDesk pour Linux : le bureau à distance open source'
excerpt: 'Installez et exécutez RustDesk sur Linux : .deb, .rpm, Flatpak et AppImage, X11 face à Wayland, accès headless et sans surveillance, et auto-hébergement du serveur.' excerpt: 'Installez et exécutez RustDesk sur Linux : .deb, .rpm, Flatpak et AppImage, X11 face à Wayland, accès sans surveillance et auto-hébergement du serveur.'
image: '~/assets/images/blog/rustdesk-for-linux-og.webp' image: '~/assets/images/blog/rustdesk-for-linux-og.webp'
category: 'Guides' category: 'Guides'
tags: ['RustDesk', 'Linux', 'Auto-hébergement'] tags: ['RustDesk', 'Linux', 'Auto-hébergement']
@@ -12,21 +12,19 @@ author: 'RustDesk Team'
slug: 'rustdesk-pour-linux-le-bureau-a-distance-open-source' slug: 'rustdesk-pour-linux-le-bureau-a-distance-open-source'
faq: faq:
- question: 'RustDesk fonctionne-t-il sous Wayland ?' - question: 'RustDesk fonctionne-t-il sous Wayland ?'
answer: "Oui — RustDesk offre l'un des meilleurs niveaux de prise en charge de Wayland parmi les outils de bureau à distance, avec notamment le partage multi-écrans ajouté dans la version 1.4.3. Sous Wayland, RustDesk capture l'écran via PipeWire et le portail de bureau XDG, qui affiche une boîte de dialogue de consentement pour choisir un écran — dans la plupart des cas, ce choix est mémorisé et il ne vous sera plus redemandé — et fonctionne au sein de la session graphique active. Cette étape de consentement fait partie de la conception sécuritaire de Wayland, commune à toutes les applications de partage d'écran. Pour un accès avant connexion ou totalement sans surveillance, utilisez aujourd'hui la configuration d'affichage virtuel headless (ou une session X11 lorsque votre distribution en propose encore une, car plusieurs migrent désormais exclusivement vers Wayland) ; la capture Wayland totalement sans surveillance est en cours de développement actif (voir github.com/rustdesk/rustdesk/pull/15420)." answer: "Oui — RustDesk offre l'un des meilleurs niveaux de prise en charge de Wayland parmi les outils de bureau à distance, avec notamment le partage multi-écrans ajouté dans la version 1.4.3. Sous Wayland, RustDesk capture l'écran via PipeWire et le portail de bureau XDG, qui affiche une boîte de dialogue de consentement pour choisir un écran — dans la plupart des cas, ce choix est mémorisé et il ne vous sera plus redemandé — et fonctionne au sein de la session graphique active. Cette étape de consentement fait partie de la conception sécuritaire de Wayland, commune à toutes les applications de partage d'écran. Pour un accès avant connexion ou totalement sans surveillance, utilisez aujourd'hui une session X11 lorsque votre distribution en propose encore une, car plusieurs migrent désormais exclusivement vers Wayland ; la capture Wayland totalement sans surveillance est en cours de développement actif (voir github.com/rustdesk/rustdesk/pull/15420)."
- question: 'Quel paquet dois-je installer sur Linux ?' - question: 'Quel paquet dois-je installer sur Linux ?'
answer: "Utilisez le .deb sur Debian, Ubuntu et Linux Mint, le .rpm sur Fedora, RHEL et openSUSE, le Flatpak depuis Flathub pour une version isolée (sandboxée) et largement compatible, ou l'AppImage portable comme solution de repli en un seul fichier. Les paquets .deb et .rpm enregistrent et démarrent un service systemd afin que RustDesk survive aux redémarrages ; le Flatpak et l'AppImage ne le font pas par défaut." answer: "Utilisez le .deb sur Debian, Ubuntu et Linux Mint, le .rpm sur Fedora, RHEL et openSUSE, le Flatpak depuis Flathub pour une version isolée (sandboxée) et largement compatible, ou l'AppImage portable comme solution de repli en un seul fichier. Les paquets .deb et .rpm enregistrent et démarrent un service systemd afin que RustDesk survive aux redémarrages ; le Flatpak et l'AppImage ne le font pas par défaut."
- question: 'Pourquoi ma machine Linux headless affiche-t-elle un écran noir ?'
answer: "Sans moniteur branché, X ou Wayland n'alloue jamais de framebuffer : il n'y a donc rien que RustDesk puisse capturer, et le visualiseur affiche un écran noir ou un message d'attente d'image. Branchez un faux connecteur HDMI/DisplayPort (dummy plug), configurez un affichage virtuel tel que xserver-xorg-video-dummy ou VKMS, ou activez le mode headless optionnel de RustDesk pour Linux afin qu'un affichage virtuel soit créé automatiquement pour vous."
- question: 'Puis-je auto-héberger le serveur RustDesk sur Linux ?' - question: 'Puis-je auto-héberger le serveur RustDesk sur Linux ?'
answer: "Oui. Le serveur RustDesk (les processus hbbs pour l'ID/rendez-vous et hbbr pour le relais) est conçu pour Linux, et c'est la manière standard de l'exécuter. Le serveur communautaire, gratuit et open source, fonctionne indéfiniment sans frais, tandis que Server Pro ajoute une console web, des groupes d'appareils et un générateur de client personnalisé. Les deux s'installent sur une simple VM Linux ou un serveur physique (bare-metal)." answer: "Oui. Le serveur RustDesk (les processus hbbs pour l'ID/rendez-vous et hbbr pour le relais) est conçu pour Linux, et c'est la manière standard de l'exécuter. Le serveur communautaire, gratuit et open source, fonctionne indéfiniment sans frais, tandis que Server Pro ajoute une console web, des groupes d'appareils et un générateur de client personnalisé. Les deux s'installent sur une simple VM Linux ou un serveur physique (bare-metal)."
metadata: metadata:
description: 'RustDesk sur Linux, de bout en bout : choix des paquets pour chaque distribution et carte ARM, capture Wayland et X11, configuration headless, et hébergement de votre propre serveur.' description: 'RustDesk sur Linux, de bout en bout : choix des paquets pour chaque distribution et carte ARM, capture Wayland et X11, et hébergement de votre propre serveur.'
keywords: 'RustDesk pour Linux, RustDesk Ubuntu, RustDesk Wayland, RustDesk X11, installation RustDesk Linux' keywords: 'RustDesk pour Linux, RustDesk Ubuntu, RustDesk Wayland, RustDesk X11, installation RustDesk Linux'
--- ---
Les utilisateurs de Linux n'ont jamais eu un grand choix de bons outils de bureau à distance, et ceux qui existent sont généralement soit des produits commerciaux à code source fermé, soit des piles VNC vieillissantes. RustDesk se démarque : c'est un client de bureau à distance open source sous licence AGPL, qui fonctionne nativement sur toutes les principales distributions, et que vous pouvez connecter à un serveur que vous hébergez vous-même. Cette combinaison — code auditable, client Linux natif et infrastructure auto-hébergeable — explique pourquoi RustDesk est devenu l'une des réponses de référence lorsqu'on cherche un bureau à distance open source pour Linux. Les utilisateurs de Linux n'ont jamais eu un grand choix de bons outils de bureau à distance, et ceux qui existent sont généralement soit des produits commerciaux à code source fermé, soit des piles VNC vieillissantes. RustDesk se démarque : c'est un client de bureau à distance open source sous licence AGPL, qui fonctionne nativement sur toutes les principales distributions, et que vous pouvez connecter à un serveur que vous hébergez vous-même. Cette combinaison — code auditable, client Linux natif et infrastructure auto-hébergeable — explique pourquoi RustDesk est devenu l'une des réponses de référence lorsqu'on cherche un bureau à distance open source pour Linux.
Ce guide explique comment l'installer, le point qui pose problème à presque tout le monde (X11 face à Wayland), comment faire fonctionner l'accès sans surveillance et headless, et quelle est la place du serveur dans tout cela. Ce guide explique comment l'installer, le point qui pose problème à presque tout le monde (X11 face à Wayland), comment faire fonctionner l'accès sans surveillance et quelle est la place du serveur dans tout cela.
## Installer RustDesk sur Linux ## Installer RustDesk sur Linux
@@ -53,7 +51,7 @@ C'est l'élément le plus important à comprendre à propos de RustDesk sur Linu
**Wayland : RustDesk offre sans doute la meilleure prise en charge de tous les outils de bureau à distance.** RustDesk prend en charge Wayland depuis la version 1.2.0 et n'a cessé de l'étendre depuis. Comme les compositeurs Wayland n'autorisent pas l'accès direct au framebuffer, RustDesk capture l'écran via le service `xdg-desktop-portal` et [PipeWire](https://deepwiki.com/rustdesk/rustdesk/6.3.1-wayland-support), et injecte les entrées via le module noyau `uinput`. Deux conséquences découlent de la conception même de Wayland — et elles s'appliquent à tout outil de partage d'écran sous Wayland, pas seulement à RustDesk : **Wayland : RustDesk offre sans doute la meilleure prise en charge de tous les outils de bureau à distance.** RustDesk prend en charge Wayland depuis la version 1.2.0 et n'a cessé de l'étendre depuis. Comme les compositeurs Wayland n'autorisent pas l'accès direct au framebuffer, RustDesk capture l'écran via le service `xdg-desktop-portal` et [PipeWire](https://deepwiki.com/rustdesk/rustdesk/6.3.1-wayland-support), et injecte les entrées via le module noyau `uinput`. Deux conséquences découlent de la conception même de Wayland — et elles s'appliquent à tout outil de partage d'écran sous Wayland, pas seulement à RustDesk :
- **Consentement à chaque connexion.** Le portail affiche une boîte de dialogue vous demandant de choisir l'écran à partager. Il s'agit d'une fonctionnalité de sécurité délibérée de Wayland, pas d'un bug de RustDesk — une application en arrière-plan ne peut pas se mettre à enregistrer votre écran en silence. Le portail v4 et les versions ultérieures prennent en charge un « jeton de restauration » (restore token) pour éviter d'être sollicité à chaque fois, mais le tout premier partage nécessite un clic à l'écran. - **Consentement à chaque connexion.** Le portail affiche une boîte de dialogue vous demandant de choisir l'écran à partager. Il s'agit d'une fonctionnalité de sécurité délibérée de Wayland, pas d'un bug de RustDesk — une application en arrière-plan ne peut pas se mettre à enregistrer votre écran en silence. Le portail v4 et les versions ultérieures prennent en charge un « jeton de restauration » (restore token) pour éviter d'être sollicité à chaque fois, mais le tout premier partage nécessite un clic à l'écran.
- **Session active uniquement.** La capture Wayland est liée à la session graphique où l'utilisateur est connecté. La capture de l'écran de connexion (greeter) Wayland n'est pas encore prise en charge — elle est en cours de développement actif ([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). Pour un accès avant connexion dès aujourd'hui, utilisez la configuration headless/affichage virtuel ci-dessous, ou une session X11 sur les distributions qui en proposent encore une. - **Session active uniquement.** La capture Wayland est liée à la session graphique où l'utilisateur est connecté. La capture de l'écran de connexion (greeter) Wayland n'est pas encore prise en charge — elle est en cours de développement actif ([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). Pour un accès avant connexion dès aujourd'hui, utilisez une session X11 sur les distributions qui en proposent encore une.
La prise en charge de Wayland continue de s'améliorer — RustDesk 1.4.3 (octobre 2025) a par exemple [ajouté le partage multi-écrans pour Wayland](https://ubuntuhandbook.org/index.php/2025/10/rustdesk-released-1-4-3-with-multi-monitor-for-wayland-virtual-mouse/). Mais si vous vous connectez et voyez un écran noir sur une machine Wayland, c'est presque toujours parce que le chemin portail/PipeWire n'est pas satisfait. Notre article dédié [RustDesk connecté mais en attente d'image](/fr/blog/rustdesk-connected-waiting-for-image-guide-de-depannage-complet) détaille spécifiquement le cas de l'écran noir sous Wayland. La prise en charge de Wayland continue de s'améliorer — RustDesk 1.4.3 (octobre 2025) a par exemple [ajouté le partage multi-écrans pour Wayland](https://ubuntuhandbook.org/index.php/2025/10/rustdesk-released-1-4-3-with-multi-monitor-for-wayland-virtual-mouse/). Mais si vous vous connectez et voyez un écran noir sur une machine Wayland, c'est presque toujours parce que le chemin portail/PipeWire n'est pas satisfait. Notre article dédié [RustDesk connecté mais en attente d'image](/fr/blog/rustdesk-connected-waiting-for-image-guide-de-depannage-complet) détaille spécifiquement le cas de l'écran noir sous Wayland.
@@ -63,21 +61,15 @@ L'accès sans surveillance consiste à se connecter à une machine sans personne
1. Installez via `.deb` ou `.rpm` afin que le service systemd soit enregistré, ou cliquez sur **Activer le service** dans l'application. 1. Installez via `.deb` ou `.rpm` afin que le service systemd soit enregistré, ou cliquez sur **Activer le service** dans l'application.
2. Dans RustDesk, définissez un **mot de passe permanent** robuste dans les paramètres de connexion (et activez idéalement l'authentification à deux facteurs). 2. Dans RustDesk, définissez un **mot de passe permanent** robuste dans les paramètres de connexion (et activez idéalement l'authentification à deux facteurs).
3. Pour un accès avant ou entre les connexions utilisateur, utilisez la configuration d'affichage virtuel headless ci-dessous (la limite concernant l'écran de connexion Wayland évoquée plus haut s'applique ici).
Une réalité de Wayland à anticiper : le portail basé sur le consentement décrit dans la section Wayland rend la capture totalement sans surveillance plus difficile que sous X11, tant que la prise en charge en développement n'est pas disponible. Prévoyez donc la configuration d'affichage virtuel headless pour les machines qui doivent fonctionner sans aucune intervention.
## Linux headless : des serveurs sans moniteur ## Linux headless : des serveurs sans moniteur
Un cas d'usage très courant sous Linux est celui d'une machine sans aucun écran connecté — un serveur personnel, une machine de laboratoire, une VM. Ici, le problème ne vient pas de RustDesk mais de la pile graphique : sans moniteur branché, X ou Wayland n'alloue jamais de framebuffer, il n'y a donc littéralement aucune image à capturer, d'où l'écran noir. Un cas d'usage très courant sous Linux est celui d'une machine sans aucun écran connecté — un serveur personnel, une machine de laboratoire, une VM. Ici, le problème ne vient pas de RustDesk mais de la pile graphique : sans moniteur branché, X ou Wayland n'alloue jamais de framebuffer, il n'y a donc littéralement aucune image à capturer, d'où l'écran noir.
Trois manières de lui donner quelque chose à afficher : Deux manières de lui donner quelque chose à afficher :
- **Un faux connecteur (dummy plug)** — un petit adaptateur HDMI/DisplayPort « headless » bon marché qui fait croire au GPU qu'un moniteur est branché. - **Un faux connecteur (dummy plug)** — un petit adaptateur HDMI/DisplayPort « headless » bon marché qui fait croire au GPU qu'un moniteur est branché.
- **Un pilote d'affichage virtuel**`xserver-xorg-video-dummy` sous X11, ou une option au niveau du noyau comme VKMS. - **Un pilote d'affichage virtuel**`xserver-xorg-video-dummy` sous X11, ou une option au niveau du noyau comme VKMS.
- **Le mode headless optionnel de RustDesk** — activez-le avec `sudo rustdesk --option allow-linux-headless Y`. D'après le [wiki Headless Linux Support](https://github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support), ce mode est désactivé par défaut, testé principalement sur Ubuntu avec GNOME, et nécessite des paquets comme `xserver-xorg-video-dummy` et `lightdm`. Vous pouvez récupérer l'identifiant de la machine avec `sudo rustdesk --get-id` et définir un mot de passe avec `sudo rustdesk --password <password>`.
Le mode headless a encore quelques aspérités : considérez-le comme « fonctionnel, avec précaution » plutôt que comme une solution clé en main.
## Auto-héberger le serveur RustDesk sur Linux ## Auto-héberger le serveur RustDesk sur Linux
@@ -58,7 +58,7 @@ Une fois que RustDesk s'exécute en tant que service, il se charge avant que qui
| ---------- | ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ---------- | ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Windows | Installer ; garder le service en cours d'exécution (démarre avec la machine) | L'exe portable se coupe à la déconnexion/UAC ; utilisez le programme d'installation | | Windows | Installer ; garder le service en cours d'exécution (démarre avec la machine) | L'exe portable se coupe à la déconnexion/UAC ; utilisez le programme d'installation |
| macOS | Installer, définir un mot de passe permanent, accorder les autorisations | Enregistrement de l'écran et Accessibilité doivent être accordés ; la capture à l'écran de connexion nécessite l'installation de l'assistant | | macOS | Installer, définir un mot de passe permanent, accorder les autorisations | Enregistrement de l'écran et Accessibilité doivent être accordés ; la capture à l'écran de connexion nécessite l'installation de l'assistant |
| Linux | Installer le paquet du service | Wayland nécessite une session active ; pour l'accès avant connexion, utilisez la configuration d'affichage virtuel headless, ou X11 là où une distribution en propose encore un | | Linux | Installer le paquet du service | Wayland nécessite une session active ; pour l'accès avant connexion, utilisez X11 là où une distribution en propose encore un |
| Android | Définir un mot de passe permanent ; activer la capture | L'écran doit être allumé ; accordez le consentement de capture d'écran (MediaProjection) et l'autorisation de saisie | | Android | Définir un mot de passe permanent ; activer la capture | L'écran doit être allumé ; accordez le consentement de capture d'écran (MediaProjection) et l'autorisation de saisie |
### Windows ### Windows
@@ -71,7 +71,7 @@ macOS conditionne la capture d'écran et la saisie à des autorisations. Après
### Linux ### Linux
Installez RustDesk afin que son composant de service s'exécute au démarrage. Pour une machine qui reste à l'écran d'accueil de connexion (greeter), Wayland ne peut pas encore capturer ce greeter — une limitation de conception propre à Wayland (et non une limite de RustDesk) que RustDesk s'efforce activement de résoudre ([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). Sur une machine headless, utilisez la configuration d'affichage virtuel ; sur un poste de bureau, une session X11/Xorg s'en charge encore là où une distribution en propose une, bien que plusieurs migrent désormais vers Wayland exclusivement. Consultez [RustDesk pour Linux](/fr/blog/rustdesk-pour-linux-le-bureau-a-distance-open-source) pour plus de détails. Installez RustDesk afin que son composant de service s'exécute au démarrage. Pour une machine qui reste à l'écran d'accueil de connexion (greeter), Wayland ne peut pas encore capturer ce greeter — une limitation de conception propre à Wayland (et non une limite de RustDesk) que RustDesk s'efforce activement de résoudre ([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). Sur un poste de bureau, une session X11/Xorg s'en charge encore là où une distribution en propose une, bien que plusieurs migrent désormais vers Wayland exclusivement. Consultez [RustDesk pour Linux](/fr/blog/rustdesk-pour-linux-le-bureau-a-distance-open-source) pour plus de détails.
## Étape 3 : Déployer à grande échelle avec un client préconfiguré ## Étape 3 : Déployer à grande échelle avec un client préconfiguré
@@ -14,7 +14,7 @@ faq:
- question: "Perché RustDesk mostra «Connesso, in attesa dell'immagine»?" - question: "Perché RustDesk mostra «Connesso, in attesa dell'immagine»?"
answer: "La sessione si è stabilita correttamente, ma la macchina remota non sta producendo un'immagine dello schermo da inviare. Il motivo più comune è l'assenza di un display attivo da catturare: un server headless senza monitor, uno schermo andato in sospensione o bloccato, oppure un display che il sistema operativo non permette a RustDesk di registrare. Risolvi la sorgente di acquisizione e l'immagine apparirà." answer: "La sessione si è stabilita correttamente, ma la macchina remota non sta producendo un'immagine dello schermo da inviare. Il motivo più comune è l'assenza di un display attivo da catturare: un server headless senza monitor, uno schermo andato in sospensione o bloccato, oppure un display che il sistema operativo non permette a RustDesk di registrare. Risolvi la sorgente di acquisizione e l'immagine apparirà."
- question: "Come risolvo il problema di RustDesk in attesa dell'immagine su un computer headless?" - question: "Come risolvo il problema di RustDesk in attesa dell'immagine su un computer headless?"
answer: 'Una macchina senza monitor non ha alcun framebuffer da catturare, quindi RustDesk non ha nulla da inviare. Collega un monitor reale, inserisci un economico dummy plug HDMI che fa credere alla GPU che un display sia collegato, oppure su Linux usa la configurazione headless documentata (github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support). Riattivare o mantenere attivo il display risolve la maggior parte dei casi.' answer: 'Una macchina senza monitor non ha alcun framebuffer da catturare, quindi RustDesk non ha nulla da inviare. Collega un monitor reale o inserisci un economico dummy plug HDMI che fa credere alla GPU che un display sia collegato. Riattivare o mantenere attivo il display risolve la maggior parte dei casi.'
- question: 'Cambiare il codec video risolve lo schermo nero?' - question: 'Cambiare il codec video risolve lo schermo nero?'
answer: "Spesso sì. Nella barra degli strumenti della sessione remota o nelle impostazioni puoi cambiare codec — VP8, VP9, AV1 o H.264/H.265 dove l'hardware lo supporta. Un codec che l'hardware remoto non riesce a codificare mostrerà un'immagine vuota o bloccata, e tornare a un codec software come VP9 di solito ripristina l'immagine." answer: "Spesso sì. Nella barra degli strumenti della sessione remota o nelle impostazioni puoi cambiare codec — VP8, VP9, AV1 o H.264/H.265 dove l'hardware lo supporta. Un codec che l'hardware remoto non riesce a codificare mostrerà un'immagine vuota o bloccata, e tornare a un codec software come VP9 di solito ripristina l'immagine."
- question: "RustDesk mostra l'immagine su un PC ma non su un altro. Perché?" - question: "RustDesk mostra l'immagine su un PC ma non su un altro. Perché?"
@@ -37,11 +37,10 @@ La sessione si è connessa, ma non c'è alcun framebuffer da catturare. Su una m
La causa di gran lunga più segnalata è una **macchina headless** — un server, un mini-PC o una workstation in funzione senza monitor collegato, oppure con il display in sospensione. Senza un display attivo, la GPU non produce alcun framebuffer, quindi RustDesk si connette ma non ha nulla da inviare. Questo schema ricorre ripetutamente nell'issue tracker di RustDesk, comprese le [segnalazioni di schermate nere specificamente quando il monitor del dispositivo di destinazione è spento](https://github.com/rustdesk/rustdesk/issues/9884) e la lunga discussione ["Connected, waiting for image"](https://github.com/rustdesk/rustdesk/issues/222). La causa di gran lunga più segnalata è una **macchina headless** — un server, un mini-PC o una workstation in funzione senza monitor collegato, oppure con il display in sospensione. Senza un display attivo, la GPU non produce alcun framebuffer, quindi RustDesk si connette ma non ha nulla da inviare. Questo schema ricorre ripetutamente nell'issue tracker di RustDesk, comprese le [segnalazioni di schermate nere specificamente quando il monitor del dispositivo di destinazione è spento](https://github.com/rustdesk/rustdesk/issues/9884) e la lunga discussione ["Connected, waiting for image"](https://github.com/rustdesk/rustdesk/issues/222).
Tre modi per darle qualcosa da catturare: Due modi per darle qualcosa da catturare:
- **Collega un monitor** e assicurati che sia acceso e attivo. - **Collega un monitor** e assicurati che sia acceso e attivo.
- **Usa un dummy plug HDMI (o DisplayPort).** Questi adattatori economici fanno credere alla GPU che un display sia collegato, così continua a renderizzare un framebuffer che RustDesk può catturare. È la soluzione standard per desktop headless e server domestici. - **Usa un dummy plug HDMI (o DisplayPort).** Questi adattatori economici fanno credere alla GPU che un display sia collegato, così continua a renderizzare un framebuffer che RustDesk può catturare. È la soluzione standard per desktop headless e server domestici.
- **Su Linux, segui il percorso headless documentato.** RustDesk supporta le configurazioni Linux headless, ma la configurazione differisce da una normale sessione desktop — consulta il [wiki Headless Linux Support](https://github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support).
Se un monitor _è_ effettivamente collegato, il prossimo sospettato è che sia andato in sospensione. Se un monitor _è_ effettivamente collegato, il prossimo sospettato è che sia andato in sospensione.
@@ -49,7 +48,7 @@ Se un monitor _è_ effettivamente collegato, il prossimo sospettato è che sia a
| Causa | Segnale | Soluzione | | Causa | Segnale | Soluzione |
| ----------------------------------- | ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | | ----------------------------------- | ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Headless / nessun display | Schermo nero su un server o mini-PC | Collega un monitor, aggiungi un dummy plug HDMI o usa il percorso headless su Linux | | Headless / nessun display | Schermo nero su un server o mini-PC | Collega un monitor o aggiungi un dummy plug HDMI |
| Schermo in sospensione / bloccato | Funzionava prima, nero dopo l'inattività | Riattiva lo schermo; disattiva sospensione/screensaver; su macOS blocca la sospensione del display nelle Impostazioni | | Schermo in sospensione / bloccato | Funzionava prima, nero dopo l'inattività | Riattiva lo schermo; disattiva sospensione/screensaver; su macOS blocca la sospensione del display nelle Impostazioni |
| Permesso mancante (macOS) | Si connette, nero permanente | Concedi la Registrazione dello schermo in Privacy e sicurezza; installa l'helper per la schermata di login | | Permesso mancante (macOS) | Si connette, nero permanente | Concedi la Registrazione dello schermo in Privacy e sicurezza; installa l'helper per la schermata di login |
| Codec non compatibile | Immagine vuota o bloccata | Cambia codec (VP8 / VP9 / AV1 / H.264 / H.265); torna a un codec software | | Codec non compatibile | Immagine vuota o bloccata | Cambia codec (VP8 / VP9 / AV1 / H.264 / H.265); torna a un codec software |
@@ -83,7 +82,7 @@ Alcune GPU — le configurazioni NVIDIA sono quelle che ricorrono più spesso
### Linux e Wayland ### Linux e Wayland
Su Linux, **la cattura dello schermo su Wayland passa attraverso PipeWire e `xdg-desktop-portal`**: la prima volta chiede il consenso per scegliere un display — nella maggior parte dei casi la scelta viene memorizzata, quindi non richiede più la conferma — e funziona all'interno di una sessione di accesso attiva. Si tratta di una scelta di sicurezza propria di Wayland, quindi di per sé non copre la schermata di login (greeter) né una macchina realmente headless — anche se la cattura Wayland non presidiata è in fase di sviluppo attivo ([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). Se ottieni uno schermo vuoto su Wayland, la soluzione di solito è accettare la richiesta di condivisione schermo del portal e verificare che `xdg-desktop-portal` e PipeWire siano installati e in esecuzione; su una macchina headless, usa la [configurazione headless](https://github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support) documentata. Accedere a una sessione X11/Xorg evita anche il percorso del portal, dove una distribuzione lo offre ancora — ma poiché molte distribuzioni si stanno spostando verso il solo Wayland, risolvere il percorso portal/PipeWire è l'approccio più a prova di futuro. Su Linux, **la cattura dello schermo su Wayland passa attraverso PipeWire e `xdg-desktop-portal`**: la prima volta chiede il consenso per scegliere un display — nella maggior parte dei casi la scelta viene memorizzata, quindi non richiede più la conferma — e funziona all'interno di una sessione di accesso attiva. Si tratta di una scelta di sicurezza propria di Wayland, quindi di per sé non copre la schermata di login (greeter) — anche se la cattura Wayland non presidiata è in fase di sviluppo attivo ([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). Se ottieni uno schermo vuoto su Wayland, la soluzione di solito è accettare la richiesta di condivisione schermo del portal e verificare che `xdg-desktop-portal` e PipeWire siano installati e in esecuzione. Accedere a una sessione X11/Xorg evita anche il percorso del portal, dove una distribuzione lo offre ancora — ma poiché molte distribuzioni si stanno spostando verso il solo Wayland, risolvere il percorso portal/PipeWire è l'approccio più a prova di futuro.
### Rete e relay ### Rete e relay
+6 -14
View File
@@ -4,7 +4,7 @@ lang: 'it'
translationKey: 'rustdesk-for-linux' translationKey: 'rustdesk-for-linux'
draft: false draft: false
title: 'RustDesk per Linux: il desktop remoto open source' title: 'RustDesk per Linux: il desktop remoto open source'
excerpt: 'Installa ed esegui RustDesk su Linux: .deb, .rpm, Flatpak e AppImage, X11 contro Wayland, accesso headless e non presidiato, e self-hosting del server.' excerpt: 'Installa ed esegui RustDesk su Linux: .deb, .rpm, Flatpak e AppImage, X11 contro Wayland, accesso non presidiato e self-hosting del server.'
image: '~/assets/images/blog/rustdesk-for-linux-og.webp' image: '~/assets/images/blog/rustdesk-for-linux-og.webp'
category: 'Guide' category: 'Guide'
tags: ['RustDesk', 'Linux', 'Self-hosting'] tags: ['RustDesk', 'Linux', 'Self-hosting']
@@ -12,21 +12,19 @@ author: 'RustDesk Team'
slug: 'rustdesk-per-linux-il-desktop-remoto-open-source' slug: 'rustdesk-per-linux-il-desktop-remoto-open-source'
faq: faq:
- question: 'RustDesk funziona su Wayland?' - question: 'RustDesk funziona su Wayland?'
answer: "Sì — RustDesk offre uno dei supporti Wayland più solidi tra tutti gli strumenti di desktop remoto, inclusa la condivisione multi-monitor aggiunta nella versione 1.4.3. Su Wayland cattura lo schermo tramite PipeWire e il portale desktop XDG, che mostra una finestra di dialogo per il consenso in cui scegliere quale display condividere — nella maggior parte dei casi la scelta viene ricordata, quindi non ti verrà richiesta di nuovo — e funziona all'interno della sessione grafica attiva in cui hai già effettuato l'accesso. Questo passaggio di consenso è una caratteristica di sicurezza propria di Wayland, condivisa da tutte le app di condivisione dello schermo. Per macchine che richiedono l'accesso prima del login o completamente non presidiato, oggi si usa la configurazione headless con display virtuale (oppure una sessione X11 dove una distribuzione la offre ancora, dato che diverse stanno passando a Wayland esclusivamente); il supporto completo alla cattura Wayland non presidiata è in fase di sviluppo attivo (vedi github.com/rustdesk/rustdesk/pull/15420)." answer: "Sì — RustDesk offre uno dei supporti Wayland più solidi tra tutti gli strumenti di desktop remoto, inclusa la condivisione multi-monitor aggiunta nella versione 1.4.3. Su Wayland cattura lo schermo tramite PipeWire e il portale desktop XDG, che mostra una finestra di dialogo per il consenso in cui scegliere quale display condividere — nella maggior parte dei casi la scelta viene ricordata, quindi non ti verrà richiesta di nuovo — e funziona all'interno della sessione grafica attiva in cui hai già effettuato l'accesso. Questo passaggio di consenso è una caratteristica di sicurezza propria di Wayland, condivisa da tutte le app di condivisione dello schermo. Per macchine che richiedono l'accesso prima del login o completamente non presidiato, oggi si usa una sessione X11 dove una distribuzione la offre ancora, dato che diverse stanno passando a Wayland esclusivamente; il supporto completo alla cattura Wayland non presidiata è in fase di sviluppo attivo (vedi github.com/rustdesk/rustdesk/pull/15420)."
- question: 'Quale pacchetto devo installare su Linux?' - question: 'Quale pacchetto devo installare su Linux?'
answer: "Usa il .deb su Debian, Ubuntu e Linux Mint, il .rpm su Fedora, RHEL e openSUSE, il Flatpak da Flathub per una build sandboxed e ampiamente compatibile, oppure l'AppImage portatile come alternativa a file singolo. I pacchetti .deb e .rpm registrano e avviano un servizio systemd, così RustDesk sopravvive ai riavvii; Flatpak e AppImage non lo fanno per impostazione predefinita." answer: "Usa il .deb su Debian, Ubuntu e Linux Mint, il .rpm su Fedora, RHEL e openSUSE, il Flatpak da Flathub per una build sandboxed e ampiamente compatibile, oppure l'AppImage portatile come alternativa a file singolo. I pacchetti .deb e .rpm registrano e avviano un servizio systemd, così RustDesk sopravvive ai riavvii; Flatpak e AppImage non lo fanno per impostazione predefinita."
- question: 'Perché la mia macchina Linux headless mostra uno schermo nero?'
answer: "Senza un monitor collegato, X o Wayland non allocano mai un framebuffer, quindi non c'è nulla che RustDesk possa catturare e il visualizzatore mostra uno schermo nero o in attesa dell'immagine. Collega un dummy plug HDMI/DisplayPort, configura un display virtuale come xserver-xorg-video-dummy o VKMS, oppure attiva la modalità headless opzionale di RustDesk per Linux in modo che un display virtuale venga creato automaticamente."
- question: 'Posso eseguire il self-hosting del server RustDesk su Linux?' - question: 'Posso eseguire il self-hosting del server RustDesk su Linux?'
answer: 'Sì. Il server RustDesk (i processi hbbs per ID/rendezvous e hbbr per il relay) è progettato per Linux ed è il modo standard per eseguirlo. Il server community open source gratuito funziona a tempo indeterminato senza alcun costo, mentre Server Pro aggiunge una console web, gruppi di dispositivi e un generatore di client personalizzati. Entrambi si installano su una normale VM Linux o su un host bare-metal.' answer: 'Sì. Il server RustDesk (i processi hbbs per ID/rendezvous e hbbr per il relay) è progettato per Linux ed è il modo standard per eseguirlo. Il server community open source gratuito funziona a tempo indeterminato senza alcun costo, mentre Server Pro aggiunge una console web, gruppi di dispositivi e un generatore di client personalizzati. Entrambi si installano su una normale VM Linux o su un host bare-metal.'
metadata: metadata:
description: "RustDesk su Linux, dall'inizio alla fine: scelta del pacchetto per ogni distribuzione e scheda ARM, cattura Wayland e X11, configurazione headless ed esecuzione del proprio server." description: "RustDesk su Linux, dall'inizio alla fine: scelta del pacchetto per ogni distribuzione e scheda ARM, cattura Wayland e X11 ed esecuzione del proprio server."
keywords: 'RustDesk per Linux, RustDesk Ubuntu, RustDesk Wayland, RustDesk X11, installazione RustDesk Linux' keywords: 'RustDesk per Linux, RustDesk Ubuntu, RustDesk Wayland, RustDesk X11, installazione RustDesk Linux'
--- ---
Gli utenti Linux non hanno mai avuto una vasta scelta di buoni strumenti di desktop remoto, e quelli esistenti sono perlopiù prodotti commerciali closed source oppure stack VNC ormai datati. RustDesk si colloca in una posizione diversa: è un client di desktop remoto open source con licenza AGPL, funziona nativamente su tutte le principali distribuzioni e può essere puntato verso un server che ospiti tu stesso. Questa combinazione — codice verificabile, client nativo per Linux e infrastruttura self-hostable — è il motivo per cui RustDesk è diventato una delle risposte di riferimento quando si cerca un desktop remoto open source per Linux. Gli utenti Linux non hanno mai avuto una vasta scelta di buoni strumenti di desktop remoto, e quelli esistenti sono perlopiù prodotti commerciali closed source oppure stack VNC ormai datati. RustDesk si colloca in una posizione diversa: è un client di desktop remoto open source con licenza AGPL, funziona nativamente su tutte le principali distribuzioni e può essere puntato verso un server che ospiti tu stesso. Questa combinazione — codice verificabile, client nativo per Linux e infrastruttura self-hostable — è il motivo per cui RustDesk è diventato una delle risposte di riferimento quando si cerca un desktop remoto open source per Linux.
Questa guida illustra come installarlo, l'aspetto che manda in confusione praticamente tutti (X11 contro Wayland), come ottenere l'accesso non presidiato e headless, e dove si inserisce il server in tutto questo. Questa guida illustra come installarlo, l'aspetto che manda in confusione praticamente tutti (X11 contro Wayland), come ottenere l'accesso non presidiato e dove si inserisce il server in tutto questo.
## Installare RustDesk su Linux ## Installare RustDesk su Linux
@@ -53,7 +51,7 @@ Questo è l'aspetto singolarmente più importante da capire su RustDesk su Linux
**Wayland: RustDesk offre probabilmente il supporto più solido tra tutti gli strumenti di desktop remoto.** RustDesk supporta Wayland dalla versione 1.2.0 e continua ad ampliarne il supporto. Poiché i compositor Wayland non consentono l'accesso diretto al framebuffer, RustDesk cattura lo schermo tramite il servizio `xdg-desktop-portal` e [PipeWire](https://deepwiki.com/rustdesk/rustdesk/6.3.1-wayland-support), e inietta l'input tramite il modulo del kernel `uinput`. Dal design stesso di Wayland derivano due conseguenze — che si applicano a ogni strumento di condivisione schermo su Wayland, non solo a RustDesk: **Wayland: RustDesk offre probabilmente il supporto più solido tra tutti gli strumenti di desktop remoto.** RustDesk supporta Wayland dalla versione 1.2.0 e continua ad ampliarne il supporto. Poiché i compositor Wayland non consentono l'accesso diretto al framebuffer, RustDesk cattura lo schermo tramite il servizio `xdg-desktop-portal` e [PipeWire](https://deepwiki.com/rustdesk/rustdesk/6.3.1-wayland-support), e inietta l'input tramite il modulo del kernel `uinput`. Dal design stesso di Wayland derivano due conseguenze — che si applicano a ogni strumento di condivisione schermo su Wayland, non solo a RustDesk:
- **Consenso per ogni connessione.** Il portale mostra una finestra di dialogo che chiede di selezionare quale display condividere. Si tratta di una funzione di sicurezza voluta da Wayland, non di un bug di RustDesk — un'app in background non può iniziare a registrare lo schermo di nascosto. Il Portal v4 e versioni successive supportano un "restore token" che evita di richiedere il consenso ogni singola volta, ma la prima condivisione richiede comunque un clic sullo schermo. - **Consenso per ogni connessione.** Il portale mostra una finestra di dialogo che chiede di selezionare quale display condividere. Si tratta di una funzione di sicurezza voluta da Wayland, non di un bug di RustDesk — un'app in background non può iniziare a registrare lo schermo di nascosto. Il Portal v4 e versioni successive supportano un "restore token" che evita di richiedere il consenso ogni singola volta, ma la prima condivisione richiede comunque un clic sullo schermo.
- **Solo sessione attiva.** La cattura su Wayland è legata alla sessione grafica con accesso già effettuato. La cattura della schermata di login (greeter) di Wayland non è ancora supportata — è in fase di sviluppo attivo ([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). Per l'accesso prima del login, oggi si usa la configurazione headless/display virtuale descritta più avanti, oppure una sessione X11 sulle distribuzioni che ne offrono ancora una. - **Solo sessione attiva.** La cattura su Wayland è legata alla sessione grafica con accesso già effettuato. La cattura della schermata di login (greeter) di Wayland non è ancora supportata — è in fase di sviluppo attivo ([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). Per l'accesso prima del login, oggi si usa una sessione X11 sulle distribuzioni che ne offrono ancora una.
Il supporto a Wayland continua a migliorare — RustDesk 1.4.3 (ottobre 2025), per esempio, [ha aggiunto la condivisione multi-monitor per Wayland](https://ubuntuhandbook.org/index.php/2025/10/rustdesk-released-1-4-3-with-multi-monitor-for-wayland-virtual-mouse/). Ma se ti connetti e vedi uno schermo nero su una macchina Wayland, quasi sempre il problema è che il percorso portal/PipeWire non è soddisfatto. Il nostro approfondimento dedicato a [RustDesk connesso ma in attesa dell'immagine](/it/blog/rustdesk-connesso-in-attesa-dellimmagine-guida-completa-alla-risoluzione) analizza nello specifico il caso dello schermo nero su Wayland. Il supporto a Wayland continua a migliorare — RustDesk 1.4.3 (ottobre 2025), per esempio, [ha aggiunto la condivisione multi-monitor per Wayland](https://ubuntuhandbook.org/index.php/2025/10/rustdesk-released-1-4-3-with-multi-monitor-for-wayland-virtual-mouse/). Ma se ti connetti e vedi uno schermo nero su una macchina Wayland, quasi sempre il problema è che il percorso portal/PipeWire non è soddisfatto. Il nostro approfondimento dedicato a [RustDesk connesso ma in attesa dell'immagine](/it/blog/rustdesk-connesso-in-attesa-dellimmagine-guida-completa-alla-risoluzione) analizza nello specifico il caso dello schermo nero su Wayland.
@@ -63,21 +61,15 @@ Per accesso non presidiato si intende la connessione a una macchina senza nessun
1. Installa tramite `.deb` o `.rpm` in modo che il servizio systemd venga registrato, oppure fai clic su **Abilita servizio** nell'app. 1. Installa tramite `.deb` o `.rpm` in modo che il servizio systemd venga registrato, oppure fai clic su **Abilita servizio** nell'app.
2. In RustDesk, imposta una **password permanente** complessa nelle impostazioni di connessione (e idealmente attiva l'autenticazione a due fattori). 2. In RustDesk, imposta una **password permanente** complessa nelle impostazioni di connessione (e idealmente attiva l'autenticazione a due fattori).
3. Per l'accesso prima del login o tra un login utente e l'altro, usa la configurazione headless con display virtuale descritta più avanti (qui si applica il limite della schermata di login di Wayland trattato sopra).
Una realtà di Wayland di cui tenere conto: il portale basato sul consenso descritto nella sezione su Wayland rende la cattura completamente non presidiata più difficile rispetto a X11, almeno finché il supporto non presidiato in sviluppo non sarà disponibile — quindi per le macchine non presidiate pianifica la configurazione headless con display virtuale.
## Linux headless: server senza monitor ## Linux headless: server senza monitor
Un caso d'uso molto comune su Linux è una macchina senza alcun display collegato — un server domestico, una macchina da laboratorio, una VM. In questo caso il problema non è RustDesk, ma lo stack grafico: senza un monitor collegato, X o Wayland non allocano mai un framebuffer, quindi non c'è letteralmente nessuna immagine da catturare e il risultato è uno schermo nero. Un caso d'uso molto comune su Linux è una macchina senza alcun display collegato — un server domestico, una macchina da laboratorio, una VM. In questo caso il problema non è RustDesk, ma lo stack grafico: senza un monitor collegato, X o Wayland non allocano mai un framebuffer, quindi non c'è letteralmente nessuna immagine da catturare e il risultato è uno schermo nero.
Tre modi per dargli qualcosa da renderizzare: Due modi per dargli qualcosa da renderizzare:
- **Un dummy plug** — un economico dongle fisico HDMI/DisplayPort "headless" che fa credere alla GPU che un monitor sia collegato. - **Un dummy plug** — un economico dongle fisico HDMI/DisplayPort "headless" che fa credere alla GPU che un monitor sia collegato.
- **Un driver di display virtuale**`xserver-xorg-video-dummy` su X11, oppure un'opzione a livello kernel come VKMS. - **Un driver di display virtuale**`xserver-xorg-video-dummy` su X11, oppure un'opzione a livello kernel come VKMS.
- **La modalità headless opzionale di RustDesk** — attivala con `sudo rustdesk --option allow-linux-headless Y`. Secondo la [wiki Headless Linux Support](https://github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support) è disattivata per impostazione predefinita, testata principalmente su Ubuntu con GNOME, e richiede pacchetti come `xserver-xorg-video-dummy` e `lightdm`. Puoi recuperare l'ID della macchina con `sudo rustdesk --get-id` e impostare una password con `sudo rustdesk --password <password>`.
La modalità headless presenta ancora alcune asperità, quindi trattala come "funziona, ma con attenzione" piuttosto che come una soluzione chiavi in mano.
## Self-hosting del server RustDesk su Linux ## Self-hosting del server RustDesk su Linux
@@ -58,7 +58,7 @@ Una volta che RustDesk funziona come servizio, si carica prima che chiunque effe
| ----------- | ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ----------- | ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Windows | Installa; mantieni il servizio in esecuzione (si avvia con la macchina) | L'exe portatile si interrompe al logout/UAC; usa il programma di installazione | | Windows | Installa; mantieni il servizio in esecuzione (si avvia con la macchina) | L'exe portatile si interrompe al logout/UAC; usa il programma di installazione |
| macOS | Installa, imposta la password permanente, concedi i permessi | Devono essere concessi Registrazione schermo e Accessibilità; la cattura della schermata di login richiede l'installazione dell'helper | | macOS | Installa, imposta la password permanente, concedi i permessi | Devono essere concessi Registrazione schermo e Accessibilità; la cattura della schermata di login richiede l'installazione dell'helper |
| Linux | Installa il pacchetto del servizio | Wayland richiede una sessione attiva; per il pre-login usa la configurazione headless con display virtuale, oppure X11 dove una distribuzione lo offre ancora | | Linux | Installa il pacchetto del servizio | Wayland richiede una sessione attiva; per il pre-login usa X11 dove una distribuzione lo offre ancora |
| Android | Imposta la password permanente; abilita la cattura | Lo schermo deve essere attivo; concedi il consenso per la cattura schermo (MediaProjection) e il permesso di input | | Android | Imposta la password permanente; abilita la cattura | Lo schermo deve essere attivo; concedi il consenso per la cattura schermo (MediaProjection) e il permesso di input |
### Windows ### Windows
@@ -71,7 +71,7 @@ macOS subordina la cattura dello schermo e dell'input a permessi specifici. Dopo
### Linux ### Linux
Installa RustDesk in modo che il suo componente di servizio si avvii all'accensione. Per una macchina che resta ferma sulla schermata di benvenuto (greeter) del login, Wayland non può ancora catturare il greeter — una scelta di progettazione di Wayland (non un limite di RustDesk) che RustDesk sta lavorando attivamente a colmare ([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). Su una macchina headless, usa la configurazione con display virtuale; su desktop, una sessione X11/Xorg gestisce ancora la situazione dove una distribuzione ne offre una, anche se diverse si stanno spostando verso il solo Wayland. Per i dettagli, consulta [RustDesk per Linux](/it/blog/rustdesk-per-linux-il-desktop-remoto-open-source). Installa RustDesk in modo che il suo componente di servizio si avvii all'accensione. Per una macchina che resta ferma sulla schermata di benvenuto (greeter) del login, Wayland non può ancora catturare il greeter — una scelta di progettazione di Wayland (non un limite di RustDesk) che RustDesk sta lavorando attivamente a colmare ([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). Su desktop, una sessione X11/Xorg gestisce ancora la situazione dove una distribuzione ne offre una, anche se diverse si stanno spostando verso il solo Wayland. Per i dettagli, consulta [RustDesk per Linux](/it/blog/rustdesk-per-linux-il-desktop-remoto-open-source).
## Passaggio 3: distribuisci su larga scala con un client preconfigurato ## Passaggio 3: distribuisci su larga scala con un client preconfigurato
@@ -14,7 +14,7 @@ faq:
- question: 'なぜRustDeskは「Connected, waiting for image」と表示するのですか?' - question: 'なぜRustDeskは「Connected, waiting for image」と表示するのですか?'
answer: 'セッション自体は正常に確立されていますが、リモートマシン側が送信する画面イメージを生成できていない状態です。最も多い原因は、キャプチャ対象となるアクティブなディスプレイが存在しないことです。モニターが接続されていないヘッドレスサーバー、スリープやロック状態になった画面、あるいはOSがRustDeskによる記録を許可していないディスプレイなどが該当します。キャプチャ元を修正すれば、画像は表示されるようになります。' answer: 'セッション自体は正常に確立されていますが、リモートマシン側が送信する画面イメージを生成できていない状態です。最も多い原因は、キャプチャ対象となるアクティブなディスプレイが存在しないことです。モニターが接続されていないヘッドレスサーバー、スリープやロック状態になった画面、あるいはOSがRustDeskによる記録を許可していないディスプレイなどが該当します。キャプチャ元を修正すれば、画像は表示されるようになります。'
- question: 'ヘッドレスコンピューターでRustDeskが「waiting for image」のままになる場合、どう解決すればよいですか?' - question: 'ヘッドレスコンピューターでRustDeskが「waiting for image」のままになる場合、どう解決すればよいですか?'
answer: 'モニターが接続されていないマシンには、キャプチャすべきフレームバッファが存在しないため、RustDeskは何も送信できません。実際のモニターを接続する、GPUにディスプレイが接続されていると認識させる安価なHDMIダミープラグを挿す、あるいはLinuxではドキュメント化されたヘッドレス構成(github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support)を利用してください。ディスプレイをスリープから復帰させる、またはスリープさせないようにするだけで、ほとんどのケースは解決します。' answer: 'モニターが接続されていないマシンには、キャプチャすべきフレームバッファが存在しないため、RustDeskは何も送信できません。実際のモニターを接続する、GPUにディスプレイが接続されていると認識させる安価なHDMIダミープラグを挿してください。ディスプレイをスリープから復帰させる、またはスリープさせないようにするだけで、ほとんどのケースは解決します。'
- question: '映像コーデックを変更すると黒画面は解決しますか?' - question: '映像コーデックを変更すると黒画面は解決しますか?'
answer: '多くの場合、解決します。リモートセッションのツールバーや設定画面から、VP8、VP9、AV1、またはハードウェアが対応していればH.264/H.265といったコーデックに切り替えられます。リモート側のハードウェアがエンコードできないコーデックを使用していると、画面が真っ黒になったりフリーズしたりします。VP9のようなソフトウェアコーデックにフォールバックすることで、たいていは画面が正常に表示されるようになります。' answer: '多くの場合、解決します。リモートセッションのツールバーや設定画面から、VP8、VP9、AV1、またはハードウェアが対応していればH.264/H.265といったコーデックに切り替えられます。リモート側のハードウェアがエンコードできないコーデックを使用していると、画面が真っ黒になったりフリーズしたりします。VP9のようなソフトウェアコーデックにフォールバックすることで、たいていは画面が正常に表示されるようになります。'
- question: 'あるPCでは画像が表示されるのに、別のPCでは表示されません。なぜですか?' - question: 'あるPCでは画像が表示されるのに、別のPCでは表示されません。なぜですか?'
@@ -37,11 +37,10 @@ RustDeskで**「Connected, waiting for image」**と表示され、その後に
圧倒的に多く報告されている原因は**ヘッドレスマシン**です。モニターが接続されていない、またはディスプレイがスリープ状態のまま稼働しているサーバー、ミニPC、ワークステーションなどが該当します。アクティブなディスプレイが存在しない場合、GPUはフレームバッファを生成しないため、RustDeskは接続はできても送信するデータがありません。このパターンはRustDeskのIssueトラッカーで繰り返し報告されており、[対象機のモニターがオフのときに限って黒画面になるという報告](https://github.com/rustdesk/rustdesk/issues/9884)や、長期にわたる[「Connected, waiting for image」スレッド](https://github.com/rustdesk/rustdesk/issues/222)などが挙げられます。 圧倒的に多く報告されている原因は**ヘッドレスマシン**です。モニターが接続されていない、またはディスプレイがスリープ状態のまま稼働しているサーバー、ミニPC、ワークステーションなどが該当します。アクティブなディスプレイが存在しない場合、GPUはフレームバッファを生成しないため、RustDeskは接続はできても送信するデータがありません。このパターンはRustDeskのIssueトラッカーで繰り返し報告されており、[対象機のモニターがオフのときに限って黒画面になるという報告](https://github.com/rustdesk/rustdesk/issues/9884)や、長期にわたる[「Connected, waiting for image」スレッド](https://github.com/rustdesk/rustdesk/issues/222)などが挙げられます。
キャプチャする対象を用意する方法は3つあります。 キャプチャする対象を用意する方法は2つあります。
- **モニターを接続する** — 電源が入っており、スリープしていない状態を確認してください。 - **モニターを接続する** — 電源が入っており、スリープしていない状態を確認してください。
- **HDMI(またはDisplayPort)ダミープラグを使用する** — この安価なアダプターは、GPUにディスプレイが接続されていると認識させるため、RustDeskが取得できるフレームバッファを描画し続けます。ヘッドレスデスクトップやホームサーバーにおける標準的な対処法です。 - **HDMI(またはDisplayPort)ダミープラグを使用する** — この安価なアダプターは、GPUにディスプレイが接続されていると認識させるため、RustDeskが取得できるフレームバッファを描画し続けます。ヘッドレスデスクトップやホームサーバーにおける標準的な対処法です。
- **Linuxではドキュメント化されたヘッドレス構成を利用する** — RustDeskはヘッドレスなLinux構成をサポートしていますが、通常のデスクトップセッションとは設定が異なります。詳しくは[Headless Linux Support wiki](https://github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support)を参照してください。
モニターが*すでに*接続されている場合、次に疑うべきはスリープ状態に入っていることです。 モニターが*すでに*接続されている場合、次に疑うべきはスリープ状態に入っていることです。
@@ -49,7 +48,7 @@ RustDeskで**「Connected, waiting for image」**と表示され、その後に
| 原因 | 兆候 | 対処法 | | 原因 | 兆候 | 対処法 |
| ------------------------------------ | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | ------------------------------------ | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| ヘッドレス / ディスプレイなし | サーバーやミニPCで黒画面になる | モニターを接続する、HDMIダミープラグを追加する、またはLinuxのヘッドレス構成を利用する | | ヘッドレス / ディスプレイなし | サーバーやミニPCで黒画面になる | モニターを接続する、HDMIダミープラグを追加する |
| 画面のスリープ / ロック | 以前は動作していたが、アイドル後に黒画面になる | 画面をスリープから復帰させる。スリープ/スクリーンセーバーを無効化する。macOSでは設定でディスプレイのスリープを停止する | | 画面のスリープ / ロック | 以前は動作していたが、アイドル後に黒画面になる | 画面をスリープから復帰させる。スリープ/スクリーンセーバーを無効化する。macOSでは設定でディスプレイのスリープを停止する |
| 権限不足(macOS) | 接続はするが、常に黒画面のまま | 「プライバシーとセキュリティ」で画面収録を許可する。ログイン画面用にヘルパーをインストールする | | 権限不足(macOS) | 接続はするが、常に黒画面のまま | 「プライバシーとセキュリティ」で画面収録を許可する。ログイン画面用にヘルパーをインストールする |
| コーデックの不一致 | 画面が空白/フリーズする | コーデックを切り替える(VP8 / VP9 / AV1 / H.264 / H.265)。ソフトウェアコーデックにフォールバックする | | コーデックの不一致 | 画面が空白/フリーズする | コーデックを切り替える(VP8 / VP9 / AV1 / H.264 / H.265)。ソフトウェアコーデックにフォールバックする |
@@ -83,7 +82,7 @@ RustDeskは複数の方式でストリームをエンコードできますが、
### LinuxとWayland ### LinuxとWayland
Linuxでは、**Waylandの画面キャプチャはPipeWireと`xdg-desktop-portal`を経由します**。初回はディスプレイを選択するための同意プロンプトが表示されますが——多くの場合その選択は記憶されるため、以降は再表示されません——アクティブなログインセッション内であれば動作します。これはWaylandのセキュリティ設計によるものであり、それ単体ではグリーター画面や完全にヘッドレスなマシンには対応しません(ただし、無人でのWaylandキャプチャは現在活発に開発が進められています。[PR #15420](https://github.com/rustdesk/rustdesk/pull/15420))。Waylandで画面が空白になる場合、通常はポータルの画面共有プロンプトを承認し、`xdg-desktop-portal`とPipeWireがインストールされて実行されていることを確認すれば解決します。ヘッドレスなマシンでは、ドキュメント化された[ヘッドレス構成](https://github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support)を利用してください。ディストリビューションがまだX11/Xorgセッションを提供している場合は、それにログインすることでもポータル経由の処理を回避できます——ただし、多くのディストリビューションがWayland専用へと移行しつつある中では、ポータル/PipeWire側の問題を解決しておくほうが、より将来性のあるアプローチと言えます。 Linuxでは、**Waylandの画面キャプチャはPipeWireと`xdg-desktop-portal`を経由します**。初回はディスプレイを選択するための同意プロンプトが表示されますが——多くの場合その選択は記憶されるため、以降は再表示されません——アクティブなログインセッション内であれば動作します。これはWaylandのセキュリティ設計によるものであり、それ単体ではグリーター画面には対応しません(ただし、無人でのWaylandキャプチャは現在活発に開発が進められています。[PR #15420](https://github.com/rustdesk/rustdesk/pull/15420))。Waylandで画面が空白になる場合、通常はポータルの画面共有プロンプトを承認し、`xdg-desktop-portal`とPipeWireがインストールされて実行されていることを確認すれば解決します。ディストリビューションがまだX11/Xorgセッションを提供している場合は、それにログインすることでもポータル経由の処理を回避できます——ただし、多くのディストリビューションがWayland専用へと移行しつつある中では、ポータル/PipeWire側の問題を解決しておくほうが、より将来性のあるアプローチと言えます。
### ネットワークとリレー ### ネットワークとリレー
+6 -14
View File
@@ -4,7 +4,7 @@ lang: 'ja'
translationKey: rustdesk-for-linux translationKey: rustdesk-for-linux
draft: false draft: false
title: 'RustDesk for Linux:オープンソースのリモートデスクトップ' title: 'RustDesk for Linux:オープンソースのリモートデスクトップ'
excerpt: 'Linux で RustDesk をインストールして実行する方法を解説:.deb、.rpm、Flatpak、AppImage の選び方、X11 と Wayland の違い、ヘッドレス環境や無人アクセスの設定、サーバーのセルフホスティングまで。' excerpt: 'Linux で RustDesk をインストールして実行する方法を解説:.deb、.rpm、Flatpak、AppImage の選び方、X11 と Wayland の違い、無人アクセスの設定、サーバーのセルフホスティングまで。'
image: ~/assets/images/blog/rustdesk-for-linux-og.webp image: ~/assets/images/blog/rustdesk-for-linux-og.webp
category: 'ガイド' category: 'ガイド'
tags: ['RustDesk', 'Linux', 'セルフホスティング'] tags: ['RustDesk', 'Linux', 'セルフホスティング']
@@ -12,21 +12,19 @@ author: 'RustDesk Team'
slug: 'rustdesk-for-linux-ja' slug: 'rustdesk-for-linux-ja'
faq: faq:
- question: 'RustDesk は Wayland で動作しますか?' - question: 'RustDesk は Wayland で動作しますか?'
answer: 'はい。RustDesk はリモートデスクトップツールの中でも屈指の Wayland サポートを備えており、1.4.3 で追加されたマルチモニター共有もその一つです。Wayland では PipeWire と XDG デスクトップポータルを通じて画面をキャプチャします。ポータルはディスプレイを選択するための同意ダイアログを表示しますが、多くの場合その選択内容は記憶されるため、毎回確認を求められることはありません。また、ログイン中のアクティブなセッション内で動作します。この同意のステップは、あらゆる画面共有アプリに共通する Wayland のセキュリティ設計によるものです。現時点でログイン前や完全な無人アクセスが必要なマシンについては、ヘッドレス仮想ディスプレイ構成を使用してください(あるいは、複数のディストリビューションが Wayland 専用への移行を進めているとはいえ、まだ X11 セッションを提供しているディストリビューションであれば X11 セッションでも構いません)。完全な無人 Wayland キャプチャは現在活発に開発が進められています(github.com/rustdesk/rustdesk/pull/15420 を参照)。' answer: 'はい。RustDesk はリモートデスクトップツールの中でも屈指の Wayland サポートを備えており、1.4.3 で追加されたマルチモニター共有もその一つです。Wayland では PipeWire と XDG デスクトップポータルを通じて画面をキャプチャします。ポータルはディスプレイを選択するための同意ダイアログを表示しますが、多くの場合その選択内容は記憶されるため、毎回確認を求められることはありません。また、ログイン中のアクティブなセッション内で動作します。この同意のステップは、あらゆる画面共有アプリに共通する Wayland のセキュリティ設計によるものです。現時点でログイン前や完全な無人アクセスが必要なマシンについては、まだ X11 セッションを提供しているディストリビューションであれば X11 セッションを使用してください。完全な無人 Wayland キャプチャは現在活発に開発が進められています(github.com/rustdesk/rustdesk/pull/15420 を参照)。'
- question: 'Linux ではどのパッケージをインストールすればよいですか?' - question: 'Linux ではどのパッケージをインストールすればよいですか?'
answer: 'Debian、Ubuntu、Linux Mint では .deb を、Fedora、RHEL、openSUSE では .rpm を使用してください。サンドボックス化された、広く互換性のあるビルドが必要な場合は Flathub の Flatpak を、単一ファイルのフォールバックとしてはポータブルな AppImage を使用します。.deb と .rpm パッケージは systemd サービスを登録・起動するため、再起動後も RustDesk が動作し続けます。Flatpak と AppImage はデフォルトではそうなりません。' answer: 'Debian、Ubuntu、Linux Mint では .deb を、Fedora、RHEL、openSUSE では .rpm を使用してください。サンドボックス化された、広く互換性のあるビルドが必要な場合は Flathub の Flatpak を、単一ファイルのフォールバックとしてはポータブルな AppImage を使用します。.deb と .rpm パッケージは systemd サービスを登録・起動するため、再起動後も RustDesk が動作し続けます。Flatpak と AppImage はデフォルトではそうなりません。'
- question: 'なぜヘッドレスの Linux マシンで黒い画面が表示されるのですか?'
answer: 'モニターが接続されていない場合、X も Wayland もフレームバッファを確保しないため、RustDesk がキャプチャできるものが何もなく、ビューア側には黒い画面または画像待ちの画面が表示されます。ダミーの HDMI/DisplayPort プラグを接続するか、xserver-xorg-video-dummy や VKMS などの仮想ディスプレイを設定するか、あるいは RustDesk のオプトイン式 Linux ヘッドレスモードを有効にして仮想ディスプレイを自動的に作成させてください。'
- question: 'Linux で RustDesk サーバーをセルフホストできますか?' - question: 'Linux で RustDesk サーバーをセルフホストできますか?'
answer: 'はい。RustDesk サーバー(hbbs の ID/ランデブープロセスと hbbr のリレープロセス)は Linux 向けに構築されており、これが標準的な実行方法です。無料でオープンソースのコミュニティサーバーは無期限で無償で稼働し、Server Pro はそれに加えて Web コンソール、デバイスグループ、カスタムクライアント生成機能を追加します。どちらも通常の Linux VM やベアメタルホストにインストールできます。' answer: 'はい。RustDesk サーバー(hbbs の ID/ランデブープロセスと hbbr のリレープロセス)は Linux 向けに構築されており、これが標準的な実行方法です。無料でオープンソースのコミュニティサーバーは無期限で無償で稼働し、Server Pro はそれに加えて Web コンソール、デバイスグループ、カスタムクライアント生成機能を追加します。どちらも通常の Linux VM やベアメタルホストにインストールできます。'
metadata: metadata:
description: 'Linux 版 RustDesk を網羅的に解説:各ディストリビューションや ARM ボード向けのパッケージ選び、Wayland と X11 でのキャプチャ、ヘッドレス設定、自前のサーバー運用まで。' description: 'Linux 版 RustDesk を網羅的に解説:各ディストリビューションや ARM ボード向けのパッケージ選び、Wayland と X11 でのキャプチャ、自前のサーバー運用まで。'
keywords: 'RustDesk Linux, RustDesk Ubuntu, RustDesk Wayland, RustDesk X11, RustDesk Linux インストール' keywords: 'RustDesk Linux, RustDesk Ubuntu, RustDesk Wayland, RustDesk X11, RustDesk Linux インストール'
--- ---
Linux ユーザーには、これまで優れたリモートデスクトップツールの選択肢がほとんどありませんでした。存在するものといえば、クローズドソースの商用製品か、古びた VNC スタックのどちらかが定番です。RustDesk はそれらとは一線を画す存在です。AGPL ライセンスのオープンソースのリモートデスクトップクライアントであり、主要なディストリビューションすべてでネイティブに動作し、しかも自分でホストするサーバーに接続できます。監査可能なコード、ネイティブな Linux クライアント、そしてセルフホスト可能なインフラという組み合わせこそが、Linux 向けのオープンソースのリモートデスクトップを探す人にとって RustDesk が定番の答えの一つになっている理由です。 Linux ユーザーには、これまで優れたリモートデスクトップツールの選択肢がほとんどありませんでした。存在するものといえば、クローズドソースの商用製品か、古びた VNC スタックのどちらかが定番です。RustDesk はそれらとは一線を画す存在です。AGPL ライセンスのオープンソースのリモートデスクトップクライアントであり、主要なディストリビューションすべてでネイティブに動作し、しかも自分でホストするサーバーに接続できます。監査可能なコード、ネイティブな Linux クライアント、そしてセルフホスト可能なインフラという組み合わせこそが、Linux 向けのオープンソースのリモートデスクトップを探す人にとって RustDesk が定番の答えの一つになっている理由です。
このガイドでは、インストール方法、誰もがつまずきがちなポイント(X11 と Wayland の違い)、無人アクセスとヘッドレスアクセスを機能させる方法、そしてサーバーがどのように関わってくるかを解説します。 このガイドでは、インストール方法、誰もがつまずきがちなポイント(X11 と Wayland の違い)、無人アクセスを機能させる方法、そしてサーバーがどのように関わってくるかを解説します。
## Linux への RustDesk のインストール ## Linux への RustDesk のインストール
@@ -53,7 +51,7 @@ RustDesk は一般的な Linux のパッケージ形式すべてに対応して
**WaylandRustDesk はリモートデスクトップツールの中でもおそらく最も強力な Wayland サポートを備えています。** RustDesk はバージョン 1.2.0 から Wayland に対応しており、その後も継続的に機能を拡張してきました。Wayland のコンポジターは直接的なフレームバッファへのアクセスを許可しないため、RustDesk は `xdg-desktop-portal` サービスと [PipeWire](https://deepwiki.com/rustdesk/rustdesk/6.3.1-wayland-support) を通じて画面をキャプチャし、カーネルの `uinput` モジュール経由で入力を注入します。この Wayland 自体の設計から、2つの帰結が生じます。これは RustDesk に限らず、Wayland 上で動作するすべての画面共有ツールに当てはまることです。 **WaylandRustDesk はリモートデスクトップツールの中でもおそらく最も強力な Wayland サポートを備えています。** RustDesk はバージョン 1.2.0 から Wayland に対応しており、その後も継続的に機能を拡張してきました。Wayland のコンポジターは直接的なフレームバッファへのアクセスを許可しないため、RustDesk は `xdg-desktop-portal` サービスと [PipeWire](https://deepwiki.com/rustdesk/rustdesk/6.3.1-wayland-support) を通じて画面をキャプチャし、カーネルの `uinput` モジュール経由で入力を注入します。この Wayland 自体の設計から、2つの帰結が生じます。これは RustDesk に限らず、Wayland 上で動作するすべての画面共有ツールに当てはまることです。
- **接続のたびに同意が必要。** ポータルがダイアログを表示し、どのディスプレイを共有するかを選択するよう求めます。これは RustDesk の不具合ではなく、意図的な Wayland のセキュリティ機能です。バックグラウンドアプリが密かに画面の録画を開始することはできない、という仕組みです。ポータル v4 以降では「リストアトークン」に対応しており、毎回確認を求められるわけではありませんが、最初の共有時には画面上でのクリックが必要です。 - **接続のたびに同意が必要。** ポータルがダイアログを表示し、どのディスプレイを共有するかを選択するよう求めます。これは RustDesk の不具合ではなく、意図的な Wayland のセキュリティ機能です。バックグラウンドアプリが密かに画面の録画を開始することはできない、という仕組みです。ポータル v4 以降では「リストアトークン」に対応しており、毎回確認を求められるわけではありませんが、最初の共有時には画面上でのクリックが必要です。
- **アクティブなセッションに限定。** Wayland のキャプチャは、ログイン済みのグラフィカルセッションに紐づいています。Wayland のログイン画面(グリーター)のキャプチャはまだサポートされておらず、現在活発に開発が進められています([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420))。現時点でログイン前にアクセスしたい場合は、後述のヘッドレス/仮想ディスプレイ構成を使うか、まだ X11 セッションを提供しているディストリビューションであれば X11 セッションを利用してください。 - **アクティブなセッションに限定。** Wayland のキャプチャは、ログイン済みのグラフィカルセッションに紐づいています。Wayland のログイン画面(グリーター)のキャプチャはまだサポートされておらず、現在活発に開発が進められています([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420))。現時点でログイン前にアクセスしたい場合は、まだ X11 セッションを提供しているディストリビューションで X11 セッションを利用してください。
Wayland サポートは今も改善が続いており、たとえば RustDesk 1.4.32025年10月)では [Wayland 向けのマルチモニター共有が追加されました](https://ubuntuhandbook.org/index.php/2025/10/rustdesk-released-1-4-3-with-multi-monitor-for-wayland-virtual-mouse/)。とはいえ、Wayland 環境で接続後に黒い画面が表示される場合、そのほとんどはポータル/PipeWire の経路が正しく満たされていないことが原因です。[RustDesk が接続済みなのに画像待ちになる場合](/ja/blog/rustdesk-connected-waiting-for-image-ja)についての専用記事では、この Wayland での黒画面のケースを具体的に取り上げています。 Wayland サポートは今も改善が続いており、たとえば RustDesk 1.4.32025年10月)では [Wayland 向けのマルチモニター共有が追加されました](https://ubuntuhandbook.org/index.php/2025/10/rustdesk-released-1-4-3-with-multi-monitor-for-wayland-virtual-mouse/)。とはいえ、Wayland 環境で接続後に黒い画面が表示される場合、そのほとんどはポータル/PipeWire の経路が正しく満たされていないことが原因です。[RustDesk が接続済みなのに画像待ちになる場合](/ja/blog/rustdesk-connected-waiting-for-image-ja)についての専用記事では、この Wayland での黒画面のケースを具体的に取り上げています。
@@ -63,21 +61,15 @@ Wayland サポートは今も改善が続いており、たとえば RustDesk 1.
1. `.deb` または `.rpm` でインストールして systemd サービスを登録するか、アプリ内で **サービスを有効にする** をクリックします。 1. `.deb` または `.rpm` でインストールして systemd サービスを登録するか、アプリ内で **サービスを有効にする** をクリックします。
2. RustDesk の接続設定で強力な **永続パスワード** を設定します(できれば二要素認証も有効にしてください)。 2. RustDesk の接続設定で強力な **永続パスワード** を設定します(できれば二要素認証も有効にしてください)。
3. ユーザーログイン前や複数ログインをまたいでアクセスする場合は、後述のヘッドレス仮想ディスプレイ構成を使用してください(前述の Wayland のログイン画面に関する制約がここにも当てはまります)。
計画時に考慮すべき Wayland の現実として、Wayland のセクションで説明した同意ベースのポータルにより、開発中の無人アクセスサポートが実装されるまでは、完全な無人キャプチャは X11 より難しくなります。そのため、人手を介さないマシンについては、ヘッドレス仮想ディスプレイ構成を前提に計画してください。
## ヘッドレス Linux:モニターのないサーバー ## ヘッドレス Linux:モニターのないサーバー
Linux の非常によくある使用例が、ディスプレイがまったく接続されていないマシンです。ホームサーバー、検証用マシン、VM などです。この場合、問題は RustDesk ではなくグラフィックスタック側にあります。モニターが接続されていないと、X も Wayland もフレームバッファを確保しないため、文字どおりキャプチャする画像が存在せず、黒い画面が表示されてしまいます。 Linux の非常によくある使用例が、ディスプレイがまったく接続されていないマシンです。ホームサーバー、検証用マシン、VM などです。この場合、問題は RustDesk ではなくグラフィックスタック側にあります。モニターが接続されていないと、X も Wayland もフレームバッファを確保しないため、文字どおりキャプチャする画像が存在せず、黒い画面が表示されてしまいます。
描画対象を用意する方法は3つあります。 描画対象を用意する方法は2つあります。
- **ダミープラグ** — GPU にモニターが接続されていると誤認させる、安価な物理的な HDMI/DisplayPort の「ヘッドレス」ドングルです。 - **ダミープラグ** — GPU にモニターが接続されていると誤認させる、安価な物理的な HDMI/DisplayPort の「ヘッドレス」ドングルです。
- **仮想ディスプレイドライバー** — X11 では `xserver-xorg-video-dummy`、あるいは VKMS のようなカーネルレベルの選択肢があります。 - **仮想ディスプレイドライバー** — X11 では `xserver-xorg-video-dummy`、あるいは VKMS のようなカーネルレベルの選択肢があります。
- **RustDesk のオプトイン式ヘッドレスモード**`sudo rustdesk --option allow-linux-headless Y` で有効化します。[Headless Linux Support のウィキ](https://github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support)によると、これはデフォルトでは無効になっており、主に GNOME を使った Ubuntu でテストされていて、`xserver-xorg-video-dummy``lightdm` といったパッケージが必要になります。マシンの ID は `sudo rustdesk --get-id` で取得でき、パスワードは `sudo rustdesk --password <password>` で設定できます。
ヘッドレスモードはまだ細部が洗練されておらず発展途上のため、「そのまま使える」ものというより「注意しながら使えば動く」ものとして扱ってください。
## Linux での RustDesk サーバーのセルフホスティング ## Linux での RustDesk サーバーのセルフホスティング
@@ -58,7 +58,7 @@ RustDeskがサービスとして動作するようになると、誰かがログ
| ---------------- | -------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ---------------- | -------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Windows | インストールし、サービスを実行し続ける(マシン起動時に自動起動) | ポータブルexeはログアウト/UAC時に切断される。インストーラーを使用すること | | Windows | インストールし、サービスを実行し続ける(マシン起動時に自動起動) | ポータブルexeはログアウト/UAC時に切断される。インストーラーを使用すること |
| macOS | インストールし、固定パスワードを設定し、権限を付与する | 画面収録とアクセシビリティの権限付与が必須。ログイン画面のキャプチャにはヘルパーのインストールが必要 | | macOS | インストールし、固定パスワードを設定し、権限を付与する | 画面収録とアクセシビリティの権限付与が必須。ログイン画面のキャプチャにはヘルパーのインストールが必要 |
| Linux | サービスパッケージをインストールする | Waylandはアクティブなセッションが必要。ログイン前の場合はヘッドレスの仮想ディスプレイ構成を使うか、ディストリビューションがまだ提供している場合はX11を使用する | | Linux | サービスパッケージをインストールする | Waylandはアクティブなセッションが必要。ログイン前の場合は、ディストリビューションがまだ提供していればX11を使用する |
| Android | 固定パスワードを設定し、キャプチャを有効にする | 画面がスリープしていないこと。画面キャプチャ(MediaProjection)の同意と入力権限の許可が必要 | | Android | 固定パスワードを設定し、キャプチャを有効にする | 画面がスリープしていないこと。画面キャプチャ(MediaProjection)の同意と入力権限の許可が必要 |
### Windows ### Windows
@@ -71,7 +71,7 @@ macOSでは画面キャプチャと入力操作が権限によって制御され
### Linux ### Linux
サービスコンポーネントが起動時に実行されるようにRustDeskをインストールしてください。ログイングリーター画面で待機しているマシンの場合、Waylandは現時点ではグリーターをキャプチャできません。これはRustDeskの制約ではなくWaylandの設計上の制約であり、RustDeskはこれを解消すべく現在も取り組みを進めています([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420))。ヘッドレス機では仮想ディスプレイ構成を使用してください。デスクトップ環境では、ディストリビューションがX11/Xorgセッションを提供していればそれで問題なく扱えますが、多くのディストリビューションがWayland専用へと移行しつつあります。詳細は[RustDesk for Linux](/ja/blog/rustdesk-for-linux-ja)をご覧ください。 サービスコンポーネントが起動時に実行されるようにRustDeskをインストールしてください。ログイングリーター画面で待機しているマシンの場合、Waylandは現時点ではグリーターをキャプチャできません。これはRustDeskの制約ではなくWaylandの設計上の制約であり、RustDeskはこれを解消すべく現在も取り組みを進めています([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420))。デスクトップ環境では、ディストリビューションがX11/Xorgセッションを提供していればそれで問題なく扱えますが、多くのディストリビューションがWayland専用へと移行しつつあります。詳細は[RustDesk for Linux](/ja/blog/rustdesk-for-linux-ja)をご覧ください。
## ステップ3: 事前設定済みクライアントで大規模展開する ## ステップ3: 事前設定済みクライアントで大規模展開する
@@ -14,7 +14,7 @@ faq:
- question: 'RustDesk에 왜 "연결됨, 이미지 대기 중"이라는 메시지가 표시되나요?' - question: 'RustDesk에 왜 "연결됨, 이미지 대기 중"이라는 메시지가 표시되나요?'
answer: '세션 자체는 정상적으로 연결되었지만, 원격 컴퓨터가 전송할 화면 이미지를 생성하지 못하고 있는 상태입니다. 가장 흔한 원인은 캡처할 수 있는 활성 디스플레이가 없는 경우입니다 — 모니터가 연결되지 않은 헤드리스 서버, 절전 모드에 들어가거나 잠긴 화면, 또는 운영체제가 RustDesk의 화면 기록을 허용하지 않는 경우 등입니다. 캡처 소스를 바로잡으면 이미지가 나타납니다.' answer: '세션 자체는 정상적으로 연결되었지만, 원격 컴퓨터가 전송할 화면 이미지를 생성하지 못하고 있는 상태입니다. 가장 흔한 원인은 캡처할 수 있는 활성 디스플레이가 없는 경우입니다 — 모니터가 연결되지 않은 헤드리스 서버, 절전 모드에 들어가거나 잠긴 화면, 또는 운영체제가 RustDesk의 화면 기록을 허용하지 않는 경우 등입니다. 캡처 소스를 바로잡으면 이미지가 나타납니다.'
- question: '헤드리스 컴퓨터에서 RustDesk가 이미지를 기다리는 문제는 어떻게 해결하나요?' - question: '헤드리스 컴퓨터에서 RustDesk가 이미지를 기다리는 문제는 어떻게 해결하나요?'
answer: '모니터가 없는 컴퓨터는 캡처할 프레임버퍼 자체가 없으므로 RustDesk가 보낼 것이 없습니다. 실제 모니터를 연결하거나, GPU가 디스플레이가 연결되어 있다고 인식하게 만드는 저렴한 HDMI 더미 플러그를 꽂거나, Linux에서는 공식 문서화된 헤드리스 설정(github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support)을 사용하세요. 화면을 깨우거나 계속 켜진 상태로 유지하면 대부분의 경우 해결됩니다.' answer: '모니터가 없는 컴퓨터는 캡처할 프레임버퍼 자체가 없으므로 RustDesk가 보낼 것이 없습니다. 실제 모니터를 연결하거나, GPU가 디스플레이가 연결되어 있다고 인식하게 만드는 저렴한 HDMI 더미 플러그를 꽂세요. 화면을 깨우거나 계속 켜진 상태로 유지하면 대부분의 경우 해결됩니다.'
- question: '비디오 코덱을 변경하면 검은 화면 문제가 해결되나요?' - question: '비디오 코덱을 변경하면 검은 화면 문제가 해결되나요?'
answer: '대체로 그렇습니다. 원격 세션 툴바나 설정에서 코덱을 전환할 수 있습니다 — VP8, VP9, AV1, 그리고 하드웨어가 지원하는 경우 H.264/H.265까지 가능합니다. 원격 하드웨어가 인코딩할 수 없는 코덱을 사용하면 화면이 비거나 멈춘 상태로 표시되며, VP9와 같은 소프트웨어 코덱으로 전환하면 대개 화면이 정상으로 돌아옵니다.' answer: '대체로 그렇습니다. 원격 세션 툴바나 설정에서 코덱을 전환할 수 있습니다 — VP8, VP9, AV1, 그리고 하드웨어가 지원하는 경우 H.264/H.265까지 가능합니다. 원격 하드웨어가 인코딩할 수 없는 코덱을 사용하면 화면이 비거나 멈춘 상태로 표시되며, VP9와 같은 소프트웨어 코덱으로 전환하면 대개 화면이 정상으로 돌아옵니다.'
- question: 'RustDesk가 한 PC에서는 이미지를 표시하지만 다른 PC에서는 표시하지 않습니다. 왜 그런가요?' - question: 'RustDesk가 한 PC에서는 이미지를 표시하지만 다른 PC에서는 표시하지 않습니다. 왜 그런가요?'
@@ -37,11 +37,10 @@ RustDesk에서 **"연결됨, 이미지 대기 중"**이라는 메시지와 함
가장 많이 보고되는 원인은 단연 **헤드리스 컴퓨터**입니다 — 모니터가 연결되지 않았거나 화면이 절전 모드인 상태로 실행 중인 서버, 미니 PC, 워크스테이션을 말합니다. 활성 디스플레이가 없으면 GPU가 프레임버퍼를 생성하지 않으므로, RustDesk는 연결은 되지만 보낼 것이 없습니다. 이런 패턴은 RustDesk 이슈 트래커에서 반복적으로 나타나며, [대상 기기의 모니터가 꺼져 있을 때 특히 검은 화면이 발생한다는 보고](https://github.com/rustdesk/rustdesk/issues/9884)와 오랫동안 이어지고 있는 ["연결됨, 이미지 대기 중" 스레드](https://github.com/rustdesk/rustdesk/issues/222)가 대표적입니다. 가장 많이 보고되는 원인은 단연 **헤드리스 컴퓨터**입니다 — 모니터가 연결되지 않았거나 화면이 절전 모드인 상태로 실행 중인 서버, 미니 PC, 워크스테이션을 말합니다. 활성 디스플레이가 없으면 GPU가 프레임버퍼를 생성하지 않으므로, RustDesk는 연결은 되지만 보낼 것이 없습니다. 이런 패턴은 RustDesk 이슈 트래커에서 반복적으로 나타나며, [대상 기기의 모니터가 꺼져 있을 때 특히 검은 화면이 발생한다는 보고](https://github.com/rustdesk/rustdesk/issues/9884)와 오랫동안 이어지고 있는 ["연결됨, 이미지 대기 중" 스레드](https://github.com/rustdesk/rustdesk/issues/222)가 대표적입니다.
캡처할 대상을 만들어주는 가지 방법이 있습니다: 캡처할 대상을 만들어주는 가지 방법이 있습니다:
- **모니터를 연결**하고 전원이 켜져 있으며 절전 모드가 아닌지 확인하세요. - **모니터를 연결**하고 전원이 켜져 있으며 절전 모드가 아닌지 확인하세요.
- **HDMI(또는 DisplayPort) 더미 플러그를 사용하세요.** 이 저렴한 어댑터는 GPU가 디스플레이가 연결되어 있다고 믿게 만들어, RustDesk가 가져갈 수 있는 프레임버퍼를 계속 렌더링하도록 합니다. 헤드리스 데스크톱과 홈 서버에서 표준적으로 사용되는 해결책입니다. - **HDMI(또는 DisplayPort) 더미 플러그를 사용하세요.** 이 저렴한 어댑터는 GPU가 디스플레이가 연결되어 있다고 믿게 만들어, RustDesk가 가져갈 수 있는 프레임버퍼를 계속 렌더링하도록 합니다. 헤드리스 데스크톱과 홈 서버에서 표준적으로 사용되는 해결책입니다.
- **Linux에서는 공식 문서화된 헤드리스 경로를 사용하세요.** RustDesk는 헤드리스 Linux 환경을 지원하지만, 설정 방식이 일반 데스크톱 세션과는 다릅니다 — 자세한 내용은 [헤드리스 Linux 지원 위키](https://github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support)를 참고하세요.
모니터가 연결되어 있는 _것이 맞다면_, 다음으로 의심할 곳은 절전 모드로 전환되었는지 여부입니다. 모니터가 연결되어 있는 _것이 맞다면_, 다음으로 의심할 곳은 절전 모드로 전환되었는지 여부입니다.
@@ -49,7 +48,7 @@ RustDesk에서 **"연결됨, 이미지 대기 중"**이라는 메시지와 함
| 원인 | 증상 | 해결책 | | 원인 | 증상 | 해결책 |
| -------------------------- | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------ | | -------------------------- | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------ |
| 헤드리스 / 디스플레이 없음 | 서버나 미니 PC에서 검은 화면 | 모니터를 연결하거나, HDMI 더미 플러그를 추가하거나, Linux 헤드리스 경로를 사용하세요 | | 헤드리스 / 디스플레이 없음 | 서버나 미니 PC에서 검은 화면 | 모니터를 연결하거나 HDMI 더미 플러그를 추가하세요 |
| 화면 절전 모드 / 잠금 | 이전에는 작동했으나 유휴 상태 후 검은 화면 | 화면을 깨우세요. 절전 모드/화면 보호기를 비활성화하세요. macOS에서는 설정에서 화면 절전을 중지하세요 | | 화면 절전 모드 / 잠금 | 이전에는 작동했으나 유휴 상태 후 검은 화면 | 화면을 깨우세요. 절전 모드/화면 보호기를 비활성화하세요. macOS에서는 설정에서 화면 절전을 중지하세요 |
| 권한 누락 (macOS) | 연결은 되지만 계속 검은 화면 | 개인정보 보호 및 보안에서 화면 기록 권한을 부여하세요. 로그인 화면용 헬퍼를 설치하세요 | | 권한 누락 (macOS) | 연결은 되지만 계속 검은 화면 | 개인정보 보호 및 보안에서 화면 기록 권한을 부여하세요. 로그인 화면용 헬퍼를 설치하세요 |
| 코덱 불일치 | 화면이 비거나 멈춤 | 코덱을 전환하세요 (VP8 / VP9 / AV1 / H.264 / H.265). 소프트웨어 코덱으로 전환하세요 | | 코덱 불일치 | 화면이 비거나 멈춤 | 코덱을 전환하세요 (VP8 / VP9 / AV1 / H.264 / H.265). 소프트웨어 코덱으로 전환하세요 |
@@ -83,7 +82,7 @@ RustDesk는 여러 방식으로 스트림을 인코딩할 수 있으며, 기본
### Linux와 Wayland ### Linux와 Wayland
Linux에서 **Wayland 화면 캡처는 PipeWire와 `xdg-desktop-portal`을 거쳐** 이루어집니다. 처음 한 번은 어떤 화면을 선택할지 동의를 요청하는 프롬프트가 뜨며 — 대부분의 경우 이 선택이 저장되어 다시 묻지 않습니다 — 활성 로그인 세션 내에서 작동합니다. 이는 Wayland의 보안 설계 방식이기 때문에, 그 자체로는 그리터(greeter, 로그인 화면)나 완전한 헤드리스 환경을 포함하지 않습니다 — 다만 무인(unattended) Wayland 캡처 기능은 현재 활발히 개발 중입니다 ([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). Wayland에서 빈 화면이 나타난다면, 보통 포털의 화면 공유 프롬프트를 수락하고 `xdg-desktop-portal`과 PipeWire가 설치되어 실행 중인지 확인하면 해결됩니다. 헤드리스 환경에서는 공식 문서화된 [헤드리스 설정](https://github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support)을 사용하세요. 배포판이 여전히 X11/Xorg 세션을 제공한다면 이를 사용해 로그인하는 것도 포털 경로를 피하는 방법입니다 — 하지만 많은 배포판이 Wayland 전용으로 전환하고 있는 만큼, 포털/PipeWire 경로를 제대로 해결하는 편이 더 미래 지향적인 접근입니다. Linux에서 **Wayland 화면 캡처는 PipeWire와 `xdg-desktop-portal`을 거쳐** 이루어집니다. 처음 한 번은 어떤 화면을 선택할지 동의를 요청하는 프롬프트가 뜨며 — 대부분의 경우 이 선택이 저장되어 다시 묻지 않습니다 — 활성 로그인 세션 내에서 작동합니다. 이는 Wayland의 보안 설계 방식이기 때문에, 그 자체로는 그리터(greeter, 로그인 화면) 포함하지 않습니다 — 다만 무인(unattended) Wayland 캡처 기능은 현재 활발히 개발 중입니다 ([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). Wayland에서 빈 화면이 나타난다면, 보통 포털의 화면 공유 프롬프트를 수락하고 `xdg-desktop-portal`과 PipeWire가 설치되어 실행 중인지 확인하면 해결됩니다. 배포판이 여전히 X11/Xorg 세션을 제공한다면 이를 사용해 로그인하는 것도 포털 경로를 피하는 방법입니다 — 하지만 많은 배포판이 Wayland 전용으로 전환하고 있는 만큼, 포털/PipeWire 경로를 제대로 해결하는 편이 더 미래 지향적인 접근입니다.
### 네트워크와 릴레이 ### 네트워크와 릴레이
+6 -14
View File
@@ -4,7 +4,7 @@ lang: 'ko'
translationKey: 'rustdesk-for-linux' translationKey: 'rustdesk-for-linux'
draft: false draft: false
title: '리눅스용 RustDesk: 오픈소스 원격 데스크톱' title: '리눅스용 RustDesk: 오픈소스 원격 데스크톱'
excerpt: '리눅스에서 RustDesk를 설치하고 실행하는 방법: .deb, .rpm, Flatpak, AppImage 패키지 선택, X11과 Wayland 비교, 헤드리스 및 무인 접속, 서버 자체 호스팅까지 다룹니다.' excerpt: '리눅스에서 RustDesk를 설치하고 실행하는 방법: .deb, .rpm, Flatpak, AppImage 패키지 선택, X11과 Wayland 비교, 무인 접속, 서버 자체 호스팅까지 다룹니다.'
image: '~/assets/images/blog/rustdesk-for-linux-og.webp' image: '~/assets/images/blog/rustdesk-for-linux-og.webp'
category: '가이드' category: '가이드'
tags: ['RustDesk', 'Linux', '셀프 호스팅'] tags: ['RustDesk', 'Linux', '셀프 호스팅']
@@ -12,21 +12,19 @@ author: 'RustDesk Team'
slug: 'rustdesk-for-linux-ko' slug: 'rustdesk-for-linux-ko'
faq: faq:
- question: 'RustDesk는 Wayland에서 작동하나요?' - question: 'RustDesk는 Wayland에서 작동하나요?'
answer: '네 — RustDesk는 1.4.3에서 추가된 다중 모니터 공유를 포함해 원격 데스크톱 도구 중에서도 손꼽히게 강력한 Wayland 지원을 제공합니다. Wayland에서는 PipeWire와 XDG 데스크톱 포털을 통해 화면을 캡처하며, 공유할 디스플레이를 선택하는 동의 대화상자가 표시됩니다 — 대부분의 경우 선택 사항이 기억되어 다시 묻지 않으며, 현재 로그인된 세션 내에서 작동합니다. 이 동의 절차는 모든 화면 공유 앱에 공통으로 적용되는 Wayland의 보안 설계입니다. 로그인 이전이나 완전 무인 상태의 머신에서는 아래의 헤드리스 가상 디스플레이 설정을 사용하세요(또는 배포판이 아직 X11 세션을 제공한다면 X11 세션을 사용할 수 있습니다 — 여러 배포판이 Wayland 전용으로 전환하고 있기 때문입니다). 완전 무인 Wayland 캡처는 현재 활발히 개발 중입니다(github.com/rustdesk/rustdesk/pull/15420 참고).' answer: '네 — RustDesk는 1.4.3에서 추가된 다중 모니터 공유를 포함해 원격 데스크톱 도구 중에서도 손꼽히게 강력한 Wayland 지원을 제공합니다. Wayland에서는 PipeWire와 XDG 데스크톱 포털을 통해 화면을 캡처하며, 공유할 디스플레이를 선택하는 동의 대화상자가 표시됩니다 — 대부분의 경우 선택 사항이 기억되어 다시 묻지 않으며, 현재 로그인된 세션 내에서 작동합니다. 이 동의 절차는 모든 화면 공유 앱에 공통으로 적용되는 Wayland의 보안 설계입니다. 로그인 이전이나 완전 무인 상태의 머신에서는 배포판이 아직 X11 세션을 제공한다면 X11 세션을 사용하세요. 완전 무인 Wayland 캡처는 현재 활발히 개발 중입니다(github.com/rustdesk/rustdesk/pull/15420 참고).'
- question: '리눅스에서 어떤 패키지를 설치해야 하나요?' - question: '리눅스에서 어떤 패키지를 설치해야 하나요?'
answer: 'Debian, Ubuntu, Linux Mint에서는 .deb를, Fedora, RHEL, openSUSE에서는 .rpm을 사용하세요. 샌드박스 환경에서 폭넓은 호환성을 원한다면 Flathub의 Flatpak을, 단일 파일로 된 대안이 필요하다면 휴대용 AppImage를 사용할 수 있습니다. .deb와 .rpm 패키지는 systemd 서비스를 등록하고 시작하므로 재부팅 후에도 RustDesk가 유지되지만, Flatpak과 AppImage는 기본적으로 그렇지 않습니다.' answer: 'Debian, Ubuntu, Linux Mint에서는 .deb를, Fedora, RHEL, openSUSE에서는 .rpm을 사용하세요. 샌드박스 환경에서 폭넓은 호환성을 원한다면 Flathub의 Flatpak을, 단일 파일로 된 대안이 필요하다면 휴대용 AppImage를 사용할 수 있습니다. .deb와 .rpm 패키지는 systemd 서비스를 등록하고 시작하므로 재부팅 후에도 RustDesk가 유지되지만, Flatpak과 AppImage는 기본적으로 그렇지 않습니다.'
- question: '헤드리스 리눅스 머신에서 왜 검은 화면이 나타나나요?'
answer: '모니터가 연결되어 있지 않으면 X나 Wayland는 프레임버퍼를 전혀 할당하지 않으므로 RustDesk가 캡처할 화면 자체가 없어, 뷰어에는 검은 화면 또는 이미지 대기 화면이 표시됩니다. 더미 HDMI/DisplayPort 플러그를 연결하거나, xserver-xorg-video-dummy나 VKMS 같은 가상 디스플레이를 구성하거나, RustDesk의 선택적 리눅스 헤드리스 모드를 활성화해 가상 디스플레이가 자동으로 생성되도록 하세요.'
- question: '리눅스에서 RustDesk 서버를 직접 호스팅할 수 있나요?' - question: '리눅스에서 RustDesk 서버를 직접 호스팅할 수 있나요?'
answer: '네. RustDesk 서버(hbbs ID/랑데부 프로세스와 hbbr 릴레이 프로세스)는 리눅스용으로 제작되었으며 이것이 표준적인 실행 방식입니다. 무료 오픈소스 커뮤니티 서버는 비용 없이 무기한 실행할 수 있으며, Server Pro는 여기에 웹 콘솔, 기기 그룹, 맞춤 클라이언트 생성기를 추가로 제공합니다. 두 가지 모두 일반 리눅스 VM이나 베어메탈 호스트에 설치할 수 있습니다.' answer: '네. RustDesk 서버(hbbs ID/랑데부 프로세스와 hbbr 릴레이 프로세스)는 리눅스용으로 제작되었으며 이것이 표준적인 실행 방식입니다. 무료 오픈소스 커뮤니티 서버는 비용 없이 무기한 실행할 수 있으며, Server Pro는 여기에 웹 콘솔, 기기 그룹, 맞춤 클라이언트 생성기를 추가로 제공합니다. 두 가지 모두 일반 리눅스 VM이나 베어메탈 호스트에 설치할 수 있습니다.'
metadata: metadata:
description: '리눅스용 RustDesk를 처음부터 끝까지 다룹니다: 모든 배포판과 ARM 보드에 맞는 패키지 선택, Wayland 및 X11 화면 캡처, 헤드리스 설정, 자체 서버 운영까지.' description: '리눅스용 RustDesk를 처음부터 끝까지 다룹니다: 모든 배포판과 ARM 보드에 맞는 패키지 선택, Wayland 및 X11 화면 캡처, 자체 서버 운영까지.'
keywords: 'RustDesk 리눅스, RustDesk 우분투, RustDesk Wayland, RustDesk X11, RustDesk 리눅스 설치' keywords: 'RustDesk 리눅스, RustDesk 우분투, RustDesk Wayland, RustDesk X11, RustDesk 리눅스 설치'
--- ---
리눅스 사용자에게는 그동안 괜찮은 원격 데스크톱 도구의 선택지가 그리 많지 않았고, 존재하는 도구들도 대부분 폐쇄형 상용 제품이거나 오래된 VNC 스택이었습니다. RustDesk는 이와는 다른 위치에 있습니다. AGPL 라이선스로 배포되는 오픈소스 원격 데스크톱 클라이언트이며, 모든 주요 배포판에서 네이티브로 실행되고, 직접 호스팅하는 서버를 지정해 사용할 수도 있습니다. 감사 가능한 코드, 네이티브 리눅스 클라이언트, 자체 호스팅 가능한 인프라라는 이 조합이야말로 누군가 리눅스용 오픈소스 원격 데스크톱을 찾을 때 RustDesk가 가장 먼저 거론되는 답 중 하나가 된 이유입니다. 리눅스 사용자에게는 그동안 괜찮은 원격 데스크톱 도구의 선택지가 그리 많지 않았고, 존재하는 도구들도 대부분 폐쇄형 상용 제품이거나 오래된 VNC 스택이었습니다. RustDesk는 이와는 다른 위치에 있습니다. AGPL 라이선스로 배포되는 오픈소스 원격 데스크톱 클라이언트이며, 모든 주요 배포판에서 네이티브로 실행되고, 직접 호스팅하는 서버를 지정해 사용할 수도 있습니다. 감사 가능한 코드, 네이티브 리눅스 클라이언트, 자체 호스팅 가능한 인프라라는 이 조합이야말로 누군가 리눅스용 오픈소스 원격 데스크톱을 찾을 때 RustDesk가 가장 먼저 거론되는 답 중 하나가 된 이유입니다.
이 가이드에서는 설치 방법, 누구나 한 번쯤 헷갈리는 부분(X11과 Wayland의 차이), 무인 및 헤드리스 접속을 설정하는 방법, 그리고 서버가 전체 구조에서 어떤 역할을 하는지 다룹니다. 이 가이드에서는 설치 방법, 누구나 한 번쯤 헷갈리는 부분(X11과 Wayland의 차이), 무인 접속을 설정하는 방법, 그리고 서버가 전체 구조에서 어떤 역할을 하는지 다룹니다.
## 리눅스에 RustDesk 설치하기 ## 리눅스에 RustDesk 설치하기
@@ -53,7 +51,7 @@ RustDesk는 일반적으로 사용되는 모든 리눅스 패키징 형식으로
**Wayland: RustDesk는 원격 데스크톱 도구 중에서도 단연 가장 강력한 지원을 제공한다고 할 만합니다.** RustDesk는 버전 1.2.0부터 Wayland를 지원해 왔으며 이후로도 계속 기능을 확장해 왔습니다. Wayland 컴포지터는 프레임버퍼에 직접 접근하는 것을 허용하지 않기 때문에, RustDesk는 `xdg-desktop-portal` 서비스와 [PipeWire](https://deepwiki.com/rustdesk/rustdesk/6.3.1-wayland-support)를 통해 화면을 캡처하고, 커널의 `uinput` 모듈을 통해 입력을 주입합니다. 이는 Wayland 자체의 설계에서 비롯된 두 가지 결과이며, RustDesk뿐 아니라 모든 Wayland 화면 공유 도구에 동일하게 적용됩니다: **Wayland: RustDesk는 원격 데스크톱 도구 중에서도 단연 가장 강력한 지원을 제공한다고 할 만합니다.** RustDesk는 버전 1.2.0부터 Wayland를 지원해 왔으며 이후로도 계속 기능을 확장해 왔습니다. Wayland 컴포지터는 프레임버퍼에 직접 접근하는 것을 허용하지 않기 때문에, RustDesk는 `xdg-desktop-portal` 서비스와 [PipeWire](https://deepwiki.com/rustdesk/rustdesk/6.3.1-wayland-support)를 통해 화면을 캡처하고, 커널의 `uinput` 모듈을 통해 입력을 주입합니다. 이는 Wayland 자체의 설계에서 비롯된 두 가지 결과이며, RustDesk뿐 아니라 모든 Wayland 화면 공유 도구에 동일하게 적용됩니다:
- **연결마다 필요한 동의.** 포털은 공유할 디스플레이를 선택하도록 요청하는 대화상자를 표시합니다. 이는 RustDesk의 버그가 아니라 Wayland가 의도적으로 설계한 보안 기능입니다 — 백그라운드 앱이 사용자 몰래 화면 녹화를 시작할 수 없도록 하기 위함입니다. 포털 v4 이상에서는 "복원 토큰(restore token)"을 지원해 매번 다시 묻지 않지만, 최초 공유 시에는 화면에서 클릭이 필요합니다. - **연결마다 필요한 동의.** 포털은 공유할 디스플레이를 선택하도록 요청하는 대화상자를 표시합니다. 이는 RustDesk의 버그가 아니라 Wayland가 의도적으로 설계한 보안 기능입니다 — 백그라운드 앱이 사용자 몰래 화면 녹화를 시작할 수 없도록 하기 위함입니다. 포털 v4 이상에서는 "복원 토큰(restore token)"을 지원해 매번 다시 묻지 않지만, 최초 공유 시에는 화면에서 클릭이 필요합니다.
- **활성 세션에서만 작동.** Wayland 캡처는 로그인된 그래픽 세션에 종속됩니다. Wayland 로그인 화면(그리터) 캡처는 아직 지원되지 않으며, 현재 활발히 개발 중입니다([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). 현재 로그인 이전 접속이 필요하다면 아래의 헤드리스/가상 디스플레이 구성을 사용하거나, 아직 X11 세션을 제공하는 배포판이라면 X11 세션을 사용하세요. - **활성 세션에서만 작동.** Wayland 캡처는 로그인된 그래픽 세션에 종속됩니다. Wayland 로그인 화면(그리터) 캡처는 아직 지원되지 않으며, 현재 활발히 개발 중입니다([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). 현재 로그인 이전 접속이 필요하다면 아직 X11 세션을 제공하는 배포판에서 X11 세션을 사용하세요.
Wayland 지원은 계속 개선되고 있습니다 — 예를 들어 RustDesk 1.4.3(2025년 10월)에서는 [Wayland용 다중 모니터 공유가 추가](https://ubuntuhandbook.org/index.php/2025/10/rustdesk-released-1-4-3-with-multi-monitor-for-wayland-virtual-mouse/)되었습니다. 다만 Wayland 환경에서 접속했는데 검은 화면이 보인다면, 이는 거의 항상 portal/PipeWire 경로가 제대로 충족되지 않은 경우입니다. Wayland의 검은 화면 문제를 구체적으로 다루는 [RustDesk가 연결되었지만 이미지를 기다리는 경우](/ko/blog/rustdesk-connected-waiting-for-image-ko) 글을 참고하세요. Wayland 지원은 계속 개선되고 있습니다 — 예를 들어 RustDesk 1.4.3(2025년 10월)에서는 [Wayland용 다중 모니터 공유가 추가](https://ubuntuhandbook.org/index.php/2025/10/rustdesk-released-1-4-3-with-multi-monitor-for-wayland-virtual-mouse/)되었습니다. 다만 Wayland 환경에서 접속했는데 검은 화면이 보인다면, 이는 거의 항상 portal/PipeWire 경로가 제대로 충족되지 않은 경우입니다. Wayland의 검은 화면 문제를 구체적으로 다루는 [RustDesk가 연결되었지만 이미지를 기다리는 경우](/ko/blog/rustdesk-connected-waiting-for-image-ko) 글을 참고하세요.
@@ -63,21 +61,15 @@ Wayland 지원은 계속 개선되고 있습니다 — 예를 들어 RustDesk 1.
1. systemd 서비스가 등록되도록 `.deb` 또는 `.rpm`으로 설치하거나, 앱에서 **서비스 활성화**를 클릭하세요. 1. systemd 서비스가 등록되도록 `.deb` 또는 `.rpm`으로 설치하거나, 앱에서 **서비스 활성화**를 클릭하세요.
2. RustDesk의 연결 설정에서 강력한 **고정 비밀번호**를 설정하세요(가능하면 2단계 인증도 활성화하세요). 2. RustDesk의 연결 설정에서 강력한 **고정 비밀번호**를 설정하세요(가능하면 2단계 인증도 활성화하세요).
3. 로그인 이전이나 사용자 로그인 전반에 걸친 접속이 필요하다면 아래의 헤드리스 가상 디스플레이 구성을 사용하세요(위에서 다룬 Wayland 그리터의 한계가 여기에도 적용됩니다).
염두에 두어야 할 Wayland의 현실이 하나 있습니다. Wayland 절에서 설명한 동의 기반 포털 방식 때문에, 개발 중인 무인 지원 기능이 정식으로 도입되기 전까지는 완전한 무인 캡처가 X11보다 까다롭습니다. 따라서 사람이 개입하지 않는 머신에는 헤드리스 가상 디스플레이 설정을 계획해 두세요.
## 헤드리스 리눅스: 모니터가 없는 서버 ## 헤드리스 리눅스: 모니터가 없는 서버
리눅스에서 매우 흔한 사용 사례 중 하나는 디스플레이가 전혀 연결되지 않은 머신입니다 — 홈 서버, 실험실용 머신, VM 등이 그렇습니다. 이 경우 문제는 RustDesk가 아니라 그래픽 스택에 있습니다. 모니터가 연결되어 있지 않으면 X나 Wayland는 프레임버퍼를 전혀 할당하지 않으므로, 그야말로 캡처할 이미지 자체가 없어 검은 화면이 나타납니다. 리눅스에서 매우 흔한 사용 사례 중 하나는 디스플레이가 전혀 연결되지 않은 머신입니다 — 홈 서버, 실험실용 머신, VM 등이 그렇습니다. 이 경우 문제는 RustDesk가 아니라 그래픽 스택에 있습니다. 모니터가 연결되어 있지 않으면 X나 Wayland는 프레임버퍼를 전혀 할당하지 않으므로, 그야말로 캡처할 이미지 자체가 없어 검은 화면이 나타납니다.
렌더링할 대상을 만들어 주는 가지 방법이 있습니다: 렌더링할 대상을 만들어 주는 가지 방법이 있습니다:
- **더미 플러그** — GPU가 모니터가 연결되어 있다고 인식하게 만드는 저렴한 물리적 HDMI/DisplayPort "헤드리스" 동글입니다. - **더미 플러그** — GPU가 모니터가 연결되어 있다고 인식하게 만드는 저렴한 물리적 HDMI/DisplayPort "헤드리스" 동글입니다.
- **가상 디스플레이 드라이버** — X11에서는 `xserver-xorg-video-dummy`, 또는 VKMS 같은 커널 수준의 옵션을 사용할 수 있습니다. - **가상 디스플레이 드라이버** — X11에서는 `xserver-xorg-video-dummy`, 또는 VKMS 같은 커널 수준의 옵션을 사용할 수 있습니다.
- **RustDesk의 선택적 헤드리스 모드**`sudo rustdesk --option allow-linux-headless Y` 명령으로 활성화할 수 있습니다. [헤드리스 리눅스 지원 위키](https://github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support)에 따르면 이 기능은 기본적으로 비활성화되어 있으며, 주로 GNOME이 설치된 Ubuntu에서 테스트되었고 `xserver-xorg-video-dummy``lightdm` 같은 패키지가 필요합니다. `sudo rustdesk --get-id`로 머신의 ID를 확인할 수 있고, `sudo rustdesk --password <password>`로 비밀번호를 설정할 수 있습니다.
헤드리스 모드는 아직 다듬어지지 않은 부분이 있으므로, 바로 사용 가능한 완성형 기능이라기보다는 "조심스럽게 다뤄야 작동하는" 기능으로 여기시기 바랍니다.
## 리눅스에서 RustDesk 서버 자체 호스팅하기 ## 리눅스에서 RustDesk 서버 자체 호스팅하기
@@ -58,7 +58,7 @@ RustDesk가 서비스로 실행되면 누군가 로그인하기 전에 미리
| ------- | -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | | ------- | -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| Windows | 설치 후 서비스가 계속 실행되도록 유지(컴퓨터와 함께 자동 시작) | 포터블 exe는 로그아웃/UAC 시 연결이 끊기므로 설치 파일을 사용할 것 | | Windows | 설치 후 서비스가 계속 실행되도록 유지(컴퓨터와 함께 자동 시작) | 포터블 exe는 로그아웃/UAC 시 연결이 끊기므로 설치 파일을 사용할 것 |
| macOS | 설치, 영구 비밀번호 설정, 권한 부여 | 화면 기록과 손쉬운 사용 권한을 반드시 부여해야 하며, 로그인 화면 캡처에는 헬퍼 설치 필요 | | macOS | 설치, 영구 비밀번호 설정, 권한 부여 | 화면 기록과 손쉬운 사용 권한을 반드시 부여해야 하며, 로그인 화면 캡처에는 헬퍼 설치 필요 |
| Linux | 서비스 패키지 설치 | Wayland는 활성 세션이 필요함. 로그인 전 화면에는 헤드리스 가상 디스플레이 설정을 사용하거나, 배포판이 여전히 제공하는 경우 X11을 사용 | | Linux | 서비스 패키지 설치 | Wayland는 활성 세션이 필요함. 로그인 전 화면에는 배포판이 여전히 제공하는 경우 X11을 사용 |
| Android | 영구 비밀번호 설정, 캡처 활성화 | 화면이 켜져 있어야 하며, 화면 캡처(MediaProjection) 동의와 입력 권한을 부여해야 함 | | Android | 영구 비밀번호 설정, 캡처 활성화 | 화면이 켜져 있어야 하며, 화면 캡처(MediaProjection) 동의와 입력 권한을 부여해야 함 |
### Windows ### Windows
@@ -71,7 +71,7 @@ macOS는 화면 캡처와 입력 기능을 권한으로 제한합니다. 설치
### Linux ### Linux
서비스 구성 요소가 부팅 시 실행되도록 RustDesk를 설치하세요. 로그인 그리터(greeter) 화면에 머물러 있는 컴퓨터의 경우, Wayland는 아직 그리터 화면을 캡처할 수 없습니다. 이는 RustDesk의 한계가 아니라 Wayland 자체의 설계 문제이며, RustDesk는 이 문제를 해결하기 위해 적극적으로 작업하고 있습니다([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). 헤드리스 장비에서는 가상 디스플레이 구성을 사용하고, 데스크톱에서는 배포판이 X11/Xorg 세션을 계속 제공하는 경우 이를 통해 처리할 수 있지만, 여러 배포판이 Wayland 전용으로 전환하는 추세입니다. 자세한 내용은 [Linux용 RustDesk](/ko/blog/rustdesk-for-linux-ko)를 참고하세요. 서비스 구성 요소가 부팅 시 실행되도록 RustDesk를 설치하세요. 로그인 그리터(greeter) 화면에 머물러 있는 컴퓨터의 경우, Wayland는 아직 그리터 화면을 캡처할 수 없습니다. 이는 RustDesk의 한계가 아니라 Wayland 자체의 설계 문제이며, RustDesk는 이 문제를 해결하기 위해 적극적으로 작업하고 있습니다([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). 데스크톱에서는 배포판이 X11/Xorg 세션을 계속 제공하는 경우 이를 통해 처리할 수 있지만, 여러 배포판이 Wayland 전용으로 전환하는 추세입니다. 자세한 내용은 [Linux용 RustDesk](/ko/blog/rustdesk-for-linux-ko)를 참고하세요.
## 3단계: 사전 구성된 클라이언트로 대규모 배포하기 ## 3단계: 사전 구성된 클라이언트로 대규모 배포하기
@@ -14,7 +14,7 @@ faq:
- question: 'Por que o RustDesk exibe "Conectado, aguardando imagem"?' - question: 'Por que o RustDesk exibe "Conectado, aguardando imagem"?'
answer: 'A sessão foi estabelecida com sucesso, mas a máquina remota não está gerando uma imagem de tela para enviar. O motivo mais comum é a ausência de um display ativo para capturar — um servidor headless sem monitor, uma tela que entrou em suspensão ou foi bloqueada, ou um display que o sistema operacional não permite que o RustDesk grave. Corrija a origem da captura e a imagem aparece.' answer: 'A sessão foi estabelecida com sucesso, mas a máquina remota não está gerando uma imagem de tela para enviar. O motivo mais comum é a ausência de um display ativo para capturar — um servidor headless sem monitor, uma tela que entrou em suspensão ou foi bloqueada, ou um display que o sistema operacional não permite que o RustDesk grave. Corrija a origem da captura e a imagem aparece.'
- question: 'Como corrigir o RustDesk que fica "aguardando imagem" em um computador headless?' - question: 'Como corrigir o RustDesk que fica "aguardando imagem" em um computador headless?'
answer: 'Uma máquina sem monitor não tem framebuffer para capturar, então o RustDesk não tem nada para enviar. Conecte um monitor real, use um dummy plug HDMI barato que faz a GPU pensar que há um display conectado ou, no Linux, use a configuração headless documentada (github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support). Ativar ou manter o display acordado resolve a maioria dos casos.' answer: 'Uma máquina sem monitor não tem framebuffer para capturar, então o RustDesk não tem nada para enviar. Conecte um monitor real ou use um dummy plug HDMI barato que faz a GPU pensar que há um display conectado. Ativar ou manter o display acordado resolve a maioria dos casos.'
- question: 'Alterar o codec de vídeo corrige a tela preta?' - question: 'Alterar o codec de vídeo corrige a tela preta?'
answer: 'Frequentemente, sim. Na barra de ferramentas da sessão remota ou nas configurações, você pode alternar entre codecs — VP8, VP9, AV1 ou H.264/H.265, quando o hardware oferece suporte. Um codec que o hardware remoto não consegue codificar exibirá uma imagem em branco ou congelada, e voltar para um codec por software, como o VP9, geralmente restaura a imagem.' answer: 'Frequentemente, sim. Na barra de ferramentas da sessão remota ou nas configurações, você pode alternar entre codecs — VP8, VP9, AV1 ou H.264/H.265, quando o hardware oferece suporte. Um codec que o hardware remoto não consegue codificar exibirá uma imagem em branco ou congelada, e voltar para um codec por software, como o VP9, geralmente restaura a imagem.'
- question: 'O RustDesk exibe a imagem em um PC, mas não em outro. Por quê?' - question: 'O RustDesk exibe a imagem em um PC, mas não em outro. Por quê?'
@@ -37,11 +37,10 @@ A sessão conectou, mas não há framebuffer para capturar. Em uma máquina remo
De longe, a causa mais relatada é uma **máquina headless** — um servidor, mini-PC ou estação de trabalho rodando sem monitor conectado, ou com o display em suspensão. Sem um display ativo, a GPU não produz framebuffer, então o RustDesk conecta, mas não tem nada para enviar. Esse padrão aparece repetidamente no rastreador de problemas do RustDesk, incluindo [relatos de telas pretas especificamente quando o monitor do alvo está desligado](https://github.com/rustdesk/rustdesk/issues/9884) e a [thread de longa duração sobre "Conectado, aguardando imagem"](https://github.com/rustdesk/rustdesk/issues/222). De longe, a causa mais relatada é uma **máquina headless** — um servidor, mini-PC ou estação de trabalho rodando sem monitor conectado, ou com o display em suspensão. Sem um display ativo, a GPU não produz framebuffer, então o RustDesk conecta, mas não tem nada para enviar. Esse padrão aparece repetidamente no rastreador de problemas do RustDesk, incluindo [relatos de telas pretas especificamente quando o monitor do alvo está desligado](https://github.com/rustdesk/rustdesk/issues/9884) e a [thread de longa duração sobre "Conectado, aguardando imagem"](https://github.com/rustdesk/rustdesk/issues/222).
Três maneiras de dar a ele algo para capturar: Duas maneiras de dar a ele algo para capturar:
- **Conecte um monitor** e certifique-se de que está ligado e ativo. - **Conecte um monitor** e certifique-se de que está ligado e ativo.
- **Use um dummy plug HDMI (ou DisplayPort).** Esses adaptadores baratos fazem a GPU acreditar que há um display conectado, então ela continua renderizando um framebuffer para o RustDesk capturar. Essa é a solução padrão para desktops headless e servidores domésticos. - **Use um dummy plug HDMI (ou DisplayPort).** Esses adaptadores baratos fazem a GPU acreditar que há um display conectado, então ela continua renderizando um framebuffer para o RustDesk capturar. Essa é a solução padrão para desktops headless e servidores domésticos.
- **No Linux, use o caminho headless documentado.** O RustDesk oferece suporte a configurações headless no Linux, mas a configuração é diferente de uma sessão de desktop normal — veja a [wiki de Suporte Headless para Linux](https://github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support).
Se um monitor _estiver_ conectado, o próximo suspeito é que ele entrou em suspensão. Se um monitor _estiver_ conectado, o próximo suspeito é que ele entrou em suspensão.
@@ -49,7 +48,7 @@ Se um monitor _estiver_ conectado, o próximo suspeito é que ele entrou em susp
| Causa | Sinal | Solução | | Causa | Sinal | Solução |
| ---------------------------------- | ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | ---------------------------------- | ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Headless / sem display | Tela preta em um servidor ou mini-PC | Conecte um monitor, adicione um dummy plug HDMI ou use o caminho headless do Linux | | Headless / sem display | Tela preta em um servidor ou mini-PC | Conecte um monitor ou adicione um dummy plug HDMI |
| Tela em suspensão / bloqueada | Funcionava antes, preta após inatividade | Ative a tela; desative a suspensão/proteção de tela; no macOS, impeça a suspensão do display nas Configurações | | Tela em suspensão / bloqueada | Funcionava antes, preta após inatividade | Ative a tela; desative a suspensão/proteção de tela; no macOS, impeça a suspensão do display nas Configurações |
| Permissão ausente (macOS) | Conecta, tela preta permanente | Conceda Gravação de Tela em Privacidade e Segurança; instale o helper para a tela de login | | Permissão ausente (macOS) | Conecta, tela preta permanente | Conceda Gravação de Tela em Privacidade e Segurança; instale o helper para a tela de login |
| Incompatibilidade de codec | Imagem em branco ou congelada | Troque o codec (VP8 / VP9 / AV1 / H.264 / H.265); volte para um codec por software | | Incompatibilidade de codec | Imagem em branco ou congelada | Troque o codec (VP8 / VP9 / AV1 / H.264 / H.265); volte para um codec por software |
@@ -83,7 +82,7 @@ Algumas GPUs — configurações NVIDIA aparecem com mais frequência — entram
### Linux e Wayland ### Linux e Wayland
No Linux, **a captura de tela no Wayland passa pelo PipeWire e pelo `xdg-desktop-portal`**: ele solicita consentimento para escolher um display na primeira vez — na maioria dos casos, a escolha é lembrada, então não solicita novamente — e funciona dentro de uma sessão de login ativa. Esse é um design de segurança do Wayland, então, por si só, não cobre a tela de login (greeter) nem uma máquina verdadeiramente headless — embora a captura Wayland sem supervisão esteja em desenvolvimento ativo ([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). Se você tiver uma tela em branco no Wayland, a solução geralmente é aceitar o aviso de compartilhamento de tela do portal e confirmar que o `xdg-desktop-portal` e o PipeWire estão instalados e em execução; em uma máquina headless, use a [configuração headless](https://github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support) documentada. Fazer login em uma sessão X11/Xorg também evita o caminho do portal onde uma distribuição ainda oferece essa opção — mas, à medida que muitas distribuições migram para Wayland exclusivamente, corrigir o caminho do portal/PipeWire é a abordagem mais preparada para o futuro. No Linux, **a captura de tela no Wayland passa pelo PipeWire e pelo `xdg-desktop-portal`**: ele solicita consentimento para escolher um display na primeira vez — na maioria dos casos, a escolha é lembrada, então não solicita novamente — e funciona dentro de uma sessão de login ativa. Esse é um design de segurança do Wayland, então, por si só, não cobre a tela de login (greeter) — embora a captura Wayland sem supervisão esteja em desenvolvimento ativo ([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). Se você tiver uma tela em branco no Wayland, a solução geralmente é aceitar o aviso de compartilhamento de tela do portal e confirmar que o `xdg-desktop-portal` e o PipeWire estão instalados e em execução. Fazer login em uma sessão X11/Xorg também evita o caminho do portal onde uma distribuição ainda oferece essa opção — mas, à medida que muitas distribuições migram para Wayland exclusivamente, corrigir o caminho do portal/PipeWire é a abordagem mais preparada para o futuro.
### Rede e relay ### Rede e relay
+6 -14
View File
@@ -4,7 +4,7 @@ lang: pt
translationKey: rustdesk-for-linux translationKey: rustdesk-for-linux
draft: false draft: false
title: 'RustDesk para Linux: o desktop remoto de código aberto' title: 'RustDesk para Linux: o desktop remoto de código aberto'
excerpt: 'Instale e execute o RustDesk no Linux: .deb, .rpm, Flatpak e AppImage, X11 vs Wayland, acesso headless e não assistido, e auto-hospedagem do servidor.' excerpt: 'Instale e execute o RustDesk no Linux: .deb, .rpm, Flatpak e AppImage, X11 vs Wayland, acesso não assistido e auto-hospedagem do servidor.'
image: ~/assets/images/blog/rustdesk-for-linux-og.webp image: ~/assets/images/blog/rustdesk-for-linux-og.webp
category: 'Guias' category: 'Guias'
tags: ['RustDesk', 'Linux', 'Auto-hospedagem'] tags: ['RustDesk', 'Linux', 'Auto-hospedagem']
@@ -12,21 +12,19 @@ author: 'RustDesk Team'
slug: 'rustdesk-para-linux-o-desktop-remoto-de-codigo-aberto' slug: 'rustdesk-para-linux-o-desktop-remoto-de-codigo-aberto'
faq: faq:
- question: 'O RustDesk funciona no Wayland?' - question: 'O RustDesk funciona no Wayland?'
answer: 'Sim — o RustDesk tem um dos suportes a Wayland mais robustos entre as ferramentas de desktop remoto, incluindo o compartilhamento multimonitor adicionado na versão 1.4.3. No Wayland, ele captura a tela por meio do PipeWire e do portal de desktop XDG, que exibe uma caixa de diálogo de consentimento para escolher um display — na maioria dos casos a escolha é lembrada, então você não precisa confirmar novamente — e funciona dentro da sessão gráfica ativa e autenticada. Essa etapa de consentimento é um recurso de segurança do próprio Wayland, compartilhado por todos os aplicativos de compartilhamento de tela. Para acesso antes do login ou em máquinas totalmente não assistidas, use por enquanto a configuração headless com display virtual (ou uma sessão X11, em distribuições que ainda oferecem essa opção, já que várias estão migrando para usar somente Wayland); a captura Wayland totalmente não assistida está em desenvolvimento ativo (veja github.com/rustdesk/rustdesk/pull/15420).' answer: 'Sim — o RustDesk tem um dos suportes a Wayland mais robustos entre as ferramentas de desktop remoto, incluindo o compartilhamento multimonitor adicionado na versão 1.4.3. No Wayland, ele captura a tela por meio do PipeWire e do portal de desktop XDG, que exibe uma caixa de diálogo de consentimento para escolher um display — na maioria dos casos a escolha é lembrada, então você não precisa confirmar novamente — e funciona dentro da sessão gráfica ativa e autenticada. Essa etapa de consentimento é um recurso de segurança do próprio Wayland, compartilhado por todos os aplicativos de compartilhamento de tela. Para acesso antes do login ou em máquinas totalmente não assistidas, use por enquanto uma sessão X11 em distribuições que ainda oferecem essa opção, já que várias estão migrando para usar somente Wayland; a captura Wayland totalmente não assistida está em desenvolvimento ativo (veja github.com/rustdesk/rustdesk/pull/15420).'
- question: 'Qual pacote devo instalar no Linux?' - question: 'Qual pacote devo instalar no Linux?'
answer: 'Use o .deb no Debian, Ubuntu e Linux Mint, o .rpm no Fedora, RHEL e openSUSE, o Flatpak do Flathub para uma versão isolada e amplamente compatível, ou o AppImage portátil como alternativa em arquivo único. Os pacotes .deb e .rpm registram e iniciam um serviço systemd, de modo que o RustDesk sobrevive a reinicializações; o Flatpak e o AppImage não fazem isso por padrão.' answer: 'Use o .deb no Debian, Ubuntu e Linux Mint, o .rpm no Fedora, RHEL e openSUSE, o Flatpak do Flathub para uma versão isolada e amplamente compatível, ou o AppImage portátil como alternativa em arquivo único. Os pacotes .deb e .rpm registram e iniciam um serviço systemd, de modo que o RustDesk sobrevive a reinicializações; o Flatpak e o AppImage não fazem isso por padrão.'
- question: 'Por que minha máquina Linux headless mostra uma tela preta?'
answer: 'Sem nenhum monitor conectado, o X ou o Wayland nunca alocam um framebuffer, então não há nada para o RustDesk capturar, e o visualizador mostra uma tela preta ou de espera pela imagem. Conecte um plugue HDMI/DisplayPort dummy, configure um display virtual como o xserver-xorg-video-dummy ou o VKMS, ou ative o modo headless opcional do RustDesk para Linux, para que um display virtual seja criado automaticamente para você.'
- question: 'Posso fazer a auto-hospedagem do servidor RustDesk no Linux?' - question: 'Posso fazer a auto-hospedagem do servidor RustDesk no Linux?'
answer: 'Sim. O servidor do RustDesk (os processos hbbs de ID/rendezvous e hbbr de retransmissão) é feito para Linux, e essa é a forma padrão de executá-lo. O servidor comunitário, gratuito e de código aberto, roda indefinidamente sem custo, e o Server Pro acrescenta um console web, grupos de dispositivos e um gerador de cliente personalizado. Ambos podem ser instalados em uma VM Linux simples ou em um servidor bare-metal.' answer: 'Sim. O servidor do RustDesk (os processos hbbs de ID/rendezvous e hbbr de retransmissão) é feito para Linux, e essa é a forma padrão de executá-lo. O servidor comunitário, gratuito e de código aberto, roda indefinidamente sem custo, e o Server Pro acrescenta um console web, grupos de dispositivos e um gerador de cliente personalizado. Ambos podem ser instalados em uma VM Linux simples ou em um servidor bare-metal.'
metadata: metadata:
description: 'RustDesk no Linux, de ponta a ponta: escolha de pacotes para cada distribuição e placa ARM, captura de tela em Wayland e X11, configuração headless e execução do seu próprio servidor.' description: 'RustDesk no Linux, de ponta a ponta: escolha de pacotes para cada distribuição e placa ARM, captura de tela em Wayland e X11, e execução do seu próprio servidor.'
keywords: 'RustDesk para Linux, RustDesk Ubuntu, RustDesk Wayland, RustDesk X11, instalar RustDesk no Linux' keywords: 'RustDesk para Linux, RustDesk Ubuntu, RustDesk Wayland, RustDesk X11, instalar RustDesk no Linux'
--- ---
Usuários de Linux nunca tiveram muitas opções de boas ferramentas de desktop remoto, e as que existem costumam ser produtos comerciais de código fechado ou pilhas VNC já ultrapassadas. O RustDesk ocupa uma posição diferente: é um cliente de desktop remoto de código aberto licenciado sob a AGPL, roda nativamente em todas as principais distribuições, e você pode apontá-lo para um servidor hospedado por você mesmo. Essa combinação — código auditável, cliente nativo para Linux e infraestrutura passível de auto-hospedagem — é o motivo pelo qual o RustDesk se tornou uma das respostas mais indicadas quando alguém procura um desktop remoto de código aberto para Linux. Usuários de Linux nunca tiveram muitas opções de boas ferramentas de desktop remoto, e as que existem costumam ser produtos comerciais de código fechado ou pilhas VNC já ultrapassadas. O RustDesk ocupa uma posição diferente: é um cliente de desktop remoto de código aberto licenciado sob a AGPL, roda nativamente em todas as principais distribuições, e você pode apontá-lo para um servidor hospedado por você mesmo. Essa combinação — código auditável, cliente nativo para Linux e infraestrutura passível de auto-hospedagem — é o motivo pelo qual o RustDesk se tornou uma das respostas mais indicadas quando alguém procura um desktop remoto de código aberto para Linux.
Este guia mostra como instalá-lo, o ponto que mais confunde as pessoas (X11 versus Wayland), como colocar o acesso não assistido e headless para funcionar, e onde o servidor entra nessa história. Este guia mostra como instalá-lo, o ponto que mais confunde as pessoas (X11 versus Wayland), como colocar o acesso não assistido para funcionar e onde o servidor entra nessa história.
## Instalando o RustDesk no Linux ## Instalando o RustDesk no Linux
@@ -53,7 +51,7 @@ Esta é a coisa mais importante a entender sobre o RustDesk no Linux, pois é is
**Wayland: o RustDesk tem, sem dúvida, um dos suportes mais fortes entre as ferramentas de desktop remoto.** O RustDesk oferece suporte a Wayland desde a versão 1.2.0 e continua expandindo esse suporte. Como os compositores do Wayland não permitem acesso direto ao framebuffer, o RustDesk captura a tela por meio do serviço `xdg-desktop-portal` e do [PipeWire](https://deepwiki.com/rustdesk/rustdesk/6.3.1-wayland-support), e injeta a entrada por meio do módulo `uinput` do kernel. Duas consequências decorrem do próprio design do Wayland — e elas se aplicam a qualquer ferramenta de compartilhamento de tela no Wayland, não só ao RustDesk: **Wayland: o RustDesk tem, sem dúvida, um dos suportes mais fortes entre as ferramentas de desktop remoto.** O RustDesk oferece suporte a Wayland desde a versão 1.2.0 e continua expandindo esse suporte. Como os compositores do Wayland não permitem acesso direto ao framebuffer, o RustDesk captura a tela por meio do serviço `xdg-desktop-portal` e do [PipeWire](https://deepwiki.com/rustdesk/rustdesk/6.3.1-wayland-support), e injeta a entrada por meio do módulo `uinput` do kernel. Duas consequências decorrem do próprio design do Wayland — e elas se aplicam a qualquer ferramenta de compartilhamento de tela no Wayland, não só ao RustDesk:
- **Consentimento a cada conexão.** O portal exibe uma caixa de diálogo pedindo que você selecione qual display compartilhar. Esse é um recurso de segurança deliberado do Wayland, não um bug do RustDesk — um aplicativo em segundo plano não pode começar a gravar sua tela silenciosamente. O Portal v4 e versões mais recentes oferecem suporte a um "token de restauração" para que você não precise confirmar toda vez, mas o primeiro compartilhamento exige um clique na tela. - **Consentimento a cada conexão.** O portal exibe uma caixa de diálogo pedindo que você selecione qual display compartilhar. Esse é um recurso de segurança deliberado do Wayland, não um bug do RustDesk — um aplicativo em segundo plano não pode começar a gravar sua tela silenciosamente. O Portal v4 e versões mais recentes oferecem suporte a um "token de restauração" para que você não precise confirmar toda vez, mas o primeiro compartilhamento exige um clique na tela.
- **Somente sessão ativa.** A captura no Wayland está vinculada à sessão gráfica com login já efetuado. A captura da tela de login (greeter) do Wayland ainda não é suportada — está em desenvolvimento ativo ([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). Para acesso antes do login hoje, use a configuração headless/display virtual abaixo, ou uma sessão X11 em distribuições que ainda oferecem essa opção. - **Somente sessão ativa.** A captura no Wayland está vinculada à sessão gráfica com login já efetuado. A captura da tela de login (greeter) do Wayland ainda não é suportada — está em desenvolvimento ativo ([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). Para acesso antes do login hoje, use uma sessão X11 em distribuições que ainda oferecem essa opção.
O suporte ao Wayland continua melhorando — o RustDesk 1.4.3 (outubro de 2025), por exemplo, [adicionou compartilhamento multimonitor para o Wayland](https://ubuntuhandbook.org/index.php/2025/10/rustdesk-released-1-4-3-with-multi-monitor-for-wayland-virtual-mouse/). Mas, se você se conectar e ver uma tela preta em uma máquina Wayland, isso quase sempre significa que o caminho do portal/PipeWire não foi satisfeito. Nosso artigo dedicado a [RustDesk conectado, mas aguardando imagem](/pt/blog/rustdesk-conectado-aguardando-imagem-guia-completo-de-correcao) detalha especificamente o caso da tela preta no Wayland. O suporte ao Wayland continua melhorando — o RustDesk 1.4.3 (outubro de 2025), por exemplo, [adicionou compartilhamento multimonitor para o Wayland](https://ubuntuhandbook.org/index.php/2025/10/rustdesk-released-1-4-3-with-multi-monitor-for-wayland-virtual-mouse/). Mas, se você se conectar e ver uma tela preta em uma máquina Wayland, isso quase sempre significa que o caminho do portal/PipeWire não foi satisfeito. Nosso artigo dedicado a [RustDesk conectado, mas aguardando imagem](/pt/blog/rustdesk-conectado-aguardando-imagem-guia-completo-de-correcao) detalha especificamente o caso da tela preta no Wayland.
@@ -63,21 +61,15 @@ Acesso não assistido significa se conectar a uma máquina sem ninguém sentado
1. Instale via `.deb` ou `.rpm` para que o serviço systemd seja registrado, ou clique em **Enable Service** (Ativar serviço) no aplicativo. 1. Instale via `.deb` ou `.rpm` para que o serviço systemd seja registrado, ou clique em **Enable Service** (Ativar serviço) no aplicativo.
2. No RustDesk, defina uma **senha permanente** forte nas configurações de conexão (e, idealmente, ative a autenticação de dois fatores). 2. No RustDesk, defina uma **senha permanente** forte nas configurações de conexão (e, idealmente, ative a autenticação de dois fatores).
3. Para acesso antes do login ou em trocas entre usuários, use a configuração headless com display virtual abaixo (a lacuna do Wayland no login, mencionada acima, também se aplica aqui).
Uma realidade do Wayland para a qual você deve se planejar: o portal baseado em consentimento descrito na seção sobre Wayland torna a captura totalmente não assistida mais difícil do que no X11, até que o suporte não assistido — ainda em desenvolvimento — seja lançado; portanto, planeje usar a configuração headless com display virtual para máquinas que operam sem intervenção.
## Linux headless: servidores sem monitor ## Linux headless: servidores sem monitor
Um caso de uso muito comum no Linux é uma máquina sem nenhum display conectado — um servidor doméstico, uma máquina de laboratório, uma VM. Aqui o problema não é o RustDesk, é a pilha gráfica: sem nenhum monitor conectado, o X ou o Wayland nunca alocam um framebuffer, então literalmente não há imagem para capturar, e você obtém uma tela preta. Um caso de uso muito comum no Linux é uma máquina sem nenhum display conectado — um servidor doméstico, uma máquina de laboratório, uma VM. Aqui o problema não é o RustDesk, é a pilha gráfica: sem nenhum monitor conectado, o X ou o Wayland nunca alocam um framebuffer, então literalmente não há imagem para capturar, e você obtém uma tela preta.
Três formas de dar a ele algo para renderizar: Duas formas de dar a ele algo para renderizar:
- **Um plugue dummy** — um adaptador físico HDMI/DisplayPort "headless" barato que faz a GPU pensar que há um monitor conectado. - **Um plugue dummy** — um adaptador físico HDMI/DisplayPort "headless" barato que faz a GPU pensar que há um monitor conectado.
- **Um driver de display virtual**`xserver-xorg-video-dummy` no X11, ou uma opção em nível de kernel como o VKMS. - **Um driver de display virtual**`xserver-xorg-video-dummy` no X11, ou uma opção em nível de kernel como o VKMS.
- **O modo headless opcional do RustDesk** — ative-o com `sudo rustdesk --option allow-linux-headless Y`. Segundo a [wiki de suporte a Linux headless](https://github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support), ele vem desativado por padrão, é testado principalmente no Ubuntu com GNOME, e espera pacotes como `xserver-xorg-video-dummy` e `lightdm`. Você pode obter o ID da máquina com `sudo rustdesk --get-id` e definir uma senha com `sudo rustdesk --password <password>`.
O modo headless ainda tem algumas arestas para aparar, então trate-o como algo que "funciona, com cuidado", não como uma solução pronta para uso imediato.
## Auto-hospedagem do servidor RustDesk no Linux ## Auto-hospedagem do servidor RustDesk no Linux
@@ -58,7 +58,7 @@ Assim que o RustDesk passa a rodar como serviço, ele é carregado antes de qual
| ---------- | -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | ---------- | -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Windows | Instale; mantenha o serviço em execução (inicia com a máquina) | O executável portátil perde a sessão no logout ou em prompts de UAC; use o instalador | | Windows | Instale; mantenha o serviço em execução (inicia com a máquina) | O executável portátil perde a sessão no logout ou em prompts de UAC; use o instalador |
| macOS | Instale, defina a senha permanente, conceda as permissões | É preciso conceder Gravação de Tela e Acessibilidade; a captura na tela de login exige o helper instalado | | macOS | Instale, defina a senha permanente, conceda as permissões | É preciso conceder Gravação de Tela e Acessibilidade; a captura na tela de login exige o helper instalado |
| Linux | Instale o pacote de serviço | O Wayland precisa de uma sessão ativa; para pré-login use a configuração de display virtual sem monitor (headless), ou X11 onde a distribuição ainda oferecer essa opção | | Linux | Instale o pacote de serviço | O Wayland precisa de uma sessão ativa; para pré-login use X11 onde a distribuição ainda oferecer essa opção |
| Android | Defina a senha permanente; ative a captura | A tela precisa estar ativa; conceda o consentimento de captura de tela (MediaProjection) e a permissão de entrada | | Android | Defina a senha permanente; ative a captura | A tela precisa estar ativa; conceda o consentimento de captura de tela (MediaProjection) e a permissão de entrada |
### Windows ### Windows
@@ -71,7 +71,7 @@ O macOS restringe a captura de tela e a entrada por trás de permissões. Depois
### Linux ### Linux
Instale o RustDesk para que o componente de serviço seja executado na inicialização. Em uma máquina parada na tela de login (greeter), o Wayland ainda não consegue capturar o greeter — uma limitação do design do Wayland (não uma limitação do RustDesk) que a equipe está trabalhando ativamente para resolver ([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). Em uma máquina headless, use a configuração de display virtual; em um desktop, uma sessão X11/Xorg ainda resolve isso onde a distribuição oferecer essa opção, embora várias estejam migrando para Wayland exclusivamente. Veja [RustDesk para Linux](/pt/blog/rustdesk-para-linux-o-desktop-remoto-de-codigo-aberto) para mais detalhes. Instale o RustDesk para que o componente de serviço seja executado na inicialização. Em uma máquina parada na tela de login (greeter), o Wayland ainda não consegue capturar o greeter — uma limitação do design do Wayland (não uma limitação do RustDesk) que a equipe está trabalhando ativamente para resolver ([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420)). Em um desktop, uma sessão X11/Xorg ainda resolve isso onde a distribuição oferecer essa opção, embora várias estejam migrando para Wayland exclusivamente. Veja [RustDesk para Linux](/pt/blog/rustdesk-para-linux-o-desktop-remoto-de-codigo-aberto) para mais detalhes.
## Etapa 3: implante em escala com um cliente pré-configurado ## Etapa 3: implante em escala com um cliente pré-configurado
@@ -14,7 +14,7 @@ faq:
- question: '为什么 RustDesk 会显示“已连接,等待图像”?' - question: '为什么 RustDesk 会显示“已连接,等待图像”?'
answer: '会话已成功建立,但远程主机没有生成可供发送的屏幕图像。最常见的原因是没有可捕获的活动显示器——例如没有显示器的无头服务器、已休眠或锁定的屏幕,或操作系统不允许 RustDesk 录制的显示器。修复捕获源之后,图像就会出现。' answer: '会话已成功建立,但远程主机没有生成可供发送的屏幕图像。最常见的原因是没有可捕获的活动显示器——例如没有显示器的无头服务器、已休眠或锁定的屏幕,或操作系统不允许 RustDesk 录制的显示器。修复捕获源之后,图像就会出现。'
- question: '如何修复无头计算机上 RustDesk 卡在“等待图像”的问题?' - question: '如何修复无头计算机上 RustDesk 卡在“等待图像”的问题?'
answer: '没有显示器的主机没有可供捕获的帧缓冲区,因此 RustDesk 无内容可发送。可以连接一台真实显示器插上一个廉价的 HDMI 仿真插头让 GPU 误以为已连接显示器),或者在 Linux 上使用官方文档中的无头配置方法(github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support。唤醒显示器或让其保持唤醒状态可解决大多数此类问题。' answer: '没有显示器的主机没有可供捕获的帧缓冲区,因此 RustDesk 无内容可发送。可以连接一台真实显示器,或插上一个廉价的 HDMI 仿真插头让 GPU 误以为已连接显示器。唤醒显示器或让其保持唤醒状态可解决大多数此类问题。'
- question: '更换视频编解码器能否解决黑屏问题?' - question: '更换视频编解码器能否解决黑屏问题?'
answer: '通常可以。在远程会话工具栏或设置中,你可以切换编解码器——VP8、VP9、AV1,或在硬件支持的情况下使用 H.264/H.265。如果远程硬件无法编码某个编解码器,画面就会显示空白或卡死,此时切换回软件编解码器(例如 VP9)通常可以恢复画面。' answer: '通常可以。在远程会话工具栏或设置中,你可以切换编解码器——VP8、VP9、AV1,或在硬件支持的情况下使用 H.264/H.265。如果远程硬件无法编码某个编解码器,画面就会显示空白或卡死,此时切换回软件编解码器(例如 VP9)通常可以恢复画面。'
- question: 'RustDesk 在一台电脑上能显示图像,在另一台却不行,这是为什么?' - question: 'RustDesk 在一台电脑上能显示图像,在另一台却不行,这是为什么?'
@@ -37,11 +37,10 @@ metadata:
迄今为止报告最多的原因是**无头主机**——即在没有连接显示器的情况下运行的服务器、迷你电脑或工作站,又或者显示器处于休眠状态。由于没有活动显示器,GPU 不会生成帧缓冲区,因此 RustDesk 虽能连接,却无内容可发送。这种情况在 RustDesk 的问题跟踪系统中反复出现,包括[目标设备显示器关闭时出现黑屏的报告](https://github.com/rustdesk/rustdesk/issues/9884),以及长期存在的[“已连接,等待图像”讨论帖](https://github.com/rustdesk/rustdesk/issues/222)。 迄今为止报告最多的原因是**无头主机**——即在没有连接显示器的情况下运行的服务器、迷你电脑或工作站,又或者显示器处于休眠状态。由于没有活动显示器,GPU 不会生成帧缓冲区,因此 RustDesk 虽能连接,却无内容可发送。这种情况在 RustDesk 的问题跟踪系统中反复出现,包括[目标设备显示器关闭时出现黑屏的报告](https://github.com/rustdesk/rustdesk/issues/9884),以及长期存在的[“已连接,等待图像”讨论帖](https://github.com/rustdesk/rustdesk/issues/222)。
以下种方法可以让它有内容可捕获: 以下种方法可以让它有内容可捕获:
- **连接一台显示器**,并确保它已通电且处于唤醒状态。 - **连接一台显示器**,并确保它已通电且处于唤醒状态。
- **使用 HDMI(或 DisplayPort)仿真插头。** 这类廉价适配器可以让 GPU 误以为已连接显示器,从而持续渲染帧缓冲区供 RustDesk 抓取。这是解决无头台式机和家庭服务器问题的标准方法。 - **使用 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 用户在系统设置中禁止显示器休眠 |
| 缺少权限(macOS) | 已连接,但始终黑屏 | 在“隐私与安全性”中授予屏幕录制权限;为登录界面安装辅助程序 | | 缺少权限(macOS) | 已连接,但始终黑屏 | 在“隐私与安全性”中授予屏幕录制权限;为登录界面安装辅助程序 |
| 编解码器不匹配 | 画面空白或卡死 | 切换编解码器(VP8 / VP9 / AV1 / H.264 / H.265);回退到软件编解码器 | | 编解码器不匹配 | 画面空白或卡死 | 切换编解码器(VP8 / VP9 / AV1 / H.264 / H.265);回退到软件编解码器 |
@@ -83,7 +82,7 @@ RustDesk 可以用多种方式对视频流进行编码,默认选项并不总
### Linux 与 Wayland ### 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 路径才是更长远的做法。
### 网络与中继 ### 网络与中继
@@ -4,7 +4,7 @@ lang: 'zh-cn'
translationKey: 'rustdesk-for-linux' translationKey: 'rustdesk-for-linux'
draft: false draft: false
title: 'RustDesk for Linux:开源远程桌面工具' title: 'RustDesk for Linux:开源远程桌面工具'
excerpt: '在 Linux 上安装并运行 RustDesk:涵盖 .deb、.rpm、Flatpak 与 AppImage 安装包、X11 与 Wayland 对比、无头模式与无人值守访问,以及自建服务器。' excerpt: '在 Linux 上安装并运行 RustDesk:涵盖 .deb、.rpm、Flatpak 与 AppImage 安装包、X11 与 Wayland 对比、无人值守访问,以及自建服务器。'
image: '~/assets/images/blog/rustdesk-for-linux-og.webp' image: '~/assets/images/blog/rustdesk-for-linux-og.webp'
category: '指南' category: '指南'
tags: ['RustDesk', 'Linux', '自托管'] tags: ['RustDesk', 'Linux', '自托管']
@@ -12,21 +12,19 @@ author: 'RustDesk Team'
slug: 'rustdesk-for-linux-zh-cn' slug: 'rustdesk-for-linux-zh-cn'
faq: faq:
- question: 'RustDesk 支持 Wayland 吗?' - question: 'RustDesk 支持 Wayland 吗?'
answer: '是的——在所有远程桌面工具中,RustDesk 对 Wayland 的支持堪称最强之一,其中包括 1.4.3 版本新增的多显示器共享功能。在 Wayland 上,RustDesk 通过 PipeWire 和 XDG 桌面门户捕获屏幕,系统会弹出一个授权对话框让你选择要共享的显示器——多数情况下这个选择会被记住,因此不会每次都重复询问——并且捕获操作是在当前已登录的会话内进行的。这一授权步骤是 Wayland 的安全设计,所有屏幕共享类应用都要遵循。对于目前需要登录前访问或完全无人值守的机器,请使用无头虚拟显示器方案(或者在仍然提供 X11 会话的发行版上使用 X11,因为已有不少发行版正转向仅支持 Wayland);完全无人值守的 Wayland 捕获功能目前正在积极开发中(参见 github.com/rustdesk/rustdesk/pull/15420)。' answer: '是的——在所有远程桌面工具中,RustDesk 对 Wayland 的支持堪称最强之一,其中包括 1.4.3 版本新增的多显示器共享功能。在 Wayland 上,RustDesk 通过 PipeWire 和 XDG 桌面门户捕获屏幕,系统会弹出一个授权对话框让你选择要共享的显示器——多数情况下这个选择会被记住,因此不会每次都重复询问——并且捕获操作是在当前已登录的会话内进行的。这一授权步骤是 Wayland 的安全设计,所有屏幕共享类应用都要遵循。对于目前需要登录前访问或完全无人值守的机器,请在仍然提供 X11 会话的发行版上使用 X11;完全无人值守的 Wayland 捕获功能目前正在积极开发中(参见 github.com/rustdesk/rustdesk/pull/15420)。'
- question: '在 Linux 上应该安装哪种安装包?' - question: '在 Linux 上应该安装哪种安装包?'
answer: '在 Debian、Ubuntu 和 Linux Mint 上使用 .deb,在 Fedora、RHEL 和 openSUSE 上使用 .rpm,如果想要沙盒化且兼容性广泛的构建版本可以选择来自 Flathub 的 Flatpak,或者选择便携的单文件 AppImage 作为备用方案。.deb 和 .rpm 安装包会注册并启动 systemd 服务,因此 RustDesk 能在重启后依然运行;而 Flatpak 和 AppImage 默认不会这样做。' answer: '在 Debian、Ubuntu 和 Linux Mint 上使用 .deb,在 Fedora、RHEL 和 openSUSE 上使用 .rpm,如果想要沙盒化且兼容性广泛的构建版本可以选择来自 Flathub 的 Flatpak,或者选择便携的单文件 AppImage 作为备用方案。.deb 和 .rpm 安装包会注册并启动 systemd 服务,因此 RustDesk 能在重启后依然运行;而 Flatpak 和 AppImage 默认不会这样做。'
- question: '为什么我的无头 Linux 主机显示黑屏?'
answer: '在没有连接显示器的情况下,X 或 Wayland 根本不会分配帧缓冲区,因此 RustDesk 没有内容可以捕获,你会看到黑屏或“等待图像”的提示。你可以接入虚拟显示器插头(dummy HDMI/DisplayPort),配置诸如 xserver-xorg-video-dummy 或 VKMS 之类的虚拟显示驱动,或者启用 RustDesk 内置的可选 Linux 无头模式,让系统自动为你创建一个虚拟显示器。'
- question: '我可以在 Linux 上自建 RustDesk 服务器吗?' - question: '我可以在 Linux 上自建 RustDesk 服务器吗?'
answer: '可以。RustDesk 服务器(包括 hbbs ID/信令服务和 hbbr 中继服务进程)是为 Linux 构建的,这也是运行它的标准方式。免费开源的社区服务器可以无限期免费运行,而 Server Pro 在此基础上增加了 Web 控制台、设备分组和自定义客户端生成器。两者都可以安装在普通的 Linux 虚拟机或裸机主机上。' answer: '可以。RustDesk 服务器(包括 hbbs ID/信令服务和 hbbr 中继服务进程)是为 Linux 构建的,这也是运行它的标准方式。免费开源的社区服务器可以无限期免费运行,而 Server Pro 在此基础上增加了 Web 控制台、设备分组和自定义客户端生成器。两者都可以安装在普通的 Linux 虚拟机或裸机主机上。'
metadata: metadata:
description: 'RustDesk 在 Linux 上的完整指南:涵盖各发行版与 ARM 开发板的安装包选择、Wayland 与 X11 屏幕捕获、无头模式配置,以及自建服务器。' description: 'RustDesk 在 Linux 上的完整指南:涵盖各发行版与 ARM 开发板的安装包选择、Wayland 与 X11 屏幕捕获,以及自建服务器。'
keywords: 'RustDesk Linux, RustDesk Ubuntu, RustDesk Wayland, RustDesk X11, RustDesk Linux 安装' keywords: 'RustDesk Linux, RustDesk Ubuntu, RustDesk Wayland, RustDesk X11, RustDesk Linux 安装'
--- ---
长期以来,Linux 用户在优秀远程桌面工具上的选择一直不多,现有的产品通常要么是闭源商业软件,要么是老旧的 VNC 技术栈。RustDesk 走的是一条不同的路:它是一款采用 AGPL 协议开源授权的开源远程桌面客户端,能够在所有主流发行版上原生运行,并且你可以将它指向自己搭建的服务器。正是这种组合——可审计的代码、原生 Linux 客户端,以及可自建的基础设施——让 RustDesk 成为人们寻找 Linux 开源远程桌面方案时最常被提及的答案之一。 长期以来,Linux 用户在优秀远程桌面工具上的选择一直不多,现有的产品通常要么是闭源商业软件,要么是老旧的 VNC 技术栈。RustDesk 走的是一条不同的路:它是一款采用 AGPL 协议开源授权的开源远程桌面客户端,能够在所有主流发行版上原生运行,并且你可以将它指向自己搭建的服务器。正是这种组合——可审计的代码、原生 Linux 客户端,以及可自建的基础设施——让 RustDesk 成为人们寻找 Linux 开源远程桌面方案时最常被提及的答案之一。
本指南将介绍如何安装 RustDesk、几乎所有人都会踩中的那个坑(X11 与 Wayland 的区别)、如何让无人值守和无头访问顺利运行,以及服务器在其中扮演的角色。 本指南将介绍如何安装 RustDesk、几乎所有人都会踩中的那个坑(X11 与 Wayland 的区别)、如何让无人值守访问顺利运行,以及服务器在其中扮演的角色。
## 在 Linux 上安装 RustDesk ## 在 Linux 上安装 RustDesk
@@ -53,7 +51,7 @@ RustDesk 为每一种常见的 Linux 打包格式都提供了安装包,因此
**Wayland:可以说 RustDesk 在这方面拥有所有远程桌面工具中最强的支持。** RustDesk 自 1.2.0 版本起就支持 Wayland,并一直在持续扩展相关能力。由于 Wayland 合成器不允许直接访问帧缓冲区,RustDesk 通过 `xdg-desktop-portal` 服务和 [PipeWire](https://deepwiki.com/rustdesk/rustdesk/6.3.1-wayland-support) 捕获屏幕画面,并通过内核的 `uinput` 模块注入输入事件。由此产生了两个源自 Wayland 自身设计的结果——不仅 RustDesk 如此,所有 Wayland 屏幕共享工具都是这样: **Wayland:可以说 RustDesk 在这方面拥有所有远程桌面工具中最强的支持。** RustDesk 自 1.2.0 版本起就支持 Wayland,并一直在持续扩展相关能力。由于 Wayland 合成器不允许直接访问帧缓冲区,RustDesk 通过 `xdg-desktop-portal` 服务和 [PipeWire](https://deepwiki.com/rustdesk/rustdesk/6.3.1-wayland-support) 捕获屏幕画面,并通过内核的 `uinput` 模块注入输入事件。由此产生了两个源自 Wayland 自身设计的结果——不仅 RustDesk 如此,所有 Wayland 屏幕共享工具都是这样:
- **每次连接都需要授权。** 门户(portal)会弹出对话框,要求你选择要共享哪个显示器。这是 Wayland 刻意设计的安全机制,而不是 RustDesk 的缺陷——后台应用无法在你不知情的情况下悄悄开始录制屏幕。Portal v4 及更高版本支持“恢复令牌”(restore token),因此不会每次都重复提示,但首次共享仍需要在屏幕上手动点击确认。 - **每次连接都需要授权。** 门户(portal)会弹出对话框,要求你选择要共享哪个显示器。这是 Wayland 刻意设计的安全机制,而不是 RustDesk 的缺陷——后台应用无法在你不知情的情况下悄悄开始录制屏幕。Portal v4 及更高版本支持“恢复令牌”(restore token),因此不会每次都重复提示,但首次共享仍需要在屏幕上手动点击确认。
- **仅限已登录的会话。** Wayland 捕获与已登录的图形会话绑定。目前还不支持捕获 Wayland 的登录欢迎界面(login greeter)——该功能正在积极开发中([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420))。如果现在就需要登录前的访问能力,请使用下文的无头/虚拟显示器配置,或者在仍然提供 X11 会话的发行版上使用 X11。 - **仅限已登录的会话。** Wayland 捕获与已登录的图形会话绑定。目前还不支持捕获 Wayland 的登录欢迎界面(login greeter)——该功能正在积极开发中([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420))。如果现在就需要登录前的访问能力,请在仍然提供 X11 会话的发行版上使用 X11。
Wayland 支持一直在持续改进——例如,RustDesk 1.4.32025 年 10 月)[为 Wayland 新增了多显示器共享功能](https://ubuntuhandbook.org/index.php/2025/10/rustdesk-released-1-4-3-with-multi-monitor-for-wayland-virtual-mouse/)。但如果你连接后在 Wayland 主机上看到黑屏,几乎总是因为 portal/PipeWire 这条路径没有被正确满足。我们专门撰写的[RustDesk 已连接但一直等待图像](/zh-cn/blog/rustdesk-connected-waiting-for-image-zh-cn)一文详细讲解了 Wayland 黑屏的具体情况。 Wayland 支持一直在持续改进——例如,RustDesk 1.4.32025 年 10 月)[为 Wayland 新增了多显示器共享功能](https://ubuntuhandbook.org/index.php/2025/10/rustdesk-released-1-4-3-with-multi-monitor-for-wayland-virtual-mouse/)。但如果你连接后在 Wayland 主机上看到黑屏,几乎总是因为 portal/PipeWire 这条路径没有被正确满足。我们专门撰写的[RustDesk 已连接但一直等待图像](/zh-cn/blog/rustdesk-connected-waiting-for-image-zh-cn)一文详细讲解了 Wayland 黑屏的具体情况。
@@ -63,21 +61,15 @@ Wayland 支持一直在持续改进——例如,RustDesk 1.4.32025 年 10
1. 通过 `.deb``.rpm` 安装,以便注册 systemd 服务,或者在应用中点击**启用服务(Enable Service**。 1. 通过 `.deb``.rpm` 安装,以便注册 systemd 服务,或者在应用中点击**启用服务(Enable Service**。
2. 在 RustDesk 的连接设置中设置一个强度足够的**永久密码**(最好同时启用双因素身份验证)。 2. 在 RustDesk 的连接设置中设置一个强度足够的**永久密码**(最好同时启用双因素身份验证)。
3. 如果需要在用户登录之前或跨越登录会话进行访问,请使用下文的无头虚拟显示器配置(上文提到的 Wayland 登录界面限制在这里同样适用)。
有一点 Wayland 的现实情况需要提前规划:在正在开发中的无人值守支持正式上线之前,前文 Wayland 部分提到的基于授权确认的门户机制,会让完全无人值守的屏幕捕获比在 X11 上更难实现,因此对于完全无人值守的机器,建议提前规划使用无头虚拟显示器方案。
## 无头 Linux:没有显示器的服务器 ## 无头 Linux:没有显示器的服务器
一种非常常见的 Linux 使用场景是完全没有连接显示器的主机——比如家庭服务器、实验室机器或虚拟机。这里的问题并不出在 RustDesk 身上,而是出在图形栈上:没有插上显示器时,X 或 Wayland 根本不会分配帧缓冲区,因此实际上没有任何图像可供捕获,你看到的只会是黑屏。 一种非常常见的 Linux 使用场景是完全没有连接显示器的主机——比如家庭服务器、实验室机器或虚拟机。这里的问题并不出在 RustDesk 身上,而是出在图形栈上:没有插上显示器时,X 或 Wayland 根本不会分配帧缓冲区,因此实际上没有任何图像可供捕获,你看到的只会是黑屏。
种方法可以让系统有内容可渲染: 种方法可以让系统有内容可渲染:
- **虚拟显示器插头(dummy plug**——一种廉价的物理 HDMI/DisplayPort“无头”转接头,能让 GPU 误以为已经连接了显示器。 - **虚拟显示器插头(dummy plug**——一种廉价的物理 HDMI/DisplayPort“无头”转接头,能让 GPU 误以为已经连接了显示器。
- **虚拟显示驱动**——在 X11 上使用 `xserver-xorg-video-dummy`,或者使用像 VKMS 这样的内核级方案。 - **虚拟显示驱动**——在 X11 上使用 `xserver-xorg-video-dummy`,或者使用像 VKMS 这样的内核级方案。
- **RustDesk 内置的可选无头模式**——通过 `sudo rustdesk --option allow-linux-headless Y` 启用。根据 [Headless Linux Support wiki](https://github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support) 的说明,该模式默认关闭,主要在搭载 GNOME 的 Ubuntu 上测试过,并依赖 `xserver-xorg-video-dummy``lightdm` 等软件包。你可以用 `sudo rustdesk --get-id` 获取该机器的 ID,并用 `sudo rustdesk --password <password>` 设置密码。
无头模式目前还不够成熟,存在一些粗糙之处,因此应将其视为“可用,但需谨慎操作”的方案,而非开箱即用的成品。
## 在 Linux 上自建 RustDesk 服务器 ## 在 Linux 上自建 RustDesk 服务器
@@ -58,7 +58,7 @@ metadata:
| ------- | -------------------------------------------- | ----------------------------------------------------------------------------------------------------------- | | ------- | -------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| Windows | 安装;保持服务处于运行状态(随设备自动启动) | 便携版 exe 会在注销或出现 UAC 提示时中断;请使用安装程序 | | Windows | 安装;保持服务处于运行状态(随设备自动启动) | 便携版 exe 会在注销或出现 UAC 提示时中断;请使用安装程序 |
| macOS | 安装、设置永久密码、授予相关权限 | 必须授予“屏幕录制”和“辅助功能”权限;登录界面下的画面捕获需要安装辅助进程 | | macOS | 安装、设置永久密码、授予相关权限 | 必须授予“屏幕录制”和“辅助功能”权限;登录界面下的画面捕获需要安装辅助进程 |
| Linux | 安装服务组件 | Wayland 需要一个处于活动状态的会话;如需登录前访问,请使用无头虚拟显示配置,或在发行版仍提供 X11 时使用 X11 | | Linux | 安装服务组件 | Wayland 需要一个处于活动状态的会话;如需登录前访问,请在发行版仍提供 X11 时使用 X11 |
| Android | 设置永久密码;启用画面捕获 | 屏幕必须保持唤醒状态;需授予屏幕捕获(MediaProjection)许可及输入权限 | | Android | 设置永久密码;启用画面捕获 | 屏幕必须保持唤醒状态;需授予屏幕捕获(MediaProjection)许可及输入权限 |
### Windows ### Windows
@@ -71,7 +71,7 @@ macOS 会将屏幕捕获和输入功能置于权限管控之下。安装完成
### Linux ### Linux
安装 RustDesk,使其服务组件能够在开机时运行。对于停留在登录欢迎界面(greeter)的设备,Wayland 目前还无法捕获该欢迎界面——这是 Wayland 本身的设计限制(而非 RustDesk 的限制),RustDesk 正在积极推动解决这一问题([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420))。对于无头(headless)设备,请使用虚拟显示配置;对于桌面设备,只要发行版仍提供 X11/Xorg 会话,该方式依然可以正常处理,不过已有多个发行版正在转向纯 Wayland。详情请参阅 [RustDesk for Linux](/zh-cn/blog/rustdesk-for-linux-zh-cn)。 安装 RustDesk,使其服务组件能够在开机时运行。对于停留在登录欢迎界面(greeter)的设备,Wayland 目前还无法捕获该欢迎界面——这是 Wayland 本身的设计限制(而非 RustDesk 的限制),RustDesk 正在积极推动解决这一问题([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420))。对于桌面设备,只要发行版仍提供 X11/Xorg 会话,该方式依然可以正常处理,不过已有多个发行版正在转向纯 Wayland。详情请参阅 [RustDesk for Linux](/zh-cn/blog/rustdesk-for-linux-zh-cn)。
## 第三步:使用预配置客户端进行规模化部署 ## 第三步:使用预配置客户端进行规模化部署
@@ -14,7 +14,7 @@ faq:
- question: '為什麼 RustDesk 會顯示「已連線,等待影像中」?' - question: '為什麼 RustDesk 會顯示「已連線,等待影像中」?'
answer: '連線本身已經成功建立,但遠端主機並沒有產生可傳送的畫面。最常見的原因是沒有可供擷取的作用中顯示器——例如未接螢幕的無頭伺服器、已進入休眠或鎖定的螢幕,或是作業系統不允許 RustDesk 錄製的顯示器。只要修復擷取來源,畫面就會出現。' answer: '連線本身已經成功建立,但遠端主機並沒有產生可傳送的畫面。最常見的原因是沒有可供擷取的作用中顯示器——例如未接螢幕的無頭伺服器、已進入休眠或鎖定的螢幕,或是作業系統不允許 RustDesk 錄製的顯示器。只要修復擷取來源,畫面就會出現。'
- question: '在無頭電腦上,要如何修復 RustDesk 一直等待影像的問題?' - question: '在無頭電腦上,要如何修復 RustDesk 一直等待影像的問題?'
answer: '沒有接螢幕的主機沒有畫面緩衝區(framebuffer)可以擷取,因此 RustDesk 沒有任何內容可以傳送。你可以接上實體螢幕插上便宜的 HDMI 模擬顯示器插頭讓 GPU 誤以為接了螢幕,或是在 Linux 上依照官方文件設定無頭環境(github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support。喚醒螢幕或讓螢幕保持不休眠,就能解決大多數情況。' answer: '沒有接螢幕的主機沒有畫面緩衝區(framebuffer)可以擷取,因此 RustDesk 沒有任何內容可以傳送。你可以接上實體螢幕,或插上便宜的 HDMI 模擬顯示器插頭讓 GPU 誤以為接了螢幕。喚醒螢幕或讓螢幕保持不休眠,就能解決大多數情況。'
- question: '更改視訊編碼格式能修復黑畫面問題嗎?' - question: '更改視訊編碼格式能修復黑畫面問題嗎?'
answer: '通常可以。在遠端連線工具列或設定中,你可以切換編碼格式——VP8、VP9、AV1,或是在硬體支援的情況下使用 H.264/H.265。如果遠端硬體無法編碼特定格式,畫面就會顯示空白或凍結,這時退回使用如 VP9 這類的軟體編碼格式,通常就能讓畫面恢復正常。' answer: '通常可以。在遠端連線工具列或設定中,你可以切換編碼格式——VP8、VP9、AV1,或是在硬體支援的情況下使用 H.264/H.265。如果遠端硬體無法編碼特定格式,畫面就會顯示空白或凍結,這時退回使用如 VP9 這類的軟體編碼格式,通常就能讓畫面恢復正常。'
- question: 'RustDesk 在某台電腦上能顯示畫面,換一台卻不行,這是為什麼?' - 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)。 目前回報最多的原因,是**無頭主機(headless machine)**——也就是沒有接螢幕、或螢幕處於休眠狀態下運作的伺服器、迷你主機或工作站。由於沒有作用中的顯示器,GPU 不會產生任何畫面緩衝區,因此 RustDesk 雖然連線成功,卻沒有任何內容可以傳送。這個狀況在 RustDesk 的問題追蹤系統中一再出現,包括[目標端螢幕關閉時出現黑畫面的回報](https://github.com/rustdesk/rustdesk/issues/9884),以及長期存在的[「已連線,等待影像中」討論串](https://github.com/rustdesk/rustdesk/issues/222)。
種方式可以讓它有東西可以擷取: 種方式可以讓它有東西可以擷取:
- **接上螢幕**,並確認螢幕已經開機且處於喚醒狀態。 - **接上螢幕**,並確認螢幕已經開機且處於喚醒狀態。
- **使用 HDMI(或 DisplayPort)模擬顯示器插頭。** 這種價格低廉的轉接頭能讓 GPU 誤以為接了螢幕,進而持續產生畫面緩衝區供 RustDesk 擷取。這是無頭桌上型電腦與家用伺服器的標準解法。 - **使用 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 可在系統設定中關閉螢幕休眠 |
| 缺少權限(macOS) | 連線成功,但畫面持續全黑 | 在隱私權與安全性中授予螢幕錄製權限;安裝可支援登入畫面的輔助程式 | | 缺少權限(macOS) | 連線成功,但畫面持續全黑 | 在隱私權與安全性中授予螢幕錄製權限;安裝可支援登入畫面的輔助程式 |
| 編碼格式不相容 | 畫面空白或凍結 | 切換編碼格式(VP8/VP9/AV1/H.264/H.265);退回使用軟體編碼格式 | | 編碼格式不相容 | 畫面空白或凍結 | 切換編碼格式(VP8/VP9/AV1/H.264/H.265);退回使用軟體編碼格式 |
@@ -83,7 +82,7 @@ RustDesk 可以用多種方式編碼串流,而預設編碼格式不見得適
### Linux 與 Wayland ### 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 路徑才是更長遠可靠的做法。
### 網路與中繼伺服器 ### 網路與中繼伺服器
@@ -4,7 +4,7 @@ lang: 'zh-tw'
translationKey: 'rustdesk-for-linux' translationKey: 'rustdesk-for-linux'
draft: false draft: false
title: 'RustDesk for Linux:開源遠端桌面軟體' title: 'RustDesk for Linux:開源遠端桌面軟體'
excerpt: '在 Linux 上安裝並執行 RustDesk.deb、.rpm、Flatpak 與 AppImage 安裝包、X11 與 Wayland 的差異、無頭與無人值守存取,以及自行架設伺服器。' excerpt: '在 Linux 上安裝並執行 RustDesk.deb、.rpm、Flatpak 與 AppImage 安裝包、X11 與 Wayland 的差異、無人值守存取,以及自行架設伺服器。'
image: '~/assets/images/blog/rustdesk-for-linux-og.webp' image: '~/assets/images/blog/rustdesk-for-linux-og.webp'
category: '指南' category: '指南'
tags: ['RustDesk', 'Linux', '自架'] tags: ['RustDesk', 'Linux', '自架']
@@ -12,21 +12,19 @@ author: 'RustDesk Team'
slug: 'rustdesk-for-linux-zh-tw' slug: 'rustdesk-for-linux-zh-tw'
faq: faq:
- question: 'RustDesk 支援 Wayland 嗎?' - question: 'RustDesk 支援 Wayland 嗎?'
answer: '支援——在所有遠端桌面工具中,RustDesk 對 Wayland 的支援可說是數一數二完整,包括 1.4.3 版新增的多螢幕分享功能。在 Wayland 環境下,RustDesk 會透過 PipeWire 與 XDG 桌面入口(desktop portal)擷取畫面,系統會跳出同意對話框,讓你選擇要分享的顯示畫面——多數情況下這個選擇會被記住,之後不會再次詢問——而且此功能僅在目前已登入的工作階段中運作。這個「需要同意」的步驟,是 Wayland 的安全性設計,所有螢幕分享應用程式都是如此,並非 RustDesk 獨有。若是登入前存取,或需要完全無人值守的機器,目前建議使用無頭虛擬顯示器設定(或是在仍提供 X11 工作階段的發行版上用 X11,因為有不少發行版正逐步轉為純 Wayland);完整的無人值守 Wayland 擷取功能仍在積極開發中(詳見 github.com/rustdesk/rustdesk/pull/15420)。' answer: '支援——在所有遠端桌面工具中,RustDesk 對 Wayland 的支援可說是數一數二完整,包括 1.4.3 版新增的多螢幕分享功能。在 Wayland 環境下,RustDesk 會透過 PipeWire 與 XDG 桌面入口(desktop portal)擷取畫面,系統會跳出同意對話框,讓你選擇要分享的顯示畫面——多數情況下這個選擇會被記住,之後不會再次詢問——而且此功能僅在目前已登入的工作階段中運作。這個「需要同意」的步驟,是 Wayland 的安全性設計,所有螢幕分享應用程式都是如此,並非 RustDesk 獨有。若是登入前存取,或需要完全無人值守的機器,目前在仍提供 X11 工作階段的發行版上使用 X11;完整的無人值守 Wayland 擷取功能仍在積極開發中(詳見 github.com/rustdesk/rustdesk/pull/15420)。'
- question: '我在 Linux 上應該安裝哪一種安裝包?' - question: '我在 Linux 上應該安裝哪一種安裝包?'
answer: '在 Debian、Ubuntu 與 Linux Mint 上使用 .deb;在 Fedora、RHEL 與 openSUSE 上使用 .rpm;如果想要沙盒化、相容性較廣的版本,可使用 Flathub 上的 Flatpak;若需要單一檔案的可攜式備援方案,則可選擇 AppImage。.deb 與 .rpm 安裝包會自動註冊並啟動 systemd 服務,讓 RustDesk 在重新開機後依然存在;Flatpak 與 AppImage 預設則不會這麼做。' answer: '在 Debian、Ubuntu 與 Linux Mint 上使用 .deb;在 Fedora、RHEL 與 openSUSE 上使用 .rpm;如果想要沙盒化、相容性較廣的版本,可使用 Flathub 上的 Flatpak;若需要單一檔案的可攜式備援方案,則可選擇 AppImage。.deb 與 .rpm 安裝包會自動註冊並啟動 systemd 服務,讓 RustDesk 在重新開機後依然存在;Flatpak 與 AppImage 預設則不會這麼做。'
- question: '為什麼我的無頭 Linux 主機畫面是黑的?'
answer: '只要沒有接上顯示器,X 或 Wayland 就不會配置畫面緩衝區,因此 RustDesk 沒有任何畫面可以擷取,檢視端就會顯示黑畫面或「等待影像」畫面。你可以接上假的 HDMI/DisplayPort 接頭,設定像 xserver-xorg-video-dummy 或 VKMS 這類虛擬顯示器,或是啟用 RustDesk 內建的 Linux 無頭模式(選用),讓系統自動為你建立虛擬顯示器。'
- question: '我可以在 Linux 上自行架設 RustDesk 伺服器嗎?' - question: '我可以在 Linux 上自行架設 RustDesk 伺服器嗎?'
answer: '可以。RustDesk 伺服器(包含 hbbs ID/集合處理程序與 hbbr 中繼處理程序)是為 Linux 打造的,也是最標準的執行方式。免費開源的社群版伺服器可以無限期免費執行,而 Server Pro 則在此基礎上額外提供網頁管理主控台、裝置群組與自訂用戶端產生器等功能。兩者都能安裝在一般的 Linux VM 或裸機主機上。' answer: '可以。RustDesk 伺服器(包含 hbbs ID/集合處理程序與 hbbr 中繼處理程序)是為 Linux 打造的,也是最標準的執行方式。免費開源的社群版伺服器可以無限期免費執行,而 Server Pro 則在此基礎上額外提供網頁管理主控台、裝置群組與自訂用戶端產生器等功能。兩者都能安裝在一般的 Linux VM 或裸機主機上。'
metadata: metadata:
description: '完整介紹 RustDesk 在 Linux 上的使用:各發行版與 ARM 開發板的安裝包選擇、Wayland 與 X11 畫面擷取、無頭設定,以及如何自行架設伺服器。' description: '完整介紹 RustDesk 在 Linux 上的使用:各發行版與 ARM 開發板的安裝包選擇、Wayland 與 X11 畫面擷取,以及如何自行架設伺服器。'
keywords: 'RustDesk Linux 版, RustDesk Ubuntu 安裝, RustDesk Wayland 支援, RustDesk X11, RustDesk Linux 安裝教學' keywords: 'RustDesk Linux 版, RustDesk Ubuntu 安裝, RustDesk Wayland 支援, RustDesk X11, RustDesk Linux 安裝教學'
--- ---
Linux 使用者向來沒有太多優質的遠端桌面工具可以選擇,市面上現有的產品不是閉源商用軟體,就是老舊的 VNC 系統。RustDesk 走的是不同的路線:它是採用 AGPL 授權的開源遠端桌面用戶端,能在所有主流發行版上原生執行,而且你可以將它連接到自己架設的伺服器。原始碼可受公開審查、原生 Linux 用戶端,再加上可自行架設的基礎架構——這樣的組合,正是當有人詢問「適用於 Linux 的開源遠端桌面工具」時,RustDesk 經常成為首選答案的原因。 Linux 使用者向來沒有太多優質的遠端桌面工具可以選擇,市面上現有的產品不是閉源商用軟體,就是老舊的 VNC 系統。RustDesk 走的是不同的路線:它是採用 AGPL 授權的開源遠端桌面用戶端,能在所有主流發行版上原生執行,而且你可以將它連接到自己架設的伺服器。原始碼可受公開審查、原生 Linux 用戶端,再加上可自行架設的基礎架構——這樣的組合,正是當有人詢問「適用於 Linux 的開源遠端桌面工具」時,RustDesk 經常成為首選答案的原因。
本指南將說明如何安裝 RustDesk、幾乎所有人都會碰到的關鍵問題(X11 與 Wayland 的差異)、如何設定無人值守與無頭(headless存取,以及伺服器在整個架構中扮演的角色。 本指南將說明如何安裝 RustDesk、幾乎所有人都會碰到的關鍵問題(X11 與 Wayland 的差異)、如何設定無人值守存取,以及伺服器在整個架構中扮演的角色。
## 在 Linux 上安裝 RustDesk ## 在 Linux 上安裝 RustDesk
@@ -53,7 +51,7 @@ RustDesk 為每一種常見的 Linux 封裝格式都提供了安裝包,因此
**Wayland:可以說是所有遠端桌面工具中支援度最完整的。** RustDesk 從 1.2.0 版起就開始支援 Wayland,而且持續在擴充相關功能。由於 Wayland 合成器(compositor)不允許直接存取畫面緩衝區,RustDesk 會透過 `xdg-desktop-portal` 服務與 [PipeWire](https://deepwiki.com/rustdesk/rustdesk/6.3.1-wayland-support) 擷取畫面,並透過核心的 `uinput` 模組注入輸入事件。這樣的設計會帶來兩個後果,而且這是 Wayland 架構本身的特性——所有 Wayland 螢幕分享工具都會遇到,並非 RustDesk 獨有: **Wayland:可以說是所有遠端桌面工具中支援度最完整的。** RustDesk 從 1.2.0 版起就開始支援 Wayland,而且持續在擴充相關功能。由於 Wayland 合成器(compositor)不允許直接存取畫面緩衝區,RustDesk 會透過 `xdg-desktop-portal` 服務與 [PipeWire](https://deepwiki.com/rustdesk/rustdesk/6.3.1-wayland-support) 擷取畫面,並透過核心的 `uinput` 模組注入輸入事件。這樣的設計會帶來兩個後果,而且這是 Wayland 架構本身的特性——所有 Wayland 螢幕分享工具都會遇到,並非 RustDesk 獨有:
- **每次連線都需要同意。** 系統的入口(portal)會跳出同意對話框,要求你選擇要分享哪個顯示畫面。這是 Wayland 刻意設計的安全機制,而不是 RustDesk 的錯誤——背景應用程式不能悄悄地開始錄製你的畫面。Portal v4 以上版本支援「還原權杖」(restore token),因此不會每次都要求你重新確認,但第一次分享時仍需要你在畫面上點擊確認。 - **每次連線都需要同意。** 系統的入口(portal)會跳出同意對話框,要求你選擇要分享哪個顯示畫面。這是 Wayland 刻意設計的安全機制,而不是 RustDesk 的錯誤——背景應用程式不能悄悄地開始錄製你的畫面。Portal v4 以上版本支援「還原權杖」(restore token),因此不會每次都要求你重新確認,但第一次分享時仍需要你在畫面上點擊確認。
- **僅限已登入的工作階段。** Wayland 擷取功能綁定在已登入的圖形工作階段上。目前尚不支援擷取 Wayland 的登入畫面(login greeter),這項功能仍在積極開發中([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420))。若你現在就需要在登入前存取畫面,請使用下方的無頭/虛擬顯示器設定,或是在仍提供 X11 工作階段的發行版上改用 X11。 - **僅限已登入的工作階段。** Wayland 擷取功能綁定在已登入的圖形工作階段上。目前尚不支援擷取 Wayland 的登入畫面(login greeter),這項功能仍在積極開發中([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420))。若你現在就需要在登入前存取畫面,請在仍提供 X11 工作階段的發行版上改用 X11。
Wayland 支援仍在持續進步——例如 RustDesk 1.4.3 版(2025 年 10 月)就[為 Wayland 新增了多螢幕分享功能](https://ubuntuhandbook.org/index.php/2025/10/rustdesk-released-1-4-3-with-multi-monitor-for-wayland-virtual-mouse/)。但如果你連線到 Wayland 主機後畫面卻是黑的,幾乎都是因為 portal/PipeWire 這條路徑沒有被正確滿足所致。我們另外撰寫的專文[《RustDesk 已連線但仍在等待影像》](/zh-tw/blog/rustdesk-connected-waiting-for-image-zh-tw),就詳細說明了 Wayland 黑畫面的情況。 Wayland 支援仍在持續進步——例如 RustDesk 1.4.3 版(2025 年 10 月)就[為 Wayland 新增了多螢幕分享功能](https://ubuntuhandbook.org/index.php/2025/10/rustdesk-released-1-4-3-with-multi-monitor-for-wayland-virtual-mouse/)。但如果你連線到 Wayland 主機後畫面卻是黑的,幾乎都是因為 portal/PipeWire 這條路徑沒有被正確滿足所致。我們另外撰寫的專文[《RustDesk 已連線但仍在等待影像》](/zh-tw/blog/rustdesk-connected-waiting-for-image-zh-tw),就詳細說明了 Wayland 黑畫面的情況。
@@ -63,21 +61,15 @@ Wayland 支援仍在持續進步——例如 RustDesk 1.4.3 版(2025 年 10
1. 透過 `.deb``.rpm` 安裝,讓 systemd 服務自動註冊,或是在應用程式中點選**啟用服務**(Enable Service)。 1. 透過 `.deb``.rpm` 安裝,讓 systemd 服務自動註冊,或是在應用程式中點選**啟用服務**(Enable Service)。
2. 在 RustDesk 的連線設定中,設定一組高強度的**永久密碼**,並建議同時啟用雙重驗證。 2. 在 RustDesk 的連線設定中,設定一組高強度的**永久密碼**,並建議同時啟用雙重驗證。
3. 若需要在使用者登入前,或跨越不同使用者登入時存取畫面,請使用下方的無頭虛擬顯示器設定(前面提到的 Wayland 登入畫面擷取限制,在此同樣適用)。
有一個 Wayland 的現實狀況需要事先規劃:在還在開發中的無人值守支援功能正式推出之前,前面 Wayland 小節提到的「需要同意」的入口機制,會讓完全無人值守的畫面擷取比在 X11 上更困難——因此,對於完全無人看管的機器,請預先規劃採用無頭虛擬顯示器設定。
## 無頭 Linux:沒有螢幕的伺服器 ## 無頭 Linux:沒有螢幕的伺服器
一個非常常見的 Linux 使用情境,是一台完全沒有接顯示器的主機——例如家用伺服器、實驗室機器或虛擬機(VM)。在這種情況下,問題並不出在 RustDesk 身上,而是出在繪圖堆疊:只要沒有接上顯示器,X 或 Wayland 就完全不會配置畫面緩衝區,因此根本沒有畫面可以擷取,你看到的就會是黑畫面。 一個非常常見的 Linux 使用情境,是一台完全沒有接顯示器的主機——例如家用伺服器、實驗室機器或虛擬機(VM)。在這種情況下,問題並不出在 RustDesk 身上,而是出在繪圖堆疊:只要沒有接上顯示器,X 或 Wayland 就完全不會配置畫面緩衝區,因此根本沒有畫面可以擷取,你看到的就會是黑畫面。
以下種方式,可以讓系統有畫面可以渲染: 以下種方式,可以讓系統有畫面可以渲染:
- **假接頭(dummy plug**——一種便宜的實體 HDMI/DisplayPort「無頭」轉接器,能讓顯示卡誤以為已經接上了顯示器。 - **假接頭(dummy plug**——一種便宜的實體 HDMI/DisplayPort「無頭」轉接器,能讓顯示卡誤以為已經接上了顯示器。
- **虛擬顯示器驅動程式**——在 X11 上可使用 `xserver-xorg-video-dummy`,或是採用像 VKMS 這類核心層級的方案。 - **虛擬顯示器驅動程式**——在 X11 上可使用 `xserver-xorg-video-dummy`,或是採用像 VKMS 這類核心層級的方案。
- **RustDesk 內建的無頭模式(選用)**——可透過 `sudo rustdesk --option allow-linux-headless Y` 啟用。根據 [Headless Linux 支援 Wiki](https://github.com/rustdesk/rustdesk/wiki/Headless-Linux-Support) 的說明,此功能預設為停用,主要在搭載 GNOME 的 Ubuntu 上測試,並需要 `xserver-xorg-video-dummy``lightdm` 等套件。你可以用 `sudo rustdesk --get-id` 取得該主機的 ID,並用 `sudo rustdesk --password <password>` 設定密碼。
無頭模式目前仍不夠成熟,細節上還有不少粗糙之處,比較適合視為「小心使用即可運作」,而非開箱即用的完整方案。
## 在 Linux 上自行架設 RustDesk 伺服器 ## 在 Linux 上自行架設 RustDesk 伺服器
@@ -58,7 +58,7 @@ metadata:
| ------- | ---------------------------------- | ------------------------------------------------------------------------------------------------------ | | ------- | ---------------------------------- | ------------------------------------------------------------------------------------------------------ |
| Windows | 安裝並保持服務執行中(隨機器啟動) | 可攜式執行檔會在登出或跳出 UAC 提示時中斷;請使用安裝程式 | | Windows | 安裝並保持服務執行中(隨機器啟動) | 可攜式執行檔會在登出或跳出 UAC 提示時中斷;請使用安裝程式 |
| macOS | 安裝、設定永久密碼、授予權限 | 必須授予「螢幕錄製」與「輔助使用」權限;登入畫面擷取需要安裝輔助程式 | | macOS | 安裝、設定永久密碼、授予權限 | 必須授予「螢幕錄製」與「輔助使用」權限;登入畫面擷取需要安裝輔助程式 |
| Linux | 安裝服務套件 | Wayland 需要有作用中的工作階段;登入前的情境請使用無頭虛擬顯示器設定,或在發行版仍提供的情況下使用 X11 | | Linux | 安裝服務套件 | Wayland 需要有作用中的工作階段;登入前的情境請在發行版仍提供的情況下使用 X11 |
| Android | 設定永久密碼;啟用擷取功能 | 螢幕必須保持喚醒狀態;需授予螢幕擷取(MediaProjection)同意權限與輸入權限 | | Android | 設定永久密碼;啟用擷取功能 | 螢幕必須保持喚醒狀態;需授予螢幕擷取(MediaProjection)同意權限與輸入權限 |
### Windows ### Windows
@@ -71,7 +71,7 @@ macOS 會透過權限機制來管控螢幕擷取與輸入功能。安裝完成
### Linux ### Linux
安裝 RustDesk,讓其服務元件在開機時執行。對於停留在登入畫面(greeter)的機器來說,Wayland 目前還無法擷取該畫面——這是 Wayland 本身的設計限制(並非 RustDesk 的限制),RustDesk 也正積極設法解決這個問題([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420))。在無頭主機上,請使用虛擬顯示器設定;在桌面環境中,只要發行版仍提供 X11/Xorg 工作階段,就仍然可以正常處理,不過目前已有不少發行版正逐漸轉向僅支援 Wayland。詳情請參閱[適用於 Linux 的 RustDesk](/zh-tw/blog/rustdesk-for-linux-zh-tw)。 安裝 RustDesk,讓其服務元件在開機時執行。對於停留在登入畫面(greeter)的機器來說,Wayland 目前還無法擷取該畫面——這是 Wayland 本身的設計限制(並非 RustDesk 的限制),RustDesk 也正積極設法解決這個問題([PR #15420](https://github.com/rustdesk/rustdesk/pull/15420))。在桌面環境中,只要發行版仍提供 X11/Xorg 工作階段,就仍然可以正常處理,不過目前已有不少發行版正逐漸轉向僅支援 Wayland。詳情請參閱[適用於 Linux 的 RustDesk](/zh-tw/blog/rustdesk-for-linux-zh-tw)。
## 步驟 3:透過預先設定好的用戶端進行大規模部署 ## 步驟 3:透過預先設定好的用戶端進行大規模部署