当前位置:首页 > 技术 > 正文内容

为 x11vnc 打造注销后自动重启的 Systemd 服务

访客 技术 2026年8月13日 1

问题现象

在 Linux 桌面环境中,常通过 x11vnc 提供远程桌面访问。把 x11vnc 注册为 Systemd 服务后,首次开机可以正常启动;但当用户注销并重新登录后,VNC 连接会断开,服务不会自动恢复,必须重启系统才能再次使用。

原始 Unit 文件

下面是一份最基本的 x11vnc 服务配置:

[Unit]
Description=X11 VNC remote desktop daemon
After=display-manager.service network.target
Requires=display-manager.service

[Service]
Type=simple
ExecStart=/usr/bin/x11vnc -auth guess -forever -rfbauth /etc/vnc/x11vnc.pass -rfbport 5900 -shared
ExecStop=/usr/bin/killall x11vnc

[Install]
WantedBy=multi-user.target

这份配置只负责把 x11vnc 拉起来,一旦 X 会话因注销而重置,x11vnc 进程退出,Systemd 默认不会再次启动它。

关键改动

让服务在失败后自动恢复,核心是在 [Service] 段加入重启策略:

  • Restart=always:无论以何种状态退出,Systemd 都会尝试重新拉起服务。
  • RestartSec=3:每次重启前等待 3 秒,避免在 X 会话尚未就绪时频繁重试。

同时保留 Type=simple。x11vnc 本身不是典型的双进程守护进程,改为 forking 后反而容易出现主进程判断不准、服务反复断开的情况。

改造后的 Unit 文件

这里把服务命名为 vnc-auto.service,并把认证文件与端口提取为环境变量,便于后续维护:

[Unit]
Description=X11 VNC remote desktop daemon
After=display-manager.service network.target
Wants=display-manager.service

[Service]
Type=simple
Environment="AUTH_FILE=/etc/vnc/x11vnc.pass"
Environment="VNC_PORT=5900"
ExecStart=/usr/bin/x11vnc -auth guess -forever -shared -rfbauth ${AUTH_FILE} -rfbport ${VNC_PORT}
ExecStop=/bin/sh -c 'killall x11vnc || true'
Restart=always
RestartSec=3

[Install]
WantedBy=multi-user.target

加载并验证

保存文件后重新加载 Systemd 配置并启用服务:

sudo systemctl daemon-reload
sudo systemctl enable --now vnc-auto.service
sudo systemctl status vnc-auto.service

观察实时日志,确认注销后服务能够自动重启:

sudo journalctl -fu vnc-auto.service

日志中应出现类似以下片段:

vnc-auto.service: Control process exited, code=exited, status=3/NOTIMPLEMENTED
vnc-auto.service: Failed with result 'exit-code'.
vnc-auto.service: Scheduled restart job, restart counter is at 5.
Starting vnc-auto.service - X11 VNC remote desktop daemon...

看到 Scheduled restart job 即说明服务已按策略自动恢复。

关于 Type 的选择

Systemd 的 Type 决定如何判定服务"已启动":

  • simple:服务进程本身即为主进程,不派生子进程,Systemd 直接认为启动完成。多数后台服务使用该类型即可。
  • forking:启动时会派生子进程并退出父进程,需要配合 PIDFile 等参数,否则容易出现状态误判。
  • oneshot:执行一次任务后立即退出,常用于初始化脚本。
  • dbus / notify:分别通过 D-Bus 信号或 sd_notify 告知 Systemd 启动完成,适用于需要精确报告状态的服务。

对于 x11vnc 这种跟随图形会话运行的服务,simple 加上 Restart=always 是最稳妥的方案。

标签: x11vnc

相关文章

Linux crontab 详解

1) crontab 是什么cron 是 Linux 的定时任务守护进程;crontab 是用来编辑/查看“按时间周期执行命令”的表(cron table)。常见两类:用户 crontab:每个用户一份(crontab -e 编辑)系统级 crontab / cron.d:可指定执行用户(/etc/crontab、/etc/cron.d/*)2) crontab 时间...

富文本里可以允许的 HTML 属性

一、所有标签默认允许的安全属性(极少)class        (可选)id           (通常建议禁用)title️ 注意:id 容易被滥用做锚点注入,很多系统直接禁用class 允许的话最好只允许固定前缀(如 editor-*)二、a 标签允许属性<a href="" t...

Mac 安装 Node.js 指南

方法一:通过官网安装包(最简单,适合初学者)如果你只是想快速安装并开始使用,这是最直接的方法。访问 Node.js 官网。页面会显示两个版本:LTS (Recommended For Most Users):长期支持版,最稳定。建议选这个。Current:最新特性版,包含最新功能但可能不够稳定。下载 .pkg 安装包并运行。按照安装向导点击“下一步”即可完成。方法二:使用 Homebrew 安装(...

Dom\HTML_NO_DEFAULT_NS 的副作用:自动加闭合标签

在使用Dom\HTMLDocument时,Dom\HTML_NO_DEFAULT_NS 将禁止在解析过程中设置元素的命名空间, 此设置是为了与DOMDocument向后兼容而存在的。当使用它时,已知的一个副作用就是:自动加闭合标签例如 </img> 为什么会这样?当你使用:Dom\HTML_NO_DEFAULT_NS文档会变成 无命名空间模式,此时内部更接近 XML...

Laravel 事件和监听器创建

在 Laravel 中,使用 Artisan 命令创建 Events(事件) 和 Listeners(监听器) 是非常高效的。你可以通过以下几种方式来实现:1. 手动创建单个 Event如果你只想创建一个事件类,可以使用 make:event 命令:Bashphp artisan make:event UserRegistered执行后,文件将生成在 app/Even...

自定义域名解析神器 dnsmasq

什么是 dnsmasq?dnsmasq 是一个轻量级、功能强大的网络服务工具,专为小型和中等规模网络设计。它是一个综合的网络基础设施解决方案[1]。dnsmasq 能做什么?功能说明应用场景DNS 转发与缓存将 DNS 查询转发到上游服务器(ISP、Google DNS 等),并在本地缓存结果加快 DNS 查询速度,减少外部 DNS 流量本地 DNS解析本地网络设备的主机名,无需编辑&n...

发表评论

访客

◎欢迎参与讨论,请在这里发表您的看法和观点。