docker
/
docs
mirror of https://github.com/docker/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Update proxy server examples to include a diff ip address 

Signed-off-by: Usha Mandya <usha.mandya@docker.com>
This commit is contained in:
Usha Mandya 2021-06-30 16:44:29 +01:00
parent 86320fcbc1
commit 9bc2f59d53
1 changed files with 11 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
network/proxy.md
View File

@ -11,23 +11,21 @@ configure it in different ways:
[configure the Docker client](#configure-the-docker-client) to pass
proxy information to containers automatically.
- In Docker 17.06 and lower, you must
[set appropriate environment variables](#use-environment-variables)
- In Docker 17.06 and earlier versions, you must set the appropriate
[environment variables](#use-environment-variables)
within the container. You can do this when you build the image (which makes
the image less portable) or when you create or run the container.
## Configure the Docker client
1. On the Docker client, create or edit the file `~/.docker/config.json` in the
home directory of the user which starts containers. Add JSON such as the
following, substituting the type of proxy with `httpsProxy` or `ftpProxy` if
necessary, and substituting the address and port of the proxy server. You
can configure multiple proxy servers at the same time.
home directory of the user that starts containers. Add JSON similar to the
following example. Substitute the type of proxy with `httpsProxy` or `ftpProxy` if necessary, and substitute the address and port of the proxy server. You can also configure multiple proxy servers simultaneously.
You can optionally exclude hosts or ranges from going through the proxy
server by setting a `noProxy` key to one or more comma-separated IP
addresses or hosts. Using the `*` character as a wildcard for hosts and using CIDR notation for IP addresses is supported as
shown in this example.
shown in this example:
```json
{
@ -35,8 +33,8 @@ configure it in different ways:
{
"default":
{
"httpProxy": "http://127.0.0.1:3001",
"httpsProxy": "http://127.0.0.1:3001",
"httpProxy": "http://192.168.1.12:3128",
"httpsProxy": "http://192.168.1.12:3128",
"noProxy": "*.test.example.com,.example2.com,127.0.0.0/8"
}
}
@ -48,7 +46,6 @@ configure it in different ways:
2. When you create or start new containers, the environment variables are
set automatically within the container.
## Use environment variables
### Set the environment variables manually
@ -59,10 +56,9 @@ value. This method makes the image less portable, so if you have Docker 17.07
or higher, you should [configure the Docker client](#configure-the-docker-client)
instead.
| Variable | Dockerfile example | `docker run` Example |
| Variable | Dockerfile example | `docker run` example |
|:--------------|:--------------------------------------------------|:----------------------------------------------------|
| `HTTP_PROXY` | `ENV HTTP_PROXY="http://127.0.0.1:3001"` | `--env HTTP_PROXY="http://127.0.0.1:3001"` |
| `HTTPS_PROXY` | `ENV HTTPS_PROXY="https://127.0.0.1:3001"` | `--env HTTPS_PROXY="https://127.0.0.1:3001"` |
| `FTP_PROXY` | `ENV FTP_PROXY="ftp://127.0.0.1:3001"` | `--env FTP_PROXY="ftp://127.0.0.1:3001"` |
| `HTTP_PROXY` | `ENV HTTP_PROXY="http://192.168.1.12:3128"` | `--env HTTP_PROXY="http://192.168.1.12:3128"` |
| `HTTPS_PROXY` | `ENV HTTPS_PROXY="https://192.168.1.12:3128"` | `--env HTTPS_PROXY="https://192.168.1.12:3128"` |
| `FTP_PROXY` | `ENV FTP_PROXY="ftp://192.168.1.12:3128"` | `--env FTP_PROXY="ftp://192.168.1.12:3128"` |
| `NO_PROXY` | `ENV NO_PROXY="*.test.example.com,.example2.com"` | `--env NO_PROXY="*.test.example.com,.example2.com"` |