hyperlocal

<div align="center"> 🔌 ✨ </div> <h1 align="center"> hyperlocal </h1> <p align="center"> <a href="https://github.com/hyperium/hyper">Hyper</a> 客户端和服务器绑定，用于<a href="https://github.com/tokio-rs/tokio/tree/master/tokio-net/src/uds/">Unix域套接字</a> </p> <div align="center"> <a alt="GitHub Actions" href="https://github.com/softprops/hyperlocal/actions"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/b7386200-8d8c-453e-92c8-51826d2d6477.svg"/> </a> <a alt="crates.io" href="https://crates.io/crates/hyperlocal"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/4f2eb14c-201b-4df3-9077-ced6e095e10e.svg?logo=rust"/> </a> <a alt="docs.rs" href="http://docs.rs/hyperlocal"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/d32e64a1-3193-4d18-843a-a837df837c77.svg"/> </a> <a alt="latest docs" href="https://softprops.github.io/hyperlocal"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/133ca264-0696-49e6-b833-19eb6fdc5963.svg"/> </a> <a alt="license" href="LICENSE"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/da6619de-5583-4444-add6-23f406484efb.svg"/> </a> </div> <br />

Hyper是一个坚如磐石的Rust HTTP客户端和服务器工具包。 Unix域套接字提供了一种主机本地进程间通信的机制。hyperlocal在Hyper的接口基础上进行了构建和补充，用于构建Unix域套接字HTTP客户端和服务器。

这在为Unix守护进程暴露简单的HTTP接口时非常有用，特别是在你想限制访问仅限于当前主机的情况下，此时不需要打开和暴露TCP端口。提供这种主机本地接口的Unix守护进程的例子包括Docker，一个进程容器管理器。

安装

在你的Cargo.toml文件中添加以下内容

[dependencies]
hyperlocal = "0.9"

使用方法

服务器

典型的服务器可以通过创建一个tokio::net::UnixListener并在循环中接受连接来构建，使用hyper::service::service_fn创建一个请求/响应处理函数，并使用hyper::server::conn::http1::Builder::new().serve_connection()将UnixStream连接到它。

hyperlocal提供了一个扩展trait UnixListenerExt，其中包含了这个实现。

示例在examples/server.rs中，可以通过cargo run --example server运行

要测试你的服务器是否工作，你可以使用现成的工具如curl

$ curl --unix-socket /tmp/hyperlocal.sock localhost

It's a Unix system. I know this.

客户端

hyperlocal还提供了用于编写基于Unix域套接字的HTTP客户端的绑定，使用hyper-utilscrate中的Client接口。

示例在examples/client.rs中，可以通过cargo run --example client运行

Hyper的客户端接口使得发送典型的HTTP方法如GET、POST、DELETE变得容易，它提供了工厂方法get、post、delete等。这些方法需要一个可以转换为hyper::Uri的参数。

由于Unix域套接字不是用可解析为IP地址和网络端口的主机名来表示的，你的标准URL字符串就不适用了。相反，使用hyperlocal::Uri，它同时表示域套接字的文件路径和资源URI路径及查询字符串。

---

Doug Tangren (softprops) 2015-2024