44 lines
1.7 KiB
Markdown
44 lines
1.7 KiB
Markdown
# 端口映射
|
||
|
||
## Type
|
||
- Concept
|
||
|
||
## Definition
|
||
端口映射（Port Mapping）是 Docker 容器网络配置的核心机制，通过 `-p host:container` 语法将容器内部端口暴露到宿主机网络，使得外部流量可以通过宿主机 IP:端口 访问容器内的服务。
|
||
|
||
## Mechanism
|
||
|
||
### 基本语法
|
||
```yaml
|
||
ports:
|
||
- "9091:9091" # host:container（TCP）
|
||
- "51413:51413/udp" # 支持协议指定
|
||
```
|
||
|
||
### 映射规则
|
||
| 格式 | 说明 | 适用场景 |
|
||
|------|------|---------|
|
||
| `host:container` | 指定宿主机和容器端口 | 生产环境 |
|
||
| `host:container/protocol` | 指定协议（TCP/UDP） | BT下载、语音等 |
|
||
| `:container` | 宿主机随机端口 | 开发环境 |
|
||
| `host-ip:host:container` | 绑定特定IP | 多网卡服务器 |
|
||
|
||
## Key Claims
|
||
- Docker 通过 iptables 规则在宿主机层面实现端口映射转发
|
||
- 桥接网络（bridge）模式下端口映射生效；host 网络模式下端口映射被忽略
|
||
- 容器重启后端口映射保持（配置持久化在 Docker daemon）
|
||
- 宿主机端口冲突会导致容器启动失败
|
||
|
||
## Relationship to [[桥接网络]]
|
||
端口映射是 [[桥接网络]] 模式的核心功能：
|
||
- **host 网络模式**：容器直接共享宿主机网络命名空间，端口映射无效（服务直接在宿主机端口监听）
|
||
- **bridge 网络模式**（默认）：容器有独立网络命名空间，通过 NAT 规则实现端口映射访问
|
||
|
||
## Relationship to [[Transmission]]
|
||
Transmission 依赖端口映射实现两个关键功能：
|
||
- Web UI 访问：`9091:9091` → 用户通过浏览器访问 http://host:9091
|
||
- BT Peer 通信：`51413:51413` + `51413:51413/udp` → 其他BT客户端发现并连接
|
||
|
||
## Sources
|
||
- [[用docker安装transmission]]
|