# 外部存取容器

容器中可以執行一些網路應用，要讓外部也可以存取這些應用，可以通過 `-P` 或 `-p` 參數來指定連接埠映射。

當使用 -P 參數時，Docker 會隨機映射一個 `49000~49900` 的連接埠到內部容器開放的網路連接埠。

使用 `docker ps` 可以看到，本地主機的 49155 被映射到了容器的 5000 連接埠。此時連結本機的 49155 連接埠即可連結容器內 web 應用提供的介面。

```bash
$ sudo docker run -d -P training/webapp python app.py
$ sudo docker ps -l
CONTAINER ID  IMAGE                   COMMAND       CREATED        STATUS        PORTS                    NAMES
bc533791f3f5  training/webapp:latest  python app.py 5 seconds ago  Up 2 seconds  0.0.0.0:49155->5000/tcp  nostalgic_morse
```

同樣的，可以透過 `docker logs` 命令來查看應用的訊息。

```bash
$ sudo docker logs -f nostalgic_morse
* Running on http://0.0.0.0:5000/
10.0.2.2 - - [23/May/2014 20:16:31] "GET / HTTP/1.1" 200 -
10.0.2.2 - - [23/May/2014 20:16:31] "GET /favicon.ico HTTP/1.1" 404 -
```

-p（小寫的）則可以指定要映射的連接埠，並且在一個指定連接埠上只可以綁定一個容器。支援的格式有 `ip:hostPort:containerPort | ip::containerPort | hostPort:containerPort`。

## 映射所有遠端位址

使用 `hostPort:containerPort` 格式本地的 5000 連接埠映射到容器的 5000 連接埠，可以執行

```bash
$ sudo docker run -d -p 5000:5000 training/webapp python app.py
```

此時預設會綁定本地所有遠端上的所有位址。

## 映射到指定位址的指定連接埠

可以使用 `ip:hostPort:containerPort` 格式指定映射使用一個特定位址，比如 localhost 位址 127.0.0.1

```bash
$ sudo docker run -d -p 127.0.0.1:5000:5000 training/webapp python app.py
```

## 映射到指定位址的任意連接埠

使用 `ip::containerPort` 綁定 localhost 的任意連接埠到容器的 5000 連接埠，本地主機會自動分配一個連接埠。

```bash
$ sudo docker run -d -p 127.0.0.1::5000 training/webapp python app.py
```

還可以使用 udp 標記來指定 udp 連接埠

```
$ sudo docker run -d -p 127.0.0.1:5000:5000/udp training/webapp python app.py
```

## 查看映射連接埠配置

使用 `docker port` 來查看當前映射的連接埠配置，也可以查看到綁定的位址

```bash
$ docker port nostalgic_morse 5000
127.0.0.1:49155.
```

注意：

* 容器有自己的內部網路和 ip 位址（使用 `docker inspect` 可以獲取所有的變數，Docker 還可以有一個可變的網路設定。）
* -p 標記可以多次使用來綁定多個連接埠

例如

```bash
$ sudo docker run -d -p 5000:5000  -p 3000:80 training/webapp python app.py
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://philipzheng.gitbook.io/docker_practice/network/port_mapping.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.