当前位置：首页 > news >正文

使用 x11vnc 与 systemd 实现持久化 VNC 远程桌面服务

news 2026/5/31 22:20:51

背景
- 由于办公电脑系统重装，顺便就使用 Wireguard 异地组网的方案替代了原先的 ssh 隧道进行远程连接等一系列操作的方案。因此需要将服务端 x11vnc 作为一个持久服务，最好能通过 systemd 自动管理。
方案
- 先测试网络连通性以及客户端兼容性。使用下面比较简单的命令启动一次性的服务：
  - ```
  x11vnc -once -display :0 -rfbport 5900 -nevershared -repeat
```
- 使用 x11vnc -storepasswd 命令设置密码。
  - 密码默认存储在 ~/.vnc/passwd文件中。也可以通过参数指定密码文件的存储路径。
  - 密码文件中存储的是加密数据，直接使用文本编辑器创建或编辑不会得到有效的密码文件。
- 优化一下命令，并在命令行中再次测试。
  - ```
  x11vnc -forever -display :0 -rfbport 35901 -rfbauth /home/username/.vnc/passwd -nevershared -noxfixes -repeat -ncache 10 -ncache_cr -q
```
- 生产环境需要避开默认端口 5900
- 配置在 service 文件中的命令尽量使用绝对路径
- Remmina 客户端可以支持 -ncache 参数所启用的缓存，故启用以提升性能。 Windows 下的 TigerVNC 不支持，远程桌面下方会有黑色区域。
- 最终形成 service 文件如下
  - ```
  [Unit]
  Description=x11vnc service
  After=graphical-session.target
  Wants=graphical-session.target[Service]
  Type=simple
  ExecStart=x11vnc -forever -display :0 -rfbport 15900 -rfbauth /home/username/.vnc/passwd -nevershared -noxfixes -repeat -ncache 10 -ncache_cr -q
  Restart=on-failure
  RestartSec=3[Install]
  WantedBy=graphical-session.target
```
- 配置为用户级服务，service 文件放在 ~/.config/systemd/user/ 目录下。
- 刷新配置，启动并启用该服务
  - ```
  systemctl --user daemon-reload
  systemctl --user start x11vnc.service
  systemctl --user enable x11vnc.service
```