Skip to content

Commit 3b1c5b9

Browse files
authored
configuration: add documentation for NO_PROXY environment variable. (#532)
Signed-off-by: Yu Yi <yiyu@google.com>
1 parent d245cc4 commit 3b1c5b9

File tree

1 file changed

+11
-0
lines changed

1 file changed

+11
-0
lines changed

administration/http-proxy.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,3 +13,14 @@ The `HTTP_PROXY` environment variable is a [standard way](https://docs.docker.co
1313

1414
**Note**: HTTP proxy is also supported using the [HTTP output plugin](https://docs.fluentbit.io/manual/pipeline/outputs/http). This configuration continues to work, however it _should not_ be used together with the `HTTP_PROXY` environment variable. This is because under the hood, the `HTTP_PROXY` environment variable based proxy support is implemented by setting up a TCP connection tunnel via [HTTP CONNECT](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/CONNECT). Unlike the plugin's implementation, this supports both HTTP and HTTPS egress traffic.
1515

16+
# NO_PROXY
17+
18+
In some environments, we wish HTTP traffic for some domains don't go through the HTTP_PROXY, and this is where we need to use `NO_PROXY` environment variable.
19+
20+
`NO_PROXY` is a comma-separated list of host names that shouldn't go through any proxy is set in (only an asterisk, * matches all hosts), e.g. `foo.com,bar.com`. This is as a [curl convention](https://curl.se/docs/manual.html).
21+
22+
One typical use case for `NO_PROXY` is when running fluent-bit in a Kubernetes environment, where we want:
23+
24+
* All real egress traffic goes through a HTTP proxy.
25+
* All "Kubernetes local" traffic does not go through the HTTP proxy.
26+
* We can set `NO_PROXY=127.0.0.1,localhost,kubernetes.default.svc` in this case.

0 commit comments

Comments
 (0)