变量参考 — 数据湖读取的内容
此处仅收录了数据湖容器实际读取的变量。默认值的权威来源在容器内的 plantpulse-datalake-cli/config/defaults.env 中，从主机传入的值会覆盖它。主机端的全部值（包括 DOCKER_*）见环境变量参考。
下表「是否可在主机更改」列中为否的变量，即使在 sidecar 中定义也不会传入容器。因为 compose 不会将这些名称传给数据湖。其值由 defaults.env 或模板决定。
密钥 — 若缺失会怎样
pd 已知的密钥分为三个列表。这些值在任何地方都没有默认值，只能通过 sidecar → compose → 环境变量的路径传入。
| 列表 | 变量 | 若缺失 |
|---|---|---|
| 必需 | PP_REDIS_PASSWORD PP_PG_PASSWORD PP_CASSANDRA_PASSWORD PP_S3_PASSWORD PP_MQ_PASSWORD PP_TSE_PASSWORD PP_SPARK_PASSWORD PP_HIVE_PASSWORD PP_GRAVITINO_PASSWORD PP_TEMPORAL_PASSWORD PP_KESTRA_DB_PASSWORD PP_KESTRA_ADMIN_PASSWORD PP_TLS_KEYSTORE_PASSWORD PP_CEP_API_KEY PP_DATA_GATEWAY_API_KEY | pd start 会以 exit 3 退出，并列出所有缺失的名称。compose 也会通过 :? 强制要求，导致栈根本无法启动 |
| Worker 附加项 | PP_PG_REPLICA_PASSWORD | 仅在 WORKER 节点上必需 |
| 可选 | PP_DATALAKE_ADMIN_PASSWORD PP_DATALAKE_ADMIN_API_KEY PP_DATA_GATEWAY_WEB_PASSWORD PP_CEP_WEB_PASSWORD | 仅该功能会被禁用。栈正常启动。pd doctor 会告知名称 |
更改方法见更改密码 · API 密钥。三个派生值（PP_TLS_TRUSTSTORE_PASSWORD · PP_REDIS_TRUSTSTORE_PASSWORD · PP_MQ_TRUSTSTORE_PASSWORD）由密钥库密码生成，无需单独设置。
节点 · 地址
| 变量 | 默认值 | 含义 | 是否可在主机更改 |
|---|---|---|---|
PP_MODE | MASTER | MASTER / WORKER。Worker 由 worker-add.sh 决定 | 节点文件 |
PP_HOST_IP | 10.99.0.100（compose 网络固定 IP） | 此容器的地址。广告地址的基础 | 通过 DOCKER_PP_IP |
PP_MASTER_IP | PP_HOST_IP | 其他盒子连接此数据湖的地址 | 节点文件 |
PP_SERVICE_IP | 空值 | NAT 后的公网 IP。会包含在 TLS SAN 中 | 通过节点文件 DOCKER_PP_EXTERNAL_IP |
PP_KAFKA_ADVERTISED_HOST | 启动时推导 | Kafka 向客户端通告的地址 | 节点文件（仅在 NAT 或第二接口时） |
PP_CLUSTER_CORES | 主机核心数 − 2 (4 ~ 30) | 通告给 Spark 等应用的核心数 | DOCKER_PP_CLUSTER_CORES |
PP_DATA_DISK_NAME | 从主机检测 | 用于测量磁盘使用率的设备 | DOCKER_PP_DATA_DISK_NAME |
PP_DATA_DIR · PP_TEMP_DIR · PP_BACKUP_DIR | /data1/pp-data · /data1/pp-temp · /data1/pp-backup | 卷挂载位置 | 否（compose 字面量） |
PP_LANG · PP_TZ | en · Asia/Seoul | 语言 · 时区 | sidecar |
存储库
| 变量 | 默认值 | 是否可在主机更改 |
|---|---|---|
PP_REDIS_USER · PP_REDIS_PORT | redis · 6379 | 仅账户名（端口不可） |
PP_PG_USER · PP_POSTGRES_PORT · PP_DB_NAME | plantpulse · 5432 · pp | 账户名 · 数据库名（端口不可） |
PP_CASSANDRA_USER · PP_CASSANDRA_PORT · PP_KEYSPACE | cassandra · 9042 · pp | 账户名 · 键空间（端口不可） |
PP_S3_USER · PP_S3_PORT · PP_S3_BUCKET | rustfs · 9000 · plantpulse | 仅账户名 |
PP_PG_REPLICA_USER | replica | sidecar |
PP_KEYSPACE · PP_DB_NAME · PP_TOPIC_PREFIX 是由数据湖创建、应用读取的标识符，因此它们被放置在 compose 的 x-pp-secrets 锚点中，以同时作用于两端。安装后更改它们将创建新名称的空存储库，而旧数据仍留在旧名称下。
分析 · 消息传递 · 时序 · 工作流
| 变量 | 默认值 | 是否可在主机更改 |
|---|---|---|
PP_HIVE_USER · PP_HIVE_PORT · PP_HIVE_DB | hive · 9083 · hive-metastore-230 | 仅账户名 |
PP_SPARK_USER · PP_SPARK_PORT · PP_SPARK_WEBUI_PORT · PP_KYUUBI_PORT | spark · 7077 · 4440 · 10000 | 仅账户名 |
PP_GRAVITINO_USER · PP_GRAVITINO_ICEBERG_REST_PORT | gravitino · 19001 | 仅账户名 |
PP_MQ_USER · PP_TOPIC_PREFIX | mq · pp | sidecar |
PP_KAFKA_PORT · PP_KAFKA_TLS_PORT · PP_KAFKA_CONTROLLER_PORT | 9092 · 9094 · 9093 | 否 |
PP_MQTT_PORT · PP_MQTT_TLS_PORT | 1883 · 1884 | 否 |
PP_TSE_USER · PP_TSE_PORT · PP_TSE_TLS_PORT · PP_TSE_PROTOCOL | tse · 7800 · 7801 · http | 仅账户名 |
PP_TSE_DATAPOINT_TTL | 31536000（365 天） | 否 — 通过模板编辑 |
PP_TEMPORAL_USER · PP_TEMPORAL_PORT | temporal · 7233 | 仅账户名 |
PP_KESTRA_DB_USER · PP_KESTRA_ADMIN_EMAIL · PP_KESTRA_PORT | kestra · admin@plantpulse.io · 8380 | 账户名 · 电子邮件 |
PP_CEP_PORT · PP_CEP_TLS_PORT · PP_CEP_PROTOCOL | 7400 · 7401 · http | 否 |
PP_DATA_GATEWAY_PORT · PP_DATA_GATEWAY_TLS_PORT · PP_DATA_GATEWAY_PROTOCOL | 5500 · 5501 · http | 否 |
PP_TSE_DATAPOINT_TTL — 时序单点的生命周期时序引擎在每次写入时记录此 TTL（INSERT … USING TTL）。因此，更改值后，将只对新写入的行生效，已写入的行仍按旧值过期。上调不会使数据复活，下调也不会缩短过期时间。要更改，请修改 /etc/kopens/conf/plantpulse-timeseries-engine.conf.template。
管理控制台 · 查询控制台
| 变量 | 默认值 | 含义 | 是否可在主机更改 |
|---|---|---|---|
PP_DATALAKE_ADMIN_USER | admin | 管理控制台登录名 | sidecar |
PP_DATALAKE_ADMIN_PASSWORD | sidecar 决定 | 管理控制台密码。若为空，仅禁用控制台 | passwd.sh |
PP_DATALAKE_ADMIN_API_KEY | 无 | 日志端点的 X-API-Key。若为空，仅禁用密钥认证 | passwd.sh |
PP_DATALAKE_ADMIN_PORT | 4949 | 容器内监听端口。4950 是同一控制台的 TLS | 否 |
PP_DATALAKE_ADMIN_LOGS_ENABLED | true | 若为 false，仅控制台日志界面会离线 | sidecar |
PP_DATA_GATEWAY_WEB_USER · PP_DATA_GATEWAY_WEB_PASSWORD | admin · 无 | 数据网关控制台(SQL)登录。若为空，仅禁用该控制台 | sidecar |
PP_CEP_WEB_USER · PP_CEP_WEB_PASSWORD | admin · 无 | CEP 控制台登录。若为空，仅禁用该控制台 | sidecar |
PP_BACKUP_SCHEDULE_ENABLED | true | 备份定时器全局开关 | sidecar |
其他控制台设置组（PP_DATALAKE_ADMIN_PD_PATH · PP_DATALAKE_ADMIN_LOG_ROOT · PP_DATALAKE_ADMIN_BACKUP_HISTORY）由 compose 以字面量方式注入。无需更改。
TLS
| 变量 | 默认值 | 含义 |
|---|---|---|
PP_TLS_ENABLED | true | 主开关 |
PP_TLS_CERT_DIR | /var/security/plantpulse | 证书目录 |
PP_TLS_DOMAIN · PP_TLS_VALID_DAYS | plantpulse.io · 3650 | 证书域名 · 有效期 |
PP_TLS_SAN_IPS · PP_TLS_SAN_DNS | 主机 IP · 主机名 | 证书 SAN。必须包含外部连接 IP |
PP_TLS_NODE_NAMES · PP_MAX_WORKERS | master worker-1 … worker-5 · 5 | 每个 Worker 一个证书。两者必须匹配才能通过构建 |
证书本身由 plantpulse-certs 容器创建 → 安全设置
以 PD_ 开头的变量
PD_ 是数据湖的「局部变量」。操作员可以设置的仅有两个，其余约 270 个是脚本内部变量或镜像内置的戳记。
| 变量 | 含义 |
|---|---|
PD_HOME | pd 存放的树。由镜像确定 |
PD_OPTIONS | 组件 on/off JSON — {"enable-hive": false}。省略的键默认开启。当前 compose 栈不会将此值传给容器 → FAQ |
PD_IMAGE_TAG · PD_IMAGE_BUILD_VERSION · PD_IMAGE_BUILT_AT · PD_IMAGE_VCS_REF | 镜像戳记。请勿修改 — 否则 pd env · pd doctor 提供的来源将变为不实 |