srvfb 项目使用教程

1. 项目目录结构及介绍

srvfb/
├── contrib/
│   ├── srvfb.service
│   └── srvfb.socket
├── internal/
│   └── fb/
│       └── fb.go
├── LICENSE
├── README.md
├── go.mod
├── go.sum
└── srvfb.go

目录结构说明

• contrib/: 包含用于 systemd 的单元文件，用于自动运行 srvfb 服务。

  • srvfb.service: systemd 服务文件，用于启动 srvfb 服务。
  • srvfb.socket: systemd socket 文件，用于 socket 激活。

• internal/fb/: 包含与 framebuffer 设备交互的实现代码。

  • fb.go: 实现 framebuffer 设备的打开、关闭、图像获取等功能。

• LICENSE: 项目的许可证文件，采用 Apache License 2.0。

• README.md: 项目的介绍文档，包含项目的基本信息和使用说明。

• go.mod 和 go.sum: Go 模块文件，用于管理项目的依赖。

• srvfb.go: 项目的主文件，包含 srvfb 服务的主要逻辑。

2. 项目启动文件介绍

srvfb.go

srvfb.go 是项目的主文件，负责启动 srvfb 服务。该文件的主要功能包括：

• 初始化: 初始化 framebuffer 设备。
• HTTP 服务: 启动一个 HTTP 服务器，用于将 framebuffer 内容作为视频流通过 HTTP 传输。
• 代理模式: 支持将 framebuffer 内容作为原始数据流进行传输。

启动命令

go run srvfb.go

该命令将启动 srvfb 服务，默认情况下，服务会监听 USB 网络接口。

3. 项目配置文件介绍

srvfb.service

srvfb.service 是 systemd 服务文件，用于配置 srvfb 服务的自动启动。该文件位于 contrib/ 目录下。

[Unit]
Description=srvfb - Stream framebuffer content over HTTP
After=network.target

[Service]
ExecStart=/usr/bin/srvfb
Restart=always

[Install]
WantedBy=multi-user.target

srvfb.socket

srvfb.socket 是 systemd socket 文件，用于配置 srvfb 服务的 socket 激活。该文件位于 contrib/ 目录下。

[Unit]
Description=srvfb socket

[Socket]
ListenStream=/run/srvfb.sock

[Install]
WantedBy=sockets.target

配置说明

• srvfb.service: 配置了服务的启动命令和重启策略。
• srvfb.socket: 配置了服务的 socket 监听路径，用于 socket 激活。

通过这两个文件，可以实现 srvfb 服务的自动启动和管理。