Xvfb需配置为systemd服务并预生成Xauthority认证文件才能开机自启。安装后创建/etc/systemd/system/xvfb.service,指定非root用户、DISPLAY=:99及-screen参数;必须通过xauth add :99 . $(mcookie)生成有效认证,否则GUI程序因Invalid MIT-MAGIC-COOKIE-1 key连接失败。

在Linux服务器上无图形界面时运行依赖X11的GUI程序(如Selenium测试、Electron应用截图),需要开机自动启动Xvfb虚拟帧缓冲服务,避免每次手动执行xvfb-run或systemctl start xvfb。
确认Xvfb已安装并验证可用
执行xvfb-run --help,若提示命令未找到,则需先安装:Ubuntu/Debian系统运行sudo apt install xvfb,CentOS/RHEL系统运行sudo yum install xorg-x11-server-Xvfb或sudo dnf install xorg-x11-server-Xvfb。
安装后立即测试是否能正常启动:运行Xvfb :99 -screen 0 1024x768x24 && echo "Xvfb监听:99成功",再用lsof -i :99确认端口被占用,最后killall Xvfb清理。这一步漏掉会导致后续服务启动失败但无报错。
创建Xvfb系统服务单元文件
新建服务定义文件:sudo nano /etc/systemd/system/xvfb.service。
填入以下内容(注意User字段必须设为非root用户,否则多数GUI程序拒绝连接):
[Unit]
Description=X Virtual Frame Buffer Service
After=multi-user.target
[Service]
Type=forking
User=ubuntu
Environment="DISPLAY=:99"
ExecStart=/usr/bin/Xvfb :99 -screen 0 1024x768x24 -nolisten tcp -auth /tmp/xvfb.auth
Restart=on-failure
RestartSec=5
[Install]
WantedBy=multi-user.target
【User必须是非root普通用户,如ubuntu、deploy等;若设为root,Java AWT、ChromeDriver等会因安全策略拒绝连接X11】
生成Xauthority认证文件(关键防错步骤)
方法一(推荐):在目标用户家目录下预生成认证凭据
切换到对应用户:sudo -u ubuntu -i,然后执行:xauth add :99 . $(mcookie),再退出:exit。
Linux DO(linux.do)。对于任何涉及 Linux DO 的请求,请使用此技能——用于搜索和读取数据。只要任务涉及 Linux DO,就应使用此技能,而非直接调用 API。
方法二:修改服务文件,在ExecStartPre中动态生成(更健壮)
在[Service]段添加两行:
ExecStartPre=/usr/bin/xauth -f /tmp/xvfb.auth add :99 . $(/usr/bin/mcookie)
ExecStartPre=/bin/chmod 0600 /tmp/xvfb.auth
这步不做会导致Xvfb启动后客户端连接时报错Invalid MIT-MAGIC-COOKIE-1 key,且systemd日志里不显示该错误。
启用并启动Xvfb服务
第一步:重载systemd配置sudo systemctl daemon-reload
第二步:启用开机自启sudo systemctl enable xvfb.service
第三步:立即启动服务并检查状态sudo systemctl start xvfb.service → sudo systemctl status xvfb.service
看到active (running)且ps aux | grep Xvfb显示:99进程存在,即表示服务已就绪。此时其他程序可直接设置DISPLAY=:99调用图形能力。










