xpra README

The project's README from github.com/Xpra-org/xpra. As one markdown file: README.md.

  1. About
  2. Installation
  3. Usage
  4. Documentation
  5. Help

About

Xpra is known as "screen for X" : its seamless mode allows you to run X11 programs, usually on a remote host, direct their display to your local machine, and then to disconnect from these programs and reconnect from the same or another machine(s), without losing any state. Effectively giving you remote access to individual graphical applications. It can also be used to access existing desktop sessions and start remote desktop sessions.

Xpra is open-source (GPLv2+) with clients available for many supported platforms, and the server includes a built-in HTML5 client. Xpra is usable over a wide variety of network protocols and does its best to adapt to any network conditions.

Xpra forwards and synchronizes many extra desktop features, which allows remote applications to integrate transparently into the client's desktop environment: audio input and output, printers, clipboard, system trays, notifications, webcams, etc.

It can also open documents and URLs remotely, display high bit depth content, and it will try to honor the display's DPI.

Here's what a seamless session with two windows (an xterm and glxspheres) looks like when attached from an MS Windows 11 desktop client: Windows11-client (the windows may look like native windows, but they are running on a remote Linux server)

Installation

Official stable downloads

All the packages are signed. There are also LTS and beta builds available.
For more information and more build architecture options, see xpra downloads.

Build from source

git clone https://github.com/Xpra-org/xpra; cd xpra
python3 ./setup.py install

For more details, see building from source. To contribute to the project, please try to use pull-requests and follow our code of conduct. Unit test status: xpra

Usage

Initial requirements

xpra must be installed on the client and the host.

You can use the html5 client in which case xpra is only required on the host.

Seamless Mode

Run xterm on a remote host, display and interact with it locally (from the client machine):

xpra seamless ssh://USER@HOST/ --start=xterm
# hint: xterm must be installed on the HOST.

For more examples, see usage.

Shadow

View an existing desktop session running on a remote host:

xpra shadow ssh://USER@HOST/

Network Access

Xpra servers can support many different types of connections using a single TCP port: SSL, SSH, (secure) http / websockets, RFB, etc..
Connections can be secured using encryption and many authentication modules.
Sessions can be automatically announced on LANs using multicast DNS so that clients can connect more easily using a GUI (ie: xpra mdns-gui).
Its flexible proxy server can be used as a relay or front end for multiple server sessions.

Documentation

There is extensive documentation right here for the current development version. This documentation is also included with each release.

For more generic version-agnostic information, checkout the wiki.

Help

Make sure to check the FAQ, your question may already be answered there. You can ask your questions on the GitHub discussions, or on the IRC channel #xpra on libera.chat or using discord. If you have hit a bug (sorry about that!), please see reporting bugs.

xpra (Xpra-org/xpra)

Searching Database…

3K ·GitHub
Xpra
这是什么？Xpra 让你在远程主机上运行 X11 应用并在本地机器上显示，即使断开连接它们也会继续运行——本质上是 GUI 应用的「screen」。它还支持完整的远程桌面会话和屏幕共享，并内置 HTML5 网页客户端。
这是桌面应用、命令行工具，还是别的什么？Xpra 主要是一个命令行服务器/客户端工具，带有适用于 Windows、macOS 和 Linux 的原生图形客户端，外加服务器端的 HTML5 客户端，因此只靠浏览器也能连接。
怎么让它跑起来？为你的操作系统安装官方签名软件包（Windows EXE/ZIP/MSI、x86_64/arm64 的 macOS DMG/PKG，或 Linux RPM/DEB），或从源码构建，然后用 xpra 启动会话并用客户端连接。
两台机器都需要安装 Xpra 吗？通常是的，客户端和主机都要安装 Xpra；唯一的例外是通过内置 HTML5 客户端连接时，只有主机一侧需要 Xpra。
它需要稳定快速的网络连接才能好用吗？对网速没有特别要求——Xpra 的设计就是为了适应不同的网络状况，可以通过多种传输方式（SSL、SSH、websockets、RFB）在单个 TCP 端口上运行。
远程连接是加密的吗？是的，Xpra 连接可以用加密加以保护，并可选择多种身份验证模块。
无缝模式和影子模式有什么区别？无缝模式转发单个远程应用窗口，使其外观和行为都像本地窗口；影子模式则让你查看并操作整个已有的远程桌面会话，而不只是单个应用。
Xpra 还能转发哪些额外的桌面功能？它可以转发音频输入/输出、打印机、剪贴板、系统托盘、通知和摄像头，还能在客户端侧打开远程文档或 URL。
一个连接可以服务多个远程会话吗？可以，Xpra 的代理服务器可以中继或充当多个服务器会话的前端，会话还可以通过组播 DNS 在局域网内自动公告，便于发现。
为什么它被称为「X 的 screen」？就像 Unix 的 'screen' 终端复用器能在你断开后让终端会话继续存活一样，Xpra 能让远程 X11 图形应用在你断开后继续运行并可重新连接。
What are similar projects?sshdesk, mRemoteNG, labtether, Termix, WindTerm, dsh-remote-web-gateway, tailcat, jumpserver
Which topics is it in?vnc, x11, remote-desktop, remote-access, gplv2, ssh, websocket, authentication, encryption, proxy, desktop, networking
Creator
Xpra-org
Size
86.3 MB
Stars
3K
Updated
CommitOct 19Releasev6.5.5Oct 12
Age
5y
Commits · 90 Days