速查：权限点、引用语法与环境变量
最后更新: 2026/11/2
权限点对应的功能、${env:}/${secret:} 引用语法、常用环境变量、健康检查与常用端点的速查表。
权限点速查
| 权限点 |
能做什么 |
system:admin |
用户、角色、登录方式、AI 辅助、导入导出、元数据库、平台设置等「管理系统」全部页面。 |
ops:view |
运维概览、平台日志、集群信息、Prometheus 指标抓取。 |
task:view / task:edit |
查看 / 新建、编辑、发布、运行流程任务；查看凭据与环境变量列表。 |
task:script |
使用 Shell / Python / JS 脚本节点（还需要部署时开启脚本节点）。 |
data:view / data:edit |
查看 / 修改数据源、管道、实时任务、数据服务、检测、对账、清洗规则、通知渠道、事件入口、文件服务器。注意 data:view 允许在连接上执行只读查询。 |
data:sensitive |
查看被标记为敏感的列。 |
secret:manage |
新建、修改、删除凭据。 |
env:manage |
新建、修改、删除环境变量（只应给能管理数据源的人）。 |
recycle:view / recycle:edit |
查看回收站 / 还原、彻底删除、修改保留设置。 |
ai:use |
使用 AI 助手（管理员开启 AI 辅助后）。 |
引用语法速查
| 写法 |
含义 |
可用位置 |
${env:名称} |
环境变量的当前值（非敏感） |
数据源的主机 / 端口 / 库 / 用户名 / JDBC URL；任务节点的文本字段 |
${secret:名称} |
凭据（加密，日志中显示 ******） |
HTTP 节点的地址、请求头、请求体；应用动作的输入 |
${参数名} |
任务参数 / 请求字段 |
节点文本字段、公式 |
${字段} |
当前行的字段值 |
管道字段映射公式、数据转换、实时任务计算列 |
常用环境变量
fdl / FDL_ 是历史内部前缀，不是笔误，请勿改动。完整说明见各章节。
| 变量 |
用途 |
详见 |
FDL_CONNECTION_SECRET_KEY |
数据源凭据加密密钥，必须与元数据库一起备份 |
安装与部署 |
FDL_DATA_DIR |
数据目录：向导配置与密钥、自备驱动（drivers/）、受管文件 |
安装与部署 |
FDL_METADATA_DB_PASSWORD、FDL_DEMO_SOURCE_PASSWORD、FDL_DEMO_DATA |
Docker Compose 的元数据库密码、示例数据源密码与示例数据开关 |
安装与部署 |
FDL_SETUP_TOKEN |
初始化管理员令牌，对公网开放前请设置 |
安装与部署 |
FDL_AUTH_COOKIE_SECURE |
刷新 Cookie 的 Secure 标记，默认 true |
安装与部署 |
FDL_TRUSTED_PROXIES、FDL_HTTP_ALLOWED_ORIGINS |
反向代理与 Origin 白名单 |
安装与部署 |
FDL_SCRIPT_NODES_ENABLED |
是否开启脚本节点（Shell / Python / JS），默认关闭 |
流程任务 |
FDL_OUTBOUND_ALLOWED_HOSTS |
出站调用（HTTP 节点、通知渠道、Webhook）的白名单 |
数据服务 |
FDL_DATA_API_ALLOWED_ORIGINS、FDL_MCP_ALLOWED_ORIGINS |
数据服务与 MCP 的跨域来源白名单 |
数据服务 |
FDL_MCP_OAUTH_ISSUER、FDL_MCP_OAUTH_DCR_ENABLED、FDL_MCP_OAUTH_ACCESS_TTL_SECONDS、FDL_MCP_OAUTH_REFRESH_TTL_SECONDS |
MCP OAuth 的 issuer、动态注册开关与令牌有效期 |
平台 MCP 接入 |
FDL_RUN_RETENTION_DAYS |
运行记录保留天数，默认 90，0 为永久 |
管道任务 |
FDL_PLATFORM_LOG_RETENTION_DAYS、FDL_AUDIT_RETENTION_DAYS |
请求日志（默认 90）与审计记录（默认 180）保留天数 |
监控、告警与审计 |
FDL_PLATFORM_ALERTS_* |
平台健康事件通知 |
监控、告警与审计 |
FDL_AI_COST_*、FDL_AI_BUDGET_* |
AI 成本估算与预算 |
监控、告警与审计 |
FDL_METRICS_GAP_REFRESH_MS |
延迟、租约等 gauge 的刷新间隔，默认 30 秒 |
监控、告警与审计 |
健康检查与常用端点
| 端点 |
用途 |
GET /api/health |
存活；mode=setup 为安装向导，mode=waiting 为等待元数据库 |
GET /api/health/ready |
就绪；完整服务启动后才返回 200 |
GET /api/setup/status |
是否还需要初始化管理员 |
GET /api/ops/cluster |
集群成员、leader 与版本（需要 ops:view） |
GET /api/system/actuator/prometheus |
Prometheus 指标（需要 ops:view） |
POST /mcp |
平台级 MCP |
POST /data/apps/{appId}/services/{serviceId}/invoke |
流程服务调用 |
命令行工具
随发布包提供，位于 tools/ 目录：
| 工具 |
用途 |
tools/backup.sh / tools/restore.sh |
备份与恢复，见 备份与恢复 |
tools/preupgrade-check.sh |
升级前自动体检，见 升级与回滚 |
tools/audit-verify.sh |
审计链校验，见 监控、告警与审计 |
tools/datalink-cli.sh |
配置导出 / 导入，用于跨环境迁移 |
