RDK X5の環境構築中に、「GUIで画面を確認したい」「ROS 2のRVizやOpenCVのウィンドウを表示したい」という場面に遭遇したためVNCサーバーを構築しました。ここにその時のメモを残します。
- 1. 必要なパッケージのインストール
- 2. VNCパスワードの設定
- 3. 起動スクリプト (xstartup) の作成
- 4. VNCサーバーの起動
- 5. トラブルシューティング:接続できない場合
- 6. クライアントPCから接続
1. 必要なパッケージのインストール
VNCサーバー本体と、軽量なデスクトップ環境(XFCE4)、および起動に必要なツールをインストールします。
sudo apt update sudo apt install tigervnc-standalone-server tigervnc-common xfce4 xfce4-goodies dbus-x11
2. VNCパスワードの設定
接続時に使用するパスワードを設定します。
vncpasswd
3. 起動スクリプト (xstartup) の作成
VNC起動時にXFCEデスクトップを立ち上げるための設定ファイルを作成します。
vi ~/.vnc/xstartup
以下の内容をコピー&ペーストしてください。1行目のシバン(#!)の前に余計な文字が入らないよう注意してください。
#!/bin/sh unset SESSION_MANAGER unset DBUS_SESSION_BUS_ADDRESS # XFCE4を起動 if [ -x /usr/bin/startxfce4 ]; then exec startxfce4 fi
保存後、実行権限を付与します。
chmod +x ~/.vnc/xstartup
4. VNCサーバーの起動
デフォルトではセキュリティ制限により外部から接続できない場合があるため、-localhost no オプションを付けて起動します。
# 解像度 1920x1080、24bitカラーで起動 vncserver :1 -geometry 1920x1080 -depth 24 -localhost no
5. トラブルシューティング:接続できない場合
もし「Connection Refused」で接続できない場合は、以下の2点を確認します。
① 待ち受けポートの確認
以下のコマンドを叩き、127.0.0.1:5901 ではなく 0.0.0.0:5901 で待機しているか確認します。
ss -tuln | grep 5901
② プロセスが即終了してしまう(Signal 11 等)場合
古いロックファイルが残っている可能性があるため、一度クリーンアップして再起動します。
vncserver -kill :1 rm -rf /tmp/.X11-unix/X1 rm -rf /tmp/.X1-lock vncserver :1 -geometry 1920x1080 -depth 24 -localhost no
6. クライアントPCから接続
PC側の VNC Viewer(RealVNCなど)から、以下の形式で接続します。
