systemfd

systemfd 是systemd中1%对开发有用的部分。它是一个小的进程，打开了一组套接字并将它们传递给另一个进程，这样该进程就可以在无需断开连接的情况下重启自己。为此，它在macOS和Linux上使用systemd套接字传递协议（LISTEN_FDS + LISTEN_PID）环境变量，在Windows上使用自定义协议。两个都由 listenfd crate 支持。

与 cargo-watch 结合使用时，您可以得到自动重新加载开发服务器的预览

$ systemfd --no-pid -s http::5000 -- cargo watch -x run

使用 --no-pid 标志禁用在Unix上传递 LISTEN_PID 变量（它在Windows上没有影响）。这使得 listenfd 跳过pid检查，否则会失败。要了解如何实现一个适用于systemfd的服务器，请参见下面的示例。

这个程序受到了 catflap 的启发，但遵循systemd语义并支持多个套接字。

安装

您可以通过使用cargo安装systemfd来获取它

$ cargo install systemfd

用法

systemfd 根据命令行中指定的内容创建一个或多个套接字，然后调用另一个应用程序。每次传递 -s（或 --socket）参数时，都会创建一个新的套接字。参数的值是套接字规范，格式为 [TYPE::]VALUE 其中 TYPE 默认为 tcp 或 unix 取决于值。以下类型存在

• tcp：创建一个tcp监听器
• http：创建用于http的TCP监听器（在info输出中打印http URL）
• https：创建用于https的TCP监听器（在info输出中打印https URL）
• unix：创建Unix监听套接字
• udp：创建UDP套接字

VALUE取决于套接字类型。支持以下格式

• <port>：整数端口号，假设主机为127.0.0.1
• <host>:<port>：绑定到特定的网络接口和端口
• <unix-path>：请求特定的Unix套接字

示例

$ systemfd -s http::5000 -- my-server-executable
$ systemfd -s http::5000 -s https::5443 -- my-server-executable
$ systemfd -s 5000 -- my-server-executable
$ systemfd -s udp::1567 -- my-game-server-executable

当systemfd启动时，它会打印出创建的套接字。可以通过传递-q来禁用此功能。另外，如果端口设置为0，则会选择一个随机端口。