Ubuntu中无界面运行Recraft需依赖Xvfb虚拟显示：先安装Xvfb并验证版本；再用xvfb-run启动脚本，可加参数指定分辨率与日志；还可配置systemd服务实现持久化；若Recraft基于Chromium，优先使用--headless=new原生模式。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在Ubuntu系统中尝试以无界面模式运行Recraft脚本，但脚本因依赖图形环境而启动失败，则可能是由于缺少Xvfb虚拟显示服务或未正确配置Headless运行参数。以下是实现该目标的具体操作步骤：
一、安装Xvfb虚拟帧缓冲
Xvfb提供一个内存中的虚拟X服务器，使图形化应用能在无物理显示器的环境中运行。它不依赖GPU或显卡驱动，适合服务器环境部署。
1、打开终端，执行更新软件包索引命令：sudo apt update。
2、安装Xvfb软件包：sudo apt install xvfb。
3、验证安装是否成功：Xvfb -version，应输出版本号信息。
二、使用xvfb-run启动Recraft脚本
xvfb-run是Xvfb提供的便捷封装工具，可自动创建并管理临时虚拟显示会话，避免手动启停Xvfb进程。
1、确认Recraft脚本具有可执行权限：chmod +x recraft.sh。
2、通过xvfb-run调用脚本：xvfb-run --server-args="-screen 0 1024x768x24" ./recraft.sh。
3、如需后台运行并记录日志，追加重定向：xvfb-run --server-args="-screen 0 1024x768x24" ./recraft.sh > recraft.log 2>&1 &。
三、配置systemd服务实现持久化Headless运行
将Recraft脚本注册为systemd服务，可确保其随系统启动、自动重启，并与系统日志集成，适用于生产环境长期运行。
1、创建服务文件：sudo nano /etc/systemd/system/recraft-headless.service。
2、写入以下内容（根据实际路径调整ExecStart）：[Unit]\nDescription=Recraft Headless Service\nAfter=network.target\n\n[Service]\nType=simple\nUser=ubuntu\nEnvironment=DISPLAY=:99\nExecStart=/usr/bin/xvfb-run --server-args=\"-screen 0 1024x768x24\" /home/ubuntu/recraft.sh\nRestart=always\nRestartSec=10\n\n[Install]\nWantedBy=multi-user.target。
3、重载配置并启用服务：sudo systemctl daemon-reload && sudo systemctl enable recraft-headless.service && sudo systemctl start recraft-headless.service。
四、使用Chrome DevTools Protocol替代方案（若Recraft基于Chromium）
若Recraft底层使用Puppeteer或Playwright等控制Chromium的库，可直接启用原生Headless模式，绕过Xvfb依赖。
1、检查脚本是否支持--headless=new参数：./recraft.sh --help | grep headless。
2、若支持，直接运行：./recraft.sh --headless=new --no-sandbox --disable-gpu。
3、若提示权限错误，添加用户命名空间支持：echo 'kernel.unprivileged_userns_clone=1' | sudo tee -a /etc/sysctl.conf && sudo sysctl -p。
五、验证Headless运行状态
确认脚本在无图形界面下正常执行逻辑，而非仅启动进程后立即退出，需检查其输出行为与资源占用是否符合预期。
1、查看进程是否存在：ps aux | grep recraft。
2、检查Xvfb是否活跃：ps aux | grep Xvfb。
3、读取最近日志行：tail -n 20 recraft.log（若启用日志重定向）或journalctl -u recraft-headless.service -n 20（若使用systemd）。
