config.py 配置项速查

想快速查某个平台配置项是干嘛的、默认值多少、在 config.py 哪一行时读这篇(常用项速查,非全量;全量以 config.py 为准)

参考速查 / 配置
配置项config.py配置速查环境变量MAX_TASK_CPUMAX_TASK_MEMMAX_TASK_GPUENABLE_MULTI_TENANTENABLE_RENTALADMIN_USERHUBSECRETREPOSITORY_ORGPUSH_REPOSITORY_ORGCONTAINER_CLIENABLE_INFERENCEPROMETHEUS

config.py 配置项速查

下面是常用配置项速查(默认值与所在行号,行号以 install/docker/config.py 为准,可能随版本偏移)。该文件即部署时挂载进容器的平台配置。 配置文件加载位置见 配置文件管理.md全量配置以部署实例的 install/docker/config.py 为准。

数据库 / 缓存 / 队列

配置项 默认 说明 位置
SQLALCHEMY_DATABASE_URI env MYSQL_SERVICE 元数据库连接串(支持 MySQL/PG/达梦/金仓,见元数据库配置) :398
SQLALCHEMY_POOL_SIZE / SQLALCHEMY_MAX_OVERFLOW 300 / 800 连接池大小/溢出 :386,388
REDIS_HOST / REDIS_PORT / REDIS_PASSWORD env(默认 127.0.0.1/6379/admin) Redis(缓存 + Celery broker) :413-415

认证 / 登录

配置项 默认 说明 位置
AUTH_USER_REGISTRATION False 是否开放自助注册 :68
AUTH_USER_REGISTRATION_ROLE Gamma 新注册用户默认角色 :75
AUTH_PLATFORM_ACCESS False 是否允许短用户名免 token 访问 :73
JWT_PASSWORD myapp API token(JWT) 签名密钥(生产务必修改) :225
AUTH_LDAP_SERVER "" LDAP 兜底登录 :146
OAUTH2_*/CAS_*/FEISHU_*/WECOM_*/DINGTALK_*/WECHAT_* 注释 各 SSO(由 OAUTH_PROVIDERS 等组织,多为注释态),见认证与单点登录配置 auth 段

管理员 / 多租户 / 项目组

配置项 默认 说明 位置
ADMIN_USER admin 运维管理员(接收系统级报警) :690
ENABLE_MULTI_TENANT False 多租户隔离(项目组/机器/存储按租户隔离) :692
ENABLE_SPECIFY_NAMESPACE False 项目组专属命名空间 :710
ENABLE_RENTAL False 机器租赁/计费能力 :712
RENTAL_WORKSPACE_FREE_GB 20 存储租赁:用户 workspace 免费额度(G),额度内不出账 view_storage_lease.py
RENTAL_DATADISK_PRICE_PER_GB_HOUR 0 存储租赁:数据盘单价(¥/GB/小时) view_storage_lease.py
RENTAL_STORAGE_MAX 10000 存储租赁:单盘容量上限(G) view_storage_lease.py
RENTAL_NAMESPACE rental 租赁实例/存储所在命名空间 view_storage_lease.py
ENABLE_BIND_NODE False 是否允许 notebook 指定调度机器 :779

资源限制 / 调度

配置项 默认 说明 位置
MAX_TASK_CPU / MAX_TASK_MEM / MAX_TASK_GPU 50 / 100 / 8 单任务可申请资源上限(核/G/卡) :1079-1081
ENABLE_TASK_QUOTA False 是否启用配额限制 :1084
DEFAULT_POD_RESOURCES dict pod 默认资源 :1238
GPU_RESOURCE / RDMA_RESOURCE / RDMA_RESOURCE_NAME dict / rdma/hca 异构算力与 RDMA 资源映射 :1193,1231,1236
GPU_SCHEDULERNAME default-scheduler GPU 调度器(可换 volcano) :1227

镜像 / 仓库

配置项 默认 说明 位置
HUBSECRET ['hubsecret'] 全局镜像拉取秘钥 :928
REPOSITORY_ORG / PUSH_REPOSITORY_ORG ccr.ccs.tencentyun.com/cube-studio/ 默认拉取/推送组织 :931,933
CONTAINER_CLI docker 容器命令(docker/nerdctl) :1063
NOTEBOOK_IMAGES list 可选 notebook 镜像 :951

推理 / 服务化 / 大模型

配置项 默认 说明 位置
ENABLE_INFERENCE [] 开放的推理类型(空=全开放) :1276
INFERNENCE_IMAGES dict 各 service_type 推理镜像 :1277
SERVICE_EXTERNAL_IP [] 内部服务对外暴露 IP :790
CHATGPT_CHAT_URL / CHATGPT_ARGS / CHATGPT_TOKEN 平台大模型(标注/知识库/网关用),私有化部署须改为自有服务与密钥 :1332-1334

监控

配置项 默认 说明 位置
PROMETHEUS prometheus-k8s.monitoring:9090 Prometheus 地址 :761
GRAFANA_*_PATH 各 Grafana 看板链接(pod/service/cluster/node) :1317-1323

任务模板 / pipeline / 存储 / serverless

配置项 默认 说明 位置
ENABLE_JOB_TEMPLATE [] 开放的任务模板(空=全开放) :1096
ENABLE_PIPELINE_IMMUTABLE False pipeline 固化为菜单能力 :1094
ENABLE_APPROVAL dict 审批开关 :1087
CRD_INFO dict 各 CRD(vcjob/tfjob/pytorchjob 等)定义 :1099
STORE_TYPE / STORE_CONFIG "" / dict 备份存储 :1256-1257
ENABLE_ALIYUN_SERVERLESS / ENABLE_TKE_SERVERLESS / ENABLE_EDGE_K8S False serverless / 边缘集群模式 :775-778
ENABLE_JUPYTER_EXPIRY 3 天 notebook 有效期(到期自动处理) :942

定时任务(celery beat)相关见 定时任务与自动清理.md。 本表只收常用项;某配置项未列出时,直接在 myapp/config.py 检索其名称即可。

最后更新 2026-08-24完整文档以官方仓库为准:GitHub Wiki