1
0
mirror of https://github.com/actix/actix-website synced 2024-12-18 09:53:12 +01:00
actix-website/content/docs/server.cn.md
2018-06-22 23:18:14 +08:00

4.8 KiB
Raw Blame History

title menu weight
服务器 docs_basics 150

HTTP服务器

HttpServer类型负责服务的HTTP请求。

HttpServer接受应用程序工厂作为参数并且应用程序工厂必须具有Send+ Sync边界。p 要绑定到特定的套接字地址, bind() 必须使用并且可能会多次调用它。绑定ssl套接字使用bind_ssl()bind_tls()。启动http服务器启动方法之一是

HttpServer是一位actix actor。它必须在正确配置的actix系统中初始化

{{< include-example example="server" section="main" >}}

可以使用该run()方法在单独的线程中启动服务器。在这种情况下服务器会产生一个新线程并在其中创建一个新的actix系统。要停止此服务器请发送StopServer消息。

HttpServer被实施为actix actor。可以通过消息传递系统与服务器进行通信。启动方法例如start()返回启动的http服务器的地址。它接受几种消息

  • PauseServer - 暂停接受传入连接
  • ResumeServer - 继续接受传入连接
  • StopServer - 停止传入连接处理停止所有workers并退出

{{< include-example example="server" file="signals.rs" section="signals" >}}

多线程

HttpServer自动启动一些http worker默认情况下这个数量等于系统中逻辑CPU的数量。该数量可以用该HttpServer::workers()方法覆盖 。

{{< include-example example="server" file="workers.rs" section="workers" >}}

服务器为每个创建的worker创建一个单独的应用实例。应用程序状态不在线程之间共享。分享状态可以使用Arc。

应用程序状态并不需要是Send和Sync但是工厂必须是Send+ Sync。

SSL

有两种功能的ssl服务器tlsalpn。该tls功能由native-tls集成alpn由openssl。

[dependencies]
actix-web = { version = "{{< actix-version "actix-web" >}}", features = ["alpn"] }

{{< include-example example="server" file="ssl.rs" section="ssl" >}}

注意HTTP / 2.0协议需要tls alpn。目前只有openssl有alpn支持。完整示例请查看examples/tls.

要创建key.pem和cert.pem请使用以下命令。Fill in your own subject

$ openssl req -x509 -newkey rsa:4096 -keyout key.pem -out cert.pem \
  -days 365 -sha256 -subj "/C=CN/ST=Fujian/L=Xiamen/O=TVlinux/OU=Org/CN=muro.lxd"

要删除密码请将nopass.pem复制到key.pem

$ openssl rsa -in key.pem -out nopass.pem

Keep-Alive

Actix可以等待keep-alive的请求。

keep-alive连接行为由服务器设置定义。

  • 75, Some(75), KeepAlive::Timeout(75) - 75秒keep alive定时器。
  • None or KeepAlive::Disabled - 禁用 keep alive.
  • KeepAlive::Tcp(75) - 使用 SO_KEEPALIVE socket 选项.

{{< include-example example="server" file="ka.rs" section="ka" >}}

如果选择第一个选项,则keep alive状态根据响应的connection-type计算。默认情况下HttpResponse::connection_type未定义。在这种情况下, keep alive 状态由请求的http版本定义。

keep alive关闭 对于 HTTP/1.0 然而是 打开 对于 HTTP/1.1HTTP/2.0.

Connection type可以用HttpResponseBuilder::connection_type()方法改变。

{{< include-example example="server" file="ka_tp.rs" section="example" >}}

优雅的关机

HttpServer支持优雅的关机。收到停止信号后workers会有特定的时间完成服务请求。任何在超时后仍然活着的workers工作线程都会被迫停止。默认情况下关机超时设置为30秒。您可以使用HttpServer::shutdown_timeout()方法更改此参数 。

您可以使用服务器地址向服务器发送停止消息,并指定是否要进行正常关机。start()方法返回服务器的地址。

HttpServer处理几个OS信号。所有操作系统都提供CTRL-C其他信号在unix系统上可用。

  • SIGINT - 强制关闭工作线程
  • SIGTERM - 优雅的停止工作线程
  • SIGQUIT - 制关闭 workers工作线程

可以用HttpServer::disable_signals() 方法禁用信号处理 。