Ubuntu Server で VNC Server が起動しない原因と対処|ログの読み方と修正手順

運営:リナックスマスター.JP(代表 宮崎智広)
HOME > Linux技術 リナックスマスター.JP(Linuxマスター.JP) > Linuxtips > Ubuntu Server で VNC Server が起動しない原因と対処|ログの読み方と修正手順
「VNC Server を設定したのに、起動しようとするとすぐに停止する」
「systemctl start を実行しても active にならない」

Ubuntu Server で ubuntu vnc server の環境を用意しようとしたとき、こういった起動失敗はよく起きます。
原因はひとつではなく、xstartup の書き方、デスクトップ環境の有無、前回セッションの残留ファイルなど複数あります。

この記事では、Ubuntu Server で VNC Server が起動しない原因を体系的に整理し、ログから原因を特定して修正するまでの手順を解説します。
Ubuntu 22.04 LTS ~ 24.04 LTS の TigerVNC を主な想定環境として説明します。

この記事のポイント

・ubuntu vnc server の起動失敗は xstartup・デスクトップ環境・残留ファイルの3つが主な原因
・journalctl と ~/.vnc/*.log を組み合わせると原因を特定しやすい
・ディスプレイ番号の競合は ~/.vnc/*.pid と /tmp/.X1-lock の削除で解消できる
・systemd ユニットファイルで管理すると起動失敗の原因がログに残りやすくなる


「このままじゃマズい」と感じていませんか?
参考書を開く気力もない、同年代に取り残される不安——
でも安心してください。プロのエンジニアはコマンドを暗記していません。
「現場で使える型」を効率よく使いこなしているだけです。
姓・名・メールの3つだけ/30秒/解除は3秒 / 詳細はこちら

VNC Server が起動しないときに最初に確認すること

Ubuntu Server 環境での VNC Server(主に TigerVNC)の起動失敗は、原因が重なっていることが多いです。
まず原因を3つに絞ってログを読み始めると、判断が速くなります。

・ xstartup スクリプトの実行権限がない、または書き方が誤っている
・ デスクトップ環境がインストールされていない(Ubuntu Server のデフォルトは GUI なし)
・ 前回のセッションが異常終了して残留ファイルが残っている

それぞれログに異なるメッセージが出るので、まずログを読むことから始めてください。

ログの確認手順

1. systemd のサービスステータスを確認する

TigerVNC を systemd 経由で起動している場合は、まず次のコマンドを実行します。

# ユーザー名と表示番号(:1 など)は環境に合わせる systemctl status vncserver@1.service

「Active: failed」と表示されたら、その下の行にエラーの手がかりがあります。
さらに詳細なログは journalctl で確認します。

journalctl -u vncserver@1.service --no-pager

2. VNC ログファイルを確認する

VNC Server は起動ユーザーのホームディレクトリ配下の ~/.vnc/ にログを出力します。

# ログファイルの一覧を確認する ls -lh ~/.vnc/ # 最新のログを表示する(hostname と :1 は環境に合わせる) cat ~/.vnc/hostname:1.log

ログの末尾に「Xvnc: Permission denied」「exec: No such file or directory」「xinit: No such file or directory」などのメッセージがあれば、xstartup か起動するコマンドに問題があります。

3. ~/.xsession-errors を確認する

デスクトップセッションの起動エラーは ~/.xsession-errors に記録されます。

cat ~/.xsession-errors

「command not found」や「Failed to load session」のような行があれば、デスクトップ環境やウィンドウマネージャーが見つかっていません。

原因別の修正手順

1. xstartup の実行権限と書き方を確認する

xstartup は VNC セッション起動時に呼び出されるシェルスクリプトです。
実行権限がない場合、VNC Server はセッションを開始できずにすぐ終了します。

# 実行権限を確認する ls -la ~/.vnc/xstartup # 実行権限を設定する chmod +x ~/.vnc/xstartup # 内容を確認する cat ~/.vnc/xstartup

xstartup の先頭行は「#!/bin/bash」または「#!/bin/sh」で始まる必要があります。
Xfce を起動する場合の典型的な内容は次のとおりです(出力例。環境により異なります)。

#!/bin/bash unset SESSION_MANAGER unset DBUS_SESSION_BUS_ADDRESS exec startxfce4

最後の行を `exec` で始めることで、プロセスが正しく引き継がれます。
`exec` なしで `startxfce4 &` のようにバックグラウンド実行すると、スクリプトがすぐ終了してセッションも終了します。

2. デスクトップ環境がインストールされているか確認する

Ubuntu Server はデフォルトで GUI を持ちません。
VNC で接続するには、デスクトップ環境を別途インストールする必要があります。
軽量な Xfce を例にします。

sudo apt update sudo apt install xfce4 xfce4-goodies

GNOME を使う場合は `ubuntu-desktop-minimal` をインストールします。
ただし GNOME は Wayland を使うため、VNC との相性に注意が必要です。
トラブルが少ないのは Xfce か GNOME の X11 セッションです。

3. .Xauthority ファイルを削除して再試行する

.Xauthority が壊れていると、VNC サーバーが X セッションを開始できません。
ログに「Invalid MIT-MAGIC-COOKIE-1 key」が出た場合は、このファイルを削除して再起動します。

# VNC Server を停止する vncserver -kill :1 # .Xauthority を削除する(次回起動時に自動生成される) rm -f ~/.Xauthority # VNC Server を再起動する vncserver :1

4. ディスプレイ番号の競合を解消する

前回の VNC セッションが異常終了すると、.pid ファイルや .X1-lock ファイルが残り、次回起動時に「A VNC server is already running」と表示されます。

# 残留ファイルを確認する ls ~/.vnc/*.pid ls /tmp/.X1-lock # 残留ファイルを削除する(表示番号 :1 の場合) rm -f ~/.vnc/*.pid rm -f /tmp/.X1-lock rm -f /tmp/.X11-unix/X1

削除後、vncserver :1 を再実行します。

5. ポートが使用中かどうか確認する

VNC Server はデフォルトで TCP ポート 5901(表示番号 :1 の場合)を使います。
このポートが別のプロセスに使われていると起動に失敗します。
Linux ポート確認の全コマンドで紹介している ss コマンドで確認できます。

# 5901 ポートを使用しているプロセスを確認する ss -tlnp | grep 5901 # 出力例(環境により異なります) # LISTEN 0 5 0.0.0.0:5901 0.0.0.0:* users:(("Xvnc",pid=12345,fd=10))

別のプロセスが使用中であれば、そのプロセスを停止してから VNC Server を起動します。

systemd ユニットファイルで自動起動する設定

毎回手動で vncserver を実行するのは手間がかかります。
systemd のユニットファイルを作成すると、サーバー起動時に自動で VNC Server を起動できます。

次の内容で /etc/systemd/system/vncserver@.service を作成します。

[Unit] Description=TigerVNC server After=syslog.target network.target [Service] Type=forking User=your-username WorkingDirectory=/home/your-username ExecStartPre=-/usr/bin/vncserver -kill :%i ExecStart=/usr/bin/vncserver :%i -geometry 1280x720 -depth 24 ExecStop=/usr/bin/vncserver -kill :%i [Install] WantedBy=multi-user.target

`your-username` の部分は実際のユーザー名に変更します。
作成後は次のように有効化します。

sudo systemctl daemon-reload sudo systemctl enable vncserver@1.service sudo systemctl start vncserver@1.service # ステータスを確認する systemctl status vncserver@1.service

サーバー管理全体の基礎から systemd の活用まで体系的に身につけたい場合は、【初心者向けLinuxセミナー(2日間ハンズオン)】で2日間で基礎から実務まで学べます。

トラブルシュート

「Connection refused」になる

VNC クライアントから接続したときに「Connection refused」が出る場合、主な原因は次のとおりです。

・ VNC Server が起動していない(前述の手順でサービスの状態を確認する)
・ ファイアウォールがポート 5901 をブロックしている
・ 接続先のホスト名またはポート番号が誤っている

Ubuntu のファイアウォール(ufw)でポートを開放するには次のように実行します。

# ポート 5901 を開放する sudo ufw allow 5901/tcp # 設定を確認する sudo ufw status

「Authentication failed」になる

VNC パスワードを忘れた場合や、パスワードファイルが壊れている場合はパスワードを再設定します。

vncpasswd

パスワードは ~/.vnc/passwd に保存されます。
このファイルのパーミッションが 600 以外だと VNC Server が読み込みを拒否することがあります。

chmod 600 ~/.vnc/passwd

本記事のまとめ

Ubuntu Server で VNC Server が起動しないときは、まずログを読んで原因を特定することが重要です。
症状・エラーメッセージ 主な原因 対処
サービスがすぐ停止する xstartup の実行権限がない、または書き方が誤っている chmod +x とスクリプト内容を確認する
command not found(ログ内) デスクトップ環境がインストールされていない xfce4 などをインストールする
Invalid MIT-MAGIC-COOKIE .Xauthority が壊れている ~/.Xauthority を削除して再起動する
A VNC server is already running 前回の残留ファイルが残っている ~/.vnc/*.pid と /tmp/.X1-lock を削除する
Connection refused ファイアウォールがポートをブロックしている ufw allow 5901/tcp を実行する
Authentication failed パスワードファイルが壊れているまたは権限が誤っている vncpasswd で再設定して chmod 600 を実行する
ログを読む習慣をつけておくと、VNC に限らずほかのサービスのトラブルにも同じ手順で対応できます。
現場で通用する安全なLinuxサーバー構築の「型」を体系的に身につけたい方へ、
VNC を含むサーバー管理の基礎から実務的な設定まで2日間で学べます。
>>【初心者向けLinuxセミナー(2日間ハンズオン)】

無料メルマガで学習を続ける

Linuxの実践スキルをメールで毎週お届け。
登録は30秒、解除もいつでも可。

登録無料・いつでも解除できます

暗記不要・1時間後にはサーバーが動く

3,100名以上が実践した「型」を無料で公開中

プロのエンジニアはコマンドを暗記していません。
「現場で使える型」を効率よく使いこなしているだけです。
その「型」を図解60Pにまとめた入門マニュアルを、完全無料でプレゼントしています。

姓・名・メールの3つだけ/30秒/解除は3秒 / 詳細はこちら

Linux無料マニュアル(図解60P) 名前とメールで30秒登録

運営

リナックスマスター.JP(代表 宮崎智広)

株式会社イーネットマーキュリーが運営するLinux教育サイトです。代表の宮崎智広は現役のLinuxサーバー管理者として20年以上の実務経験を持ち、累計3,100名以上のエンジニアを指導してきました。実践型のLinuxセミナーや無料マニュアルの配布を通じてLinux人材の育成に取り組んでいます。