> - 作者：邵欢庆 > - 链接：https://kuboard.cn/guide/proxy/#%E4%BB%A3%E7%90%86%E9%85%8D%E7%BD%AE ## Kuboard Proxy 借助 `Kuboard Proxy`，登录 Kuboard 的用户可以直接访问 Service/Pod，而无需为 Service 做额外的 NodePort、Ingress 等配置。Kuboard Proxy 是 `kubectl proxy` 命令一种替代选项。 与 `kubectl proxy` 相比： * 用户可以直接在 Kuboard 界面进行操作，而无需使用命令行； * 用户权限控制； * 支持更加细致的 rebase 控制； * 可以对接支持 Auth-Proxy 认证方式的后端服务，实现单点登录，例如 [Grafana](https://grafana.com/docs/grafana/v6.5/auth/auth-proxy/)。 本文后面的章节将描述 Kuboard Proxy 的基本使用方法。并有另外三篇文档对 Kuboard Proxy 做进一步的阐述： * [授权用户访问 Kuboard Proxy](https://kuboard.cn/guide/proxy/authorization.html) * [为什么我的网页通过 Kuboard Proxy 代理后显示不正常 - Rebase - （少数情况）](https://kuboard.cn/guide/proxy/rebase.html) * [通过 Auth-Proxy 实现 Grafana 与 Kuboard 的单点登录](https://kuboard.cn/guide/proxy/auth-proxy.html) ## 使用 Kuboard Proxy 访问 Service 按照如下步骤，可以非常方便地使用 Kuboard Proxy： * 进入工作负载查看页面，此处以 [导入 example](https://kuboard.cn/guide/example/import.html) 中导入的 web-example 作为例子，如下图所示：  如果您看不到途中的 ***代理*** 按钮，很可能是您的 Kuboard 版本低于 v1.0.7-beta.4；也可能是因为您没有该Service 的 `service/proxy` 对应的权限，请参考 [授权用户访问 KuboardProxy](https://kuboard.cn/guide/proxy/auth-proxy.html) * 点击上图中的 ***代理*** 按钮，将打开如下界面： 界面中显示了三个区域： * KuboardProxy 代理配置信息，点击 ***修改*** 按钮后可以 [修改KuboardProxy配置](https://kuboard.cn/guide/proxy/#%E4%BF%AE%E6%94%B9KuboardProxy%E4%BB%A3%E7%90%86%E9%85%8D%E7%BD%AE)； * KuboardProxy 代理发现信息（显示了此次所获得 Token 的有效期）； * 访问代理目标（显示了代理的进一步操作区）： * 选择代理协议，此处支持 `http`、 `https` 两种选择，该协议要访问的容器内端口所支持的协议； * 选择访问方法，可以直接在浏览器中打开网页，也可以通过 crul/postman 等测试工具调用容器内的 restful 接口。  * 通过代理访问目标 Service * 点击 ***在浏览器窗口中打开*** 按钮，将直接打开一个新窗口，并显示目标页面，如下所示：  * 点击 ***使用 curl/postman 访问目标代理***，将显示如下对话框： 复制对话框中的代码，并在命令行终端执行，可以获得代理目标服务返回的响应。 > 这种做法在进行 API 测试时非常方便。  ## 修改KuboardProxy代理配置 KuboardProxy代理的设置有： * 环境变量 * 全局生效； * 代理设置 * 只针对 Service/Pod 的单个端口代理生效； ### 环境变量 与 KuboardProxy 相关的环境变量有如下两个： | 名称 | 变量类型 | 默认值 | 描述 | | ------------------------ | -------- | ------ | ------------------------------------------------------------ | | KUBOARD_AUTH_ENCRYPT_KEY | String | 随机 |