xpra - クラウドでオンライン

プログラム：

NAME

xpra - リモートの永続的な X アプリケーション用のビューア

SYNOPSIS

エックスプラ start [：画面] | エックスプラ start ssh:ホスト:ディスプレイ [--開始子=子] ...
[--env=KEY = VALUE] [--子を連れて終了] [- デーモン=はい|いいえ] [--使用表示]
[--xvfb=CMD] [--ビデオエンコーダー=エンコーダー] [--csc-モジュール=モジュール]
[--pulseaudio=はい|いいえ] [--pulseaudio-コマンド=サーバ 開始 COMMAND]
[-クリップボード=はい|いいえ] [--カーソル=はい|いいえ] [--通知=はい|いいえ] [--xsettings=はい|いいえ]
[- システムトレイ=はい|いいえ] [- ベル=はい|いいえ] [--リモートロギング=はい|いいえ]
[--音源=プラグイン] [- スピーカー=はい|いいえ] [--スピーカーコーデック=コー​​デック]
[- マイクロフォン=はい|いいえ] [--マイクコーデック=コー​​デック] [--共有=はい|いいえ]
[--バインド-tcp=[ホスト]:ポート] [-暗号化=CIPHER] [--暗号化キーファイル=ファイル名]
[--認証=モジュール] [--tcp-認証=モジュール] [--パスワードファイル=ファイル名]
[-アイドルタイムアウト=アイドルタイムアウト] [--クリップボードフィルターファイル=ファイル名] [--dpi=VALUE]
[- 入力方式=METHOD] [--ソケットディレクトリ=DIR] [--ソケット権限=アクセスモード]
[--mmap-グループ] [--tcp-プロキシ=ホスト:ポート] [--html=on|オフ|[ホスト]:ポート]
エックスプラ アタッチ [：画面 | ssh:[USER@]ホスト:ディスプレイ | tcp:[USER@]ホスト:ポート[:DISPLAY]] [-zLEVEL
| -圧縮=LEVEL] [--mmap=はい|いいえ] [- ウィンドウズ=はい|いいえ] [-クリップボード=はい|いいえ]
[--カーソル=はい|いいえ] [--通知=はい|いいえ] [--xsettings=はい|いいえ]
[- システムトレイ=はい|いいえ] [- ベル=はい|いいえ] [--リモートロギング=はい|いいえ]
[--キーボード同期=はい|いいえ] [--トレイ=はい|いいえ] [--音源=プラグイン]
[- スピーカー=on|オフ|無効] [--スピーカーコーデック=コー​​デック] [- マイクロフォン=on|オフ|無効]
[--マイクコーデック=コー​​デック] [--遅延トレイ] [- エンコーディング=エンコーディング]
[- スケーリング=on|オフスケーリング] [--opengl=はい|いいえ|自動] [- 品質=品質]
[--最小品質=最小品質] [- 速度=スピード] [--最小速度=最小速度]
[--自動更新遅延=遅延] [--キーショートカット=キー:アクション] [-読み取り専用=はい|いいえ]
[--共有=はい|いいえ] [- 題名=値] [--クライアントツールキット=ツールキット] [- 国境=ボーダー]
[--ウィンドウレイアウト=レイアウト] [--ウィンドウアイコン=ファイル名] [- トレイのアイコン=ファイル名] [--ssh=CMD]
[--exit-ssh=はい|いいえ] [--remote-xpra=CMD] [--パスワードファイル=ファイル名] [--dpi=値]
[--マウスポーリング=値] [--ソケットディレクトリ=DIR] [--ping=はい|いいえ] [-暗号化=暗号]
[--暗号化キーファイル=ファイル名]
エックスプラ 影 [：画面] | ssh:[USER@]ホスト[:DISPLAY] [- 始める=CMD] ...
[--開始子=子] ... [--env=KEY = VALUE] ... [--子を連れて終了]
[- デーモン=はい|いいえ] [-クリップボード=はい|いいえ] [--通知=はい|いいえ] [- ベル=はい|いいえ]
[--音源=プラグイン] [- スピーカー=on|オフ|無効] [--スピーカーコーデック=コー​​デック]
[- マイクロフォン=on|オフ|無効] [--マイクコーデック=コー​​デック] [--バインド-tcp=[ホスト]:ポート]
[--認証=モジュール] [--tcp-認証=モジュール] [--パスワードファイル=ファイル名]
[-アイドルタイムアウト=アイドルタイムアウト] [--ソケットディレクトリ=DIR] [--ソケット権限=アクセスモード]
[--mmap-グループ] [--tcp-プロキシ=ホスト:ポート] [--html=on|オフ|[ホスト]:ポート]
エックスプラ 代理 ：画面
エックスプラ stop [：画面 | ssh:[USER@]ホスト:ディスプレイ | tcp:[USER@]ホスト:ポート] [--ssh=CMD]
[--remote-xpra=CMD] [--ソケットディレクトリ=DIR]
エックスプラ 終了する [：画面 | ssh:[USER@]ホスト:ディスプレイ | tcp:[USER@]ホスト:ポート] [--ssh=CMD]
[--remote-xpra=CMD] [--ソケットディレクトリ=DIR]
エックスプラ デタッチ [：画面 | ssh:[USER@]ホスト:ディスプレイ | tcp:ホスト:ポート] [--ssh=CMD]
[--remote-xpra=CMD] [--ソケットディレクトリ=DIR]
エックスプラ スクリーンショット ファイル名 [：画面 | ssh:[USER@]ホスト:ディスプレイ | tcp:ホスト:ポート] [--ssh=CMD]
[--remote-xpra=CMD] [--ソケットディレクトリ=DIR]
エックスプラ バージョン [：画面 | ssh:[USER@]ホスト:ディスプレイ | tcp:ホスト:ポート] [--ssh=CMD]
[--remote-xpra=CMD] [--ソケットディレクトリ=DIR]
エックスプラ info [：画面 | ssh:[USER@]ホスト:ディスプレイ | tcp:ホスト:ポート] [--ssh=CMD]
[--remote-xpra=CMD] [--ソケットディレクトリ=DIR]
エックスプラ コントロール (：画面 | ssh:[USER@]ホスト:ディスプレイ | tcp:ホスト:ポート) command [引数..]
[--ssh=CMD] [--remote-xpra=CMD] [--ソケットディレクトリ=DIR]
エックスプラ 初期化 [--ソケットディレクトリ=DIR]
エックスプラ リスト [--ソケットディレクトリ=DIR]
エックスプラ アップグレード ：[画面] [...によって受け入れられるオプション エックスプラ start...]

DESCRIPTION

Xpra は、X プログラムを (通常はリモート ホスト上で) 実行できるようにするツールです。
表示をローカル マシンに向け、これらのプログラムから切断して再接続します。
同じマシンまたは別のマシンから、状態を失うことなく実行できます。 標準とは異なります
X 転送では、通信を中断することなく切断と再接続が可能です。
転送されたアプリケーション。 VNC や同様のリモート ディスプレイ テクノロジとは次の点で異なります。
xpraは 根無し草: つまり、xpra によって転送されたアプリケーションは通常どおりデスクトップに表示されます。
ウィンドウはすべて「一緒にボックスに閉じ込められる」のではなく、ウィンドウ マネージャーによって管理されます。
Xpra は、自己調整機能があり、比較的遅延の影響を受けにくいカスタム プロトコルも使用します。
したがって、標準 X では遅すぎる、または信頼性が低いネットワーク接続でも使用できます。
転送。 Xpra は、既存の X11 ディスプレイに影を付けるために使用することもできます。

デフォルトでは、Xpra サーバーは利用可能なセッション (ユーザー名とディスプレイ番号) を次の方法で通知します。
mDNS をローカル ネットワークに接続します。 使用 mdns=いいえ 無効にします。

インターフェイス STRINGS

Xpra は 3 種類の接続文字列をサポートしています。

：画面
ローカル ディスプレイ: これは最も単純な形式であり、現在のローカル ディスプレイに対してのみ有効です。
現在のユーザーの。

tcp:[ユーザー名@]ホスト:ポート[:ディスプレイ]
TCP モードではポート番号が使用され、番号は表示されません。 複数のディスプレイが利用可能な場合
単一の TCP ポート経由 (プロキシ サーバーを使用) の場合、表示を指定することもできます。
数。

ssh/[ユーザー名[:パスワード]@]ホスト[:SSH_PORT]/DISPLAY
SSH モードでは、接続を使用して最も一般的な接続オプションを指定できます。
弦。 さらにオプションを指定するには、 --ssh コマンドラインオプション。

下位互換性のために、SSH モードは次の構文もサポートします。
ssh:[ユーザー名[:パスワード]@ホスト:DISPLAY) ただし、このフォームは SSH の指定をサポートしていません
ポート番号。

パスワードは実際に Microsoft Windows でのみ使用されます。

例

エックスプラ start :7
ディスプレイ番号を使用して xpra サーバーを起動する :7.

エックスプラ start ssh:ビッグボックス:7 --start=xterm
xpraサーバーを起動します 大きな箱 xterm を含めて接続します。

表示=:7 Firefoxの
開始 Firefoxの xpra サーバー内で実行されます。 xpra があったホストでこれを実行します。
開始されたか、xpra によって転送された端末内で。 アタッチするまでウィンドウは表示されません
　 エックスプラ アタッチ.

エックスプラ リスト
現在のホストで実行している xpra サーバーのリストを表示します。

エックスプラ アタッチ :7
ローカル ディスプレイ番号を使用する xpra サーバーに接続します。 :7。 で実行されているすべてのアプリ
そのサーバーが画面に表示されます。

エックスプラ アタッチ ssh:foo@frodo:7
SSH を使用して、マシン上で実行されている xpra サーバーに接続します。 フロド ユーザーとして foo &
ディスプレイを使用する :7。 そのサーバー上で実行されているアプリはすべてローカル画面に表示されます。

エックスプラ start :7 && 表示=:7 screen
xpra サーバーを起動し、 screen(1)セッション。 内部のアプリケーションのいずれかが
画面で X を使用しようとすると、xpra サーバーにリダイレクトされます。

表示

xpra を適切に使用するには、ディスプレイの基本的な考え方を理解することが重要です。

このアイデアは標準 X から来ています。同じホスト上で複数の X サーバーが実行されている場合、
その場合、それらを区別する何らかの方法が必要になります。 X は、各サーバーに
小さくてユニークな整数を (おそらく混乱を招くため) 「ディスプレイ」と呼びます。 よくあるケースでは、
X サーバーが 0 つだけ実行されているデスクトップ マシン。そのサーバーはディスプレイ ":XNUMX" (または
場合によっては「:0.0」と表示されることがありますが、これは事実上同じです)。 アプリケーションの起動時
X では、使用する適切な X サーバーを見つける方法を知る必要があります。 これはチェックすることで行われます
環境変数 $ DISPLAY.

Xpra も同様の問題に直面しています。同じ上で複数の xpra サーバーが実行されている可能性があります。
ホストと複数の X サーバー。 X のソリューションを再利用することで、この問題を解決します。
各 xpra サーバーには、それに関連付けられたディスプレイがあります。 この表示は X としても機能します。
(xpra が X アプリケーションと通信しているとき用)、および xpra が使用する識別子として表示されます。
クライアント（ エックスプラ アタッチ) xpra サーバーを見つけることができます。

もしあなたの xvfb コマンドは、 -displayfd 引数を設定すると、 ディスプレイFD オプション
true 自分で /etc/xpra/xpra.conf ファイル (またはユーザーの ~/.xpra/xpra.conf）そして、あなたはそうすることができます
使用する場合は表示番号を省略してください エックスプラ start: ディスプレイが選択されます
自動的。 選択したディスプレイ番号はログ出力に表示されます。
で見ることができる エックスプラ リスト.

それ以外の場合は、xpra サーバーを起動するときに、使用するディスプレイの名前を指定する必要があります。
これを行うには、好きな数字を選択し、その数字の前にコロンを付けます。 ために
インスタンス :7、:12、および :3117 はすべて有効な表示名です。 次のことに留意してください。

· 単一マシン上で実行されているすべての X または xpra サーバーは、異なるサーバーを使用する必要があります。
表示名。 すでに使用されている番号を選択すると、xpra は機能しません。

· 最初のいくつかの数字 (0、1、2) は、実際の X サーバーで一般的に使用されます。

· を使用して特定のマシンに接続する全員 ssh(1) X 転送が有効な場合
表示番号も使用します。 ssh は通常、10 に近い番号 (11、12、XNUMX、
...）。

次のようなクライアントプログラムに xpra サーバーを指定する場合 エックスプラ アタッチ, エックスプラ デタッチ, エックスプラ
stop, エックスプラ 終了する, エックスプラ バージョン, エックスプラ info, エックスプラ リスト or エックスプラ スクリーンショット それからあなたは使うことができます
フォームの表示 :DISPLAY ローカルホスト上のサーバー、または次の形式のいずれかを参照します。
ssh:[ユーザー@]ホスト:DISPLAY リモートホスト上のサーバーを参照します。 xpra は自動的に
を使用してリモートホストに接続します ssh(1)。 一般に、xpra セッションが XNUMX つしかない場合、
マシン上で実行されている (実行して確認できます) エックスプラ リスト そのマシン上で)、その後、あなたは
数字を完全に省略できます。 エックスプラ アタッチ 単独で、上の唯一の xpra サーバーに接続します。
現在のマシンの番号に関係なく、 エックスプラ アタッチ ssh:フロド 同様に付着します
リモート マシン上の唯一の xpra セッション。

xpra サーバーに --バインド-tcp 開始時にオプションを選択すると、接続することもできます
フォームの表示を使用してそれにアクセスします tcp:ホスト:ポート。 (注意してください ssh: オプションがかかります
ディスプレイ 数値、一方 TCP: 必要な時間がかかります ポート 番号。）

サブコマンド

エックスプラ start
このコマンドは、必要なセットアップを含めて、新しい xpra サーバーを起動します。 (起動時
リモートサーバーと ssh:ホスト:ディスプレイ 構文を使用すると、新しいセッションもアタッチされます。)

エックスプラ アタッチ
このコマンドは、実行中の xpra サーバーに接続し、それを使用するアプリケーションを転送します。
サーバーを現在の画面に表示します。

エックスプラ デタッチ
指定された xpra ディスプレイを切り離します。

エックスプラ スクリーンショット
スクリーンショットを撮り、指定したファイル名に保存します。 注: スクリーンショットは、
クライアントが接続されているときに取得されます。

エックスプラ バージョン
サーバーのバージョンを問い合わせて出力します。 注: 古いサーバーはこれをサポートしていない可能性があります
特徴。

エックスプラ info
サーバーにバージョン、ステータス、統計情報を問い合わせます。 注: 古いサーバーでは機能しない可能性があります。
この機能をサポートします。

エックスプラ コントロール
コマンドを発行して、実行時にサーバーを変更します。 コマンドのリストは次のようにして取得できます。
コマンドとして「help」を指定します。 これらのコマンドの一部は「ヘルプ」モードをサポートしている場合があります。
自分自身。

エックスプラ 初期化
この内部コマンドは、ssh 接続で使用される run-xpra スクリプトを作成します。

エックスプラ stop
このコマンドは、実行中の xpra サーバーに接続し、それを終了するように要求します。
すぐに。 これにより通常、そのサーバーを使用しているアプリケーションはすべて終了します。
よく。

エックスプラ 終了する
このコマンドは、実行中の xpra サーバーに接続し、それを終了するように要求します。
すぐに。 ようではない エックスプラ stop、Xvfb プロセスとその X11 クライアント (存在する場合) は残ります。
実行している。

エックスプラ リスト
このコマンドは、現在のユーザーによって起動されたすべての xpra サーバーを検索します。
現在のマシンをリストし、リストします。

エックスプラ アップグレード
このコマンドは新しい xpra サーバーを起動しますが、最初から作成するのではなく、
別の既存のサーバーに接続し、終了するように指示し、サーバーの管理を引き継ぎます。
以前に管理していたアプリケーション。 名前が示すように、主な使用例は次のとおりです。
古いバージョンの xpra に対して実行されているサーバーを新しいバージョンに置き換えます。
セッションを再起動する必要があります。 現在実行中のもの エックスプラ アタッチ コマンドは終了し、
再起動する必要があります。

エックスプラ 影
このコマンドは、既存の X11 ディスプレイをシャドウします。 アクティブな X11 ディスプレイが XNUMX つだけある場合、
その数が 10 未満の場合は、自動検出できます。

この操作モードでは効率がはるかに低いスクリーンスクレイピングを使用することに注意してください。 を使って
この動作モードにはビデオ エンコーダ (h264 または vp8) を強くお勧めします。

エックスプラ 代理
このコマンドにより、単一のサーバーが他の複数のサーバーへのプロキシ接続を行うことができるようになります。
多くのセッションの負荷分散または認証エントリ ポイントとして機能します。 代理人
サーバーはプロキシ接続ごとに新しいプロセスを生成し、このプロキシ プロセスは
サブコマンドで使用できる未認証の新しい UNIX ドメイン ソケット info,
バージョン & stop.

重要 Note
一部のプラットフォームおよびパッケージ マネージャーは、クライアントのビルドのみを選択し、クライアントのビルドは行わない場合があります。
サーバ。 この場合、 アタッチ サブコマンドが利用可能になります。

OPTIONS

オプション
- バージョン
xpraのバージョン番号を表示します。

-NS、 - 助けて
コマンドラインの使用法の概要を表示します。

-d フィルター1、フィルター2、..., - デバッグ=フィルター1、フィルター2、...
デバッグログを有効にします。 特別な値 を すべてのデバッグを有効にします。

--mmap=はい|いいえ
メモリマップされたピクセルデータ転送を有効または無効にします。 デフォルトでは通常は
サーバーとクライアントが同じファイルシステム上に存在する場合、自動的に有効になります。
名前空間。 このデータ転送方法では、オーバーヘッドがはるかに低くなり、
CPU 消費量とローカル ネットワーク トラフィックの両方。

- ウィンドウズ=はい|いいえ
ウィンドウの転送を有効または無効にします。 通常、これが主な用途です
xpra を有効にする必要があります。

-クリップボード=はい|いいえ
クリップボードの同期を有​​効または無効にします。 サーバーで使用する場合、クライアントは不要
クリップボード同期をまったく使用できるようになります。 クライアントで使用する場合のみ、
この特定の接続では、サーバーからのクリップボード データが無視されます。

--pulseaudio=はい|いいえ
セッションによるpulseaudioサーバーの起動を有効または無効にします。

--pulseaudio-コマンド=サーバー起動コマンド
例外的に、pulseaudio サーバーの起動に使用するpulseaudio コマンドを指定します。
で無効に パルスオーディオ=いいえ.

--セッション名=VALUE
このセッションの名前を設定します。 この値は通知、ユーティリティ、
トレイ メニューなど。サーバー上でこの値を設定すると、デフォルト値が提供されます。
クライアントでオーバーライドされる可能性があります。

- エンコーディング=エンコーディング
これは使用する画像エンコーディングを指定します。エンコーディングは多数あります。
サポート： JPEG, PNG, png/P, png/L, webp, RGB, vp8, vp9, h264 & h265 (一部の人は
お使いの環境ではご利用いただけません）。

PNG 圧縮され可逆性があるため、非常に遅くなる可能性があります。

png/P 圧縮され非可逆: カラー パレットを使用するため、より優れたものになります。
圧縮されていますが、それでも遅いです。

png/L 圧縮および非可逆: パレットを使用したグレースケールのみ。

RGB zlib または lz4 で圧縮された生のピクセル形式 (ロスレス)、圧縮
比率は低くなりますが、利用できるエンコーディングの中で最も高速です。

webp 非可逆モードまたは可逆モードで使用でき、グラフィカル アプリケーションに便利です。
JPEGよりも圧縮率が高く、高速を除いてかなり高速です
決断。

JPEG グラフィカル アプリケーションには便利ですが、損失が多く、通常は非常に高速です。

vp8 常にカラーサブサンプリングを使用する非可逆ビデオエンコーディング。 エンコードが速い
そしてデコード。

vp9 エンコードが遅すぎるので避けてください。

h264 現在利用可能な最良のエンコーディング: 高速かつ効率的で、次の方法で調整可能です。
品質と速度のオプション。

h265 エンコードが遅すぎるので避けてください。

指定しない場合に自動的に選択されるデフォルトのエンコーディングは次のようになります。
サーバーとクライアントの両方でどのようなオプションが利用できるかについて: RGB いつでも利用可能です
(内蔵)、 JPEG & PNG Python イメージング ライブラリが必要です。 vp8, vp9, webp, h264 & h265
すべては、それぞれの共有ライブラリと、それらを使用する xpra コーデックを必要とします。

注: ビデオエンコーディングを選択するとき (通常は h264 or vp8)、一部の小さな画面
更新は、他の非ビデオ エンコーディングのいずれかを使用して送信されます。

- スケーリング=on|オフスケーリング
自動ウィンドウ ダウンスケーリングをどの程度使用するか (1 (まれに) から 100 まで)
(積極的に)、無効にする場合は 0。 ウィンドウのスケーリングは通常、大きなウィンドウで使用されます。
(特に全画面ウィンドウ) 適切なフレームレートを維持しようとします。 窓
ダウンスケーリングは視覚的な品質に悪影響を及ぼし、自動更新が発生します。
(有効な場合)、かなりの量を節約できるビデオ コンテンツで最も役立ちます。
帯域幅の量。

--opengl=はい|いいえ|オート
クライアントで OpenGL アクセラレーション レンダリングを使用します。 デフォルトでは、
グラフィックス カードとドライバーがサポートされています (オート モード）ですが、無効にすることもできます
OpenGL (いいえ) または強制的に有効化します (はい).

--ソケットディレクトリ=DIR
Xpra ソケット ファイルを書き込んで検索する場所。 デフォルトは「~/.xpra".
XPRA_SOCKET_DIR 環境変数を使用して指定することもできます。

socket-dir オプションを使用する場合は、通常、socket-dir を指定する必要があります。
xpra が開いているセッションで動作するように、以下のすべてのコマンドで実行します。 混合
異なるソケットディレクトリオプションは推奨されません。

共有ディレクトリを指定することで、これを mmap グループ or
ソケット権限 ユーザー アカウント間で Xpra セッションを接続するオプション。

オプション for 始めて、 アップグレード、 代理 & 影
- デーモン=はい|いいえ
デフォルトでは、xpra サーバーは自身をバックグラウンドに置きます。つまり、「デーモン化」し、
出力をログ ファイルにリダイレクトします。 これにより、その動作が防止されます (主に次の場合に役立ちます)
デバッグ)。

--mdns=はい|いいえ
mDNS 経由の新しいセッションの公開を有効または無効にします。

--認証=モジュール
使用する認証モジュールを指定します。 これはソケットを保護するために使用できます。
とは別の方法で -暗号化 スイッチ: 認証モジュールは、
さまざまなバックエンド モジュールに対するユーザー名とパスワード:

許す 常に認証を許可します - これは危険なので、次の場合にのみ使用してください。
テスト

失敗する 認証は常に失敗します。テストに役立ちます

file を使用して指定されたファイルとパスワードを照合します。 パスワードファイル スイッチか
経由で提供されるデータ XPRA_パスワード 環境変数。 彼らは次のいずれかを行うことができます
単一のパスワードが含まれている場合、そのパスワードはすべてのユーザー名に使用されます。
または、次の形式のユーザー認証情報のリスト (XNUMX 行に XNUMX つ):
ユーザー名|パスワード|uid|gid|ディスプレイ|env_opts|session_opts

PAM PAM システムを使用してユーザー名とパスワードを検証します

win32 Microsoft Windows認証を使用してユーザー名とパスワードを検証します

SYS 最適なシステム認証モジュールを自動的に選択します
（どちらか PAM or win32)

--tcp-認証=モジュール
と同じように 認証 ただし、これは TCP ソケット (ソケット) にのみ適用されます。
を使用して定義されます バインドTCP スイッチ）。

オプション for 始めて、 アップグレード

- 始める=CMD
サーバーを起動した後、コマンドを実行します CMD デフォルトのシェルを使用します。 の
コマンドはそのコマンドで実行されます $ DISPLAY 新しく起動したサーバーを指すように設定します。 これ
オプションを複数回指定して、複数の子を開始することができます。 --開始子=CMD
と同じ - 始めるただし、コマンドは次のように考慮されます。
--子を連れて終了.

--env=KEY = VALUE
fB--start を使用して開始されたコマンドにのみ影響する追加の環境変数
または fb--start-child。

--子を連れて終了
このオプションは次の場合にのみ使用できます。 --開始子 も与えられます。 それが与えられるなら、
xpra サーバーは、によって開始された子のステータスを監視します。 --開始子,
そして、最後のものが終了すると自動的に終了します。

--使用表示
xvfb でディスプレイを開始するのではなく、既存のディスプレイを使用します。 あなたに責任があります
自分で表示を開始するため。 これは、既存のメッセージをレスキューするためにも使用できます。
xpra サーバー インスタンスがクラッシュしたことを表示します。

--xvfb=CMD
サーバーを起動すると、xpra はクライアントを実行する仮想 X サーバーを起動します。 に
デフォルトでは、これは「Xvfb」です。 Xvfb がおかしな場所にインストールされている場合、または
他の仮想 X サーバーを使用したい場合、このスイッチを使用して、その方法を指定できます。
好みの X サーバー実行可能ファイルを実行します。 使用されるデフォルト値は次のとおりです。 Xvfb
+拡張機能 複合 -画面 0 3840x2560x24 + 32 -ノーリッスン TCP -noreset -認証
$XAUTHORITY

これは、Xvfb の代わりに Xdummy を指定するためにも使用できます。これには、
Xorg サーバーのバージョン 1.12 以降、およびダミードライバーのバージョン 0.3.5 以降。 ために
詳細については、https://xpra.org/Xdummy.html を参照してください。

オプション for 始めて、 アップグレード、 影

--バインド-tcp=[ホスト]:ポート
xpra サーバーは常にローカルの Unix ドメイン ソケットでの接続をリッスンし、
とのローカル接続をサポートします。 :7-style 表示アドレス、およびリモート
とのつながり ssh:フロド:7-スタイルの表示アドレス。 必要に応じて、それも可能です
生の TCP ソケットで接続をリッスンします。 この動作は次のコマンドで有効になります。
--バインド--tcp。 ホスト部分を省略した場合は、127.0.0.1 (localhost) となります。
使用済み。 すべてのインターフェイスで接続を受け入れたい場合は、0.0.0.0 を渡します。
ホスト部分。

認証オプションを使用せずにこのスイッチを使用することはお勧めできません。
セキュリティ リスク (特に 0.0.0.0 を渡す場合)! 誰でもこれに接続できます
ポートしてセッションにアクセスします。 特別なニーズがある場合にのみ使用してください。
自分の行動の結果を理解します。

--tcp-プロキシ=ホスト:ポート
非 xpra パケットの転送先アドレスを指定します。 これは可能です
別の TCP サーバー (通常は Web サーバー) と同じ TCP ポートを共有するために使用されます。
xpra クライアントは通常どおり接続しますが、xpra を話さないクライアントは接続します。
プロトコルは代替サーバーに転送されます。

--html=on|オフ|[ホスト]:ポート
HTML5 クライアント用の Web サーバーのセットアップを処理します。 これは自動的に
を構成します tcp-プロキシ 起動する Web サーバーを指します。 ポートがそうでない場合は、
指定すると、XNUMX つが自動的に選択されます。 ポート番号を指定するか、
Web サーバーは保護されていますが、少なくともファイアウォールの制限が適用されていることを確認してください。
通常は公立。 これには必要です ウェブソックファイ インストールされ、単一の TCP ポートが
を使用して構成されます バインドTCP.

--ビデオエンコーダー=エンコーダー
ロードを試行するビデオ エンコーダを指定します。 デフォルトではすべてロードされていますが、
ただし、より制限的なエンコーダのリストを指定したい場合もあります。 特別なものを使用してください
値「help」を指定すると、オプションのリストが表示されます。 ビデオをロードしない場合は、値「none」を使用します。
エンコーダ。

--csc-モジュール=モジュール
ロードしようとする色空間変換モジュールを指定します。 デフォルトでは、すべて
それらはロードされますが、より制限的なモジュールのリストを指定したい場合があります。
オプションのリストを取得するには、特別な値「help」を使用します。 値「none」を使用しない場合は、
色空間変換モジュールをロードします。

--mmap-グループ mmap ファイルの gid をソケット ファイルの gid と一致するように設定し、
mmap ファイルのアクセス許可を 660 に設定します。これは、mmap ファイルを共有するために必要です。
ユーザーアカウント。

--ソケット権限=アクセスモード
サーバーソケットの権限を指定します。 デフォルトは 600 です。これは無視されます。
いつ mmap グループ 有効になっています。

オプション for 始めて、 アップグレード & アタッチ

--パスワードファイル=ファイル名
これにより、テキスト ファイルに保存されたパスワードを使用してセッションを保護できます。 あなた
を使用する場合はこれを使用する必要があります --バインド-tcp オプション。 これをサーバー上で使用すると、
同じパスワード値を提供しないクライアント接続は拒否されます。
このオプションを使用する代わりに、パスワード自体を次の方法で指定できます。 XPRA_パスワード
環境変数。

-暗号化=CIPHER
接続を覗き見から保護するために使用する暗号を指定します。 これは
本当に役立つのは --バインド-tcp オプション。 このオプションでは、
--暗号化キーファイル オプションまたは XPRA_ENCRYPTION_KEY 環境変数。 NS
現在サポートされている暗号は次のとおりです AES、クライアントが暗号化を要求すると、
最初の通信後のすべての通信にクライアントとサーバーの両方で使用されます。
ただし、サーバーがこの機能もサポートしている場合に限ります。 ノート：
この機能は広範にレビューされていないため、現状ではレビューされるべきではありません
決意の強い攻撃者からは安全であると考えられています。

--暗号化キーファイル=ファイル名
で指定された暗号化暗号で使用するキーを指定します。 -暗号化.
クライアントとサーバーは同じキーファイルの内容を使用する必要があります。 これを使用する代わりに
オプションの場合、キーは次の方法で提供できます。 XPRA_ENCRYPTION_KEY 環境変数。

-アイドルタイムアウト=アイドルタイムアウト
ユーザーの操作 (マウスのクリックやキーなど) がない場合、接続は終了します。
を一定時間 (秒単位) 押し続けます。 値 0 を使用すると、
タイムアウト。

--クリップボードフィルターファイル=ファイル名
正規表現を含むファイルの名前、正規表現に一致するクリップボード データ
これらの正規表現のうちのいくつかは削除されます。 注: 現時点ではこれのみが適用されます
このオプションが使用されているマシンへのコピーではなく、このオプションが使用されているマシンからのコピーです。

--dpi=VALUE
クライアント アプリケーションが尊重する必要がある「XNUMX インチあたりのドット数」の値。 これ
数値は 10 ～ 500 の範囲内である必要があります。 多くのアプリケーション
この値は起動時にのみ読み取られるため、既存のセッションに接続します
異なる DPI 値で開始すると、期待した効果が得られない可能性があります。

--マウスポーリング=VALUE
カーソルが次のいずれかの上にない場合にマウスの位置をポーリングする頻度
私たちのウィンドウでは、これは秒単位で測定されます。 サーバーを許可したくない場合は、
マウスの動きの大まかな概要を把握するため、または単に無効にしたい場合
この機能を使用するには、特別な値「0」を使用します。

--カーソル=はい|いいえ
カスタム アプリケーションのマウス カーソルの転送を有効または無効にします。 クライアント
アプリケーションはいつでもマウス カーソルを変更する可能性があり、これにより新しい
毎回クライアントに送信されるカーソルのピクセル。 これにより、この機能が無効になります。

--通知=はい|いいえ
システム通知の転送を有効または無効にします。 システム通知には次のことが必要です
xpra サーバーに dbus デーモンの独自のインスタンスが存在する (dbus デーモンが欠落している場合)。
起動時に警告が出力されます。 このスイッチは機能を完全に無効にし、
警告を回避します。

- 入力方式=METHOD
設定する入力方法を指定します。 これにより、いくつかの環境が設定されます
で開始されたアプリケーションによって受け入れられる変数 開始子
オプションを選択します。

以下 METHODsは現在サポートされています：

なし 入力メソッドを完全に無効にし、干渉しないようにします。
キーボード入力。 これがデフォルトです。

続ける 環境を変化させずに維持します。 あなたはそれが確実であることを確認する責任があります
正しい。

xim X 入力メソッドを有効にします。

iBus インテリジェント入力バスを有効にします。

SCIM スマートコモン入力方式を有効にします。

ウイム ユニバーサル入力方式を有効にします。

他の値も設定されますが、警告がトリガーされます。

--xsettings=はい|いいえ
xsettings の同期を有​​効または無効にします。 Xsettings は次からのみ転送されます
posix クライアントは実際の posix サーバー (シャドウではない) に接続します。

- システムトレイ=はい|いいえ
システム トレイ アイコンの転送を有効または無効にします。 この機能にはクライアントが必要です
はサポートされていないため、プラットフォームによっては利用できない場合があります。

- ベル=はい|いいえ
システム ベルの転送を有効または無効にします。

--リモートロギング=はい|いいえ
クライアントがログ出力をサーバーに転送できるようにします。

オプション for アタッチ
-zLEVEL, -圧縮=LEVEL
xpra がデータを送信するときに使用する zlib 圧縮のレベルを選択します。
通信網。 圧縮レベルが高くなると、ネットワーク上で送信されるデータは少なくなりますが、
より多くの CPU パワー。 有効なオプションは 0 (圧縮なしを意味します) から 9 までです。
包括的な。 レベルが高くなると、CPU の使用量が徐々に増加しますが、CPU の使用量は減少します。
実際に達成された圧縮に関して返されます。 デフォルトは 3 です。
一般的には合理的なトレードオフです。 lz4 圧縮が利用可能な場合は、
レベルが 1 に設定されている場合に有効になります。lz4 の圧縮率は zlib よりも大幅に低くなりますが、
また、はるかに高速です。

この圧縮はピクセル データには使用されません (ただし、 RGB エンコーディング）。

- 品質=VALUE
このオプションは、非可逆エンコーディングの固定画像圧縮品質を設定します (JPEG, webp,
h264/h265 & vp8/vp9）。 まず、これらの非可逆エンコーディングの XNUMX つを有効にする必要があります。
- エンコーディング。 値の範囲は 1 (最低品質、高圧縮 - 一般に)
使用不可) から 100 (最高品質、低圧縮)。 ゼロの値を指定すると、
システムが品質を動的に調整して、帯域幅の使用率を最適化します。
可能。

--最小品質=最低品質
このオプションは、品質オプションが次の場合に許可される最小エンコード品質を設定します。
自動モードに設定します。

- 速度=SPEED
このオプションはエンコード速度を設定します。 遅いほど圧縮率が高く、速いほど圧縮率が高くなります
遅延が改善されます。 システムは通常、可変速度を使用しますが、このオプションは強制的に速度を変更します。
代わりに固定速度設定が使用されます。

--最小速度=最小速度
このオプションは、速度オプションが に設定されている場合に許可される最小エンコード速度を設定します。
自動モード。

--自動更新遅延=DELAY
このオプションは、次を使用してウィンドウが自動的に更新されるまでの遅延を設定します。
ロスレスフレーム。 遅延は浮動小数点数であり、単位は秒です。 これ
このオプションはデフォルトで 1 秒の遅延で有効になっています。 このオプションはあくまで
品質が 95% 未満の非可逆エンコーディングを使用する場合に関係します。

--キーショートカット=キー:アクション
複数回指定して複数のキー ショートカットを追加できます。 これらのキーは
クライアントによってキャッチされ、指定されたアクションがトリガーされ、キーが押されても無効になります。
サーバーに渡されます。

　 キー 仕様には次の形式でキーボード修飾子が含まれる場合があります。 [修飾子+]*キー,
たとえば、次の + F10シフト or Shift+Ctrl+B

コマンドラインでショートカットが定義されていない場合は、次のデフォルトのショートカットが使用されます。
中古： Meta+Shift+F4:終了

一部のアクションでは引数を使用できる場合があります (例: ログ アクションが実行されます)、その場合は
これらは通常のプログラミング スタイルの構文で指定されます。 ACTION(ARG1, ARG2、 など）
文字列引数は引用符で囲む必要があります (一重引用符と二重引用符の両方がサポートされています)。
数値引数を引用符で囲むことはできません。 括弧と引用符に注意してください
通常、シェルコマンドラインから使用する場合はエスケープされます。 例： - 鍵-
ショートカット=Meta+Shift+F7:log\(\'hello\'\)

以下 ACTIONは現在次のように定義されています。

やめます xpra クライアントを切断します。

ログ("メッセージ")
センド MESSAGE ログに。

show_session_info[("タブ名")]
セッション情報ウィンドウを表示します。 オプションの タブ名 ことができます
情報タブが選択されていることが示されています。 値を使用する 助けます のリストを取得するには
オプション。

show_start_new_command
新しいコマンドの開始ダイアログを表示します。

マジックキー
一部のウィンドウ レイアウトで使用できるプレースホルダー。

ボイド 何もしないので、特定のキーを防ぐために使用できます。
組み合わせがサーバーに送信されることはありません。

リフレッシュウィンドウ
現在フォーカスされているウィンドウを強制的に更新します。

すべてのウィンドウをリフレッシュ
すべてのウィンドウを強制的に更新します。

-読み取り専用=はい|いいえ
読み取り専用モードでは、キーボードとマウスのすべてのアクティビティがサーバーに送信されなくなります。
サーバー。

--共有=はい|いいえ
共有により、複数のクライアントが同じセッションに接続できるようになります。 これはきっと
サーバーとすべての連携クライアントの両方で機能できるようになります。

--キーボード同期=はい|いいえ
通常、キーを押すイベントとキーを放すイベントは、イベントが行われたときにサーバーに送信されます。
これは、サーバーが一貫したキーボードの状態を維持できるようにするためです。 無効化
同期により、待ち時間の長いリンク上でキーが予期せず繰り返されるのを防ぐことができます
ただし、キーボードに直接アクセスするアプリケーション (ゲーム、
など）。

--音源=ルギン
サウンド ストリームのキャプチャに使用される GStreamer サウンド プラグインを指定します。 これ
サーバー上の「スピーカー転送」とサーバー上の「マイク」転送に影響します。
クライアント。 オプションのリストを取得するには、特別な値「help」を使用します。 それも
次の形式を使用してプラグイン オプションを指定できます。 --音源=パルス
device=device.alsa_input.pci-0000_00_14.2.analog-stereo

- スピーカー=on|オフ|無効 & - マイクロフォン=on|オフ|無効
サウンドの入出力転送のサポート: on すぐに転送を開始します
接続が確立され、 オフ ユーザーはメニューから有効にする必要があります。
無効 使用できなくなり、メニューエントリが無効になります。

--スピーカーコーデック=コー​​デック & --マイクコーデック=コー​​デック
サウンド出力 (スピーカー) または入力 (マイク) に使用するコーデックを指定します。 これ
パラメータは複数回指定でき、コーデックの順序も指定できます。
指定されたコーデックの優先順序を定義します。 特別な値「help」を使用して、
オプションのリスト。 指定しない場合、利用可能なすべてのコーデックが許可され、
最初のものが使用されます。

- 題名=VALUE
ウィンドウのタイトルとして表示されるテキストを設定します。 提供された文字列はリモートを利用できます
メタデータ プレースホルダー。実行時に、
リモートサーバー。 使用されるデフォルト値は「@title@ on @client-machine@」です。

次のプレースホルダーが定義されています。

@タイトル@
リモート ウィンドウのタイトルに置き換えられます。

@クライアントマシン@
リモート サーバーのホスト名に置き換えられます。

--クライアントツールキット=ツールキット
使用するクライアント ツールキットを指定します。 これにより、使用されるユーザー インターフェイス ツールキットが変更されます
ウィンドウを描画するためのものであり、他の機能の可用性に影響を与える可能性があります。 「gtk2」
ツールキットは最も多くの機能を備えています。 特別な値「help」を使用して、
オプションのリスト。

- 国境=境界
すべての xpra ウィンドウ内に描画する境界線の色とサイズを指定します。 これ
リモート ホストで実行されている xpra ウィンドウとローカル ホストを簡単に区別するために使用できます。
ウィンドウズ。 の 境界 標準の色名を使用して指定できます (例: 赤または
オレンジ) または Web XNUMX 進構文を使用します (例: ＃F00 or ＃FF8C00）。 特別な
色の名前「オート" は、サーバーのターゲット アドレス (
接続文字列) なので、同じターゲットに接続すると常に
同じ色。 境界線のサイズをピクセル単位で指定することもできます。
- 国境=黄、10.

--ウィンドウレイアウト=レイアウト
メイン ウィンドウの描画方法を指定します。これはウィジェットの追加やカスタムの使用に使用できます。
コード。 オプションのリストを取得するには、特別な値「help」を使用します。 各クライアントツールキット
異なるウィンドウ レイアウトが提供される場合と提供されない場合があります。

--ウィンドウアイコン=ファイル名
すべてのウィンドウに使用されるデフォルトの画像へのパス。 このアイコンはおそらく
ウィンドウのバー、アイコン化された状態、またはタスク スイッチャーに表示されます。 これは以下に依存します
オペレーティング システム、ウィンドウ管理、およびアプリケーションもこれをオーバーライドする可能性があります。

--トレイ=はい|いいえ
システムトレイを有効または無効にします。 ドックアイコンが表示されているため、OSX では使用できません。
常に表示されます。

--遅延トレイ
システムを表示する前に、最初のウィンドウまたは通知が表示されるまで待機します。
トレイ。 (posixのみ)

- トレイのアイコン=ファイル名
ドック/トレイに表示されるアイコンを指定します。 デフォルトでは、単純なデフォルトが使用されます
「xpra」アイコン。 (Microsoft Windows では、アイコンは ICO フォーマット。）

--enable-ping
クライアントとサーバーは、収集に使用される ping および echo パケットを交換します。
レイテンシ統計。 これらの統計は、 エックスプラ info

オプション for 付けて、 止まる 情報、 スクリーンショット、 バージョン
--ssh=CMD
あなたが使うとき ssh: リモート ディスプレイに接続するためのアドレス、xpra が実行される ssh（1）〜
基礎となる接続を確立します。 デフォルトでは、次のコマンドを実行してこれを行います。
「しっ」。 ssh プログラムが通常とは異なる場所にあるか、通常とは異なる名前が付いているか、または
特別なオプションを渡して SSH の動作を変更したい場合は、 --ssh
xpra に ssh の実行方法を指示するためのスイッチです。

たとえば、Arcfour 暗号化を使用する場合は、次を実行する必要があります。

エックスプラ アタッチ --ssh=「しー」 -c アークフォー」 ssh:フロド:7

注： わざわざ ssh 圧縮を有効にする必要はありません。 これは xpra 独自のものと重複しています
圧縮すると、CPU が無駄になるだけです。 xpra も参照してください -圧縮 スイッチ。

MS Windows では、パス要素を区切るためにバックスラッシュが使用されます。
スペースはパスの一部として使用されることが多いため、パスの前後に引用符を追加する必要があります。 (つまり:
ssh="C:\プログラム ファイル\Xpra\Plink.exe」 - SSH -エージェント)

--exit-ssh=はい|いいえ
xpra 時に SSH クライアント プロセスを強制終了するかどうかを選択します
サーバーから切断されます。 SSH 接続共有を使用している場合は、
xpra によって生成された SSH マスター プロセス インスタンスが使用される可能性があるため、停止しないようにするため
他の SSH セッションによって。 注: 終了-ssh=いいえ SSH プロセスを
SSH プロセスが端末入力と対話するのを防ぐ端末、
これにより、パスワード入力やホストキーに必要なキーボード操作が無効になります。
検証など。

--remote-xpra=CMD
SSH 経由でリモート サーバーに接続する場合、xpra は検索して実行できる必要があります。
リモート ホスト上の xpra 実行可能ファイル。 この実行可能ファイルが非標準の場合
場所を指定するか、実行する前に特別な環境変数を設定する必要があります。
そうすると、これを達成するのは簡単ではないかもしれません。 実行中の場合 エックスプラ アタッチ ssh:何か
リモート xpra が見つからないために失敗する場合は、このオプションを使用して、
リモート ホストで xpra を実行する方法を指定します。

とはいえ、xpra はかなりの努力をするため、通常の使用ではこのオプションは必要ありません。
上記の問題を回避するのは困難です。 頻繁に必要になる場合は、
その場合、それはバグを示している可能性がありますので、お知らせいただければ幸いです。

ENVIRONMENT

DISPLAY
エックスプラ start --開始子=... 子の環境でこの変数を次のように設定します。
xpra ディスプレイをポイントします。

エックスプラ アタッチ一方、 はこの変数を使用して、どのディスプレイに表示されるかを決定します。
リモート アプリケーションが表示されるはずです。

XPRA_パスワード パスワード (またはユーザーとパスワードのリスト) を指定するために使用できます。
パスワードファイルの代わりになります。 もしも --パスワードファイル も指定されており、これは
環境変数は無視されます。

XPRA_ENCRYPTION_KEY 暗号化する場合に使用する暗号化キーを指定するために使用できます。
有効になっています。 キーを単独で指定しても暗号化はできません。 もしも
--暗号化キーファイル も指定されている場合、この環境変数は無視されます。

onworks.net サービスを使用して xpra オンラインを使用する