nginx-ingress注解说明(翻译版本)

本是古典何须时尚 2022-12-27 04:57 173阅读 0赞

您可以将这些Kubernetes批注添加到特定的Ingress对象，以自定义其行为。

Tip

注释键和值只能是字符串。其他类型，如布尔或数值必须被引用，即`"true"`，`"false"`，`"100"`。

Note

可以使用[`--annotations-prefix`命令行参数][--annotations-prefix]更改注释前缀 ，但默认值为`nginx.ingress.kubernetes.io`，如下表所述。

<table> 
 <thead> 
  <tr> 
   <th>Name</th> 
   <th>type</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#rewrite" rel="nofollow">nginx.ingress.kubernetes.io/app-root</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#session-affinity" rel="nofollow">nginx.ingress.kubernetes.io/affinity</a></td> 
   <td>cookie</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#session-affinity" rel="nofollow">nginx.ingress.kubernetes.io/affinity-mode</a></td> 
   <td>"balanced" or "persistent"</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#authentication" rel="nofollow">nginx.ingress.kubernetes.io/auth-realm</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#authentication" rel="nofollow">nginx.ingress.kubernetes.io/auth-secret</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#authentication" rel="nofollow">nginx.ingress.kubernetes.io/auth-secret-type</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#authentication" rel="nofollow">nginx.ingress.kubernetes.io/auth-type</a></td> 
   <td>basic or digest</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#client-certificate-authentication" rel="nofollow">nginx.ingress.kubernetes.io/auth-tls-secret</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#client-certificate-authentication" rel="nofollow">nginx.ingress.kubernetes.io/auth-tls-verify-depth</a></td> 
   <td>number</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#client-certificate-authentication" rel="nofollow">nginx.ingress.kubernetes.io/auth-tls-verify-client</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#client-certificate-authentication" rel="nofollow">nginx.ingress.kubernetes.io/auth-tls-error-page</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#client-certificate-authentication" rel="nofollow">nginx.ingress.kubernetes.io/auth-tls-pass-certificate-to-upstream</a></td> 
   <td>"true" or "false"</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#external-authentication" rel="nofollow">nginx.ingress.kubernetes.io/auth-url</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#external-authentication" rel="nofollow">nginx.ingress.kubernetes.io/auth-cache-key</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#external-authentication" rel="nofollow">nginx.ingress.kubernetes.io/auth-cache-duration</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#external-authentication" rel="nofollow">nginx.ingress.kubernetes.io/auth-proxy-set-headers</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#external-authentication" rel="nofollow">nginx.ingress.kubernetes.io/auth-snippet</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#external-authentication" rel="nofollow">nginx.ingress.kubernetes.io/enable-global-auth</a></td> 
   <td>"true" or "false"</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#backend-protocol" rel="nofollow">nginx.ingress.kubernetes.io/backend-protocol</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#canary" rel="nofollow">nginx.ingress.kubernetes.io/canary</a></td> 
   <td>"true" or "false"</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#canary" rel="nofollow">nginx.ingress.kubernetes.io/canary-by-header</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#canary" rel="nofollow">nginx.ingress.kubernetes.io/canary-by-header-value</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#canary" rel="nofollow">nginx.ingress.kubernetes.io/canary-by-header-pattern</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#canary" rel="nofollow">nginx.ingress.kubernetes.io/canary-by-cookie</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#canary" rel="nofollow">nginx.ingress.kubernetes.io/canary-weight</a></td> 
   <td>number</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#client-body-buffer-size" rel="nofollow">nginx.ingress.kubernetes.io/client-body-buffer-size</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#configuration-snippet" rel="nofollow">nginx.ingress.kubernetes.io/configuration-snippet</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#custom-http-errors" rel="nofollow">nginx.ingress.kubernetes.io/custom-http-errors</a></td> 
   <td>[]int</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#default-backend" rel="nofollow">nginx.ingress.kubernetes.io/default-backend</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#enable-cors" rel="nofollow">nginx.ingress.kubernetes.io/enable-cors</a></td> 
   <td>"true" or "false"</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#enable-cors" rel="nofollow">nginx.ingress.kubernetes.io/cors-allow-origin</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#enable-cors" rel="nofollow">nginx.ingress.kubernetes.io/cors-allow-methods</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#enable-cors" rel="nofollow">nginx.ingress.kubernetes.io/cors-allow-headers</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#enable-cors" rel="nofollow">nginx.ingress.kubernetes.io/cors-expose-headers</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#enable-cors" rel="nofollow">nginx.ingress.kubernetes.io/cors-allow-credentials</a></td> 
   <td>"true" or "false"</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#enable-cors" rel="nofollow">nginx.ingress.kubernetes.io/cors-max-age</a></td> 
   <td>number</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#server-side-https-enforcement-through-redirect" rel="nofollow">nginx.ingress.kubernetes.io/force-ssl-redirect</a></td> 
   <td>"true" or "false"</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#redirect-fromto-www" rel="nofollow">nginx.ingress.kubernetes.io/from-to-www-redirect</a></td> 
   <td>"true" or "false"</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#http2-push-preload" rel="nofollow">nginx.ingress.kubernetes.io/http2-push-preload</a></td> 
   <td>"true" or "false"</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#rate-limiting" rel="nofollow">nginx.ingress.kubernetes.io/limit-connections</a></td> 
   <td>number</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#rate-limiting" rel="nofollow">nginx.ingress.kubernetes.io/limit-rps</a></td> 
   <td>number</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#permanent-redirect" rel="nofollow">nginx.ingress.kubernetes.io/permanent-redirect</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#permanent-redirect-code" rel="nofollow">nginx.ingress.kubernetes.io/permanent-redirect-code</a></td> 
   <td>number</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#temporal-redirect" rel="nofollow">nginx.ingress.kubernetes.io/temporal-redirect</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#custom-max-body-size" rel="nofollow">nginx.ingress.kubernetes.io/proxy-body-size</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#proxy-cookie-domain" rel="nofollow">nginx.ingress.kubernetes.io/proxy-cookie-domain</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#proxy-cookie-path" rel="nofollow">nginx.ingress.kubernetes.io/proxy-cookie-path</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#custom-timeouts" rel="nofollow">nginx.ingress.kubernetes.io/proxy-connect-timeout</a></td> 
   <td>number</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#custom-timeouts" rel="nofollow">nginx.ingress.kubernetes.io/proxy-send-timeout</a></td> 
   <td>number</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#custom-timeouts" rel="nofollow">nginx.ingress.kubernetes.io/proxy-read-timeout</a></td> 
   <td>number</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#custom-timeouts" rel="nofollow">nginx.ingress.kubernetes.io/proxy-next-upstream</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#custom-timeouts" rel="nofollow">nginx.ingress.kubernetes.io/proxy-next-upstream-timeout</a></td> 
   <td>number</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#custom-timeouts" rel="nofollow">nginx.ingress.kubernetes.io/proxy-next-upstream-tries</a></td> 
   <td>number</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#custom-timeouts" rel="nofollow">nginx.ingress.kubernetes.io/proxy-request-buffering</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#proxy-redirect" rel="nofollow">nginx.ingress.kubernetes.io/proxy-redirect-from</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#proxy-redirect" rel="nofollow">nginx.ingress.kubernetes.io/proxy-redirect-to</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#proxy-http-version" rel="nofollow">nginx.ingress.kubernetes.io/proxy-http-version</a></td> 
   <td>"1.0" or "1.1"</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#backend-certificate-authentication" rel="nofollow">nginx.ingress.kubernetes.io/proxy-ssl-secret</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#backend-certificate-authentication" rel="nofollow">nginx.ingress.kubernetes.io/proxy-ssl-ciphers</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#backend-certificate-authentication" rel="nofollow">nginx.ingress.kubernetes.io/proxy-ssl-name</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#backend-certificate-authentication" rel="nofollow">nginx.ingress.kubernetes.io/proxy-ssl-protocols</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#backend-certificate-authentication" rel="nofollow">nginx.ingress.kubernetes.io/proxy-ssl-verify</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#backend-certificate-authentication" rel="nofollow">nginx.ingress.kubernetes.io/proxy-ssl-verify-depth</a></td> 
   <td>number</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#backend-certificate-authentication" rel="nofollow">nginx.ingress.kubernetes.io/proxy-ssl-server-name</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#enable-rewrite-log" rel="nofollow">nginx.ingress.kubernetes.io/enable-rewrite-log</a></td> 
   <td>"true" or "false"</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#rewrite" rel="nofollow">nginx.ingress.kubernetes.io/rewrite-target</a></td> 
   <td>URI</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#satisfy" rel="nofollow">nginx.ingress.kubernetes.io/satisfy</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#server-alias" rel="nofollow">nginx.ingress.kubernetes.io/server-alias</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#server-snippet" rel="nofollow">nginx.ingress.kubernetes.io/server-snippet</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#service-upstream" rel="nofollow">nginx.ingress.kubernetes.io/service-upstream</a></td> 
   <td>"true" or "false"</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#cookie-affinity" rel="nofollow">nginx.ingress.kubernetes.io/session-cookie-name</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#cookie-affinity" rel="nofollow">nginx.ingress.kubernetes.io/session-cookie-path</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#cookie-affinity" rel="nofollow">nginx.ingress.kubernetes.io/session-cookie-change-on-failure</a></td> 
   <td>"true" or "false"</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#cookie-affinity" rel="nofollow">nginx.ingress.kubernetes.io/session-cookie-samesite</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#cookie-affinity" rel="nofollow">nginx.ingress.kubernetes.io/session-cookie-conditional-samesite-none</a></td> 
   <td>"true" or "false"</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#server-side-https-enforcement-through-redirect" rel="nofollow">nginx.ingress.kubernetes.io/ssl-redirect</a></td> 
   <td>"true" or "false"</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#ssl-passthrough" rel="nofollow">nginx.ingress.kubernetes.io/ssl-passthrough</a></td> 
   <td>"true" or "false"</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#custom-nginx-upstream-hashing" rel="nofollow">nginx.ingress.kubernetes.io/upstream-hash-by</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#x-forwarded-prefix-header" rel="nofollow">nginx.ingress.kubernetes.io/x-forwarded-prefix</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#custom-nginx-load-balancing" rel="nofollow">nginx.ingress.kubernetes.io/load-balance</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#custom-nginx-upstream-vhost" rel="nofollow">nginx.ingress.kubernetes.io/upstream-vhost</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#whitelist-source-range" rel="nofollow">nginx.ingress.kubernetes.io/whitelist-source-range</a></td> 
   <td>CIDR</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#proxy-buffering" rel="nofollow">nginx.ingress.kubernetes.io/proxy-buffering</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#proxy-buffers-number" rel="nofollow">nginx.ingress.kubernetes.io/proxy-buffers-number</a></td> 
   <td>number</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#proxy-buffer-size" rel="nofollow">nginx.ingress.kubernetes.io/proxy-buffer-size</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#proxy-max-temp-file-size" rel="nofollow">nginx.ingress.kubernetes.io/proxy-max-temp-file-size</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#ssl-ciphers" rel="nofollow">nginx.ingress.kubernetes.io/ssl-ciphers</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#ssl-ciphers" rel="nofollow">nginx.ingress.kubernetes.io/ssl-prefer-server-ciphers</a></td> 
   <td>"true" or "false"</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#connection-proxy-header" rel="nofollow">nginx.ingress.kubernetes.io/connection-proxy-header</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#enable-access-log" rel="nofollow">nginx.ingress.kubernetes.io/enable-access-log</a></td> 
   <td>"true" or "false"</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#enable-opentracing" rel="nofollow">nginx.ingress.kubernetes.io/enable-opentracing</a></td> 
   <td>"true" or "false"</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#influxdb" rel="nofollow">nginx.ingress.kubernetes.io/enable-influxdb</a></td> 
   <td>"true" or "false"</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#influxdb" rel="nofollow">nginx.ingress.kubernetes.io/influxdb-measurement</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#influxdb" rel="nofollow">nginx.ingress.kubernetes.io/influxdb-port</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#influxdb" rel="nofollow">nginx.ingress.kubernetes.io/influxdb-host</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#influxdb" rel="nofollow">nginx.ingress.kubernetes.io/influxdb-server-name</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#use-regex" rel="nofollow">nginx.ingress.kubernetes.io/use-regex</a></td> 
   <td>bool</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#modsecurity" rel="nofollow">nginx.ingress.kubernetes.io/enable-modsecurity</a></td> 
   <td>bool</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#modsecurity" rel="nofollow">nginx.ingress.kubernetes.io/enable-owasp-core-rules</a></td> 
   <td>bool</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#modsecurity" rel="nofollow">nginx.ingress.kubernetes.io/modsecurity-transaction-id</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#modsecurity" rel="nofollow">nginx.ingress.kubernetes.io/modsecurity-snippet</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#mirror" rel="nofollow">nginx.ingress.kubernetes.io/mirror-request-body</a></td> 
   <td>string</td> 
  </tr> 
  <tr> 
   <td><a href="https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#mirror" rel="nofollow">nginx.ingress.kubernetes.io/mirror-target</a></td> 
   <td>string</td> 
  </tr> 
 </tbody> 
</table>

### 金丝雀 ###

在某些情况下，您可能希望通过向少量与生产服务不同的服务发送少量请求来“取消”一组新的更改。Canary注释使Ingress规范可以充当替代服务，以根据所应用的规则将请求路由至。`nginx.ingress.kubernetes.io/canary: "true"`设置后，可以启用以下用于配置金丝雀的注释：

*  `nginx.ingress.kubernetes.io/canary-by-header`：用于通知Ingress将请求路由到Canary Ingress中指定的服务的标头。当请求标头设置`always`为时，它将被路由到Canary。当标头设置`never`为时，它将永远不会路由到金丝雀。对于任何其他值，标头将被忽略，并且按优先级将请求与其他金丝雀规则进行比较。
 *  `nginx.ingress.kubernetes.io/canary-by-header-value`：匹配的报头值，用于通知Ingress将请求路由到Canary Ingress中指定的服务。当请求标头设置为此值时，它将被路由到Canary。对于任何其他标头值，标头将被忽略，并按优先级将请求与其他金丝雀规则进行比较。此注释必须与一起使用。注释是的扩展，`nginx.ingress.kubernetes.io/canary-by-header`允许自定义标头值，而不使用硬编码值。如果`nginx.ingress.kubernetes.io/canary-by-header`未定义注释，则没有任何作用。
 *  `nginx.ingress.kubernetes.io/canary-by-header-pattern`：这与`canary-by-header-value`PCRE Regex匹配相同。请注意，`canary-by-header-value`设置时，此注释将被忽略。当给定的正则表达式在请求处理期间导致错误时，该请求将被视为不匹配。
 *  `nginx.ingress.kubernetes.io/canary-by-cookie`：用于通知Ingress将请求路由到Canary Ingress中指定的服务的cookie。当cookie值设置`always`为时，它将被路由到canary。当cookie设置`never`为时，它将永远不会路由到Canary。对于任何其他值，将忽略cookie，并按优先级将请求与其他canary规则进行比较。
 *  `nginx.ingress.kubernetes.io/canary-weight`：随机请求的整数百分比（0-100），应将其路由到canary Ingress中指定的服务。权重0表示此Canary规则不会在Canary入口中将任何请求发送到服务。权重为100表示所有请求都将发送到Ingress中指定的替代服务。

金丝雀规则按优先级顺序评估。优先级如下： `canary-by-header -> canary-by-cookie -> canary-weight`

**请注意**，当您将某个入口标记为canary时，除`nginx.ingress.kubernetes.io/load-balance`和以外的所有其他非canary注释都将被忽略（从相应的主要入口继承）`nginx.ingress.kubernetes.io/upstream-hash-by`。

**已知局限性**

目前，每个Ingress规则最多可以应用一个Canary Ingress。

### Rewrite ###

在某些情况下，后端服务中公开的URL与Ingress规则中指定的路径不同。如果没有重写，则任何请求都将返回404。将注释设置`nginx.ingress.kubernetes.io/rewrite-target`为服务所需的路径。

如果应用程序根目录暴露在其他路径中，并且需要重定向，请设置注释`nginx.ingress.kubernetes.io/app-root`以重定向的请求`/`。

例子

请检查[重写][Link 1]示例。

### Session Affinity ###

注释`nginx.ingress.kubernetes.io/affinity`在Ingress的所有上游中启用和设置相似性类型。这样，请求将始终定向到同一上游服务器。NGINX唯一可用的相似性类型是`cookie`。

注释`nginx.ingress.kubernetes.io/affinity-mode`定义了会话的粘性。`balanced`如果将部署规模扩大，则将此选项设置为（默认）将重新分配一些会话，从而重新平衡服务器上的负载。将此设置为`persistent`不会重新平衡与新服务器的会话，因此提供了最大的粘性。

**注意**

如果为一个主机定义了多个Ingress `nginx.ingress.kubernetes.io/affinity: cookie`，并且至少一个Ingress使用，则只有Ingress使用的路径`nginx.ingress.kubernetes.io/affinity`将使用会话Cookie相似性。通过随机选择后端服务器，可以在主机的其他入口定义的所有路径进行负载均衡。

**例**

请检查[相似性][Link 2]示例。

**Cookie亲和力**

如果您使用`cookie`相似性类型，则还可以指定将用于通过注释路由请求的cookie的名称`nginx.ingress.kubernetes.io/session-cookie-name`。默认是创建一个名为“ INGRESSCOOKIE”的cookie。

NGINX批注`nginx.ingress.kubernetes.io/session-cookie-path`定义将在cookie上设置的路径。除非注释`nginx.ingress.kubernetes.io/use-regex`设置为true，否则这是可选的。会话Cookie路径不支持正则表达式。

使用`nginx.ingress.kubernetes.io/session-cookie-samesite`的应用`SameSite`属性粘饼干。浏览器接受的值是`None`，`Lax`和`Strict`。某些浏览器会拒绝带有的cookie `SameSite=None`，包括在`SameSite=None`规范之前创建的cookie （例如Chrome 5X）。其他浏览器错误地将`SameSite=None`cookie视为`SameSite=Strict`（例如，在OSX 14上运行的Safari）。要`SameSite=None`在浏览器中忽略这些不兼容性，请添加注释`nginx.ingress.kubernetes.io/session-cookie-conditional-samesite-none: "true"`。

### 认证方式 ###

可以通过在Ingress规则中添加其他注释来添加身份验证。身份验证的来源是包含用户名和密码的机密。

注释是：

nginx.ingress.kubernetes.io/auth-type: [basic|digest]

指示[HTTP身份验证类型：基本或摘要访问身份验证][HTTP]。

nginx.ingress.kubernetes.io/auth-secret: secretName

Secret的名称，其中包含用户名和密码，这些用户名和密码被授予`path`对Ingress规则中定义的的访问权限。此注释还接受替代形式“名称空间/ secretName”，在这种情况下，秘密查找在引用的名称空间而不是Ingress名称空间中执行。

nginx.ingress.kubernetes.io/auth-secret-type: [auth-file|auth-map]

本`auth-secret`可以有两种形式：

*  `auth-file`\-默认情况下，密钥`auth`内的htpasswd文件为秘密
 *  `auth-map` \-机密密钥是用户名，值是哈希密码

nginx.ingress.kubernetes.io/auth-realm: "realm string"

**例**

请检查[身份验证][Link 3]示例。

### 自定义 NGINX upstream hashing ###

NGINX通过基于给定密钥的[一致性哈希][Link 4]的客户端-服务器映射来支持负载平衡。键可以包含文本，变量或其任何组合。此功能允许请求粘性，而不是客户端IP或cookie。将使用[ketama][]一致的哈希方法，该方法确保在上游组更改时仅将少数密钥重新映射到不同的服务器。

上游散列有一种特殊的模式，称为子集。在这种模式下，上游服务器被分组为子集，粘性通过将密钥映射到子集而不是单独的上游服务器而起作用。从选定的粘性子集中随机选择特定的服务器。它提供了粘性和负载分配之间的平衡。

要为后端启用一致的哈希：

`nginx.ingress.kubernetes.io/upstream-hash-by`：nginx变量，文本值或它们的任意组合，以用于一致的哈希。例如：`nginx.ingress.kubernetes.io/upstream-hash-by: "$request_uri"`或`nginx.ingress.kubernetes.io/upstream-hash-by: "$request_uri$host"`或`nginx.ingress.kubernetes.io/upstream-hash-by: "${request_uri}-text-value"`以当前请求URI始终对上游请求进行哈希处理。

可以启用“子集”散列设置`nginx.ingress.kubernetes.io/upstream-hash-by-subset`：“ true”。这会将请求映射到节点的子集，而不是单个请求。`upstream-hash-by-subset-size`确定每个子集的大小（默认为3）。

请检查[chashsubset][]示例。

### 自定义 NGINX load balancing ###

这与[`load-balance`ConfigMap中的][load-balance_ConfigMap]类似，但每个入口配置负载均衡算法。

> 请注意，`nginx.ingress.kubernetes.io/upstream-hash-by`优先于此。如果`nginx.ingress.kubernetes.io/upstream-hash-by`未设置，则我们将退回到使用全局配置的负载平衡算法。

### 自定义 NGINX upstream vhost ###

通过此配置设置，您可以在以下语句中控制host的值：`proxy_set_header Host $host`，它是位置块的一部分。如果您需要通过以外的方式调用上游服务器，这将非常有用`$host`。

### 客户端证书认证 ###

可以使用“入口规则”中的附加注释来启用“客户端证书认证”。

客户端证书身份验证是针对每个主机应用的，因此无法为各个路径指定不同的规则。

注释是：

*  `nginx.ingress.kubernetes.io/auth-tls-secret: secretName`：包含完整的证书颁发机构链的密钥的名称，该链`ca.crt`可以针对此Ingress进行身份验证。此注释还接受替代形式“名称空间/ secretName”，在这种情况下，秘密查找在引用的名称空间而不是Ingress名称空间中执行。
 *  `nginx.ingress.kubernetes.io/auth-tls-verify-depth`：提供的客户证书和证书颁发机构链之间的验证深度。
 *  `nginx.ingress.kubernetes.io/auth-tls-verify-client`：启用客户端证书的验证。可能的值为：
 *  `off`：不要申请客户证书，也不要进行客户证书验证。（默认）
 *  `on`：请求客户端证书，该证书必须由所`ca.crt`指定的密钥的密钥中包含的证书签名`nginx.ingress.kubernetes.io/auth-tls-secret: secretName`。证书验证失败将导致状态码400（错误请求）。
 *  `optional`：对来自的CA执行可选的客户端证书验证`auth-tls-secret`。当提供的证书未经CA签名时，请求失败，状态码为400（错误请求）。如果不提供证书或提供其他无效证书，则请求不会失败，而是将验证结果发送到上游服务。
 *  `optional_no_ca`：进行可选的客户端证书验证，但是当客户端证书没有由CA从签名时，请不要使请求失败`auth-tls-secret`。证书验证结果将发送到usptream服务。
 *  `nginx.ingress.kubernetes.io/auth-tls-error-page`：如果发生证书身份验证错误，应重定向用户的URL /页面
 *  `nginx.ingress.kubernetes.io/auth-tls-pass-certificate-to-upstream`：指示是否应将接收到的证书传递给标头中的上游服务器`ssl-client-cert`。可能的值为“ true”或“ false”（默认）。

根据标头，以下标头被发送到上游服务`auth-tls-*`：

*  `ssl-client-issuer-dn`：客户证书的发行者信息。示例：“ CN =我的CA”
 *  `ssl-client-subject-dn`：客户证书的主题信息。示例：“ CN =我的客户”
 *  `ssl-client-verify`：客户端验证的结果。可能的值：“成功”，“失败：”
 *  `ssl-client-cert`：PEM格式的完整客户端证书。仅当`nginx.ingress.kubernetes.io/auth-tls-pass-certificate-to-upstream`设置为“ true”时才发送。例：`-----BEGIN%20CERTIFICATE-----%0A...---END%20CERTIFICATE-----%0A`

**例**

请检查[客户端证书][Link 5]示例。

**注意**

在Cloudflare中**无法**使用带有客户端身份验证的TLS，**这**可能会导致意外行为。

Cloudflare仅允许使用Authenticated Origin Pulls，并且需要使用其自己的证书：[https][] : [//blog.cloudflare.com/protecting-the-origin-with-tls-authenticated-origin-pulls/][https]

仅允许通过身份验证的原始请求提取，并可以按照其教程进行配置：[https][https 1] : [//support.cloudflare.com/hc/en-us/articles/204494148-Setting-up-NGINX-to-use-TLS-Authenticated-Origin -拉][https 1]

### 后端证书认证 ###

使用入口规则中的附加注释，可以使用证书向代理的HTTPS后端进行身份验证。

*  `nginx.ingress.kubernetes.io/proxy-ssl-secret: secretName`：使用证书`tls.crt`（`tls.key`PEM格式的密钥）指定用于对代理HTTPS服务器进行身份验证的密钥。它还应包含`ca.crt`用于验证代理HTTPS服务器证书的PEM格式的受信任CA证书。此注释还接受替代形式“名称空间/ secretName”，在这种情况下，秘密查找在引用的名称空间而不是Ingress名称空间中执行。
 *  `nginx.ingress.kubernetes.io/proxy-ssl-verify`：启用或禁用对代理HTTPS服务器证书的验证。（默认值：关闭）
 *  `nginx.ingress.kubernetes.io/proxy-ssl-verify-depth`：设置代理HTTPS服务器证书链中的验证深度。（默认值：1）
 *  `nginx.ingress.kubernetes.io/proxy-ssl-ciphers`：指定对代理HTTPS服务器的请求启用的[密码][Link 6]。密码以OpenSSL库可以理解的格式指定。
 *  `nginx.ingress.kubernetes.io/proxy-ssl-name`：允许设置[proxy\_ssl\_name][proxy_ssl_name]。这允许覆盖用于验证代理HTTPS服务器的证书的服务器名称。建立与代理HTTPS服务器的连接时，也会通过SNI传递此值。
 *  `nginx.ingress.kubernetes.io/proxy-ssl-protocols`：启用对代理HTTPS服务器的请求的指定[协议][Link 7]。
 *  `nginx.ingress.kubernetes.io/proxy-ssl-server-name`：在与代理HTTPS服务器建立连接时，允许通过TLS服务器名称指示扩展名（SNI，RFC 6066）传递服务器名称。

### Configuration snippet ###

使用此注释，您可以将其他配置添加到NGINX位置。例如：

nginx.ingress.kubernetes.io/configuration-snippet: |
      more_set_headers "Request-Id: $req_id";

### 自定义 HTTP Errors ###

就像[`custom-http-errors`][custom-http-errors]ConfigMap中的值一样，此批注将设置NGINX `proxy-intercept-errors`，但仅针对与此入口相关联的NGINX位置。如果在入口上指定了[默认后端注释][Link 8]，则错误将路由到该注释的默认后端服务（而不是全局默认后端）。不同的入口可以指定不同的错误代码集。即使多个入口对象共享相同的主机名，此注释也可以用于为每个入口截取不同的错误代码（例如，如果每个路径在不同的入口上，则对于同一主机名上的不同路径将截取不同的错误代码） 。如果`custom-http-errors` 如果也是全局指定的，则在此批注中指定的错误值将覆盖给定入口的主机名和路径的全局值。

用法示例：

nginx.ingress.kubernetes.io/custom-http-errors: "404,415"

### Default Backend ###

此批注具有`nginx.ingress.kubernetes.io/default-backend: <svc name>`指定自定义默认后端的形式。这`<svc name>`是对您在其中应用此批注的相同名称空间内的服务的引用。此注释将覆盖全局默认后端。

当Ingress规则中的服务没有活动的端点时，将处理该服务的响应。如果同时设置了该注释和[custom-http-errors注释][custom-http-errors 1]，它将也处理错误响应。

### 启用CORS ###

要在Ingress规则中启用跨域资源共享（CORS），请添加注释 `nginx.ingress.kubernetes.io/enable-cors: "true"`。这将在服务器位置中添加一个部分以启用此功能。

可以使用以下注释来控制CORS：

*  `nginx.ingress.kubernetes.io/cors-allow-methods` 控制接受哪些方法。这是一个多值字段，以“，”分隔，仅接受字母（大写和小写）。
 *  默认： `GET, PUT, POST, DELETE, PATCH, OPTIONS`
 *  例： `nginx.ingress.kubernetes.io/cors-allow-methods: "PUT, GET, POST, OPTIONS"`
 *  `nginx.ingress.kubernetes.io/cors-allow-headers` 控制接受哪些标题。这是一个多值字段，以“，”分隔，并接受字母，数字，\_和-。
 *  默认： `DNT,X-CustomHeader,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Authorization`
 *  例： `nginx.ingress.kubernetes.io/cors-allow-headers: "X-Forwarded-For, X-app123-XPTO"`
 *  `nginx.ingress.kubernetes.io/cors-expose-headers` 控制哪些标头暴露给响应。这是一个多值字段，以“，”分隔，并接受字母，数字，\_，-和\*。
 *  默认值：*空*
 *  例： `nginx.ingress.kubernetes.io/cors-expose-headers: "*, X-CustomResponseHeader"`
 *  `nginx.ingress.kubernetes.io/cors-allow-origin` 控制CORS接受的原产地。这是一个单字段值，格式如下：`http(s)://origin-site.com`或`http(s)://origin-site.com:port`
 *  默认： `*`
 *  例： `nginx.ingress.kubernetes.io/cors-allow-origin: "https://origin-site.com:4443"`
 *  `nginx.ingress.kubernetes.io/cors-allow-credentials` 控制在CORS操作期间是否可以传递凭据。
 *  默认： `true`
 *  例： `nginx.ingress.kubernetes.io/cors-allow-credentials: "false"`
 *  `nginx.ingress.kubernetes.io/cors-max-age` 控制可以将预检请求缓存多长时间。默认值：`1728000` 示例：`nginx.ingress.kubernetes.io/cors-max-age: 600`

**注意**

有关更多信息，请参见[https://enable-cors.org][https_enable-cors.org]

### HTTP2推送预加载。[¶][Link 9] ###

启用将“链接”响应标题字段中指定的预加载链接自动转换为推送请求的功能。

**例**

*  `nginx.ingress.kubernetes.io/http2-push-preload: "true"`

### 服务器别名 ###

允许使用注释在NGINX配置的服务器定义中定义一个或多个别名`nginx.ingress.kubernetes.io/server-alias: "<alias 1>,<alias 2>"`。这将创建具有相同配置的服务器，但是会向`server_name`指令添加新值。

**注意**

服务器别名不能与现有服务器的主机名冲突。如果是这样，服务器别名注释将被忽略。如果创建了服务器别名，然后又创建了具有相同主机名的新服务器，则新服务器配置将取代别名配置。

欲了解更多信息，请参阅[该`server_name`文档][server_name]。

### Server snippet ###

使用注释`nginx.ingress.kubernetes.io/server-snippet`，可以在服务器配置块中添加自定义配置。

apiVersion: networking.k8s.io/v1beta1
    kind: Ingress
    metadata:
      annotations:
        nginx.ingress.kubernetes.io/server-snippet: |
            set $agentflag 0;
    
            if ($http_user_agent ~* "(Mobile)" ){
              set $agentflag 1;
            }
    
            if ( $agentflag = 1 ) {
              return 301 https://m.example.com;
            }

**注意**

每个主机只能使用一次此注释。

### Client Body Buffer Size ###

设置缓冲区大小，以读取每个位置的客户端请求正文。如果请求主体大于缓冲区，则将整个主体或仅将其一部分写入临时文件。默认情况下，缓冲区大小等于两个内存页。在x86，其他32位平台和x86-64上为8K。在其他64位平台上，通常为16K。此注释将应用于入口规则中提供的每个位置。

**注意**

注释值必须以Nginx可以理解的格式给出。

**例**

*  `nginx.ingress.kubernetes.io/client-body-buffer-size: "1000"` ＃1000字节
 *  `nginx.ingress.kubernetes.io/client-body-buffer-size: 1k` ＃1千字节
 *  `nginx.ingress.kubernetes.io/client-body-buffer-size: 1K` ＃1千字节
 *  `nginx.ingress.kubernetes.io/client-body-buffer-size: 1m` ＃1兆字节
 *  `nginx.ingress.kubernetes.io/client-body-buffer-size: 1M` ＃1兆字节

有关更多信息，请参见[http://nginx.org][http_nginx.org]

### 外部认证 ###

要使用提供身份验证的现有服务，可以对Ingress规则进行注释，`nginx.ingress.kubernetes.io/auth-url`以指示应将HTTP请求发送到的URL。

nginx.ingress.kubernetes.io/auth-url: "URL to the authentication service"

另外，可以设置：

*  `nginx.ingress.kubernetes.io/auth-method`： `<Method>`指定要使用的HTTP方法。
 *  `nginx.ingress.kubernetes.io/auth-signin`： `<SignIn_URL>`指定错误页面的位置。
 *  `nginx.ingress.kubernetes.io/auth-signin-redirect-param`： `<SignIn_URL>`在错误页面中指定URL参数，该参数应包含失败登录请求的原始URL。
 *  `nginx.ingress.kubernetes.io/auth-response-headers`： `<Response_Header_1, ..., Response_Header_n>`指定在身份验证请求完成后传递给后端的标头。
 *  `nginx.ingress.kubernetes.io/auth-proxy-set-headers`： `<ConfigMap>`ConfigMap的名称，该名称指定要传递给身份验证服务的标头
 *  `nginx.ingress.kubernetes.io/auth-request-redirect`： `<Request_Redirect_URL>` 指定X-Auth-Request-Redirect标头值。
 *  `nginx.ingress.kubernetes.io/auth-cache-key`： `<Cache_Key>`这将启用对身份验证请求的缓存。指定身份验证响应的查找键。例如`$remote_user$http_authorization`。每个服务器和位置都有其自己的密钥空间。因此，缓存的响应仅在按服务器和按位置的基础上有效。
 *  `nginx.ingress.kubernetes.io/auth-cache-duration`： `<Cache_duration>`根据身份验证响应的响应代码（例如）指定身份验证响应的缓存时间`200 202 30m`。有关详细信息，请参见[proxy\_cache\_valid][proxy_cache_valid]。您可以指定多个逗号分隔的值：`200 202 10m, 401 5m`。默认为`200 202 401 5m`。
 *  `nginx.ingress.kubernetes.io/auth-snippet`： `<Auth_Snippet>`指定用于外部身份验证的自定义代码段，例如

nginx.ingress.kubernetes.io/auth-url: http://foo.com/external-auth
    nginx.ingress.kubernetes.io/auth-snippet: |
        proxy_set_header Foo-Header 42;

> 注意：`nginx.ingress.kubernetes.io/auth-snippet`是可选注释。但是，它只能与结合使用`nginx.ingress.kubernetes.io/auth-url`，如果`nginx.ingress.kubernetes.io/auth-url`未设置，则将被忽略

**例**

请检查[external-auth][]示例。

**全局外部认证**

默认情况下，如果`global-auth-url`在NGINX ConfigMap中设置，则控制器会将所有请求重定向到提供身份验证的现有服务。如果要为该入口禁用此行为，则可以`enable-global-auth: "false"`在NGINX ConfigMap中使用。 `nginx.ingress.kubernetes.io/enable-global-auth`：指示是否应将GlobalExternalAuth配置应用于此Ingress规则。默认值设置为`"true"`。

**注意**

有关更多信息，请参见[global-auth-url][]。

### 限速 ###

这些注释定义了对连接和传输速率的限制。这些可以用来减轻[DDoS攻击][DDoS]。

*  `nginx.ingress.kubernetes.io/limit-connections`：单个IP地址允许的并发连接数。超出此限制时，将返回503错误。
 *  `nginx.ingress.kubernetes.io/limit-rps`：每秒从给定IP接受的请求数。突发限制设置为此限制乘以突发乘数，默认乘数为5。当客户端超过此限制时， [将][Link 10] 返回[limit-req-status-code][Link 10]***默认值：*** 503。
 *  `nginx.ingress.kubernetes.io/limit-rpm`：每分钟从给定IP接受的请求数。突发限制设置为此限制乘以突发乘数，默认乘数为5。当客户端超过此限制时， [将][Link 10] 返回[limit-req-status-code][Link 10]***默认值：*** 503。
 *  `nginx.ingress.kubernetes.io/limit-burst-multiplier`：突发大小限制速率的倍数。默认的脉冲串乘数为5，此注释会覆盖默认的乘数。当客户端超过此限制时， [将][Link 10] 返回[limit-req-status-code][Link 10]***默认值：*** 503。
 *  `nginx.ingress.kubernetes.io/limit-rate-after`：初始千字节数，之后将进一步限制对给定连接的响应的进一步传输。必须在启用[代理缓冲的情况][Link 11]下使用此功能。
 *  `nginx.ingress.kubernetes.io/limit-rate`：每秒允许发送到给定连接的千字节数。零值禁用速率限制。必须在启用[代理缓冲的情况][Link 11]下使用此功能。
 *  `nginx.ingress.kubernetes.io/limit-whitelist`：客户端IP源范围要从速率限制中排除。该值是逗号分隔的CIDR列表。

如果你在一个单一的入口规则指定多个注释，限制在顺序应用`limit-connections`，`limit-rpm`，`limit-rps`。

要为所有Ingress规则全局配置设置，可以在[NGINX ConfigMap中][NGINX ConfigMap]设置`limit-rate-after`和`limit-rate`值。在Ingress注释中设置的值将覆盖全局设置。

当启用[use-forwarded-headers][]时，将基于[PROXY协议][PROXY]的使用或从`X-Forwarded-For`标头值设置客户端IP地址。

### 永久重定向 ###

此注释允许返回永久重定向（返回代码301），而不是向上游发送数据。例如`nginx.ingress.kubernetes.io/permanent-redirect: https://www.google.com`，将所有内容重定向到Google。

### 永久重定向码 ###

此注释使您可以修改用于永久重定向的状态代码。例如，`nginx.ingress.kubernetes.io/permanent-redirect-code: '308'`将以308返回您的永久重定向。

### 时间重定向 ###

此注释使您可以返回时间重定向（返回代码302），而不是将数据发送到上游。例如`nginx.ingress.kubernetes.io/temporal-redirect: https://www.google.com`，将所有内容重定向到Google，返回码为302（临时移动）

### SSL直通 ###

注释`nginx.ingress.kubernetes.io/ssl-passthrough`指示控制器将TLS连接直接发送到后端，而不是让NGINX解密通信。另请参阅《用户指南》中的[TLS / HTTPS][TLS _ HTTPS]。

**注意**

SSL直通**默认情况下**处于**禁用状态，**并且需要使用该[`--enable-ssl-passthrough`][--annotations-prefix]标志启动控制器 。

**注意**

由于SSL Passthrough在OSI模型（TCP）的第4层而不是第7层（HTTP）上起作用，因此使用SSL Passthrough会使在Ingress对象上设置的所有其他注释无效。

### Service Upstream ###

默认情况下，NGINX入口控制器使用NGINX上游配置中所有端点（Pod IP /端口）的列表。

该`nginx.ingress.kubernetes.io/service-upstream`注释禁用该行为，而是使用在NGINX，该服务的群集IP和端口的单一上游。

这对于零停机时间部署之类的事情可能是理想的，因为它减少了Pod上下时重新加载NGINX配置的需要。参见问题[＃257][257]。

**已知的问题**

如果`service-upstream`指定了注释，则应考虑以下事项：

*  粘性会话将不起作用，因为仅支持循环负载平衡。
 *  该`proxy_next_upstream`指令不会有任何影响，因为如果出错，该请求将不会分派到另一个上游。

### 通过重定向执行服务器端HTTPS ###

默认情况下，如果为该入口启用了TLS，则控制器将重定向（308）到HTTPS。如果要全局禁用此行为，可以`ssl-redirect: "false"`在NGINX [ConfigMap中使用][ConfigMap]。

要为特定的入口资源配置此功能，可以`nginx.ingress.kubernetes.io/ssl-redirect: "false"` 在特定资源中使用注释。

在群集之外（例如AWS ELB）使用SSL卸载时，即使没有可用的TLS证书，强制执行到HTTPS的重定向也是有用的。这可以通过`nginx.ingress.kubernetes.io/force-ssl-redirect: "true"`在特定资源中使用注释来实现。

### 从/重定向到www ###

在某些情况下，需要从重定向`www.domain.com`到`domain.com`，反之亦然。要启用此功能，请使用注释`nginx.ingress.kubernetes.io/from-to-www-redirect: "true"`

**注意**

如果在某个时候创建了一个新的Ingress且其主机等于选项之一（如`domain.com`），则将省略注释。

**注意**

对于从HTTPS到HTTPS的重定向是强制性的，在Ingress TLS部分中的Secret中定义的SSL证书包含两个通用名称的FQDN。

### 白名单来源范围 ###

您可以通过`nginx.ingress.kubernetes.io/whitelist-source-range`注释指定允许的客户端IP源范围。该值是逗号分隔的[CIDR][]列表，例如 `10.0.0.0/24,172.10.0.1`。

要为所有Ingress规则全局配置此设置，`whitelist-source-range`可以在[NGINX ConfigMap中][NGINX ConfigMap 1]设置该值。

**注意**

向Ingress规则添加注释会覆盖所有全局限制。

### 自定义 timeouts ###

使用配置configmap可以为与上游服务器的连接设置默认的全局超时。在某些情况下，要求具有不同的值。为此，我们提供了允许进行此自定义的注释：

*  `nginx.ingress.kubernetes.io/proxy-connect-timeout`
 *  `nginx.ingress.kubernetes.io/proxy-send-timeout`
 *  `nginx.ingress.kubernetes.io/proxy-read-timeout`
 *  `nginx.ingress.kubernetes.io/proxy-next-upstream`
 *  `nginx.ingress.kubernetes.io/proxy-next-upstream-timeout`
 *  `nginx.ingress.kubernetes.io/proxy-next-upstream-tries`
 *  `nginx.ingress.kubernetes.io/proxy-request-buffering`

### 代理重定向 ###

使用注释`nginx.ingress.kubernetes.io/proxy-redirect-from`，`nginx.ingress.kubernetes.io/proxy-redirect-to`可以在[代理服务器响应][Link 12]的`Location`和`Refresh`标头字段中设置应更改的文本

在注释中设置“ off”或“ default”`nginx.ingress.kubernetes.io/proxy-redirect-from`会禁用`nginx.ingress.kubernetes.io/proxy-redirect-to`，否则，必须同时使用两个注释。请注意，每个注释必须是不带空格的字符串。

默认情况下，每个注释的值为“ off”。

### 自定义 max body size ###

对于NGINX，当请求中的大小超过客户端请求正文的最大允许大小时，将向客户端返回413错误。该大小可以通过参数来配置[`client_max_body_size`][client_max_body_size]。

要为所有Ingress规则全局配置此设置，`proxy-body-size`可以在[NGINX ConfigMap中][NGINX ConfigMap 2]设置该值。要在Ingress规则中使用自定义值，请定义以下注释：

nginx.ingress.kubernetes.io/proxy-body-size: 8m

### Proxy cookie domain ###

设置[应在][Link 13]代理服务器响应的“ Set-Cookie”标头字段[的domain属性][Link 13]中[更改][Link 13]的文本。

要为所有Ingress规则全局配置此设置，`proxy-cookie-domain`可以在[NGINX ConfigMap中][NGINX ConfigMap 3]设置该值。

### Proxy cookie path ###

设置[应在][Link 14]代理服务器响应的“ Set-Cookie”标头字段[的path属性][Link 14]中[更改][Link 14]的文本。

要为所有Ingress规则全局配置此设置，`proxy-cookie-path`可以在[NGINX ConfigMap中][NGINX ConfigMap 4]设置该值。

### Proxy buffering ###

启用或禁用代理缓冲[`proxy_buffering`][proxy_buffering]。默认情况下，NGINX配置中禁用代理缓冲。

要为所有Ingress规则全局配置此设置，`proxy-buffering`可以在[NGINX ConfigMap中][NGINX ConfigMap 5]设置该值。要在Ingress规则中使用自定义值，请定义以下注释：

nginx.ingress.kubernetes.io/proxy-buffering: "on"

### Proxy buffers Number ###

设置[`proxy_buffers`][proxy_buffers]用于读取从代理服务器接收到的响应的第一部分的缓冲区数。默认情况下，代理缓冲区数设置为4

要全局配置此设置，请`proxy-buffers-number`在[NGINX ConfigMap中进行][NGINX ConfigMap 6]设置。要在Ingress规则中使用自定义值，请定义以下注释：

nginx.ingress.kubernetes.io/proxy-buffers-number: "4"

### Proxy buffer size ###

设置[`proxy_buffer_size`][proxy_buffer_size]用于读取从代理服务器接收到的响应的第一部分的缓冲区的大小。默认情况下，代理缓冲区大小设置为“ 4k”

要全局配置此设置，请`proxy-buffer-size`在[NGINX ConfigMap中进行][NGINX ConfigMap 7]设置。要在Ingress规则中使用自定义值，请定义以下注释：

nginx.ingress.kubernetes.io/proxy-buffer-size: "8k"

### Proxy max temp file size ###

如果[`buffering`][proxy_buffering]启用了来自代理服务器的响应，并且整个响应都无法放入[`proxy_buffer_size`][proxy_buffer_size]和[`proxy_buffers`][proxy_buffers]指令设置的缓冲区中，则可以将响应的一部分保存到临时文件中。此伪指令设置`size`临时文件的最大值，设置为[`proxy_max_temp_file_size`][proxy_max_temp_file_size]。一次写入临时文件的数据大小由[`proxy_temp_file_write_size`][proxy_temp_file_write_size]指令设置。

零值禁用对临时文件的响应的缓冲。

要在Ingress规则中使用自定义值，请定义以下注释：

nginx.ingress.kubernetes.io/proxy-max-temp-file-size: "1024m"

### 代理HTTP版本 ###

使用此注释设置[`proxy_http_version`][proxy_http_version]Nginx反向代理将用于与后端通信的。默认情况下，它设置为“ 1.1”。

nginx.ingress.kubernetes.io/proxy-http-version: "1.0"

### SSL ciphers ###

指定[启用的密码][Link 15]。

使用此注释将`ssl_ciphers`在服务器级别设置指令。该配置对主机中的所有路径均有效。

nginx.ingress.kubernetes.io/ssl-ciphers: "ALL:!aNULL:!EXPORT56:RC4+RSA:+HIGH:+MEDIUM:+LOW:+SSLv2:+EXP"

以下注释将`ssl_prefer_server_ciphers`在服务器级别设置指令。此配置指定在使用SSLv3和TLS协议时，服务器密码应优先于客户端密码。

nginx.ingress.kubernetes.io/ssl-prefer-server-ciphers: "true"

### Connection proxy header ###

使用此注释将覆盖NGINX设置的默认连接头。要在Ingress规则中使用自定义值，请定义注释：

nginx.ingress.kubernetes.io/connection-proxy-header: "keep-alive"

### 启用访问日志 ###

默认情况下，访问日志处于启用状态，但是在某些情况下，可能需要针对给定的入口禁用访问日志。为此，请使用注释：

nginx.ingress.kubernetes.io/enable-access-log: "false"

### 启用重写日志 ###

默认情况下，未启用重写日志。在某些情况下，可能需要启用NGINX重写日志。请注意，重写日志将在通知级别发送到error\_log文件。要启用此功能，请使用注释：

nginx.ingress.kubernetes.io/enable-rewrite-log: "true"

### 启用开放追踪 ###

可以通过ConfigMap在全局范围内启用或禁用Opentracing，但是有时需要重写它才能启用它或针对特定入口禁用它（例如，关闭对外部运行状况检查端点的跟踪）

nginx.ingress.kubernetes.io/enable-opentracing: "true"

### X-Forwarded-Prefix Header ###

要将非标准`X-Forwarded-Prefix`标头添加到带有字符串值的上游请求中，可以使用以下注释：

nginx.ingress.kubernetes.io/x-forwarded-prefix: "/path"

### ModSecurity ###

[ModSecurity][]是一个开源Web应用程序防火墙。可以为一组特定的入口位置启用它。首先必须通过在[ConfigMap中][ConfigMap 1]启用ModSecurity来启用ModSecurity模块 。请注意，这将为所有路径启用ModSecurity，并且必须手动禁用每个路径。

可以使用以下注释启用它：

nginx.ingress.kubernetes.io/enable-modsecurity: "true"

ModSecurity将使用[推荐的配置][Link 16]以“仅检测”模式[运行][Link 16]。

您可以通过设置以下注释来启用[OWASP核心规则集][OWASP]：

nginx.ingress.kubernetes.io/enable-owasp-core-rules: "true"

您可以通过设置以下内容从nginx传递transactionID：

nginx.ingress.kubernetes.io/modsecurity-transaction-id: "$request_id"

您还可以通过代码段添加自己的modsecurity规则集：

nginx.ingress.kubernetes.io/modsecurity-snippet: |
    SecRuleEngine On
    SecDebugLog /tmp/modsec_debug.log

注意：如果同时使用`enable-owasp-core-rules`和和`modsecurity-snippet`注释，则仅 `modsecurity-snippet`会生效。如果要包括[OWASP核心规则集][OWASP]或 [建议的配置，][Link 16]只需使用include语句：

nginx 0.24.1及以下

nginx.ingress.kubernetes.io/modsecurity-snippet: |
    Include /etc/nginx/owasp-modsecurity-crs/nginx-modsecurity.conf
    Include /etc/nginx/modsecurity/modsecurity.conf

nginx 0.25.0及以上

nginx.ingress.kubernetes.io/modsecurity-snippet: |
    Include /etc/nginx/owasp-modsecurity-crs/nginx-modsecurity.conf

### InfluxDB ###

通过使用`influxdb-*`批注，我们可以使用[nginx-influxdb-module][]将请求发送到暴露UDP套接字的InfluxDB后端，从而监控通过位置的请求。

nginx.ingress.kubernetes.io/enable-influxdb: "true"
    nginx.ingress.kubernetes.io/influxdb-measurement: "nginx-reqs"
    nginx.ingress.kubernetes.io/influxdb-port: "8089"
    nginx.ingress.kubernetes.io/influxdb-host: "127.0.0.1"
    nginx.ingress.kubernetes.io/influxdb-server-name: "nginx-ingress"

对于`influxdb-host`参数，您有两个选择：

*  使用配置了启用[UDP协议][UDP]的InfluxDB服务器 。
 *  将Telegraf作为Sidecar代理部署到Ingress控制器，该控制器配置为使用[套接字侦听器输入][Link 17]侦听UDP并使用任何[输出插件（][Link 18]例如InfluxDB，Apache Kafka，Prometheus等）进行写入。（推荐）

重要的是要记住，目前没有DNS解析器，因此您必须将IP地址配置为`nginx.ingress.kubernetes.io/influxdb-host`。如果将Influx或Telegraf部署为Sidecar（同一吊舱中的另一个容器），这将变得很简单，因为您可以直接使用`127.0.0.1`。

### Backend Protocol ###

使用`backend-protocol`注释可以指示NGINX应如何与后端服务通信。（`secure-backends`在旧版本中替换）有效值：HTTP，HTTPS，GRPC，GRPCS，AJP和FCGI

默认情况下，NGINX使用`HTTP`。

例：

nginx.ingress.kubernetes.io/backend-protocol: "HTTPS"

### 使用 Regex ###

**注意**

当将此注释与`nginx.ingress.kubernetes.io/affinity`类型为NGINX的注释一起使用时`cookie`， `nginx.ingress.kubernetes.io/session-cookie-path`还必须设置；会话Cookie路径不支持正则表达式。

使用`nginx.ingress.kubernetes.io/use-regex`注释将指示Ingress上定义的路径是否使用正则表达式。默认值为`false`。

下面将指示正在使用正则表达式路径：

nginx.ingress.kubernetes.io/use-regex: "true"

以下内容将指示**未**使用正则表达式路径：

nginx.ingress.kubernetes.io/use-regex: "false"

当此注释设置为时`true`，不区分大小写的正则表达式[位置修饰符][Link 19]将在给定主机的所有路径上强制执行，而不管它们定义在什么Ingress上。

另外，如果在给定主机的任何Ingress上使用了[`rewrite-target`注释][rewrite-target]，则不区分大小写的正则表达式[位置修饰符][Link 19]将在给定主机的所有路径上强制执行，而不管它们在什么Ingress上定义。

在使用此修饰符之前，请阅读有关[入口路径匹配的信息][Link 20]。

### Satisfy ###

默认情况下，请求将需要满足所有身份验证要求才能被允许。通过使用此批注，基于配置值，允许满足任何或所有身份验证要求的请求。

nginx.ingress.kubernetes.io/satisfy: "any"

### Mirror ###

允许将请求镜像到镜像后端。镜像后端的响应将被忽略。此功能很有用，可以查看请求在“测试”后端中的反应。

可以通过以下方式设置镜像后端：

nginx.ingress.kubernetes.io/mirror-target: https://test.env.com/$request_uri

默认情况下，请求正文发送到镜像后端，但是可以通过应用以下命令将其关闭：

nginx.ingress.kubernetes.io/mirror-request-body: "off"

**注意：** mirror指令将应用于入口资源内的所有路径。

发送到镜像的请求链接到原始请求。如果您的镜像后端很慢，则原始请求将受到限制。

有关镜像模块的更多信息，请参见[ngx\_http\_mirror\_module][ngx_http_mirror_module]

[--annotations-prefix]: https://kubernetes.github.io/ingress-nginx/user-guide/cli-arguments/
[Link 1]: https://kubernetes.github.io/ingress-nginx/examples/rewrite/
[Link 2]: https://kubernetes.github.io/ingress-nginx/examples/affinity/cookie/
[HTTP]: https://tools.ietf.org/html/rfc2617
[Link 3]: https://kubernetes.github.io/ingress-nginx/examples/auth/basic/
[Link 4]: http://nginx.org/en/docs/http/ngx_http_upstream_module.html#hash
[ketama]: http://www.last.fm/user/RJ/journal/2007/04/10/392555/
[chashsubset]: https://kubernetes.github.io/ingress-nginx/examples/chashsubset/deployment.yaml
[load-balance_ConfigMap]: https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/configmap/#load-balance
[Link 5]: https://kubernetes.github.io/ingress-nginx/examples/auth/client-certs/
[https]: https://blog.cloudflare.com/protecting-the-origin-with-tls-authenticated-origin-pulls/
[https 1]: https://support.cloudflare.com/hc/en-us/articles/204494148-Setting-up-NGINX-to-use-TLS-Authenticated-Origin-Pulls
[Link 6]: http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_ssl_ciphers
[proxy_ssl_name]: http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_ssl_name
[Link 7]: http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_ssl_protocols
[custom-http-errors]: https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/configmap/#custom-http-errors
[Link 8]: https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#default-backend
[custom-http-errors 1]: https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#custom-http-errors
[https_enable-cors.org]: https://enable-cors.org/server_nginx.html
[Link 9]: https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#http2-push-preload
[server_name]: http://nginx.org/en/docs/http/ngx_http_core_module.html#server_name
[http_nginx.org]: http://nginx.org/en/docs/http/ngx_http_core_module.html#client_body_buffer_size
[proxy_cache_valid]: http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cache_valid
[external-auth]: https://kubernetes.github.io/ingress-nginx/examples/auth/external-auth/
[global-auth-url]: https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/configmap/#global-auth-url
[DDoS]: https://www.nginx.com/blog/mitigating-ddos-attacks-with-nginx-and-nginx-plus
[Link 10]: https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/configmap/#limit-req-status-code
[Link 11]: https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#proxy-buffering
[NGINX ConfigMap]: https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/configmap/#limit-rate
[use-forwarded-headers]: https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/configmap/#use-forwarded-headers
[PROXY]: https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/configmap/#use-proxy-protocol
[TLS _ HTTPS]: https://kubernetes.github.io/ingress-nginx/user-guide/tls/#ssl-passthrough
[257]: https://github.com/kubernetes/ingress-nginx/issues/257
[ConfigMap]: https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/configmap/#ssl-redirect
[CIDR]: https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing
[NGINX ConfigMap 1]: https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/configmap/#whitelist-source-range
[Link 12]: http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_redirect
[client_max_body_size]: http://nginx.org/en/docs/http/ngx_http_core_module.html#client_max_body_size
[NGINX ConfigMap 2]: https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/configmap/#proxy-body-size
[Link 13]: http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cookie_domain
[NGINX ConfigMap 3]: https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/configmap/#proxy-cookie-domain
[Link 14]: http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cookie_path
[NGINX ConfigMap 4]: https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/configmap/#proxy-cookie-path
[proxy_buffering]: http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_buffering
[NGINX ConfigMap 5]: https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/configmap/#proxy-buffering
[proxy_buffers]: http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_buffers
[NGINX ConfigMap 6]: https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/configmap/#proxy-buffers-number
[proxy_buffer_size]: http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_buffer_size
[NGINX ConfigMap 7]: https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/configmap/#proxy-buffer-size
[proxy_max_temp_file_size]: http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_max_temp_file_size
[proxy_temp_file_write_size]: http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_temp_file_write_size
[proxy_http_version]: http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_http_version
[Link 15]: http://nginx.org/en/docs/http/ngx_http_ssl_module.html#ssl_ciphers
[ModSecurity]: http://modsecurity.org/
[ConfigMap 1]: https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/configmap/#enable-modsecurity
[Link 16]: https://github.com/SpiderLabs/ModSecurity/blob/v3/master/modsecurity.conf-recommended
[OWASP]: https://www.modsecurity.org/CRS/Documentation/
[nginx-influxdb-module]: https://github.com/influxdata/nginx-influxdb-module/
[UDP]: https://docs.influxdata.com/influxdb/v1.5/supported_protocols/udp/
[Link 17]: https://github.com/influxdata/telegraf/tree/release-1.6/plugins/inputs/socket_listener
[Link 18]: https://github.com/influxdata/telegraf/tree/release-1.7/plugins/outputs
[Link 19]: https://nginx.org/en/docs/http/ngx_http_core_module.html#location
[rewrite-target]: https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#rewrite
[Link 20]: https://kubernetes.github.io/ingress-nginx/user-guide/ingress-path-matching/
[ngx_http_mirror_module]: https://nginx.org/en/docs/http/ngx_http_mirror_module.html