Ubuntu 安装 VNC server

2021/11/01 #Linux

记录服务器上安装 VNC server 的流程跟配置，防止下次踩坑。

当前版本: Ubuntu 20.04，默认桌面环境：GNOME

基本介绍

VNC server

有多种 VNC server 可供选择，这里我们使用 TigerVNC。

桌面环境

用来显示图形界面的，在这里分两种，一是服务器本身的桌面环境，二是你想在 VNC 里使用的桌面环境。服务器本身可以安装多种桌面环境，使用 VNC 时需要在配置里指定其中一种。

常见的环境包括 gnome，kde，xfce 等。xfce 相对比较轻量，但是丑，ubuntu 默认用的 gnome，所以这里我们选择 gnome 作为 vnc 的桌面环境。

安装

安装 TigerVNC（会自动帮你安装其它依赖包）

sudo apt install tigervnc-standalone-server

设置登陆密码

vncpasswd

Would you like to enter a view-only password (y/n)? n

配置

创建配置文件并赋予执行权限

touch ~/.vnc/xstartup
chmod 775 ~/.vnc/xstartup

将下面内容写入到配置文件 ~/.vnc/xstartup 里：

#!/bin/sh
unset SESSION_MANAGER
unset DBUS_SESSION_BUS_ADDRESS
export PATH=/usr/bin:$PATH # promote priority of /usr/bin, aviod conda problem
export XKL_XMODMAP_DISABLE=1
export XDG_CURRENT_DESKTOP="GNOME-Flashback:GNOME"
export XDG_MENU_PREFIX="gnome-flashback-"
[ -x /etc/vnc/xstartup ] && exec /etc/vnc/xstartup
[ -r $HOME/.Xresources ] && xrdb $HOME/.Xresources
xsetroot -solid grey
vncconfig -iconic &
gnome-session --session=gnome-flashback-metacity --disable-acceleration-check &

2025-04-25 更新：如果是用的 KDE 可参考如下配置：

确保安装了必需的包

sudo apt install plasma-workspace plasma-desktop dbus-x11 xorg

配置文件 ~/.vnc/xstartup 内容如下：

#!/bin/sh
unset SESSION_MANAGER
unset DBUS_SESSION_BUS_ADDRESS
# 一些 KDE 环境变量，确保 Plasma 识别到这是 X11 会话
export XDG_CURRENT_DESKTOP=KDE
export XDG_SESSION_TYPE=x11
# 如有 ~/.Xresources，则加载（可选）
[ -r "$HOME/.Xresources" ] && xrdb "$HOME/.Xresources"
# （可选）让剪贴板在客户端和服务端同步
vncconfig -iconic &
# 启动 Plasma，且用 exec 保证脚本不提前退出
exec dbus-launch --exit-with-session startplasma-x11

配置这里是最坑的，配置有问题很容易在启动后碰到黑屏灰屏等奇奇怪怪的状况，而且 log 基本没什么参考价值。关于配置文件一些细节跟注意事项可参考 VNC server配置。

运行

启动

如果配置文件中没有添加 export PATH=/usr/bin:$PATH，启动 VNC 之前一定要退出 conda 的 base 或者任何虚拟环境，不然有可能某些包你装了但是提示找不到或者启动失败，详情可参考上述 VNC 配置链接。

vncserver

启动后会提示你目前用的是哪个端口，比如 New 'xxxx' desktop at :2 .... 即为 5902（默认从 5900 开始）。

如果启动后发现 VNC viewer 显示不正常可能是因为某些包没有安装，在 ~/.vnc/*.log 里会看到提示，手动安装就行。

其他问题

启动时碰到的一个报错 vncserver: /usr/bin/Xtigervnc did not start up, please look into '/home/xxx/.vnc/yyy:1.log' to determine the reason! -2，查看 /home/xxx/.vnc/yyy:1.log 发现是如下内容：

_XSERVTransSocketUNIXCreateListener: ...SocketCreateListener() failed
_XSERVTransMakeAllCOTSServerListeners: server already running
(EE)
Fatal server error:
(EE) Cannot establish any listening sockets - Make sure an X server isn't already running(EE)

解决办法：手动创建一个 X1 文件并设置权限，原理未知

mkdir /tmp/.X11-unix
touch /tmp/.X11-unix/X1
chmod 777 /tmp/.X11-unix/X1

常用命令

# 1. 查看当前已开启 vnc 端口
vncserver -list

# 2. 指定端口启动，比如从 5902 端口启动（默认从 5900 开始）
vncserver :2

# 3. 关闭某个端口进程，比如 5902
vncserver -kill :2

# 4. 指定分辨率（仅本次运行期间有效）
vncserver -geometry 1920x1080

# 5. 允许非局域网用户访问，碰上学校网络坑爹可能需要加上这个
vncserver -localhost no

# 6. 综合版
vncserver -geometry 1920x1080 -localhost no

TOC

基本介绍
- VNC server
- 桌面环境
安装
配置
运行