本目录存放 XFCE4 桌面环境的运行日志和进程 ID 文件。

• 文件说明
  • 日志文件
  • PID 文件
• 日志查看
• 日志分析
• 清理日志
• 注意事项

文件名称	功能说明
desktop.log	XFCE4 桌面环境启动和运行日志
x11vnc.log	VNC 服务器运行日志
websockify.log	noVNC WebSocket 代理日志
installation.log	安装过程日志（由安装脚本生成）
controller.log	主控制器运行日志

文件名称	功能说明
xvfb.pid	Xvfb 虚拟显示服务器进程 ID
xfce.pid	XFCE4 桌面会话进程 ID
websockify.pid	WebSocket 代理进程 ID
controller.pid	主控制器进程 ID

make logs       # 列出所有日志文件
make tail       # 实时查看桌面日志
make tail-all   # 实时查看所有日志

# 查看桌面日志
cat logs/desktop.log

# 实时查看
tail -f logs/desktop.log

# 查看所有日志
tail -f logs/*.log

# 检查启动错误
grep -i error logs/desktop.log
grep -i fail logs/desktop.log

# 检查连接问题
grep -i connect logs/websockify.log
grep -i timeout logs/websockify.log

# 检查 VNC 问题
grep -i error logs/x11vnc.log

日志文件会持续增长，建议定期清理：

# 清理日志（重置环境时自动执行）
make reset

# 或手动清理
rm -f logs/*.log

# 通过 Makefile
make reset      # 停止服务并清理日志

# 手动清理
rm -f logs/*.log logs/*.pid

1. 日志文件可能包含敏感信息，请注意保护
2. 清理日志前请先停止桌面服务
3. PID 文件用于服务管理，请勿手动删除
4. 日志目录会在服务启动时自动创建

---

最后更新: 2026-02-26