Skip to content
首页配置环境变量

环境变量 ​

Kite 默认支持一些环境变量,来改变一些配置项的默认值。

  • PLUGIN_DIR:已安装插件的文件目录,默认是相对于 Kite 工作目录的 data/plugins(官方容器镜像中为 /app/data/plugins)。Helm Chart 将其设为 /data/plugins,可复用 SQLite 的存储卷。目录与持久化配置见插件存储。

  • KITE_CONFIG_FILE:配置文件路径。该功能仅适用于 Kite v0.10.0 及以上版本。设置后,Kite 从该文件加载集群、OAuth、LDAP、RBAC 和超级用户设置。详见配置文件。

  • PLUGIN_DEV_URL:开发插件的 manifest 地址,例如 http://localhost:5174/plugin.json。浏览器直接加载该地址,同 ID 时优先使用开发插件,不修改安装记录。不设置时仅加载已安装插件。Helm 部署可通过 extraEnvs 配置,详见插件调试。

  • KITE_USERNAME:兼容旧配置的超级用户名环境变量。仅在未设置 KITE_CONFIG_FILE 时,用于环境变量到数据库配置的迁移。

  • KITE_PASSWORD:兼容旧配置的超级用户密码环境变量。仅在未设置 KITE_CONFIG_FILE 时,用于环境变量到数据库配置的迁移。

  • KUBECONFIG:兼容旧配置的 kubeconfig 环境变量。仅在未设置 KITE_CONFIG_FILE 时读取并导入集群配置。

  • ANONYMOUS_USER_ENABLED:启用匿名用户访问,默认值为 false,当启用后所有访问将不再需要身份验证,并且默认拥有最高权限。

  • JWT_SECRET:用于签名和验证 JWT 的密钥

  • KITE_ENCRYPT_KEY:用于加密敏感数据的密钥, 例如用户密码,OAuth 的 clientSecret ,kubeconfig 等。

  • HOST: 用户 OAuth 2.0 授权回调地址生成,默认会从请求头获取,如果您发现结果不及预期可以手动配置此环境变量。

  • TRUSTED_PROXIES:以逗号分隔的反向代理、Ingress 或负载均衡器 IP/CIDR 列表;只有这些直连 Kite 的上一跳才会被信任,Kite 才会读取其转发的 X-Forwarded-For / X-Real-IP 来判断客户端 IP。默认信任本地和常见私网网段(127.0.0.0/8、10.0.0.0/8、172.16.0.0/12、192.168.0.0/16、::1、fc00::/7),方便常见 Ingress 部署拿到真实用户 IP。生产环境建议配置为更窄的范围,例如 TRUSTED_PROXIES=10.42.0.0/16,192.168.1.10;如需忽略所有客户端转发头,可设置 TRUSTED_PROXIES=none。

  • KUBECTL_TERMINAL_IMAGE: 用于 kubectl 终端的 Docker 镜像。

  • NODE_TERMINAL_IMAGE: 用于生成 Node Terminal Agent 的 Docker 镜像。

  • CLUSTER_AGENT_IMAGE: 为 Cluster Agent 类型集群生成 Cluster Agent 部署清单时使用的 Docker 镜像。

  • ENABLE_ANALYTICS:启用数据分析功能,默认值为 false。当启用后,Kite 将收集有限数据以帮助改进产品。

  • PORT:Kite 运行的端口,默认值为 8080。

Released under the Apache License.