Yilialinn commented on code in PR #11963: URL: https://github.com/apache/apisix/pull/11963#discussion_r1950161165
########## docs/en/latest/plugins/real-ip.md: ########## @@ -27,97 +27,176 @@ description: This document contains information about the Apache APISIX real-ip # --> +<head> + <link rel="canonical" href="https://docs.api7.ai/hub/real-ip"; /> +</head> + ## Description -The `real-ip` Plugin is used to dynamically change the client's IP address and port as seen by APISIX. +The `real-ip` plugin allows APISIX to set the client's real IP by the IP address passed in the HTTP header or HTTP query string. This is particularly useful when APISIX is behind a reverse proxy since the proxy could act as the request-originating client otherwise. -This is more flexible but functions similarly to Nginx's [ngx_http_realip_module](https://nginx.org/en/docs/http/ngx_http_realip_module.html). +The plugin is functionally similar to NGINX's [ngx_http_realip_module](https://nginx.org/en/docs/http/ngx_http_realip_module.html) but offers more flexibility. -:::info IMPORTANT +## Attributes -This Plugin requires APISIX to run on [APISIX-Runtime](../FAQ.md#how-do-i-build-the-apisix-runtime-environment). +| Name | Type | Required | Valid values | Description | +|-----------|---------|----------|----------------|---------------| +| source | string | Yes | Any Nginx variable like `arg_realip` or `http_x_forwarded_for`. |ically Dynam sets the client's IP address and an optional port, or the client's hostname, from APISIX's view.| +| trusted_addresses | array[string] | No | List of IPs or CIDR ranges. | Dynamically sets the `set_real_ip_from` field. | +| recursive | boolean | No | True to enable, false to disable (default is false) | If the recursive search is disabled, the original client address that matches one of the trusted addresses is replaced by the last address sent in the configured `source`. If the recursive search is enabled, the original client address that matches one of the trusted addresses is replaced by the last non-trusted address sent in the configured `source`. | Review Comment: not sure about the link -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
