VNC リモート接続の初期化（Linux クライアント）

Linux クライアントでは、10888 WEB コンソール（Linux クライアントの更新を参照）にログインすると「VNC を初期化」カードが表示されます。クリックするだけで VNC の設定とコンソールへの通知が完了し、コンソールから当該クライアントへリモート接続できます。ほとんどの場合は全自動で、手動設定は不要です。自動処理が環境によって妨げられる場合（x11vnc がない、デスクトップが Wayland など）のみ、下記「手動対応」の手順が必要です。

ワンクリック初期化が行うこと

「VNC を初期化」をクリックすると、クライアント（vdclient、root で実行）が順に自動で実行します：

Apport クラッシュポップアップを無効化（Ubuntu/Debian のみ）：x11vnc のインストールが失敗した際に「システムプログラムの問題が検出されました」ウィンドウが、これから接続されるデスクトップ上に出るのを防ぎます。
デスクトップセッション種別を確認：Wayland セッションの場合、x11vnc は画面を取得できないため、Xorg への切り替えを案内します（下記ケース 2）。
x11vnc の導入を保証：無ければディストリのパッケージマネージャ（apt / dnf / yum / zypper / pacman）でオンライン自動インストール。
8 文字の動的ランダムパスワードを生成し、VNC パスワードファイルに書き込み。
グラフィカルセッションの DISPLAY と XAUTHORITY を自動検出し、:0 のポート 9015 で x11vnc を起動。
IP・ポート 9015・動的パスワードを起動サーバーへ自動通知し、コンソールがリモート接続できるようにします。パスワード入力は一切不要です。
自動起動マーカーを書き込み：以後、クライアントが起動するたびに、デスクトップとサーバーが準備でき次第 vdclient が自動的に VNC を立ち上げます。再クリックは不要です。

VNC ポートは 9015 固定です。制御パスワードは初期化のたびに動的生成されるランダムな文字列で、クライアントが自動でコンソールへ通知します。手動設定はできず、その必要もありません。

自動初期化の手順

クライアント機のローカルブラウザで http://localhost:10888 を開き、管理者アカウント（既定 admin / 123456）でログインします。
「VNC を初期化」カードの 「VNC を初期化」 ボタンをクリックします。
「VNC を初期化しました」と表示されれば成功で、コンソールからリモート接続できます。

ソフトが自動処理できないときの手動対応

クリック後に失敗が表示されたら、以下の該当ケースに従って対処してください。対処後はコンソールに戻り、もう一度「VNC を初期化」をクリックします。必ずボタンで再試行してください。ボタンだけが VNC 情報をコンソールへ通知し、x11vnc を手動で起動しただけでは通知されず、コンソールから接続できません。

ケース 1：x11vnc が見つからず自動インストールも失敗

クライアントがネットワークに接続できない、ソフトウェアソースが未設定の場合に多く見られます。「x11vnc が見つからず自動インストールに失敗しました。手動でインストールしてください：apt-get install -y x11vnc」のように表示されます。

クライアントの端末で、システム種別に応じて x11vnc を手動インストールします（vdclient は root で実行。手動インストールにも root 権限が必要）：

システム	インストールコマンド
Ubuntu / Debian / Kylin / UOS（deb 系）	`apt-get install -y x11vnc`
openEuler / Anolis / RHEL / CentOS（新しい）	`dnf install -y x11vnc`
RHEL / CentOS（古い）	`yum install -y x11vnc`
openSUSE	`zypper install x11vnc`
Arch	`pacman -S x11vnc`

ソースに x11vnc が無い場合は、まず利用可能なソフトウェアソースを設定してください（または x11vnc と依存関係をオフラインで入手して手動インストール）。インストール後、コンソールに戻ってもう一度「VNC を初期化」をクリックします。

ケース 2：デスクトップが Wayland で VNC が画面を取得できない

GNOME などのデスクトップは既定で Wayland コンポジターを使いますが、x11vnc は X11 経由で画面を取得するため、Wayland ではデスクトップを取得できません。Xorg セッションへ切り替える必要があります。

コンソールからの自動切り替え（推奨）：「VNC を初期化」をクリックして Wayland が検出されると、確認ダイアログが表示されます：

現在 Wayland デスクトップのため VNC は画面を取得できません。Xorg へ切り替えるとディスプレイマネージャを再起動し、現在のデスクトップセッションからログアウトします（約15秒で自動的に Xorg に戻ります）。続行しますか？

「OK」をクリックすると、クライアントが自動的に GDM 設定を変更し（WaylandEnable=false を書き込み、元ファイルを *.osvbak にバックアップ）、ディスプレイマネージャを再起動して Xorg に切り替えます。デスクトップが Xorg に戻ったら（約 15 秒）、もう一度「VNC を初期化」をクリックします。

自動切り替えが失敗したときの手動対応：GDM 設定が見つからない、ディスプレイマネージャの再起動に失敗、切り替え後もまだ Wayland、と表示される場合は、クライアントの端末で手動操作します：

GDM 設定（Debian/Ubuntu/Kylin/UOS は /etc/gdm3/custom.conf、Red Hat 系は /etc/gdm/custom.conf）を編集し、[daemon] セクションに次を追加または変更します：
ini
```
[daemon]
WaylandEnable=false
```
ディスプレイマネージャを再起動します（現在のデスクトップからログアウトされるため、先に作業を保存してください）：
bash
```
systemctl restart display-manager
```
クライアントを再起動しても構いません。または GDM ログイン画面の右下の歯車から「Xorg 上で」(on Xorg) を選んでログインします。
Xorg セッションに入ったことを確認したら、コンソールに戻ってもう一度「VNC を初期化」をクリックします。

WaylandEnable=false を設定済みなのにまだ Wayland の場合：通常は現在のセッションが再ログインされていないだけです。クライアントを再起動するか Xorg に入り直してから初期化してください。

ケース 3：Xorg に切り替えた後はもう一度クリック

自動 Xorg 切り替えはデスクトップをログアウト・再ログイン（約 15 秒）するため、今回の初期化は中断されます。デスクトップが戻ったら、コンソールに戻ってもう一度「VNC を初期化」をクリックし、起動と通知を完了します。

確認とトラブルシュート

クライアントで x11vnc がポート 9015 で動作しているか確認：
bash
```
pgrep -a x11vnc
ss -lntp | grep 9015
```
起動ログは vdclient プログラムディレクトリ配下の log/x11vnc.log にあります。失敗時の切り分けに利用できます（DISPLAY/XAUTHORITY 未検出、ポート使用中、取得 BadMatch など）。
コンソール側で当該クライアントがリモート接続可能と表示されれば、通知成功です。

注意事項

この機能は Linux クライアント専用です。Windows クライアントは独立した TightVNC リンクを使い、このボタンはありません。
クライアントに動作中のグラフィカルデスクトップセッション（X/Xorg）が必要です。文字端末のみ、デスクトップ未ログインでは初期化できません。
一度初期化すると起動時に自動起動します。クライアント再起動後の再クリックは不要で、毎回（自動起動を含む）動的パスワードを再生成してコンソールへ通知します。
信創クライアント（Kylin、UOS、openEuler、Anolis など）も手順は完全に同じです。deb 系は Kylin / UOS の行、Red Hat 系は openEuler / Anolis の行に従って対処してください。

VNC リモート接続の初期化（Linux クライアント） ​

ワンクリック初期化が行うこと ​

自動初期化の手順 ​

ソフトが自動処理できないときの手動対応 ​

ケース 1：x11vnc が見つからず自動インストールも失敗 ​

ケース 2：デスクトップが Wayland で VNC が画面を取得できない ​

ケース 3：Xorg に切り替えた後はもう一度クリック ​

確認とトラブルシュート ​

注意事項 ​