「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 ユニットファイルで管理すると起動失敗の原因がログに残りやすくなる
でも安心してください。プロのエンジニアはコマンドを暗記していません。
「現場で使える型」を効率よく使いこなしているだけです。
VNC Server が起動しないときに最初に確認すること
Ubuntu Server 環境での VNC Server(主に TigerVNC)の起動失敗は、原因が重なっていることが多いです。まず原因を3つに絞ってログを読み始めると、判断が速くなります。
・ xstartup スクリプトの実行権限がない、または書き方が誤っている
・ デスクトップ環境がインストールされていない(Ubuntu Server のデフォルトは GUI なし)
・ 前回のセッションが異常終了して残留ファイルが残っている
それぞれログに異なるメッセージが出るので、まずログを読むことから始めてください。
ログの確認手順
1. systemd のサービスステータスを確認する
TigerVNC を systemd 経由で起動している場合は、まず次のコマンドを実行します。# ユーザー名と表示番号(:1 など)は環境に合わせる systemctl status vncserver@1.service
さらに詳細なログは journalctl で確認します。
journalctl -u vncserver@1.service --no-pager
2. VNC ログファイルを確認する
VNC Server は起動ユーザーのホームディレクトリ配下の ~/.vnc/ にログを出力します。# ログファイルの一覧を確認する ls -lh ~/.vnc/ # 最新のログを表示する(hostname と :1 は環境に合わせる) cat ~/.vnc/hostname:1.log
3. ~/.xsession-errors を確認する
デスクトップセッションの起動エラーは ~/.xsession-errors に記録されます。cat ~/.xsession-errors
原因別の修正手順
1. xstartup の実行権限と書き方を確認する
xstartup は VNC セッション起動時に呼び出されるシェルスクリプトです。実行権限がない場合、VNC Server はセッションを開始できずにすぐ終了します。
# 実行権限を確認する ls -la ~/.vnc/xstartup # 実行権限を設定する chmod +x ~/.vnc/xstartup # 内容を確認する cat ~/.vnc/xstartup
Xfce を起動する場合の典型的な内容は次のとおりです(出力例。環境により異なります)。
#!/bin/bash unset SESSION_MANAGER unset DBUS_SESSION_BUS_ADDRESS exec startxfce4
`exec` なしで `startxfce4 &` のようにバックグラウンド実行すると、スクリプトがすぐ終了してセッションも終了します。
2. デスクトップ環境がインストールされているか確認する
Ubuntu Server はデフォルトで GUI を持ちません。VNC で接続するには、デスクトップ環境を別途インストールする必要があります。
軽量な Xfce を例にします。
sudo apt update sudo apt install xfce4 xfce4-goodies
ただし 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
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))
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
作成後は次のように有効化します。
sudo systemctl daemon-reload sudo systemctl enable vncserver@1.service sudo systemctl start vncserver@1.service # ステータスを確認する systemctl status vncserver@1.service
トラブルシュート
「Connection refused」になる
VNC クライアントから接続したときに「Connection refused」が出る場合、主な原因は次のとおりです。・ VNC Server が起動していない(前述の手順でサービスの状態を確認する)
・ ファイアウォールがポート 5901 をブロックしている
・ 接続先のホスト名またはポート番号が誤っている
Ubuntu のファイアウォール(ufw)でポートを開放するには次のように実行します。
# ポート 5901 を開放する sudo ufw allow 5901/tcp # 設定を確認する sudo ufw status
「Authentication failed」になる
VNC パスワードを忘れた場合や、パスワードファイルが壊れている場合はパスワードを再設定します。vncpasswd
このファイルのパーミッションが 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 を含むサーバー管理の基礎から実務的な設定まで2日間で学べます。
>>【初心者向けLinuxセミナー(2日間ハンズオン)】
3,100名以上が実践した「型」を無料で公開中
プロのエンジニアはコマンドを暗記していません。
「現場で使える型」を効率よく使いこなしているだけです。
その「型」を図解60Pにまとめた入門マニュアルを、完全無料でプレゼントしています。
姓・名・メールの3つだけ/30秒/解除は3秒 / 詳細はこちら
- 前のページへ:AlmaLinux 9のシステム要件と推奨スペック|lscpuとfreeでKVM環境の適合を確認する
- この記事の属するカテゴリ:Linuxtipsへ戻る

無料メルマガで学習を続ける
Linuxの実践スキルをメールで毎週お届け。
登録は30秒、解除もいつでも可。
登録無料・いつでも解除できます