nginx 1.13.10新增了对grpc的原生支持。本文介绍如何配置nginx的grpc。
安装nginx
nginx版本要求：1.13.10。
grpc必须使用http/2传输数据，支持明文和tls加密数据，支持流数据的交互。这是为了充分利用 http/2 连接的多路复用和流式特性。所以在安装部署nginx时需要安装http/2。使用源码安装，编译时需要加入http_ssl和http_v2模块：
$ auto/configure --with-http_ssl_module --with-http_v2_module
nginx以明文的方式发布grpc服务。
nginx是使用http服务器监听grpc的请求。
示例：
我要评论
http {
server {
listen 80 http2;
access_log logs/access.log main;
location / {
# the 'grpc://' prefix is optional; unencrypted grpc is the default
grpc_pass grpc://localhost:50051;
}
}
}
指令grpc_pass用来指定代理的grpc服务器地址，前缀协议有两种：
grpc服务器地址的前缀“grpc://”是可以忽略，默认就是明文交互方式。
此示例里nginx以明文的方式在80端口发布grpc，其中代理的grpc在后端也是以明文的方式交互。
注意：nginx是不支持在明文的端口上同时支持http1和http2的。如果要支持这两种的http协议，需要设置为不同的端口。
nginx以tls加密方式公开grpc服务
在生成环境建议使用nginx是以加密的方式发布grpc。这种情景需要在nginx添加一个加密层。
在开发/测试环境可以使用自签名证书，关于自签名证书可以参考此。
配置示例：
server {
listen 1443 ssl http2;
ssl_certificate ssl/cert.pem;
ssl_certificate_key ssl/key.pem;
location / {
grpc_pass grpc://localhost:50051;
}
}
示例里在nginx层给grpc服务对外添加了ssl，而内部代理到grpc服务器仍然是使用明文的交互方式。
grpc客户端也是需要tls加密。如果是使用自签名证书等未经信任的证书，客户端都需要禁用证书检查。在部署到生产环境时，需要将自签名证书换成由可信任证书机构发布的证书，客户端也需要配置成信任该证书。
代理加密的grpc
如果nginx内部代理的grpc也需要以加密的方式交互，这种情况就需要把明文代理协议grpc://替换为grpcs://。这首先要grpc服务器是以加密的方式发布服务的。
nginx层修改如下：
grpc_pass grpcs://localhost:50051;
nginx路由grpc请求
如果后端有多个grpc服务端，其中每个服务端都是提供不同的grpc服务。这种情况可以使用一个nginx接收客户端请求，然后根据不同的路径分发路由到指定的grpc服务器。使用location区分：
location /helloworld.greeter {
grpc_pass grpc://192.168.20.11:50051;
}
location /helloworld.dispatcher {
grpc_pass grpc://192.168.20.21:50052;
}
location / {
root html;
index index.htm;
}
对grpc请求做负载均衡
在后端有多个grpc服务器，它们都是同一个grpc服务，这种情况可以结合nginx的upstream可以对grpc的请求做负载均衡。
upstream grpcservers {
server 192.168.20.21:50051;
server 192.168.20.22:50052;
}
server {
listen 1443 ssl http2;
ssl_certificate ssl/certificate.pem;
ssl_certificate_key ssl/key.pem;
location /helloworld.greeter {
grpc_pass grpc://grpcservers;
error_page 502 = /error502grpc;
}
location = /error502grpc {
internal;
default_type application/grpc;
add_header grpc-status 14;
add_header grpc-message "unavailable";
return 204;
}
}
其中upstream指定定义了统一grpc服务的服务器组。在grpc_pass指定的grpc服务器地址使用upstream定义的服务器组。
以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持移动技术网。
如对本文有疑问， 点击进行留言回复！！
Nginx服务500：Internal Server Error原因之一
nginx禁止直接通过ip进行访问并跳转到自定义500页面的操作
网友评论