使用 SOCKS5 代理访问 Kubernetes API

    本文展示了如何使用 SOCKS5 代理访问远程 Kubernetes 集群的 API。 当你要访问的集群不直接在公共 Internet 上公开其 API 时，这很有用。

    你必须拥有一个 Kubernetes 的集群，同时你的 Kubernetes 集群必须带有 kubectl 命令行工具。 建议在至少有两个节点的集群上运行本教程，且这些节点不作为控制平面主机。 如果你还没有集群，你可以通过 Minikube 构建一个你自己的集群，或者你可以使用下面任意一个 Kubernetes 工具构建：

    您的 Kubernetes 服务器版本必须是 v1.24. 要获知版本信息，请输入 kubectl version.

    你需要 SSH 客户端软件（ssh 工具），并在远程服务器上运行 SSH 服务。 你必须能够登录到远程服务器上的 SSH 服务。

    任务上下文

    说明： 此示例使用 SSH 隧道传输流量，SSH 客户端和服务器充当 SOCKS 代理。 你可以使用其他任意类型的 SOCKS5 代理代替。

    • 你有一台在后面的步骤中被称为本地计算机的客户端计算机，你将在这台计算机上创建与 Kubernetes API 对话的请求。
    • Kubernetes 服务器/API 托管在远程服务器上。
    • 你将使用 SSH 客户端和服务器软件在本地和远程服务器之间创建安全的 SOCKS5 隧道。 客户端和 Kubernetes API 之间的 HTTPS 流量将流经 SOCKS5 隧道，该隧道本身通过 SSH 进行隧道传输。

    graph LR; subgraph local[本地客户端机器] client([客户端])— 本地
    流量.-> local_ssh[本地 SSH
    SOCKS5 代理]; end ocal_ssh[SSH
    SOCKS5
    代理]— SSH 隧道 —>sshd subgraph remote[远程服务器] sshd[SSH
    服务器]— 本地流量 —>service1; end client([客户端])-. 通过代理传递的
    HTTPS 流量 .->service1[Kubernetes API]; classDef plain fill:#ddd,stroke:#fff,stroke-width:4px,color:#000; classDef k8s fill:#326ce5,stroke:#fff,stroke-width:4px,color:#fff; classDef cluster fill:#fff,stroke:#bbb,stroke-width:2px,color:#326ce5; class ingress,service1,service2,pod1,pod2,pod3,pod4 k8s; class client plain; class cluster cluster;

    必须 JavaScript 才能查看此页内容

    图 1. SOCKS5 教程组件

    此命令在你的客户端计算机和远程服务器之间启动一个 SOCKS5 代理。 SOCKS5 代理允许你连接到集群的 API 服务器。

    • -D 1080: 在本地端口 1080 上打开一个 SOCKS 代理。
    • -N: 不执行远程命令。仅用于转发端口。
    • username@kubernetes-remote-server.example: 运行 Kubernetes 集群的远程 SSH 服务器。

    客户端配置

    要探索 Kubernetes API，你首先需要指示你的客户端通过我们之前创建的 SOCKS5 代理发送他们的查询。 对于命令行工具，设置 https_proxy 环境变量并将其传递给你运行的命令。

    1. export https_proxy=socks5h://localhost:1080

    说明： 在 URL 中，localhost 不是指你的本地客户端计算机。 它指的是远程服务器上称为 “localhost” 的端点。 curl 工具通过 SOCKS 从 HTTPS URL 发送主机名，远程服务器在本地解析（到属于其环回接口的地址）。

    要将官方 Kubernetes 客户端 与代理一起使用，请在 ~/.kube/config 文件中为相关的 cluster 条目设置 proxy-url 元素。 例如：

    1. apiVersion: v1
    2. clusters:
    3. - cluster:
    4.     certificate-authority-data: LRMEMMW2 # 为了便于阅读缩短
    5.     server: https://localhost            # 上图中的“Kubernetes API”
    6.     proxy-url: socks5://localhost:1080   # 上图中的“SSH SOCKS5代理”（内置DNS解析）
    7.   name: default
    8. contexts:
    9. - context:
    10.     user: default
    11.   name: default
    12. current-context: default
    13. kind: Config
    14. preferences: {}
    15. users:
    16. - name: default
    17.   user:
    18.     client-certificate-data: LS0tLS1CR== # 为了便于阅读缩短
    19.     client-key-data: LS0tLS1CRUdJT=      # 为了便于阅读缩短

    如果隧道能够正常工作，并且你调用 kubectl 时使用此集群的上下文， 则可以通过该代理与你的集群交互。 例如：

    1. NAMESPACE     NAME                                     READY   STATUS      RESTARTS   AGE

    通过在运行它的终端上按“CTRL+C”来停止 ssh 端口转发进程。

    在终端中键入 unset https_proxy 以停止通过代理转发 http 流量。

    进一步阅读