「TigerVNC」の版間の差分

提供: ArchWiki
ナビゲーションに移動 検索に移動
 
(同じ利用者による、間の10版が非表示)
1行目: 1行目:
[[Category:セキュリティ]]
 
 
[[Category:リモートデスクトップ]]
 
[[Category:リモートデスクトップ]]
  +
[[Category:サーバー]]
 
[[de:VNC]]
 
[[de:VNC]]
 
[[en:TigerVNC]]
 
[[en:TigerVNC]]
10行目: 10行目:
 
{{Related|TurboVNC}}
 
{{Related|TurboVNC}}
 
{{Related articles end}}
 
{{Related articles end}}
[http://tigervnc.org/ TigerVNC] は [[Wikipedia:VNC|VNC]] プロトコルの実装です。この記事ではサーバー機能に焦点をあてています。
+
[http://tigervnc.org/ TigerVNC] は [[Wikipedia:Virtual Network Computing|Virtual Network Computing]] (VNC) プロトコルの実装です。この記事ではサーバー機能に焦点をあてています。
   
 
== インストール ==
 
== インストール ==
48行目: 48行目:
 
{{Note|{{ic|/usr/bin/vncserver}} への直接の呼び出しは、適切なセッションスコープを確立しないため、サポートされていません。''systemd'' サービスは TigerVNC を使うために唯一サポートされている方法です。[https://github.com/TigerVNC/tigervnc/issues/1096 Issue #1096] を参照してください。}}
 
{{Note|{{ic|/usr/bin/vncserver}} への直接の呼び出しは、適切なセッションスコープを確立しないため、サポートされていません。''systemd'' サービスは TigerVNC を使うために唯一サポートされている方法です。[https://github.com/TigerVNC/tigervnc/issues/1096 Issue #1096] を参照してください。}}
   
  +
== ローカルディスプレイを直接公開する ==
== Expose the local display directly ==
 
   
  +
Tigervnc は {{ic|libvnc.so}} を同梱しており、これは X の初期化中に直接ロードすることができます。これにより、パフォーマンスが向上します。
Tigervnc comes with {{ic|libvnc.so}} which can be directly loaded during X initialization which provides better performance.
 
  +
以下のファイルを作成し、X を再起動してください:
Create a following file and restart X:
 
   
 
{{hc|/etc/X11/xorg.conf.d/10-vnc.conf|
 
{{hc|/etc/X11/xorg.conf.d/10-vnc.conf|
65行目: 65行目:
 
}}
 
}}
   
  +
== x0vncserver を直接実行してローカルディスプレイを制御する ==
== Running x0vncserver to directly control the local display ==
 
   
  +
{{Pkg|tigervnc}} はまた、{{man|1|x0vncserver}} も提供しており、これによって物理的な X セッションを直接制御することができます。''vncpasswd'' ツールを使ってセッションパスワードを定義した後、以下のようにサーバーを起動します:
{{Pkg|tigervnc}} also provides {{man|1|x0vncserver}} which allows direct control over a physical X session. After defining a session password using the ''vncpasswd'' tool, invoke the server like so:
 
   
 
$ x0vncserver -rfbauth ~/.vnc/passwd
 
$ x0vncserver -rfbauth ~/.vnc/passwd
   
 
{{Note|
 
{{Note|
  +
* [[x11vnc]] は、現在の X セッションを直接制御できる代替の VNC サーバーでもあります。
* [[x11vnc]] is an alternative VNC server which can also provide direct control of the current X session.
 
* {{ic|x0vncserver}} does not currently support clipboard sharing between the client and the server (even with the help of {{ic|autocutsel}}). See: [https://github.com/TigerVNC/tigervnc/issues/529 Issue #529].
+
* {{ic|x0vncserver}} は現在、クライアントとサーバー間のクリップボード共有をサポートしていません({{ic|autocutsel}} の助けを借りても)。参照:[https://github.com/TigerVNC/tigervnc/issues/529 Issue #529]
 
}}
 
}}
   
=== With xprofile ===
+
=== xprofile とともに ===
   
  +
''x0vncserver'' を簡単に起動する方法の一つは、[[xprofile]] ファイルの一つに以下のような行を追加することです:
A simple way to start ''x0vncserver'' is adding a line in one of the [[xprofile]] files such as:
 
   
 
{{hc|~/.xprofile|
 
{{hc|~/.xprofile|
85行目: 85行目:
 
}}
 
}}
   
=== With systemd ===
+
=== systemd とともに ===
   
==== With a system service ====
+
==== システムサービスとして ====
   
  +
このオプションは、ユーザーが現在のディスプレイ、およびディスプレイマネージャーが提供するログイン画面にアクセスできるようにします。
This option will allow the users to access the current display, including the login screen provided by your display manager.
 
   
  +
このサービスは、ユーザーがセッションからログオフするたびに自動的に再起動されます。
The service will be relaunched automatically every time an user logs off of their session.
 
   
  +
以下の例では [[LightDM]] が使用されていますが、{{ic|XAUTHORITY}} 変数を修正することで他のディスプレイマネージャーに適応させることが可能です。
[[LightDM]] is used for the example below, but it should be possible to adapt it to other display managers by modifying the {{ic|XAUTHORITY}} variable.
 
   
 
{{hc|/etc/systemd/system/x0vncserver.service|2=
 
{{hc|/etc/systemd/system/x0vncserver.service|2=
114行目: 114行目:
 
}}
 
}}
   
As this is a system unit, {{ic|-rfbauth ~/.vnc/passwd}} refers to {{ic|/root/.vnc/passwd}}
+
このサービスはシステムユニットなので、{{ic|-rfbauth ~/.vnc/passwd}} {{ic|/root/.vnc/passwd}} を指します。
   
[[Start/enable]] {{ic|x0vncserver.service}}.
+
{{ic|x0vncserver.service}} を[[開始/有効化]]してください。
   
==== With a user service ====
+
==== ユーザーサービスとして ====
   
  +
現在のデスクトップにリモートアクセスをすぐに設定できる最も簡単な方法として、''x0vncserver'' を実行する VNC サーバーを持つために、以下のように ''systemd'' ユニットを作成して、必要なユーザーとオプションで置き換えてください:
In order to have a VNC Server running ''x0vncserver'', which is the easiest way for most users to quickly have remote access to the current desktop, create a ''systemd'' unit as follows replacing the user and the options with the desired ones:
 
   
 
{{hc|~/.config/systemd/user/x0vncserver.service|2=
 
{{hc|~/.config/systemd/user/x0vncserver.service|2=
135行目: 135行目:
 
}}
 
}}
   
The {{ic|ExecStartPre}} line waits for Xorg to be started by {{ic|${USER}<nowiki/>}}.
+
{{ic|ExecStartPre}} 行は、{{ic|${USER}<nowiki/>}} によって Xorg が開始されるのを待っています。
   
To login with your username and password, replace {{ic|ExecStart}} by {{ic|1=/usr/bin/x0vncserver -PAMService=login -PlainUsers=${USER} -SecurityTypes=TLSPlain}}.
+
ユーザーネームとパスワードでログインする場合は、{{ic|ExecStart}} {{ic|1=/usr/bin/x0vncserver -PAMService=login -PlainUsers=${USER} -SecurityTypes=TLSPlain}} に置き換えてください。
   
[[Start/enable]] the {{ic|x0vncserver.service}} [[user unit]].
+
{{ic|x0vncserver.service}} ユーザーユニットを[[開始/有効化]]してください。
   
  +
== XDMCP と組み合わせて Xvnc をオンデマンドセッションで実行する ==
== Running Xvnc with XDMCP for on demand sessions ==
 
   
  +
''systemd'' のソケットアクティベーションと [[XDMCP]] を組み合わせることで、ログインしようとする各ユーザーごとに自動的に VNC サーバーを生成することができます。そのため、ユーザーごとにサーバー/ポートを設定する必要はありません。このセットアップでは、ディスプレイマネージャーを使用してユーザーを認証し、ログインするため、VNC パスワードは必要ありません。欠点としては、ユーザーがサーバー上でセッションを継続して後で再接続することはできません。
One can use ''systemd'' socket activation in combination with [[XDMCP]] to automatically spawn VNC servers for each user who attempts to login, so there is no need to set up one server/port per user. This setup uses the display manager to authenticate users and login, so there is no need for VNC passwords. The downside is that users cannot leave a session running on the server and reconnect to it later.
 
   
  +
これを動作させるには、まず [[XDMCP]] を設定し、ディスプレイマネージャーが動作していることを確認してください。
To get this running, first set up [[XDMCP]] and make sure the display manager is running.
 
  +
次に、以下を作成します:
Then create:
 
   
 
{{hc|/etc/systemd/system/xvnc.socket|2=
 
{{hc|/etc/systemd/system/xvnc.socket|2=
171行目: 171行目:
 
}}
 
}}
   
  +
{{ic|xvnc.socket}} を[[開始/有効化]]してください。これで、任意の数のユーザーがポート 5900 に接続することで独自のデスクトップを取得できます。
[[Start/enable]] {{ic|xvnc.socket}}. Now, any number of users can get unique desktops by connecting to port 5900.
 
   
If the VNC server is exposed to the internet, add the {{ic|-localhost}} option to {{ic|Xvnc}} in {{ic|xvnc@.service}} (note that {{ic|-query localhost}} and {{ic|-localhost}} are different switches) and follow [[#Accessing vncserver via SSH tunnels]]. Since we only select a user after connecting, the VNC server runs as user ''nobody'' and uses {{ic|Xvnc}} directly instead of the {{ic|vncserver}} script, so any options in {{ic|~/.vnc}} are ignored. Optionally, [[autostart]] ''vncconfig'' so that the clipboard works (''vncconfig'' exits immediately in non-VNC sessions). One way is to create:
+
VNC サーバーがインターネットに公開されている場合は、{{ic|xvnc@.service}} {{ic|Xvnc}} {{ic|-localhost}} オプションを追加してください({{ic|-query localhost}} {{ic|-localhost}} は異なるスイッチです)、[[#Accessing vncserver via SSH tunnels]] に従ってください。接続後にユーザーを選択するだけなので、VNC サーバーはユーザー ''nobody'' として実行され、{{ic|vncserver}} スクリプトの代わりに直接 {{ic|Xvnc}} を使用するため、{{ic|~/.vnc}} のオプションは無視されます。オプションで、クリップボードが動作するように ''vncconfig'' [[自動起動]]させてください(''vncconfig'' は非 VNC セッションで即座に終了します)。作成する一つの方法は:
   
 
{{hc|/etc/X11/xinit/xinitrc.d/99-vncconfig.sh|
 
{{hc|/etc/X11/xinit/xinitrc.d/99-vncconfig.sh|
211行目: 211行目:
 
サーバ側では、''vncserver'' または、 ''x0vncserver'' を実行する必要があります。
 
サーバ側では、''vncserver'' または、 ''x0vncserver'' を実行する必要があります。
   
  +
これらのどちらかを実行する場合、{{ic|~/.vnc/config}} の {{ic|localhost}} オプション、または {{ic|-localhost}} スイッチ(''x0vncserver'' の場合)を使用することをお勧めします。例えば
When running either one of these, it is recommended to use the {{ic|localhost}} option in {{ic|~/.vnc/config}} or the {{ic|-localhost}} switch (for ''x0vncserver'') since it allows connections from the localhost only and by analogy, only from users ssh'ed and authenticated on the box. For example:
 
   
 
{{hc|~/.vnc/config|2=
 
{{hc|~/.vnc/config|2=
220行目: 220行目:
 
}}
 
}}
   
  +
例えば、{{ic|vncserver@.service}} を[[開始]]または[[再起動]]してください([[#初回セットアップ]]も参照してください)。
Make sure to [[Start]] or [[Restart]] the {{ic|vncserver@.service}}, for example (see also [[#Initial setup]]):
 
   
 
=== クライアント側 ===
 
=== クライアント側 ===
288行目: 288行目:
 
x509 証明書の作成方法はこの記事では説明しません。[[Let’s Encrypt]] を使用したり、[[OpenSSL]] を使って手動で証明書を発行してサーバーとクライアントで鍵を共有できます。
 
x509 証明書の作成方法はこの記事では説明しません。[[Let’s Encrypt]] を使用したり、[[OpenSSL]] を使って手動で証明書を発行してサーバーとクライアントで鍵を共有できます。
   
  +
=== フルスクリーンの切り替え ===
=== Toggling fullscreen ===
 
   
  +
これは VNC クライアントのメニューから行うことができます。デフォルトでは、VNC クライアントの mkey は {{ic|F8}} です。
This can be done through vnc client's menu. By default, vnc client's mkey is {{ic|F8}}.
 
   
  +
=== マウスの戻る/進むボタンが動作しない場合の回避策 ===
=== Workaround for mouse back and forward buttons not working ===
 
   
  +
現在の VNC プロトコルは 7つのマウスボタン(左、中、右、スクロールアップ、スクロールダウン、スクロール左、スクロール右)しか使用していないため、マウスに戻るボタンと進むボタンがある場合、これらは使用できず、入力は無視されます。
The VNC protocol currently only uses 7 mouse buttons (left, middle, right, scroll up, scroll down, scroll left, scroll right) which means if your mouse has a back and a forward button, these are not usable and input will be ignored.
 
   
  +
[https://www.bedroomlan.org/projects/evrouter/ evrouter] は、マウスの戻る/進むボタンをクリックしたときにキーボードのキー押下を送信してこの制限を回避するために使用できます。オプションで、{{Pkg|xautomation}} と {{Pkg|xbindkeys}} をサーバーで使用して、必要に応じてキーボードのキー押下をマウスボタンのクリックにマップバックできます。
[https://www.bedroomlan.org/projects/evrouter/ evrouter] can be used to work around this limitation by sending keyboard key presses when clicking the mouse back/forward buttons. Optionally, xte found in {{Pkg|xautomation}} and {{Pkg|xbindkeys}} can be used on the server to map the keyboard key presses back to mouse button clicks if needed.
 
   
  +
==== キーボードキー XF86Back/XF86Forward でマウスの戻る/進むボタンを代用する ====
==== Substituting mouse back/forward buttons with keyboard keys XF86Back/XF86Forward ====
 
   
  +
この方法はシンプルで、例えば Web ブラウザやファイルブラウザを使用している間に戻る/進むをナビゲートする方法が必要な場合に適しています。
This method is simple and suitable if you only need a way to navigate backward/forward while using web browsers or file browsers for example.
 
   
  +
クライアントで {{AUR|evrouter}} と {{Pkg|xautomation}} をインストールします。evrouter を設定します。正確なデバイス名、ウィンドウ名、ボタン名などを見つける方法とヒントについては、[[マウスボタン#evrouter]] と evrouter の man ページを参照してください。例の設定は以下の通りです:
Install {{AUR|evrouter}} and {{Pkg|xautomation}} on the client. Configure evrouter, see [[Mouse buttons#evrouter]] and evrouter man pages for instructions and tips on how to find the correct device name, window name, button names etc. Example config:
 
   
 
{{hc|~/.evrouterrc|
 
{{hc|~/.evrouterrc|
316行目: 316行目:
 
}}
 
}}
   
  +
クライアントで evrouter を起動します。上記の設定で、マウスの戻るボタンをクリックすると VNC サーバーに {{ic|XF86Back}} が送信され、進むボタンをクリックすると {{ic|XF86Forward}} が送信されます。
Start evrouter on the client. With above configuration keyboard key {{ic|XF86Back}} is sent to the VNC server when clicking the back button on the mouse, and {{ic|XF86Forward}} is sent when clicking the forward button.
 
   
  +
==== サーバーでキーボードキー押下をマウスボタンクリックにマップバックする ====
==== Mapping the keyboard key presses back to mouse button clicks on the server ====
 
   
  +
必要に応じて、サーバーでキーボードキーをマウスボタンクリックにマップバックすることが可能です。この場合、クライアントやサーバーで絶対に使用されないキーボードキーを使用することが良いでしょう。以下の例では、キーボードキー {{ic|XF86Launch8}} / {{ic|XF86Launch9}} がマウスボタン 8/9 として使用されています。
If needed, it is possible to map the keyboard keys back to mouse button clicks on the server. In this case, it might be a good idea to use keyboard keys which are never on the client or server. In the example below, keyboard keys {{ic|XF86Launch8}}/{{ic|XF86Launch9}} are used as mouse buttons 8/9.
 
   
  +
クライアントでの evrouter 設定:
Evrouter configuration on the client:
 
   
 
{{hc|~/.evrouterrc|
 
{{hc|~/.evrouterrc|
Window "OtherComputer:0 - TigerVNC": # Window title
+
Window "OtherComputer:0 - TigerVNC": # ウィンドウタイトル
   
  +
# キー押下を繰り返さないように Shell を使用(evrouter マニュアルを参照)
# Using Shell to avoid repeating key presses (see evrouter manual)
 
 
"USB mouse" "/dev/input/by-id/usb-Mouse-name-event-mouse" none key/275 "Shell/xte 'key XF86Launch8'"
 
"USB mouse" "/dev/input/by-id/usb-Mouse-name-event-mouse" none key/275 "Shell/xte 'key XF86Launch8'"
 
"USB mouse" "/dev/input/by-id/usb-Mouse-name-event-mouse" none key/276 "Shell/xte 'key XF86Launch9'"
 
"USB mouse" "/dev/input/by-id/usb-Mouse-name-event-mouse" none key/276 "Shell/xte 'key XF86Launch9'"
 
}}
 
}}
   
Install {{Pkg|xautomation}} and {{Pkg|xbindkeys}} on the server. Configure xbindkeys to map keyboard keys {{ic|XF86Launch8}}/{{ic|XF86Launch9}} to mouse buttons 8/9 with xte.
+
サーバーで {{Pkg|xautomation}} {{Pkg|xbindkeys}} をインストールします。xbindkeys を設定して、キーボードキー {{ic|XF86Launch8}} / {{ic|XF86Launch9}} xte を使ってマウスボタン 8/9 にマップします。
   
 
{{hc|~/.xbindkeysrc|
 
{{hc|~/.xbindkeysrc|
342行目: 342行目:
 
}}
 
}}
   
Start xbindkeys ({{ic|xbindkeys -f ~/.xbindkeysrc}}). The server will now map {{ic|XF86Launch8}}/{{ic|XF86Launch9}} to mouse buttons 8/9.
+
xbindkeys({{ic|xbindkeys -f ~/.xbindkeysrc}})を起動します。サーバーは、{{ic|XF86Launch8}} / {{ic|XF86Launch9}} をマウスボタン 8/9 にマップするようになります。
   
  +
== トラブルシューティング ==
== Troubleshooting ==
 
   
  +
=== ウィンドウの代わりに黒い四角 ===
=== Black rectangle instead of window ===
 
   
  +
おそらく、これはアプリケーションが Composite Xorg 拡張を厳密に必要としているためです。例えば、webkit ベースのアプリ:midori、psi-plus など。
Most probably, this is due to the application strictly requiring the composite Xorg extension. For example webkit based app: midori, psi-plus, etc.
 
   
  +
この場合、以下のようなコマンドで vncserver を再起動してください:
Restart vncserver in this case using something like following:
 
   
 
$ vncserver -geometry ... -depth 24 :1 +extension Composite
 
$ vncserver -geometry ... -depth 24 :1 +extension Composite
   
  +
Composite 拡張は、VNC で 24 ビット深度でしか動作しないようです。
It looks like Composite extension in VNC will work only with 24bit depth.
 
   
  +
=== マウスカーソルのある空の黒いウィンドウ ===
=== Empty black window with mouse cursor ===
 
   
Verify that the user is not logged into a physical X session, unless this option was configured with {{ic|x0vncserver}}. Multiple X sessions for a single user are not supported, see https://github.com/TigerVNC/tigervnc/issues/684#issuecomment-494385395.
+
ユーザーが物理的な X セッションにログインしていないことを確認してください、{{ic|x0vncserver}} でこのオプションが設定されていない限り。単一のユーザーで複数の X セッションはサポートされていません。詳細は https://github.com/TigerVNC/tigervnc/issues/684#issuecomment-494385395 を参照してください。
   
  +
逆に、VNC サーバーサービスがそのユーザーで動作している間にローカルの X セッションにログインしようとすると、うまくいかない可能性があり、デスクトップ環境を使用している場合、スプラッシュスクリーンで詰まることがあります。
Conversely, trying to log into a local X session while a VNC server service is running for that user will likely not work, and you may get stuck on a splash screen when using a desktop environment.
 
   
  +
=== マウスカーソルが表示されない ===
=== No mouse cursor ===
 
   
  +
''x0vncserver'' を使用していてマウスカーソルが表示されない場合、以下のように ''vncviewer'' を起動してください:
If no mouse cursor is visible when using ''x0vncserver'', start ''vncviewer'' as follows:
 
   
$ vncviewer DotWhenNoCursor=1 ''server''
+
$ vncviewer DotWhenNoCursor=1 ''サーバー''
   
  +
または、TigerVNC の設定ファイル(デフォルトで {{ic|~/.vnc/default.tigervnc}} にあります)に {{ic|1=DotWhenNoCursor=1}} を追加してください。
Alternatively, put {{ic|1=DotWhenNoCursor=1}} in the TigerVNC configuration file, which is at {{ic|~/.vnc/default.tigervnc}} by default.
 
   
  +
=== リモートマシンからのクリップボードの内容をコピーする ===
=== Copying clipboard content from the remote machine ===
 
   
If copying from the remote machine to the local machine does not work, run {{ic|autocutsel}} on the server, as mentioned in [https://bbs.archlinux.org/viewtopic.php?id=101243]:
+
リモートマシンからローカルマシンへのコピーが機能しない場合は、サーバー上で {{ic|autocutsel}} を実行してください。詳しくは [https://bbs.archlinux.org/viewtopic.php?id=101243] を参照:
   
 
$ autocutsel -fork
 
$ autocutsel -fork
   
Now, press {{ic|F8}} to display the VNC menu popup, and select {{ic|Clipboard: local -> remote}} option.
+
次に、{{ic|F8}} キーを押して VNC メニューのポップアップを表示し、{{ic|Clipboard: local -> remote}} オプションを選択してください。
  +
  +
=== ウィンドウ装飾 / 境界線 / タイトルバーがない / ウィンドウを動かせない ===
  +
  +
空の [[xterm]] フレームを修正するためにウィンドウマネージャーを起動してください。例えば、[[Xfce]] 上では {{ic|xfwm4 &}} を実行してください。
   
  +
=== デスクトップ環境でフォントがボックスで表示される ===
=== No window decoration / borders / titlebars / cannot move windows around ===
 
   
  +
一部の[[デスクトップ環境]]では、ASCII 文字を表示するための必要なフォントが欠けている可能性があります。{{pkg|ttf-dejavu}} を[[インストール]]してください。
Start a window manager to fix an empty [[xterm]] frame. For example, on [[Xfce]], run {{ic|xfwm4 &}}.
 
   
  +
== 参照 ==
=== Desktop environment is displaying only boxes for font ===
 
   
  +
* https://github.com/TigerVNC/tigervnc
Some [[desktop environment]]s might be missing necessary font to display ASCII characters. [[Install]] {{pkg|ttf-dejavu}}.
 

2023年9月15日 (金) 20:58時点における最新版

関連記事

TigerVNCVirtual Network Computing (VNC) プロトコルの実装です。この記事ではサーバー機能に焦点をあてています。

目次

インストール

tigervnc パッケージをインストールしてください。

ノート: パッケージには vncserver, x0vncserver, vncviewer が含まれています。

Vncserver には2つのリモート制御機能が存在します:

  1. 標準的な X サーバーと同じような仮想 (ヘッドレス) サーバー。物理的な画面ではなく仮想スクリーンを使用する。仮想サーバーは物理的な X サーバーと並行して動作します。
  2. 物理モニターを使用しているローカルの X セッションの直接制御。

vncserver をバーチャル(ヘッドレス)セッションで起動する

初回セットアップ

ノート: Linux システムでは物理メモリが許すかぎりいくらでも VNC サーバーを使うことができます。それぞれは互いに並行して動きます。

クイックスタートについては、以下のステップを参照してください。 設定オプションの完全なリストについては vncserver(8) を読むことをお勧めします。

  1. vncpasswd を使用してパスワードを作成して、ハッシュ化したパスワードを ~/.vnc/passwd に保存します。
  2. /etc/tigervnc/vncserver.users を編集して、ユーザマッピングを定義します。このファイルで定義された各ユーザは、そのセッションが実行される対応するポートを持っています。ファイル内の数字は、TCP ポートに対応します。デフォルトでは、:1 が TCP ポート 5901 (5900+1) になっています。別の並列サーバが必要な場合、2 番目のインスタンスは次に高い空きポート、つまり 5902 (5900+2) で実行することができます。
  3. ~/.vnc/config を作成し、最低限 session=foo のような行で、実行するデスクトップ環境を foo に対応させたセッションの種類を定義してください。どのデスクトップ環境がシステムで利用できるかは、/usr/share/xsessions/ 内の .desktop ファイルで確認できます。例えば:
~/.vnc/config
session=lxqt
geometry=1920x1080
localhost
alwaysshared
ノート: 前のステップを完全に動作させるには、追加のセキュリティ設定が必要です。設定を完了するには、#SSHトンネル経由での vncserver へのアクセスを参照してください。テスト目的では、この手順を省略して localhost 以外からの安全でない接続を許可します。

tigervnc の開始と終了

vncserver@.service テンプレートのインスタンスを 起動 します。オプションで起動時やシャットダウン時に動くよう有効化します。この場合のインスタンス識別子はディスプレイ番号であることに注意してください(例:ディスプレイ番号 :1 のインスタンス vncserver@:1.service など)。

ノート: /usr/bin/vncserver への直接の呼び出しは、適切なセッションスコープを確立しないため、サポートされていません。systemd サービスは TigerVNC を使うために唯一サポートされている方法です。Issue #1096 を参照してください。

ローカルディスプレイを直接公開する

Tigervnc は libvnc.so を同梱しており、これは X の初期化中に直接ロードすることができます。これにより、パフォーマンスが向上します。 以下のファイルを作成し、X を再起動してください:

/etc/X11/xorg.conf.d/10-vnc.conf
Section "Module"
Load "vnc"
EndSection

Section "Screen"
Identifier "Screen0"
Option "UserPasswdVerifier" "VncAuth"
Option "PasswordFile" "/root/.vnc/passwd"
EndSection

x0vncserver を直接実行してローカルディスプレイを制御する

tigervnc はまた、x0vncserver(1) も提供しており、これによって物理的な X セッションを直接制御することができます。vncpasswd ツールを使ってセッションパスワードを定義した後、以下のようにサーバーを起動します:

$ x0vncserver -rfbauth ~/.vnc/passwd
ノート:
  • x11vnc は、現在の X セッションを直接制御できる代替の VNC サーバーでもあります。
  • x0vncserver は現在、クライアントとサーバー間のクリップボード共有をサポートしていません(autocutsel の助けを借りても)。参照:Issue #529

xprofile とともに

x0vncserver を簡単に起動する方法の一つは、xprofile ファイルの一つに以下のような行を追加することです:

~/.xprofile
...
x0vncserver -rfbauth ~/.vnc/passwd &

systemd とともに

システムサービスとして

このオプションは、ユーザーが現在のディスプレイ、およびディスプレイマネージャーが提供するログイン画面にアクセスできるようにします。

このサービスは、ユーザーがセッションからログオフするたびに自動的に再起動されます。

以下の例では LightDM が使用されていますが、XAUTHORITY 変数を修正することで他のディスプレイマネージャーに適応させることが可能です。

/etc/systemd/system/x0vncserver.service
[Unit]
Description=Remote desktop service (VNC) for :0 display
Requires=display-manager.service
After=network-online.target
After=display-manager.service

[Service]
Type=simple
Environment=HOME=/root
Environment=XAUTHORITY=/var/run/lightdm/root/:0
ExecStart=x0vncserver -display :0 -rfbauth ~/.vnc/passwd
Restart=on-failure
RestartSec=500ms

[Install]
WantedBy=multi-user.target

このサービスはシステムユニットなので、-rfbauth ~/.vnc/passwd/root/.vnc/passwd を指します。

x0vncserver.service開始/有効化してください。

ユーザーサービスとして

現在のデスクトップにリモートアクセスをすぐに設定できる最も簡単な方法として、x0vncserver を実行する VNC サーバーを持つために、以下のように systemd ユニットを作成して、必要なユーザーとオプションで置き換えてください:

~/.config/systemd/user/x0vncserver.service
[Unit]
Description=Remote desktop service (VNC)

[Service]
Type=simple
ExecStartPre=/bin/sh -c 'while ! pgrep -U "$USER" Xorg; do sleep 2; done'
ExecStart=/usr/bin/x0vncserver -rfbauth %h/.vnc/passwd

[Install]
WantedBy=default.target

ExecStartPre 行は、${USER} によって Xorg が開始されるのを待っています。

ユーザーネームとパスワードでログインする場合は、ExecStart/usr/bin/x0vncserver -PAMService=login -PlainUsers=${USER} -SecurityTypes=TLSPlain に置き換えてください。

x0vncserver.service ユーザーユニットを開始/有効化してください。

XDMCP と組み合わせて Xvnc をオンデマンドセッションで実行する

systemd のソケットアクティベーションと XDMCP を組み合わせることで、ログインしようとする各ユーザーごとに自動的に VNC サーバーを生成することができます。そのため、ユーザーごとにサーバー/ポートを設定する必要はありません。このセットアップでは、ディスプレイマネージャーを使用してユーザーを認証し、ログインするため、VNC パスワードは必要ありません。欠点としては、ユーザーがサーバー上でセッションを継続して後で再接続することはできません。

これを動作させるには、まず XDMCP を設定し、ディスプレイマネージャーが動作していることを確認してください。 次に、以下を作成します:

/etc/systemd/system/xvnc.socket
[Unit]
Description=XVNC Server

[Socket]
ListenStream=5900
Accept=yes

[Install]
WantedBy=sockets.target
/etc/systemd/system/xvnc@.service
[Unit]
Description=XVNC Per-Connection Daemon

[Service]
ExecStart=-/usr/bin/Xvnc -inetd -query localhost -geometry 1920x1080 -once -SecurityTypes=None
User=nobody
StandardInput=socket
StandardError=syslog

xvnc.socket開始/有効化してください。これで、任意の数のユーザーがポート 5900 に接続することで独自のデスクトップを取得できます。

VNC サーバーがインターネットに公開されている場合は、xvnc@.serviceXvnc-localhost オプションを追加してください(-query localhost-localhost は異なるスイッチです)、#Accessing vncserver via SSH tunnels に従ってください。接続後にユーザーを選択するだけなので、VNC サーバーはユーザー nobody として実行され、vncserver スクリプトの代わりに直接 Xvnc を使用するため、~/.vnc のオプションは無視されます。オプションで、クリップボードが動作するように vncconfig自動起動させてください(vncconfig は非 VNC セッションで即座に終了します)。作成する一つの方法は:

/etc/X11/xinit/xinitrc.d/99-vncconfig.sh
#!/bin/sh
vncconfig -nowin &

vncserver に接続する

警告: LAN の外でセキュアな対策を取ることなく vncserver に接続することは推奨されません。LAN の外側で接続する必要がある場合は下の説明を読むことを推奨します。SecurityTypes をセキュアでないオプションに設定しないかぎり TigerVNC はデフォルトで暗号化されますが、通信相手の確認はしないため接続時の MITM 攻撃を防ぐことはできません。セキュアな接続をするときは X509Vnc を使うことを推奨します。

vncserver に接続できるクライアントは多数存在します。下は 10.1.10.2 のポート 5901 (:1) で動作している vncserver に接続するコマンド例です:

$ vncviewer 10.1.10.2:1

パスワードなしで認証

-passwd スイッチを使うことでサーバーの ~/.vnc/passwd ファイルの場所を定義することができます。サーバー上のこのファイルには SSH か物理的なアクセスによってユーザーがアクセスすることが期待されています。どちらの場合でも、クライアントのファイルシステム上の安全な場所、つまり特定のユーザーだけが読み込みアクセスできる場所にファイルを置いて下さい。

$ vncviewer -passwd /path/to/server-passwd-file

GUI ベースのクライアント

TigerVNC の vncviewer にはシンプルが GUI が存在し、何もパラメータを付けずに実行します:

$ vncviewer

SSH トンネル経由で vncserver にアクセス

SSH 接続を提供するサーバの利点は、VNC トラフィックが SSH ポートを介してトンネリングされるため、既に開いている SSH ポート以外のポートを外部に開く必要がないことです。

サーバー側

サーバ側では、vncserver または、 x0vncserver を実行する必要があります。

これらのどちらかを実行する場合、~/.vnc/configlocalhost オプション、または -localhost スイッチ(x0vncserver の場合)を使用することをお勧めします。例えば

~/.vnc/config
session=lxqt
geometry=1920x1080
localhost
alwaysshared

例えば、vncserver@.service開始または再起動してください(#初回セットアップも参照してください)。

クライアント側

サーバーはローカルホストからの接続だけを許可しているので、-L スイッチを使ってトンネルを有効にして ssh で接続します。例えば:

$ ssh 10.1.10.2 -L 5901:localhost:5901

上記はサーバーのポート 5901 をクライアントのポート 5901 に転送します。サーバーとクライアントでポート番号を必ずしも一致させる必要はありません。例:

$ ssh 10.1.10.2 -L 8900:localhost:5901

上記のコマンドはサーバーのポート 5901 をクライアントマシンのポート 8900 に転送します。

SSH で接続したら、サーバーと接続するための暗号化トンネルとして xterm やシェルのウィンドウは開いたままにしてください。暗号化トンネルを使って接続するには、vncviewer でローカルホストのクライアントポートを指定します。

サーバーとクライアントで同じポートを使用する場合:

$ vncviewer localhost:1

サーバーとクライアントで違うポートを使用する場合:

$ vncviewer localhost:8900

SSH で Android デバイスから VNC サーバーに接続する

Android デバイスを使って SSH で VNC サーバーに接続するには:

1. 接続するマシン上で SSH サーバーを動作させる。
2. 接続するマシン上で VNC サーバーを動作させる (上述のように -localhost フラグでサーバーを起動する)。
3. Android デバイスで SSH クライアントを使う (ConnectBot が人気があります、この外では例としてこれを使います)。
4. Android デバイスで VNC クライアントを使う (androidVNC)。

固定 IP アドレスを持たないマシンではダイナミック DNS サービスを使うことを考慮してください。

ConnectBot で、IP を入力してマシンに接続してください。オプションキーをタップして、Port Forwards を選択し新しいポートを追加してください:

Nickname: vnc
Type: Local
Source port: 5901
Destination: 127.0.0.1:5901 (it did not work for me when I typed in 192.168.x.xxx here, I had to use 127.0.0.1)

保存してください。

androidVNC で:

Nickname: nickname
Password: the password used to set up the VNC server
Address: 127.0.0.1 (we are in local after connecting through SSH)
Port: 5901

接続してください。

ヒントとテクニック

macOS に接続する

https://help.ubuntu.com/community/AppleRemoteDesktop を見てください。Remmina でテスト済みです。

推奨セキュリティ設定

ノート: SSH トンネルを使用する場合、sshd によって暗号化が行われるため X509Vnc は不要です。

SecurityTypes は使用するセキュリティアルゴリズムを制御します。現在のバージョン 1.5.0 でのデフォルトは "X509Plain,TLSPlain,X509Vnc,TLSVnc,X509None,TLSNone,VncAuth,None" です。"X509Vnc,TLSVnc" とすることで暗号化しないデータのやりとりを無効化できます。

TLSVnc では同一性確認がないため、X509Vnc を使うことを推奨します:

$ vncserver -x509key /path/to/key.pem -x509cert /path/to/cerm.pem -SecurityTypes X509Vnc :1

x509 証明書の作成方法はこの記事では説明しません。Let’s Encrypt を使用したり、OpenSSL を使って手動で証明書を発行してサーバーとクライアントで鍵を共有できます。

フルスクリーンの切り替え

これは VNC クライアントのメニューから行うことができます。デフォルトでは、VNC クライアントの mkey は F8 です。

マウスの戻る/進むボタンが動作しない場合の回避策

現在の VNC プロトコルは 7つのマウスボタン(左、中、右、スクロールアップ、スクロールダウン、スクロール左、スクロール右)しか使用していないため、マウスに戻るボタンと進むボタンがある場合、これらは使用できず、入力は無視されます。

evrouter は、マウスの戻る/進むボタンをクリックしたときにキーボードのキー押下を送信してこの制限を回避するために使用できます。オプションで、xautomationxbindkeys をサーバーで使用して、必要に応じてキーボードのキー押下をマウスボタンのクリックにマップバックできます。

キーボードキー XF86Back/XF86Forward でマウスの戻る/進むボタンを代用する

この方法はシンプルで、例えば Web ブラウザやファイルブラウザを使用している間に戻る/進むをナビゲートする方法が必要な場合に適しています。

クライアントで evrouterAURxautomation をインストールします。evrouter を設定します。正確なデバイス名、ウィンドウ名、ボタン名などを見つける方法とヒントについては、マウスボタン#evrouter と evrouter の man ページを参照してください。例の設定は以下の通りです:

~/.evrouterrc
Window "OtherComputer:0 - TigerVNC": # Window title used as filter

# Using Shell to avoid repeating key presses (see evrouter manual)
"USB mouse" "/dev/input/by-id/usb-Mouse-name-event-mouse" none key/275 "Shell/xte 'key XF86Back'"
"USB mouse" "/dev/input/by-id/usb-Mouse-name-event-mouse" none key/276 "Shell/xte 'key XF86Forward'"

# Use XKey below instead if repeating keys is desired (see evrouter manual)
#"Logitech Gaming Mouse G400" "/dev/input/by-id/usb-Logitech_Gaming_Mouse_G400-event-mouse" none key/275 "XKey/XF86Back"
#"Logitech Gaming Mouse G400" "/dev/input/by-id/usb-Logitech_Gaming_Mouse_G400-event-mouse" none key/276 "XKey/XF86Forward"

クライアントで evrouter を起動します。上記の設定で、マウスの戻るボタンをクリックすると VNC サーバーに XF86Back が送信され、進むボタンをクリックすると XF86Forward が送信されます。

サーバーでキーボードキー押下をマウスボタンクリックにマップバックする

必要に応じて、サーバーでキーボードキーをマウスボタンクリックにマップバックすることが可能です。この場合、クライアントやサーバーで絶対に使用されないキーボードキーを使用することが良いでしょう。以下の例では、キーボードキー XF86Launch8 / XF86Launch9 がマウスボタン 8/9 として使用されています。

クライアントでの evrouter 設定:

~/.evrouterrc
Window "OtherComputer:0 - TigerVNC": # ウィンドウタイトル

# キー押下を繰り返さないように Shell を使用(evrouter マニュアルを参照)
"USB mouse" "/dev/input/by-id/usb-Mouse-name-event-mouse" none key/275 "Shell/xte 'key XF86Launch8'"
"USB mouse" "/dev/input/by-id/usb-Mouse-name-event-mouse" none key/276 "Shell/xte 'key XF86Launch9'"

サーバーで xautomationxbindkeys をインストールします。xbindkeys を設定して、キーボードキー XF86Launch8 / XF86Launch9 を xte を使ってマウスボタン 8/9 にマップします。

~/.xbindkeysrc
"xte 'mouseclick 8'"
     XF86Launch8

"xte 'mouseclick 9'"
     XF86Launch9

xbindkeys(xbindkeys -f ~/.xbindkeysrc)を起動します。サーバーは、XF86Launch8 / XF86Launch9 をマウスボタン 8/9 にマップするようになります。

トラブルシューティング

ウィンドウの代わりに黒い四角

おそらく、これはアプリケーションが Composite Xorg 拡張を厳密に必要としているためです。例えば、webkit ベースのアプリ:midori、psi-plus など。

この場合、以下のようなコマンドで vncserver を再起動してください:

$ vncserver -geometry ... -depth 24 :1 +extension Composite

Composite 拡張は、VNC で 24 ビット深度でしか動作しないようです。

マウスカーソルのある空の黒いウィンドウ

ユーザーが物理的な X セッションにログインしていないことを確認してください、x0vncserver でこのオプションが設定されていない限り。単一のユーザーで複数の X セッションはサポートされていません。詳細は https://github.com/TigerVNC/tigervnc/issues/684#issuecomment-494385395 を参照してください。

逆に、VNC サーバーサービスがそのユーザーで動作している間にローカルの X セッションにログインしようとすると、うまくいかない可能性があり、デスクトップ環境を使用している場合、スプラッシュスクリーンで詰まることがあります。

マウスカーソルが表示されない

x0vncserver を使用していてマウスカーソルが表示されない場合、以下のように vncviewer を起動してください:

$ vncviewer DotWhenNoCursor=1 サーバー

または、TigerVNC の設定ファイル(デフォルトで ~/.vnc/default.tigervnc にあります)に DotWhenNoCursor=1 を追加してください。

リモートマシンからのクリップボードの内容をコピーする

リモートマシンからローカルマシンへのコピーが機能しない場合は、サーバー上で autocutsel を実行してください。詳しくは [1] を参照:

$ autocutsel -fork

次に、F8 キーを押して VNC メニューのポップアップを表示し、Clipboard: local -> remote オプションを選択してください。

ウィンドウ装飾 / 境界線 / タイトルバーがない / ウィンドウを動かせない

空の xterm フレームを修正するためにウィンドウマネージャーを起動してください。例えば、Xfce 上では xfwm4 & を実行してください。

デスクトップ環境でフォントがボックスで表示される

一部のデスクトップ環境では、ASCII 文字を表示するための必要なフォントが欠けている可能性があります。ttf-dejavuインストールしてください。

参照