ものづくりのブログ

うちのネコを題材にしたものづくりができたらいいなと思っていろいろ奮闘してます。

RDK X5 (Ubuntu) でVNCサーバーを構築し、リモートデスクトップ接続する方法

RDK X5の環境構築中に、「GUIで画面を確認したい」「ROS 2のRVizやOpenCVのウィンドウを表示したい」という場面に遭遇したためVNCサーバーを構築しました。ここにその時のメモを残します。

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など)から、以下の形式で接続します。