代码： 全选
XPRA(1) XPRA(1)
NAME
xpra - viewer for remote, persistent X applications
xpra - 浏览远程，持久的X应用程序
SYNOPSIS
xpra start :DISPLAY [--start-child=CHILD] ... [--exit-with-children]
[--no-daemon] [--bind-tcp=[HOST]:PORT]
xpra attach [:DISPLAY | ssh:HOST:DISPLAY | tcp:HOST:DISPLAY]
[--remote-xpra=CMD]
xpra stop [:DISPLAY | ssh:HOST:DISPLAY | tcp:HOST:DISPLAY]
[--remote-xpra=CMD]
xpra list
xpra upgrade :DISPLAY [...any options accepted by xpra start...]
DESCRIPTION
Xpra is a tool which allows you to run X programs — usually on a remote
host — and then direct their display to your local machine, disconnect
from these programs, and reconnect from the same or another machine,
all without losing any state. It differs from standard X forwarding in
that it allows disconnection and reconnection without disrupting the
forwarded application; it differs from VNC and similar remote display
technologies in that xpra is rootless: i.e., applications forwarded by
xpra appear on your desktop as normal windows managed by your window
manager, rather than being all "trapped in a box together". Xpra also
uses a custom protocol that is self-tuning and relatively latency-
insensitive, and thus is usable over network connections that are too
slow or unreliable for standard X forwarding.
Xpra是一个工具，它允许你运行X程序 - 通常在远程
主机 - 然后直接显示到本地机器，从这些程序中断开链接
，并重新从同一或另一台机器链接，
而不会失去任何数据。它不同于标准的X转发
它允许断开和重新连接不中断转发应用程序，它与VNC和类似的远程显示不同
xpra中，技术是无根的：即xpra转发的应用程序
出现在您的桌面上，由正常的窗口管理器创建您的窗口
，而不是被全部“一起被困在一个盒子里”。 Xpra也
使用自定义的协议，是自我调整和相对延迟
不敏感，因而可以通过过于缓慢或不可靠的网络连接使用
标准X转发。
EXAMPLES
xpra start :7
Start an xpra server using display number :7.
启动xpra服务器，使用显示器号码：7。
DISPLAY=:7 firefox
Start firefox running inside the xpra server. No window will
appear.
启动Firefox，在xpra的服务器：7内运行。将无窗口出现。
xpra list
Show a list of xpra servers you have running on the current host.
显示xpra在你当前主机上运行的服务器的列表。
xpra attach :7
Attach to the xpra server that is using local display number :7.
Any apps running on that server will appear on your screen.
附加xpra使用显示器号码：7的服务器到本地。
该服务器上运行的任何应用程序将出现在屏幕上。
xpra attach ssh:frodo:7
Use ssh to attach to the xpra server that is running on machine
frodo and using display :7. Any apps running on that server will
appear on your local screen.
使用ssh连接到机器上运行的xpra服务器
佛罗多和使用显示：7。将在该服务器上运行的任何应用程序
在您当地的屏幕上出现。
xpra start :7 && DISPLAY=:7 screen
Start an xpra server and a screen(1) session. If any of the
applications inside screen attempt to use X, they will be directed
to the xpra server.
启动xpra服务器和一个屏幕（1）进程。如果有任何
内屏幕尝试使用X的应用程序，他们将
xpra服务器。
DISPLAYS
Understanding the basic idea of displays is critical to using xpra suc‐
cessfully.
The idea comes from standard X. If you have multiple X servers running
on the same host, then there has to be some way to distinguish them. X
does this by assigning each server a small, unique integer called (per‐
haps confusingly) its "display". In the common case of a desktop
machine that has only one X server running, that server uses display
":0" (or sometimes you'll see ":0.0", which is effectively the same).
When an application starts under X, it needs to know how to find the
right X server to use; it does this by checking the environment vari‐
able $DISPLAY.
Xpra faces a similar problem — there may be multiple xpra servers run‐
ning on the same host, as well as well as multiple X servers. It
solves this problem by re-using X's solution — each xpra server has a
display associated with it. This display functions as both an X dis‐
play (for when xpra is talking to X applications) and as an identifier
by which xpra clients (like xpra attach) can locate the xpra server.
When starting an xpra server, you must specify the name of the display
to use. To do this, simply pick any number you like and stick a colon
in front of it. For instance :7, :12, and :3117 are all valid display
names. Just keep in mind that:
· Every X or xpra server that is running on a single machine must
use a different display name. If you pick a number that is
already in use then xpra will not work.
· The first few numbers (0, 1, 2) are commonly used by real X
servers.
· Everyone who connects to a given machine using ssh(1) with X
forwarding enabled will also use a display number; ssh generally
picks numbers near ten (10, 11, 12, ...).
When specifying an xpra server to a client program like xpra attach or
xpra stop, then you can use a display of the form :NUMBER to refer to a
server on the local host, or one of the form ssh:HOST:NUMBER to refer
to a server on a remote host; xpra will automatically connect to the
remote host using ssh(1). Generally, if you have only one xpra server
running on a machine, then you can omit the number entirely; xpra
attach alone will attach to the lone xpra server on the current machine
regardless of its number, xpra attach ssh:frodo will similarly attach
to the lone xpra server on a remote machine.
If the xpra server was given the --bind-tcp option when started (which
is a major security risk, and not recommended!), then you can also con‐
nect to it using a display of the form tcp:HOST:PORT. (Notice that ssh:
takes an optional display number, while tcp: takes a required port num‐
ber.)
了解显示器的基本思想是使用xpra SUC的关键
cessfully。
从标准X.的想法，如果您有多个X服务器上运行
在同一主机上，那么必须有一些方法来区分他们。 X
每个服务器分配一个小的，唯一的整数称为（每
混淆的HAPS）的“显示”。在桌面的共同情况下
机器只有一个X服务器上运行，该服务器使用的显示
“0”（或有时你会看到“0.0”，这实际上是相同的）。
当一个应用程序在X下启动时，它需要知道如何找到
正确的X服务器使用;这通过检查环境变量
能够为显示。
Xpra面临着类似的问题 - 有可能是多个xpra服务器运行
宁在同一主机上，以及以及多个X服务器。它
再利用X的解决方案来解决这个问题 - 每个xpra服务器都有一个
与它相关联的显示。既是一个X显示功能显示
播放（时xpra谈论X应用程序）和一个标识符
xpra客户（像xpra重视），可以找到xpra服务器。
当启动一个xpra服务器，你必须指定的显示名称
使用。要做到这一点，只需拿起任何你喜欢的号码，并坚持一个冒号
在它前面。例如：7：12：3117都是有效显示
名称。只要牢记：
每X或xpra这是一台机器上上运行的服务器必须
使用不同的显示名称。如果你选择一个数字，
已在使用，然后xpra将无法正常工作。
·第一的几个数字（0，1，2）常用的是真正的X
服务器。
每个人连接到一个给定的机器用X使用SSH（1）
启用了转发功能，也将一般使用显示号码; SSH
近十年的精选号码（10，11，12，...).
当指定xpra服务器的客户端程序，像xpra附加或
xpra停止，那么你可以使用的形式显示：数来指
服务器上的本地主机，或一个形式SSH：主持人：数指
到远程主机上的的服务器; xpra会自动连接到
远程主机使用ssh（1）。一般来说，如果你只有一个xpra服务器
一台机器上运行，那么你可以省略的数量完全; xpra
重视单独会附着在当前计算机上的独行xpra服务器
无论其数量，xpra附加SSH：佛罗多将同样重视
孤独xpra在远程机器上的服务器。
如果xpra服务器 - 绑定TCP选项启动时（
是一个重大的安全风险，不推荐！），那么你也可以CON
NECT它使用TCP的形式显示：主机：端口。 （请注意SSH：
有一个可选的显示号码，而TCP：需要所需的端口号
误码率。）
SUBCOMMANDS
xpra start
This command starts a new xpra server, including any necessary setup.
此命令启动一个新的xpra服务器，包括任何必要的设置。
xpra attach
This command attachs to a running xpra server, and forwards any appli‐
cations using that server to appear on your current screen.
此命令attachs正在运行的xpra服务器，并转发任何使用该服务器的应用
程序当前屏幕上出现。
xpra stop
This command attachs to a running xpra server, and requests that it
terminate immediately. This generally causes any applications using
that server to terminate as well.
此命令attachs到一个正在运行的xpra服务器，并请它
立即终止。这通常会导致任何应用程序使用
该服务器以及终止。
xpra list
This command finds all xpra servers that have been started by the cur‐
rent user on the current machine, and lists them.
这个命令发现所有xpra服务器已开始由当前
租金在当前计算机上的用户，并列出了它们。
xpra upgrade
This command starts a new xpra server, but instead of creating it from
scratch, it attaches to another existing server, tells it to exit, and
takes over managing the applications that it was managing before. As
the name suggests, the main use case is to replace a server running
against an older version of xpra with a newer version, without having
to restart your session. Any currently-running xpra attach command
will exit and need to be restarted.
此命令启动一个新的xpra服务器，而是创造它从
从无到有，它连接到另一个现有的服务器，告诉它退出，并
接管管理应用程序，这是管理之前。作为
顾名思义，主要使用的情况下更换一个服务器上运行
对年纪较大的一个新版本的版本的xpra，无需
重新启动您的会话。任何当前运行的xpra附加命令
将退出，需要重新启动。
OPTIONS
General options
--version
Displays xpra's version number.
显示xpra的版本号。
-h, --help
Displays a summary of command line usage.
显示命令行用法的总结。
-d FILTER1,FILTER2,..., --debug=FILTER1,FILTER2,...
Enable debug logging. The special value all enables all debug‐
ging; alternatively, debugging logs for particular systems can
be enabled by specifying one or more filters (separated by com‐
mas). In general, check the source to determine filter names —
but they will look something like xpra.protocol.raw or wimpiggy
(wimpiggy is the name of one of xpra's underlying libraries). A
filter like xpra.protocol.raw is more specific than one like
xpra.protocol.
启用调试日志记录。特殊值，使所有调试
蔓茎;另外，可以针对特定系统的调试日志
启用指定一个或多个过滤器（COM -分隔
MAS）。在一般情况下，检查源，以确定过滤器的名字 -
但他们将看起来像xpra.protocol.raw或wimpiggy这样的东西
（wimpiggy xpra的底层库的名称）。一
过滤器就像xpra.protocol.raw是一个以上的特定像
xpra.protocol。
Options for start, upgrade
--start-child=CMD
After starting the server, runs the command CMD using the
default shell. The command is run with its $DISPLAY set to
point to the newly-started server. This option may be given
multiple times to start multiple children.
启动服务器后，运行命令cmd使用
默认的shell。运行该命令其设置为显示
指向新启动的服务器。此选项可给予
多次启动多个孩子。
--exit-with-children
This option may only be used if --start-child is also given. If
it is given, then the xpra server will monitor the status of the
children started by --start-child, and will automatically termi‐
nate itself when the last of them has exited.
此选项只可使用 --start-child 也启动后。如果
它被赋予的，那么xpra服务器将监视--start-child子程序的状态，
并会在他们本身已退出时，自动终止
--no-daemon
By default, the xpra server puts itself into the background,
i.e. 'daemonizes', and redirects its output to a log file. This
prevents that behavior (useful mostly for debugging).
xpra服务器默认情况下，放入自己的背景，
即“daemonizes”，它的输出重定向到一个日志文件。这
阻止这种行为（主要用于调试时非常有用）。
Options for attach, stop
--bind-tcp=[HOST]:PORT
The xpra server always listens for connections on a local Unix
domain socket, and supports local connections with the :7-style
display address, and remote connections with the
ssh:frodo:7-style display address. If you want, it can also lis‐
ten for connections on a raw TCP socket. This behavior is
enabled with --bind--tcp. If the host portion is omitted, then
127.0.0.1 (localhost) will be used.
xpra服务器始终侦听连接为一个本地的Unix
:7 -域套接字，并支持本地连接
显示与地址，远程连接
SSH：佛罗多:7 -风格的显示地址。如果你想，它也可以LIS
十一个原始TCP套接字上的连接。这种行为是
- 绑定 - TCP启用。如果主机部分被省略，则
127.0.0.1（本地主机）将被使用。
Using this switch is NOT RECOMMENDED, and is a major security risk!
Xpra does not do any checking on incoming connections; anyone at
all may connect to this port and access your desktop. Use it
only if you have special needs (e.g., certain virtualization
environments), and understand the consequences of your actions.
使用此开关是不推荐的，是一个重大安全隐患！
Xpra没有做任何人在检查传入的连接;
都可以连接到这个端口，并访问您的桌面。使用它
只有当您有特殊需求（如，某些虚拟化
环境），并了解你的行动的后果。
Options for start
--remote-xpra=CMD
When connecting to a remote server over ssh, xpra needs to be
able to find and run the xpra executable on the remote host. If
this executable is in a non-standard location, or requires spe‐
cial environment variables to be set before it can run, then
accomplishing this may be non-trivial. If running xpra attach
ssh:something fails because it cannot find the remote xpra, then
you can use this option to specify how to run xpra on the remote
host.
That said, this option should not be needed in normal usage, as
xpra tries quite hard to work around the above problems. If you
find yourself needing it often, then that may indicate a bug
that we would appreciate hearing about.
当连接到一个通过SSH的远程服务器，xpra需要
能够找到并运行远程主机上的xpra的可执行文件。如果
这个可执行文件是一个非标准的位置，或需要SPE -
CIAL环境变量设置，才可以运行，然后
完成这可能是不平凡的。如果运行xpra重视
SSH：事情失败，因为它不能找到遥控器xpra，然后
您可以使用此选项来指定如何在遥控器上运行xpra
主机。
这就是说，此选项不应该需要在正常使用中，由于
xpra试图解决上述问题相当困难。如果你
发现自己经常需要它，那么这可能表明一个错误
我们希望听到有关。
ENVIRONMENT
DISPLAY
xpra start --start-child=... sets this variable in the environ‐
ment of the child to point to the xpra display.
xpra attach, on the other hand, uses this variable to determine
which display the remote applications should be shown on.
xpra start --start-child=...在设置这个变量环境
对孩子的指向xpra显示。
xpra重视，另一方面，使用这个变量来确定
这显示应显示在远程应用程序。
FILES
Xpra uses the directory ~/.xpra to store a number of files.
Xpra使用目录〜/.xpra存储大量的文件。
~/.xpra/:7
The unix domain socket that clients use to contact the xpra
server.
Unix域套接字的客户端使用的xpra联系
服务器。
~/.xpra/:7.log
When run in daemon mode (the default), the xpra server directs
all output to this file. This includes all debugging output, if
debugging is enabled.
在守护进程模式（默认）运行时，指示xpra服务器
这个文件的所有输出。这包括所有的调试输出，如果
启用调试。
~/.xpra/run-xpra
A shell script that, when run, starts up xpra with the correct
python interpreter, PYTHONPATH, PATH, location of the main xpra
script, etc. Automatically generated by xpra start and used by
xpra attach (see also the discussion of --remote-xpra).
一个shell脚本，运行时，启动正确的xpra
Python解释器，PYTHONPATH中，路径，主要xpra的位置
xpra启动脚本等自动生成和使用
xpra重视（见还讨论 - 远程xpra）。
BUGS
Xpra has no test suite.
Xpra does not fully handle all aspects of the X protocol; for instance,
as of March 2009 it does not yet forward custom cursors, beeps, fancy
input features like pressure-sensitivity on tablets, some window man‐
ager hints, and probably other more obscure parts of the X protocol.
It does, however, degrade gracefully, and patches for each feature
would be gratefully accepted.
The mapping between local and remote keyboard events is not very
robust; in particular, it is possible in some situations for modifier
keys to get "stuck" in xpra, and it is usually impossible to type char‐
acters outside of the standard US keyboard range.
The xpra server allocates an over-large framebuffer; this wastes mem‐
ory, and can cause applications to misbehave (e.g., by letting menus go
off-screen). Conversely, if the framebuffer is ever insufficiently
large, clients will misbehave in other ways (e.g., input events will be
misdirected).
The need to choose display numbers by hand is annoying.
Xpra does not fully handle all aspects of the X protocol; for instance,
as of March 2009 it does not yet forward custom cursors, beeps, fancy
input features like pressure-sensitivity on tablets, some window man‐
ager hints, and probably other more obscure parts of the X protocol.
It does, however, degrade gracefully, and patches for each feature
would be gratefully accepted.
The mapping between local and remote keyboard events is not very
robust; in particular, it is possible in some situations for modifier
keys to get "stuck" in xpra, and it is usually impossible to type char‐
acters outside of the standard US keyboard range.
The xpra server allocates an over-large framebuffer; this wastes mem‐
ory, and can cause applications to misbehave (e.g., by letting menus go
off-screen). Conversely, if the framebuffer is ever insufficiently
large, clients will misbehave in other ways (e.g., input events will be
misdirected).
The need to choose display numbers by hand is annoying.
Xpra没有测试套件。
Xpra不能完全处理的X协议的所有方面，例如，
2009年3月，还没有提出自定义光标，会发出蜂鸣声，看中
输入的功能，如片压力的敏感性，一些窗口的人
AGER提示，可能是比较晦涩的X协议的其他部分。
然而，它降低正常，并为每个功能的补丁
会欣然接受。
本地和远程键盘事件之间的映射是不是很
强劲，尤其是，它可能在某些情况下，修饰
键“卡壳”在xpra和char类型，通常是不可能
acters以外的美国标准键盘范围。
xpra服务器分配过大的framebuffer;，这会浪费MEM -
存储器，并可能导致应用程序做坏事（例如，让菜单去
关闭屏幕）。反之，如果framebuffer的是永远不够
大，客户端将在其他方法（如行为不端，输入事件将被
误导）。
需要手工选择显示数字是烦人。
REPORTING BUGS
Send any questions or bugs reports to <parti-discuss@partiwm.org>.
任何问题或错误报告发送到<parti-discuss@partiwm.org>。
SEE ALSO
screen(1)
这两个终端的速度都很快,比 xterm 好多了.