@@ -8,33 +8,19 @@ Nginx网关是一个微服务网关。在原生Nginx的基础上,通过对接
8
8
9
9
## 支持的nginx版本
10
10
11
- 当前支持 nginx 的版本为>=1.4.7
11
+ 当前插件集成的版本为 ``` nginx-1.23.1 ```
12
12
13
- ## 安装说明
13
+ ## 快速入门
14
14
15
- ### 操作系统支持
15
+ 快速入门指南可以参考: [ nginx网关快速入门 ] ( https://polarismesh.cn/zh/doc/%E5%BF%AB%E9%80%9F%E5%85%A5%E9%97%A8/Nginx%E7%BD%91%E5%85%B3%E6%8E%A5%E5%85%A5.html#nginx%E7%BD%91%E5%85%B3%E6%8E%A5%E5%85%A5 )
16
16
17
- 当前仅支持linux操作系统,linux下要求GCC版本>=4.8.5
18
-
19
- ```
20
- [sam@VM_15_118_centos ~/testgen]$ gcc --version
21
- gcc (GCC) 4.8.5 20150623 (Red Hat 4.8.5-39)
22
- Copyright (C) 2015 Free Software Foundation, Inc.
23
- This is free software; see the source for copying conditions. There is NO
24
- warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
25
- ```
26
-
27
- ### 下载安装包
28
-
29
- 可以直接从[ releases] ( https://github.com/polarismesh/nginx-gateway/releases ) 下载最新的nginx网关安装包。
30
-
31
- ### 【可选】编译生成安装包
17
+ ## 编译指南
32
18
33
19
用户也可以通过源码编译的方式,生成安装包。
34
20
35
21
- 安装依赖项:在编译之前,需要先安装依赖项。通过执行``` yum install autoconf automake libtool curl make gcc-c++ libstdc++-devel unzip ``` 进行安装。
36
22
37
- - 下载源码包:可以直接从[ releases] ( https://github.com/polarismesh/nginx-gateway/releases ) 下载最新的nginx网关源码包 。
23
+ - 下载源码包:可以直接从[ releases] ( https://github.com/polarismesh/nginx-gateway/releases ) 下载最新的nginx源码包 。
38
24
39
25
- 编译安装:解压源码包。执行以下命令构建,构建过程需要连接网络下载依赖,请务必保证外网连通性。
40
26
@@ -44,66 +30,3 @@ warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
44
30
```
45
31
46
32
- 获取编译结果:构建成功后,在源码包的根目录下,可以获取安装包:``` nginx-gateway-release-*.tar.gz ```
47
-
48
- ### 【可选】修改端口号
49
-
50
- nginx默认端口号为80,如需修改端口号,可以通过编辑conf/nginx.conf配置文件进行修改。
51
-
52
- ```
53
- http {
54
- server {
55
- listen 80; #这里修改成希望监听的端口号
56
- }
57
- }
58
- ```
59
-
60
- ### 运行安装包
61
-
62
- 解压安装包,并运行命令启动nginx网关。
63
-
64
- ```
65
- tar xf nginx-gateway-release-*.tar.gz
66
- cd nginx-gateway-release-*/sbin
67
- bash start.sh
68
- ```
69
-
70
- ## 使用指南
71
-
72
- ### 使用访问限流功能
73
-
74
- - 安装北极星
75
-
76
- 参考[ 安装指南] ( https://polarismesh.cn/zh/doc/%E5%BF%AB%E9%80%9F%E5%85%A5%E9%97%A8/%E5%AE%89%E8%A3%85%E6%9C%8D%E5%8A%A1%E7%AB%AF/%E5%AE%89%E8%A3%85%E5%8D%95%E6%9C%BA%E7%89%88.html#%E5%8D%95%E6%9C%BA%E7%89%88%E5%AE%89%E8%A3%85 ) 进行安装。
77
-
78
- - 配置限流规则
79
-
80
- 在北极星可视化控制台上配置限流规则,比如针对uri为``` /test ``` 的请求,限制每秒只能100QPS。参考[ 限流使用指南] ( https://polarismesh.cn/zh/doc/%E4%BD%BF%E7%94%A8%E6%8C%87%E5%8D%97/%E8%AE%BF%E9%97%AE%E9%99%90%E6%B5%81/%E5%8D%95%E6%9C%BA%E9%99%90%E6%B5%81.html#%E5%8D%95%E6%9C%BA%E9%99%90%E6%B5%81 ) 。
81
-
82
- - 修改nginx配置
83
-
84
- 通过修改nginx中的location,添加polaris_rate_limiting配置,启用北极星限流功能。
85
- ```
86
- http {
87
- server {
88
- location / {
89
- polaris_rate_limiting namespace=default service=testcpp;
90
- }
91
- }
92
- }
93
- ```
94
-
95
- polaris_rate_limiting参数说明:
96
-
97
- | 参数名 | 说明 | 是否必选 |
98
- | --------- | -------------------------------- | ----------------- |
99
- | service | 服务名,与限流规则服务名对应 | 是 |
100
- | namespace | 命名空间,与限流规则命名空间对应 | 否,不填为default |
101
-
102
- - 重启nginx
103
-
104
- ```
105
- cd nginx-gateway-release-*/sbin
106
- bash stop.sh
107
- bash start.sh
108
- ```
109
-
0 commit comments