附录：KubeSphere Core 高级配置

global.imageRegistry

全局 Docker 镜像仓库地址

registry.cn-beijing.aliyuncs.com

global.tag

全局 Docker 镜像标签

v4.1.3

global.imagePullSecrets

全局 Docker 仓库密钥名称数组

[]

nameOverride

部分覆盖 common.names.fullname 的字符串

""

fullnameOverride

完全覆盖 common.names.fullname 的字符串

""

commonLabels

添加到所有部署对象的标签

{}

commonAnnotations

添加到所有部署对象的注解

{}

multicluster.role

多集群角色 (host/member)

""

multicluster.hostClusterName

主集群名称

""

portal.hostname

ks-console 服务的公开入口域名或 IP 地址

ks-console.kubesphere-system.svc

portal.http.port

ks-console 服务通过公开入口暴露的 HTTP 端口号

30880

s3.endpoint

S3 端点 URL

""

s3.region

S3 区域

us-east-1

s3.disableSSL

禁用 S3 SSL

true

s3.forcePathStyle

强制 S3 路径样式

true

s3.accessKeyID

S3 访问密钥 ID

admin

s3.secretAccessKey

S3 访问密钥

admin

s3.bucket

S3 存储桶名称

uploads

authentication.authenticateRateLimiterMaxTries

认证最大尝试次数

10

authentication.authenticationRateLimiterDuration

限流器持续时间

10m0s

authentication.loginHistoryRetentionPeriod

登录历史保留期限

168h

authentication.enableMultiLogin

启用多点登录

true

authentication.maxInactivityDuration

最大不活动持续时间

0s

authentication.adminPassword

管理员密码

""

authentication.issuer.maximumClockSkew

JWT 令牌验证时允许的最大时钟偏差

10s

authentication.issuer.jwtSecret

用于签发 JWT 的密钥

""

authentication.issuer.accessTokenMaxAge

访问令牌最大有效期

2h

authentication.issuer.accessTokenInactivityTimeout

JWT 访问令牌的不活跃超时时间

30m

experimental.validationDirective

资源验证模式（严格/忽略/警告）

""

experimental.maintenance

是否启用维护模式

false

auditing.enable

启用审计

false

auditing.auditLevel

审计级别（元数据/请求/请求响应）

Metadata

auditing.logOptions.path

审计日志路径

/etc/audit/audit.log

auditing.logOptions.maxAge

审计日志的最大保留天数

7

auditing.logOptions.maxBackups

审计日志的最大备份数

10

auditing.logOptions.maxSize

审计日志文件的最大大小（MB）

100

serviceAccount.create

创建服务账户

true

serviceAccount.annotations

服务账户注解

{}

serviceAccount.name

服务账户名称

kubesphere

tolerations

Pod 容忍配置

[]

affinity

Pod 亲和性配置

{}

nodeSelector

Pod 节点选择器

{}

internalTLS

启用组件间 TLS 通信

false

apiserver.image.registry

ks-apiserver 的镜像注册中心地址

""

apiserver.image.repository

ks-apiserver 的镜像仓库路径

kse/ks-apiserver

apiserver.image.tag

ks-apiserver 的镜像标签

""

apiserver.image.digest

ks-apiserver 的镜像摘要

""

apiserver.image.pullPolicy

ks-apiserver 的镜像拉取策略

IfNotPresent

apiserver.containerPorts

ks-apiserver 容器启用的端口列表

[]

apiserver.resources.limits

ks-apiserver 容器的资源限制

{}

apiserver.resources.requests

ks-apiserver 容器的资源请求

{}

apiserver.command

覆盖默认容器命令

[]

apiserver.extraEnvVars

额外环境变量列表

[]

apiserver.extraVolumeMounts

额外 volumeMounts 列表

[]

apiserver.extraVolumes

额外 volumes 列表

[]

apiserver.hardAntiAffinity

是否启用强反亲和性调度

false

console.image.registry

console 镜像仓库地址

""

console.image.repository

console 的镜像命名空间

kse/ks-console

console.image.tag

console 镜像标签

""

console.image.digest

console 镜像摘要

""

console.image.pullPolicy

console 镜像拉取策略

IfNotPresent

console.config.enenableNodeListTerminal

在控制台中启用节点列表终端

true

console.containerPorts

ks-console 容器启用的端口列表

[]

console.nodePort

console 服务的节点端口

30880

console.resources.limits

ks-console 容器的资源限制

{}

console.resources.requests

ks-console 容器的资源请求

{}

console.command

覆盖默认容器命令

[]

console.extraEnvVars

添加到 ks-console 的额外环境变量数组

[]

console.extraVolumeMounts

ks-console 容器的额外 volumeMounts 列表

[]

console.extraVolumes

ks-console Pod 的额外 volumes 列表

[]

console.hardAntiAffinity

是否强制 ks-console Pod 运行在不同节点上

false

controller.image.registry

控制器镜像仓库地址

""

controller.image.repository

控制器的镜像命名空间

kse/ks-controller-manager

controller.image.tag

控制器镜像标签

""

controller.image.digest

控制器镜像摘要

""

controller.image.pullPolicy

控制器镜像拉取策略

IfNotPresent

controller.containerPorts

ks-controller-manager 容器启用的端口列表

[]

controller.resources.limits

ks-controller-manager 容器的资源限制

{}

controller.resources.requests

ks-controller-manager 容器的资源请求

{}

controller.command

覆盖默认容器命令

[]

controller.extraEnvVars

添加到 ks-controller-manager 的额外环境变量数组

[]

controller.extraVolumeMounts

ks-controller-manager 容器的额外 volumeMounts 列表

[]

controller.extraVolumes

ks-controller-manager Pod 的额外 volumes 列表

[]

controller.hardAntiAffinity

是否强制 ks-controller-manager Pod 运行在不同节点上

false

agent.replicaCount

代理副本数量

1

helmExecutor.timeout

Helm 执行器超时时间

10m

helmExecutor.historyMax

Helm 历史记录最大数量

2

helmExecutor.jobTTLAfterFinished

任务完成后的存活时间

0s

helmExecutor.image.registry

Helm 执行器的镜像仓库地址

""

helmExecutor.image.repository

Helm 执行器的镜像命名空间

kubesphereio/kubectl

helmExecutor.image.tag

Helm 执行器镜像标签

v1.27.12

helmExecutor.image.pullPolicy

Helm 执行器镜像拉取策略

IfNotPresent

helmExecutor.resources.limits

Helm 执行器的资源限制

{}

helmExecutor.resources.requests

Helm 执行器的资源请求

{}

helmExecutor.affinity

Helm 执行器的亲和性配置

{}

composedApp.appSelector

用于筛选需要协调的 K8s 应用的选择器

""

kubectl.image.registry

Kubectl 镜像仓库地址

""

kubectl.image.repository

Kubectl 的镜像命名空间

kubesphereio/kubectl

kubectl.image.tag

Kubectl 镜像标签

v1.33.1

kubectl.image.pullPolicy

Kubectl 镜像拉取策略

IfNotPresent

ingress.enabled

启用 Ingress

false

ingress.ingressClassName

Ingress 类名称

""

ingress.tls.enabled

启用 TLS

true

ingress.tls.source

TLS 来源 (生成/导入/Let’s Encrypt)

generation

ingress.tls.secretName

TLS 证书 Secret 名称

kubesphere-tls-certs

letsEncrypt.environment

Let’s Encrypt 环境 (生产/测试)

production

certmanager.duration

证书有效期

2160h

certmanager.renewBefore

证书到期前续订时间

360h

nodeShell.image.registry

Node Shell 镜像仓库地址

""

nodeShell.image.repository

Node Shell 镜像命名空间

kubesphereio/kubectl

nodeShell.image.tag

Node Shell 镜像标签

v1.27.12

nodeShell.image.pullPolicy

Node Shell 镜像拉取策略

IfNotPresent

cloud.enabled

启用云功能

false

cloud.env

云环境

kubesphere.cloud

cloud.customEnv

自定义云环境配置

{}

extension.imageRegistry

扩展组件的镜像注册中心地址

""

extension.nodeSelector

扩展组件的节点选择器

{}

extension.ingress.ingressClassName

扩展组件的 Ingress Class 名称

""

extension.ingress.domainSuffix

为扩展组件自动分配的域名后缀

""

extension.ingress.httpPort

为扩展组件自动分配的 HTTP 端口

80

extension.ingress.httpsPort

为扩展组件自动分配的 HTTPS 端口

443

ha.enabled

启用高可用模式

false

redis.port

Redis 服务端口

6379

redis.replicaCount

Redis 副本数量

1

redis.image.registry

Redis 镜像仓库地址

""

redis.image.repository

Redis 的镜像命名空间

kubesphereio/redis

redis.image.digest

Redis 镜像摘要

""

redis.image.tag

Redis 镜像标签

7.2.4-alpine

redis.image.pullPolicy

Redis 镜像拉取策略

IfNotPresent

redis.persistentVolume.enabled

启用 Redis 持久卷

true

redis.persistentVolume.size

Redis 持久卷大小

2Gi

redisHA.enabled

启用 Redis 高可用

false

redisHA.redis.port

Redis 高可用端口

6379

redisHA.image.registry

Redis 高可用的镜像仓库地址

""

redisHA.image.repository

Redis 高可用的镜像命名空间

kubesphereio/redis

redisHA.image.tag

Redis 高可用的镜像标签

7.2.4-alpine

redisHA.image.digest

Redis 高可用的镜像摘要

""

redisHA.image.pullPolicy

Redis 高可用的镜像拉取策略

IfNotPresent

redisHA.persistentVolume.enabled

启用 Redis 高可用持久卷

true

redisHA.persistentVolume.size

Redis 高可用持久卷大小

2Gi

redisHA.tolerations

Redis 高可用容忍设置

[]

redisHA.hardAntiAffinity

Redis 高可用硬反亲和性

false

redisHA.additionalAffinities

Redis 高可用额外亲和性设置

{}

redisHA.haproxy.servicePort

HAProxy 服务端口

6379

redisHA.haproxy.containerPort

HAProxy 容器端口

6379

redisHA.haproxy.image.registry

HAProxy 镜像仓库地址

""

redisHA.haproxy.image.repository

HAProxy 镜像命名空间

kubesphereio/haproxy

redisHA.haproxy.image.tag

HAProxy 镜像标签

2.9.6-alpine

redisHA.haproxy.image.digest

HAProxy 镜像摘要

""

redisHA.haproxy.image.pullPolicy

HAProxy 镜像拉取策略

IfNotPresent

redisHA.haproxy.hardAntiAffinity

HAProxy 硬反亲和性设置

false

redisHA.haproxy.additionalAffinities

HAProxy 额外亲和性配置

{}

ksCRDs.kubectl.image.registry

CRDs 使用的 kubectl 镜像仓库地址

""

ksCRDs.kubectl.image.repository

CRDs 使用的 kubectl 镜像命名空间

kubesphereio/kubectl

ksCRDs.kubectl.image.tag

CRDs 使用的 kubectl 镜像标签

v1.27.12

ksCRDs.kubectl.image.pullPolicy

CRDs 使用的 kubectl 镜像拉取策略

IfNotPresent

kseExtensionRepository.enabled

启用 KSE 扩展组件仓库

true

kseExtensionRepository.image.registry

扩展仓库的镜像仓库地址

""

kseExtensionRepository.image.repository

扩展仓库的镜像命名空间

kse/extensions-museum

kseExtensionRepository.image.tag

扩展仓库镜像标签

v10.2.3

kseExtensionRepository.image.pullPolicy

扩展仓库镜像拉取策略

IfNotPresent

bool - 启用限流器。

string - 限流器存储类型，可选项："memory"。

float32 - 限流器令牌桶算法中每秒恢复的令牌数。

int - 限流器令牌桶算法中令牌桶的最大容量。