TigerVNC (简体中文) - ArchWiki

Jump to content
翻译状态：本文是 TigerVNC 的翻译。上次翻译日期：2021-06-13。如果英文版本有所更改，则您可以帮助同步翻译。

相关文章

- x11vnc

TigerVNC 是 Virtual Network Computing (VNC) 协议的一种实现。本文着重介绍服务端的功能。

## 安装

安装 tigervnc 软件包。

## 为虚拟（无界面）会话运行 vncserver

### 初始设置

注意： 在内存允许的条件下，Linux 系统可以启动任意数量的 VNC 服务端，它们同时并行运行，互不干扰。

简易教程如下。推荐用户阅读 vncserver 的 man 手册来了解所有的配置项。

1. 用 `vncpasswd` 创建密码，它会将哈希处理之后的密码存储在 `~/.vnc/passwd`。
2. 编辑 `/etc/tigervnc/vncserver.users` 来定义用户映射。该文件中定义的每个用户都会拥有对应的端口来运行会话。该文件中的数字对应的是 TCP 端口。默认情况下，:1 是 TCP 端口 5901 (5900+1)。如果需要运行一个并行的服务端，第二个实例可以运行在下一个最大的、未被占用的端口，即 5902 (5900+2)。
3. 创建 `~/.vnc/config`，其中至少要有一行定义会话的类型，比如 `session=foo` （将foo替换为你想要运行的桌面环境）。你可以通过查看 `/usr/share/xsessions/` 里的 `.desktop` 文件来知道有哪些桌面环境在当前系统上可以使用。

文件内容举例：

    ~/.vnc/config

    session=lxqt
    geometry=1920x1080
    localhost
    alwaysshared

### 启动与停止 tigervnc

start `vncserver@.service`，如果需要让它随系统启动，enable 它。注意 `/etc/tigervnc/vncserver.users` 中定义的编号需要在@符号后面指定，比如启动:1的命令是：

    # systemctl start vncserver@:1

注意： 已经不再支持直接调用 `/usr/bin/vncserver` 了，因为这样做不会建立完整可用的会话环境。systemd 服务是唯一受支持的使用 TigerVNC 的方式。参见 Issue #1096。

## 直接转发本地显示内容

Tigervnc 带有 libvnc.so，它可以在 X 初始化过程中直接加载，以提供更好的性能。 创建如下文件并重启 X：

    /etc/X11/xorg.conf.d/10-vnc.conf

    Section "Module"
    Load "vnc"
    EndSection

    Section "Screen"
    Identifier "Screen0"
    Option "UserPasswdVerifier" "VncAuth"
    Option "PasswordFile" "/root/.vnc/passwd"
    EndSection

## 运行 x0vncserver 来直接控制本地显示内容

tigervnc 同时也提供 `x0vncserver`，允许直接控制物理 X 会话。在使用 vncpasswd 定义了会话密码后，请这样启动服务端：

    $ x0vncserver -rfbauth ~/.vnc/passwd

更多信息请参阅 x0vncserver(1)。

注意：

- x11vnc 是另一个可以直接控制当前 X 会话的 VNC 服务端。
- `x0vncserver` 目前不支持客户端和服务端之间的剪贴板共享（即使有 `autocutsel` 支持也不行）。参阅 Issue #529。

### 从 xprofile 启动 x0vncserver

一种启动 x0vncserver 的简单方法是在某个 xprofile 文件中添加如下行：

    ~/.xprofile

    ...
    x0vncserver -rfbauth ~/.vnc/passwd &

### 通过 systemd 启动与停止 x0vncserver

对大多数用户来说，快速远程访问当前桌面的最简单方法是运行 x0vncserver 来得到一个 VNC 服务器。为此可以创建一个 systemd unit，将其中的用户和选项替换为实际值：

    ~/.config/systemd/user/x0vncserver.service

    [Unit]
    Description=Remote desktop service (VNC)

    [Service]
    Type=simple
    # wait for Xorg started by ${USER}
    ExecStartPre=/bin/sh -c 'while ! pgrep -U "$USER" Xorg; do sleep 2; done'
    ExecStart=/usr/bin/x0vncserver -rfbauth %h/.vnc/passwd
    # or login with your username & password
    #ExecStart=/usr/bin/x0vncserver -PAMService=login -PlainUsers=${USER} -SecurityTypes=TLSPlain

    [Install]
    WantedBy=default.target

在 Systemd/User 模式下 start 并 enable `x0vncserver.service` 服务，也就是带上 `--user` 参数。

## 使用 XDMCP 为需要的会话运行 Xvnc

可以让 systemd socket activation 与 XDMCP 结合使用，为每个想登录的用户自动生成 VNC 服务器，这样无需为每个用户都准备服务器或端口。这种方法使用显示管理器来验证用户和登录，所以也不需要设置 VNC 密码。这种方法的缺点是会话无法在服务器上保持运行，退出后无法重新连接到它。

该方法首先需要设置 XDMCP，并确保显示管理器正在运行。 然后创建：

    /etc/systemd/system/xvnc.socket

    [Unit]
    Description=XVNC Server

    [Socket]
    ListenStream=5900
    Accept=yes

    [Install]
    WantedBy=sockets.target

    /etc/systemd/system/xvnc@.service

    [Unit]
    Description=XVNC Per-Connection Daemon

    [Service]
    ExecStart=-/usr/bin/Xvnc -inetd -query localhost -geometry 1920x1080 -once -SecurityTypes=None
    User=nobody
    StandardInput=socket
    StandardError=syslog

使用 systemctl 来 start 并 enable `xvnc.socket`。现在多个用户同时连接到 5900 端口，均可获得单独的桌面。

如果 VNC 服务器直接暴露在公网，请在 `xvnc@.service` 里给 `Xvnc` 添加 `-localhost` 选项（注意 `-query localhost` 和 `-localhost` 是不同的开关），然后遵循 #通过 SSH 隧道连接到 vncserver。由于我们只在连接后才选择用户，所以 VNC 服务端以 nobody 用户运行，且直接使用了 `Xvnc` 而不是 `vncserver` 脚本，所以忽略了 `~/.vnc` 中的选项。或者也可以 自动启动 vncconfig 来打开剪贴板共享（在非 VNC 会话中 vncconfig 将立即退出）。一种自动启动的方法是创建：

    /etc/X11/xinit/xinitrc.d/99-vncconfig.sh

    #!/bin/sh
    vncconfig -nowin &

## 连接到 vncserver

警告： TigerVNC 默认的连接方式不安全，它缺乏身份验证，且在连接建立过程中无法防止中间人攻击。请确保知晓当前服务器的安全设置，并且不要以不安全的方式连接到可信网络之外的 vncserver。
注意： TigerVNC 默认使用 TLSVnc 作为验证和加密方式，也可以用 `SecurityTypes` 参数来改成其他方式。TLSVnc 意味着标准的 VNC 身份验证，使用 GNUTLS 加密流量，但不会验证服务器的身份。TigerVNC 支持更换其他安全方案，如 X509Vnc，它结合了标准 VNC 身份验证、GNUTLS 加密、服务器身份识别，推荐将它用于安全连接。 如果服务器上的 `SecurityTypes` 设置了非加密方式（如 None, VncAuth, Plain, TLSNone, TLSPlain, X509None, X509Plain）为高优先级，这样无法使用加密，是不明智的。运行 vncviewer 时，更安全的方式是明确指定 `SecurityTypes` 且不接受未加密的流量。其他的模式仅在 #通过 SSH 隧道连接到 vncserver 时使用。

连接到 vncserver 的客户端不限数量。下面是一个简单的例子，其中 vncserver 运行在 10.1.10.2 的 5901 端口上，端口可以用缩写 :1 来表示：

    $ vncviewer 10.1.10.2:1

### 无密码验证

`-passwd` 开关允许我们定义服务器上 `~/.vnc/passwd` 文件的位置。用户在服务器上必须有权访问该文件，可以是通过 SSH 访问，也可以是实体访问。两种情况下都应将该文件放在客户端文件系统的一个安全位置，比如一个仅给期望用户以读取权限的位置。

    $ vncviewer -passwd /path/to/server-passwd-file

直接提供密码也是可以的。

注意： 下方的密码输入方式是不安全的，本机上任何可以运行 `ps` 的人都可以看到密码。

    $ vncviewer -passwd <(echo MYPASSWORD | vncpasswd -f)

### 图形界面客户端示例

- gtk-vnc
- krdc
- vinagre
- remmina
- virt-viewer
- vncviewer-jarAUR

TigerVNC 的 vncviewer 也带有一个简单的图形界面，不带参数运行即可：

    $ vncviewer

## 通过 SSH 隧道连接到 vncserver

对于提供 SSH 的服务器来说，这种方法有一个优点，除了已经打开的 SSH 端口外不需要再打开其他端口，因为 VNC 流量是在 SSH 隧道中传输的。

### 服务端配置

服务端必须运行 vncserver 或 x0vncserver。

无论运行哪个服务端，都建议在 `~/.vnc/config` 添加 `localhost` 选项或使用 `-localhost` 开关（适用于 x0vncserver），只允许来自 localhost 的连接，这样可以确保连接都来自于 ssh 或实体机上认证过的用户。例如：

    ~/.vnc/config

    session=lxqt
    geometry=1920x1080
    localhost
    alwaysshared

确保已经 start 或 restart `vncserver@.service`。例如（参见 #初始设置）：

    # systemctl start vncserver@:1

对于 x0vncserver 则是：

    $ x0vncserver -localhost -SecurityTypes none

### 客户端配置

远程计算机上的 VNC 服务端已被设置为仅接受本地连接。 现在，客户端必须与远程计算机（本例中为 10.1.10.2）建立 SSH 连接，并在客户端的某个端口（如 9901）和服务器的 5901 端口之间建立隧道。关于该功能的详细信息，参见 OpenSSH#Forwarding other ports 和 ssh(1)。

    $ ssh 10.1.10.2 -L 9901:localhost:5901

当通过 SSH 建立连接后，请保持该 shell 窗口打开，它现在是与服务器之间的安全隧道。或者也可以使用 `-f` 选项直接在后台运行 SSH。客户端要想通过这一加密隧道连接到服务端，请指定 vncviewer 连接到客户端 localhost 上的转发端口。

    $ vncviewer localhost:9901

实际上就是 vncviewer 连接到了本地的 9901 端口，而该端口映射到了服务器本地的 5901 端口。通过 SSH，向正确的端口建立了连接。

提示： 只用一行命令即可实现在连接期间保持端口转发，在连接关闭后立即关闭转发：

    $ ssh -fL 9901:localhost:5901 10.1.10.2 sleep 10; vncviewer localhost:9901

上述命令中 `-f` 选项使 ssh 在后台运行，它将因为 `sleep 10` 而保持运行。接着运行 vncviewer，在 vncviewer 使用隧道期间，ssh 在后台继续运行。当隧道不再使用，ssh 将关闭，这正是我们所需要的行为。

另外，vncviewer 的 `-via` 选项提供了上述命令的快捷方式：

    $ vncviewer -via 10.1.10.2 localhost::5901

（注意双冒号：vncviewer 的语法是 `[host]:[display#]` 或 `[host]::[port]`。）

### 从 Android 设备通过 SSH 连接到 vncserver

为了用 Android 设备作为客户端，通过 SSH 连接到 VNC 服务端，可以进行以下设置：

1. 服务器运行 SSH
2. 服务器运行 vncserver（带有 `-localhost` 标志以确保安全）
3. Android 设备上的 SSH 客户端：ConnectBot 是一个流行的选择，本例中将使用它
4. Android 设备上的 VNC 客户端：此处采用 androidVNC

在 ConnectBot 中连接到目标主机。轻点 options 按钮，选择 Port Forwards 并添加一个端口：

    Type: Local
    Source port: 5901
    Destination: 127.0.0.1:5901

在 androidVNC 中连接到 VNC 端口，即 SSH 连接中设置的本地端口：

    Password: the vncserver password
    Address: 127.0.0.1
    Port: 5901

## 提示和技巧

### 连接到 OS X 系统

参见 https://help.ubuntu.com/community/AppleRemoteDesktop 。 已在 Remmina 上测试。

### 推荐的安全设置

#通过 SSH 隧道连接到 vncserver 中，SSH 处理身份验证和加密，如果没有采用该方法，则建议用 X509Vnc，因为 TLSVnc 缺乏身份验证。

    $ vncserver -x509key /path/to/key.pem -x509cert /path/to/cert.pem -SecurityTypes X509Vnc :1

颁发 x509 证书超出了本指南的范围，而 Let's Encrypt 提供了一种简便方法。也可以使用 OpenSSL 来颁发证书，然后与客户端共享公钥并使用 `-X509CA` 参数指定证书。下面是一个示例（服务器运行在 10.1.10.2 上）：

    $ vncviewer 10.1.10.2 -X509CA /path/to/cert.pem

### 切换全屏

从 VNC 客户端的菜单可以切换全屏。默认快捷键是 `F8`。

### 鼠标后退和前进按钮失效的解决方法

VNC 协议目前只支持 7 个鼠标按钮（左、中、右、向上滚动、向下滚动、向左滚动、向右滚动），如果鼠标有后退和前进按钮，这些按钮无法使用，按钮的输入将被忽略。

在单击鼠标后退/前进按钮时，evrouter 将其改为键盘按键发送，可以解决此限制。如果需要，可以在服务器上使用 xautomation 和 xbindkeys 中的 xte 将键盘按键映射回鼠标单击。

#### 用键盘 XF86Back/XF86Forward 按键代替鼠标后退/前进按钮

如果只需要在用 Web 浏览器或文件浏览器时后退/前进，则此方法既简单又合适。

客户端安装 evrouterAUR 和 xautomation。配置 evrouter，想知道如何查找设备名称、窗口名称、按钮名称等，请参阅 Mouse buttons#evrouter 和 evrouter 手册页。以下是示例配置：

    ~/.evrouterrc

    Window "OtherComputer:0 - TigerVNC": # 筛选窗口标题

    # 使用 Shell 防止重复按键（参见 evrouter 手册）
    "USB mouse" "/dev/input/by-id/usb-Mouse-name-event-mouse" none key/275 "Shell/xte 'key XF86Back'"
    "USB mosue" "/dev/input/by-id/usb-Mouse-name-event-mouse" none key/276 "Shell/xte 'key XF86Forward'"

    # 如果需要重复按键，请使用下面的 XKey（参见 evrouter 手册）
    #"Logitech Gaming Mouse G400" "/dev/input/by-id/usb-Logitech_Gaming_Mouse_G400-event-mouse" none key/275 "XKey/XF86Back"
    #"Logitech Gaming Mouse G400" "/dev/input/by-id/usb-Logitech_Gaming_Mouse_G400-event-mouse" none key/276 "XKey/XF86Forward"

客户端启动 evrouter。按照上面的配置，点击鼠标后退按钮时，向 VNC 服务器发送键盘按键 XF86Back，点击前进按钮时发送 XF86Forward。

#### 在服务端将键盘按键映射回的鼠标点击

必要时可以在服务端将键盘按键映射回鼠标点击。此时最好使用客户端或服务端都不使用的按键值。下面的例子将按键值 XF86Launch8/XF86Launch9 用作鼠标按钮 8/9。

客户端上的 evrouter 配置：

    ~/.evrouterrc

    Window "OtherComputer:0 - TigerVNC": # 窗口标题

    # 使用 Shell 防止重复按键（参见 evrouter 手册）
    "USB mouse" "/dev/input/by-id/usb-Mouse-name-event-mouse" none key/275 "Shell/xte 'key XF86Launch8'"
    "USB mosue" "/dev/input/by-id/usb-Mouse-name-event-mouse" none key/276 "Shell/xte 'key XF86Launch9'"

服务端安装 xautomation 和 xbindkeys。配置 xbindkeys，配置中使用 xte 将键盘按键 XF86Launch8/XF86Launch9 映射到鼠标按钮 8/9。

    ~/.xbindkeysrc

    "xte 'mouseclick 8'"
         XF86Launch8

    "xte 'mouseclick 9'"
         XF86Launch9

启用 xbindkeys `$ xbindkeys -f ~/.xbindkeysrc`。服务端将 XF86Launch8/XF86Launch9 映射为鼠标按钮 8/9。

## 疑难解答

### vncserver 内的终端起始于 / （根目录）

这是上游引入的已知问题。参阅：https://github.com/TigerVNC/tigervnc/issues/1108

### 无法输入 '<' 符号

如果在客户端上按下 `<` 却发送了 `>` 字符，请尝试重新映射键盘 [1][失效链接 2020-04-03 ⓘ]：

    $ x0vncserver -RemapKeys="0x3c->0x2c"

### 窗口显示为黑色方框

这种情况很可能是应用程序依赖于 Xorg 的 Composite 扩展。如基于 webkit 的应用程序：midori、psi-plus 等。

这种情况下使用下列命令重启 vncserver：

    $ vncserver -geometry ... -depth 24 :1 +extension Composite

VNC 下的 Composite 扩展仅在 24 位色深时才能正常工作。

### 没有鼠标指针

当使用 `x0vncserver` 时没有可见的鼠标指针，请使用下列命令启动 vncviewer：

    $ vncviewer DotWhenNoCursor=1 <server>

或者将 `DotWhenNoCursor=1` 写入 tigervnc 配置文件，配置文件默认存放在 `~/.vnc/default.tigervnc`。

### 从远程主机复制剪贴板内容

如果无法从远程主机复制到本地，请在服务端运行 `autocutsel`，如 [2] 中所述：

    $ autocutsel -fork

然后按下 F8 打开 VNC 菜单，选择 `Clipboard: local -> remote` 选项。

### 启动 GNOME 3 时显示 "Authentication is required to create a color managed device" 对话框

一种解决方法是创建一个 "vnc" 组，将 gdm 用户和其他使用 vnc 的用户添加到该组。按如下方式 [3] 修改 `/etc/polkit-1/rules.d/gnome-vnc.rules`：

       polkit.addRule(function(action, subject) {
          if ((action.id == "org.freedesktop.color-manager.create-device" ||
               action.id == "org.freedesktop.color-manager.create-profile" ||
               action.id == "org.freedesktop.color-manager.delete-device" ||
               action.id == "org.freedesktop.color-manager.delete-profile" ||
               action.id == "org.freedesktop.color-manager.modify-device" ||
               action.id == "org.freedesktop.color-manager.modify-profile") &&
              subject.isInGroup("vnc")) {
             return polkit.Result.YES;
          }
       });

### 没有窗口装饰/边框/标题栏/无法移动窗口

启动一个窗口管理器来修复一个空的 xterm frame。例如在 xfce 上，可在终端中运行 `xfwm4 &`。

### 按用户运行 systemd service unit

    $ sudo nano /usr/lib/systemd/system/tigervnc@.service

    [Unit]
    Description=Remote desktop service (VNC)
    After=syslog.target network.target

    [Service]
    Type=simple
    ExecStart=/sbin/runuser -l USERNAME -c "/usr/bin/vncserver %i"

    [Install]
    WantedBy=multi-user.target

假设在 display 9 上启动服务：

    $ sudo systemctl start tigervnc@:9

在启动时运行：

    $ sudo systemctl enable tigervnc@:9

## 另外参见

- https://github.com/TigerVNC/tigervnc

Categories:

- Remote desktop (简体中文)
- Servers (简体中文)

Hidden category:

- Pages with dead links