Function lesson_4_port_mapping

tutorials/14b_networking_for_engineers.py:285–403

Docker 的 -p 8080:80 是最容易让人困惑的参数之一。

()

# ============================================================

def lesson_4_port_mapping():
    """
    Docker 的 -p 8080:80 是最容易让人困惑的参数之一。
    """
    print("\n" + "=" * 60)
    print("第四课: 端口映射")
    print("=" * 60)

    print("""
    场景: 你在 Docker 里运行了一个网站，它监听 80 端口。
    但容器有自己的网络命名空间——外面看不到容器里的 80 端口。

    docker run -p 8080:80 nginx
                  ↑    ↑
                  │    └── 容器内部的端口 (nginx 监听 80)
                  └─────── 宿主机暴露的端口 (你用 8080 访问)

    这就是"端口映射"——在两个隔离的网络之间开一个"传送门"。

    ┌──────────────────────────────────────────────┐
    │  宿主机                                      │
    │                                              │
    │  浏览器 ──→ localhost:8080 ──┐               │
    │                              │ 端口映射      │
    │  ┌──────────────────────┐    │               │
    │  │  Docker 容器          │    │               │
    │  │  (独立网络命名空间)    │    │               │
    │  │                      │    │               │
    │  │  nginx ←── :80 ◄─────┘               │
    │  │                      │                    │
    │  │  内部 IP: 172.17.0.2 │                    │
    │  └──────────────────────┘                    │
    └──────────────────────────────────────────────┘

    访问 localhost:8080 → Docker 把流量转发到容器的 80 → nginx 响应
    """)

    # 用 Python 模拟端口转发
    print("  用 Python 模拟端口转发的工作原理:")
    print("  (不需要 Docker，纯 Python 演示)")

    # "容器内部"的服务器
    internal_server = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
    internal_server.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
    internal_server.bind(("127.0.0.1", 0))
    internal_port = internal_server.getsockname()[1]
    internal_server.listen(1)
    internal_server.settimeout(3)

    # 端口转发器（模拟 Docker 的端口映射）
    proxy_server = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
    proxy_server.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
    proxy_server.bind(("127.0.0.1", 0))
    external_port = proxy_server.getsockname()[1]
    proxy_server.listen(1)
    proxy_server.settimeout(3)

    print(f"    '容器内' 服务监听: 127.0.0.1:{internal_port}")