环境变量说明

本文说明 FastGPT 自部署时常用服务的环境变量。projects/app 与 pro/admin 会大量复用 packages/service/env.ts 中的服务端配置，因此数据库、密钥、对象存储、向量库等变量合并说明；只有 projects/app 或 pro/admin 自己读取的变量单独列出。

说明

projects/app：主应用服务，包含 Next.js 页面、API 路由、工作流、知识库、对象存储、向量库等能力。
pro/admin：商业版 Admin 服务。除自己的后台功能变量外，也会复用 App/Service 的数据库、密钥、对象存储、模型、日志等变量。
projects/code-sandbox：代码沙箱服务，对外暴露 /sandbox 执行接口，供 App 通过 CODE_SANDBOX_URL 调用。
代码中 packages/service/env.ts 导出名为 serviceEnv，projects/app/src/env.ts 导出名为 appEnv。
App/Admin 共享布尔变量使用 true、1、yes 或 y 表示开启；其他值视为关闭。
「已弃用」列标记不再读取的历史变量，弃用版本与替代变量见对应说明。
FILE_TOKEN_KEY、AES256_SECRET_KEY 与 INVOKE_TOKEN_SECRET 为运行期必填，建议使用随机强密钥，不要使用示例值。

App/Admin 共享变量

这些变量主要由 packages/service/env.ts 校验，适用于 projects/app，也适用于会导入 @fastgpt/service 的 pro/admin。注意：packages/service/env.ts 当前也包含少量 App 侧开关；这类变量在下方 projects/app 额外变量中单独列出。

基础与密钥

变量	默认值	已弃用	说明
`DB_MAX_LINK`	`10`	-	MongoDB、PG、OceanBase、openGauss 等数据库连接池最大连接数，自动限制在 10～1000。
`SYNC_INDEX`	`true`	-	是否在启动时创建缺失的 MongoDB 索引并清理显式声明的废弃索引；关闭后需自行维护索引。
`FILE_TOKEN_KEY`	无，必填	-	文件读取、文件鉴权相关密钥，长度至少 6 位。
`AES256_SECRET_KEY`	无，必填	-	AES 加解密密钥，长度至少 6 位。
`INVOKE_TOKEN_SECRET`	无，必填	-	Invoke 反向调用 JWT 密钥，长度至少 32 位。
`ROOT_KEY`	`fastgpt_root_key`	-	当前系统管理员 API 密钥，可用于调用 `/api/admin/**` 接口，长度至少 6 位。
`PRO_TOKEN`	空	-	FastGPT app 服务端调用 pro/admin 内部接口的凭证，需与 pro/admin 配置一致；App 配置 `PRO_URL` 时必填。
`PRO_URL`	空	-	商业版服务地址，配置后 App 可调用 Pro API，也会作为文件 URL 安全校验允许域名。

服务地址与集成

从 V4.17.0 起，AI Proxy 为必需依赖。App 和复用 App/Service 配置的 Admin 服务都必须设置 AIPROXY_API_ENDPOINT 和非空的 AIPROXY_API_TOKEN；缺少任一项会导致启动校验失败。旧 OpenAI 环境变量或单模型自定义请求地址不能替代这两个配置。

变量	默认值	已弃用	说明
`PLUGIN_BASE_URL`	`http://localhost:3004`	-	FastGPT Plugin 服务地址；部署模板通常会配置为内部 Plugin 服务地址。
`PLUGIN_TOKEN`	`token`	-	调用 Plugin 服务使用的认证 Token；需与 Plugin 服务配置一致。
`CODE_SANDBOX_URL`	`http://localhost:3002`	-	Code Sandbox 服务地址；部署模板通常会配置为内部 Code Sandbox 服务地址。
`CODE_SANDBOX_TOKEN`	`codesandbox`	-	App 调用 Code Sandbox 时使用的认证 Token，需与沙箱服务 `SANDBOX_TOKEN` 一致。
`AIPROXY_API_ENDPOINT`	无，必填	-	AI Proxy 服务根地址，例如 `http://aiproxy:3000`，不要附加 `/v1`。
`AIPROXY_API_TOKEN`	无，必填	-	AI Proxy 管理员 Token，必须与服务端配置一致且不能为空。
`CRM_API_URL`	空	-	官网访客归因 CRM 的 API 基础地址（包含 `/api/v1`）；为空时不进行身份上报。
`CRM_API_KEY`	空	-	CRM 管理 API Key，用于注册或登录成功后按 `visitor_id` 绑定 FastGPT 用户。
`MARKETPLACE_URL`	`https://v2.marketplace.fastgpt.cn`	-	插件市场接口地址。
`FEISHU_BASE_URL`	`https://open.feishu.cn`	-	飞书开放平台地址，私有化飞书可改为对应域名。
`DINGTALK_BASE_URL`	`https://api.dingtalk.com`	-	钉钉新版 API 基础地址。
`DINGTALK_OAPI_BASE_URL`	`https://oapi.dingtalk.com`	-	钉钉 OAPI 基础地址。
`YUQUE_DATASET_BASE_URL`	`https://www.yuque.com`	-	语雀知识库地址。

Agent Sandbox

变量	默认值	已弃用	说明
`AGENT_SANDBOX_PROVIDER`	空	-	Agent 沙箱提供方，可选 `sealosdevbox`、`opensandbox`；为空时不启用沙箱。配置后必须同时配置对应 provider 的必填变量；启用 OpenSandbox 时请参考 OpenSandbox 配置；`fastgpt-app` 还需要三项 Proxy 变量，`fastgpt-pro` 只需要预览 Proxy URL。
`AGENT_SANDBOX_SEALOS_BASEURL`	空	-	Sealos Devbox 服务地址。
`AGENT_SANDBOX_SEALOS_TOKEN`	空	-	Sealos Devbox 访问 Token。
`AGENT_SANDBOX_SEALOS_WORK_DIRECTORY`	`/home/devbox/workspace`	-	Sealos Devbox 沙箱内工作目录。
`AGENT_SANDBOX_SEALOS_IMAGE`	空	-	Sealos Devbox 使用的运行态镜像；启用 `sealosdevbox` 时必填。
`AGENT_SANDBOX_OPENSANDBOX_BASEURL`	空	-	OpenSandbox 服务地址。
`AGENT_SANDBOX_OPENSANDBOX_API_KEY`	空	-	OpenSandbox API Key；启用 OpenSandbox 时必填，并且必须与 OpenSandbox server 的 `[server].api_key` 一致。
`AGENT_SANDBOX_OPENSANDBOX_RUNTIME`	`docker`	-	OpenSandbox 运行时，可选 `docker` 或 `kubernetes`。
`AGENT_SANDBOX_OPENSANDBOX_IMAGE`	空	-	OpenSandbox 使用的完整运行态镜像；启用 `opensandbox` 时必填。
`AGENT_SANDBOX_OPENSANDBOX_USE_SERVER_PROXY`	`true`	-	OpenSandbox 是否通过服务端代理访问。
`AGENT_SANDBOX_OPENSANDBOX_VOLUME_MANAGER_URL`	空	-	OpenSandbox 模式下必填，Volume Manager 服务地址。
`AGENT_SANDBOX_OPENSANDBOX_VOLUME_MANAGER_TOKEN`	空	-	OpenSandbox 模式下必填，Volume Manager 认证 Token。
`AGENT_SANDBOX_OPENSANDBOX_VOLUME_NAME_PREFIX`	`fastgpt-session`	-	FastGPT app 生成 OpenSandbox 持久卷 `claimName` 时使用的前缀；升级时需沿用旧 `VM_VOLUME_NAME_PREFIX` 的值。
`AGENT_SANDBOX_PROXY_SECRET`	空	-	agent-sandbox-proxy 与主站共用的 HMAC 密钥；`fastgpt-app` 启用 Agent Sandbox 时必填，至少 32 字节。
`AGENT_SANDBOX_PROXY_URL`	空	-	浏览器访问 agent-sandbox-proxy 的 WebSocket 地址；`fastgpt-app` 启用 Agent Sandbox 时必填，必须以 `ws://` 或 `wss://` 开头。
`AGENT_SANDBOX_PREVIEW_PROXY_URL`	空	-	浏览器访问 Sandbox 文件预览的 HTTP(S) 地址；`fastgpt-app` 和 `fastgpt-pro` 启用 Agent Sandbox 时都必须增加。建议使用与 FastGPT 主站不同的 origin。
`AGENT_SANDBOX_FREE_TIP`	`false`	-	前端是否展示 Agent Sandbox 免费提示。
`AGENT_SANDBOX_STORAGE_SIZE_GI`	`1`	-	Agent Sandbox 存储容量，单位 Gi；FastGPT 根据该值计算归档、Skill 和单文件限制。
`AGENT_SANDBOX_SUSPEND_MINUTES`	`60`	-	运行中的 Agent 沙箱持续未活跃多少分钟后自动暂停。
`AGENT_SANDBOX_ARCHIVE_INACTIVE_DAYS`	`7`	-	已暂停的 Agent 沙箱持续未活跃多少天后自动归档。
`AGENT_SANDBOX_MAX`	`100`	-	Agent 沙箱活跃实例系统总上限（app 会话与技能编辑共用同一计数池）。
`AGENT_SANDBOX_MAX_EDIT_DEBUG`	`100`（历史默认值）	✅	活跃编辑/调试沙盒数量上限。自 V4.17.3 起弃用，不再读取该变量；请改用 `AGENT_SANDBOX_MAX`。
`AGENT_SANDBOX_MAX_PER_TEAM`	空	-	单团队 Agent 沙箱活跃实例配额；为空表示不限制。
`AGENT_SANDBOX_NPM_REGISTRY`	空	-	Agent 沙箱内 npm、yarn、pnpm、bun 使用的 npm registry。
`AGENT_SANDBOX_PYPI_INDEX_URL`	空	-	Agent 沙箱内 pip、`python -m pip`、uv 使用的 PyPI index URL。
`AGENT_SANDBOX_APT_MIRROR`	空	-	Ubuntu 或 Debian Agent 沙箱内使用的 apt 镜像地址（可选），仅 root 权限的 Agent 沙箱有效。

数据库、缓存与向量库

变量	默认值	已弃用	说明
`REDIS_URL`	`redis://default:mypassword@localhost:6379`	-	Redis 连接地址。
`STREAM_RESUME_TTL_SECONDS`	`300`	-	流式恢复镜像在生成中的 TTL，单位秒。
`STREAM_RESUME_POST_COMPLETE_TTL_SECONDS`	`30`	-	流结束后恢复镜像的缩短 TTL，单位秒。
`STREAM_RESUME_REDIS_MAXMEMORY_RATIO`	`0.5`	-	Redis 已用内存与 `maxmemory` 比例达到该值后，不再创建新的流恢复镜像。
`STREAM_RESUME_REDIS_MEMORY_CHECK_INTERVAL_MS`	`5000`	-	Redis 内存水位检测缓存时间，单位毫秒。
`MONGODB_URI`	本地 MongoDB 示例地址	-	主业务 MongoDB 连接地址。
`MONGODB_LOG_URI`	同 `MONGODB_URI` 示例地址	-	日志 MongoDB 连接地址；不配置时可复用主库。
`VECTOR_VQ_LEVEL`	`32`	-	向量量化等级；不同向量库支持范围不同。
`PG_URL`	空	-	PostgreSQL/pgvector 向量库连接地址。
`OCEANBASE_URL`	空	-	OceanBase 向量库连接地址。
`SEEKDB_URL`	空	-	SeekDB 向量库连接地址。
`MILVUS_ADDRESS`	空	-	Milvus/Zilliz 连接地址。
`MILVUS_TOKEN`	空	-	Milvus/Zilliz 访问 Token。
`MILVUS_LANGUAGE_IDENTIFIER`	`lingua`	-	Milvus BM25 全文检索的语言识别引擎：`lingua`（默认）\| `whatlang`。当向量库为 Milvus 时全文检索走 BM25（`modeldata_v2` 单表）；其他向量库全文走 MongoDB `$text`。
`OPENGAUSS_URL`	空	-	openGauss 向量库连接地址。

对象存储

变量	默认值	已弃用	说明
`STORAGE_VENDOR`	`minio`	-	对象存储类型，可选 `minio`、`aws-s3`、`r2`、`cos`、`oss`。
`STORAGE_PUBLIC_BUCKET`	`fastgpt-public`	-	公开文件 Bucket。
`STORAGE_PRIVATE_BUCKET`	`fastgpt-private`	-	私有文件 Bucket。
`STORAGE_REGION`	`us-east-1`	-	对象存储 Region。
`STORAGE_EXTERNAL_ENDPOINT`	空	-	外部可访问的对象存储地址，用于浏览器或外部服务访问。
`STORAGE_R2_PUBLIC_ENDPOINT`	空	-	Cloudflare R2 公开 bucket 的 HTTPS 公网域名；`STORAGE_VENDOR=r2` 时必填。
`STORAGE_S3_CDN_ENDPOINT`	空	-	`short-redirect` 临时下载地址使用的 CDN 地址；配置时必须同时配置 `STORAGE_EXTERNAL_ENDPOINT`。
`STORAGE_DOWNLOAD_URL_MODE`	`short-proxy`	-	下载模式，可选 `short-proxy` 或 `short-redirect`；对外始终返回 FastGPT 短链。
`STORAGE_DOWNLOAD_REDIRECT_TTL_SECONDS`	`300`	-	`short-redirect` 模式下临时对象存储/CDN 下载地址的有效时间，单位秒。
`STORAGE_S3_ENDPOINT`	`http://localhost:9000`	-	S3/MinIO 兼容 API 地址。
`STORAGE_PUBLIC_ACCESS_EXTRA_SUB_PATH`	空	-	公开文件访问路径的额外子路径。
`STORAGE_ACCESS_KEY_ID`	`minioadmin`	-	对象存储 Access Key。
`STORAGE_SECRET_ACCESS_KEY`	`minioadmin`	-	对象存储 Secret Key。
`STORAGE_S3_FORCE_PATH_STYLE`	`false`	-	S3 是否强制 path-style 访问，MinIO 通常需要开启。
`STORAGE_S3_MAX_RETRIES`	`3`	-	S3 客户端最大重试次数。
`STORAGE_COS_PROTOCOL`	`https:`	-	腾讯云 COS 访问协议，可选 `https:` 或 `http:`。
`STORAGE_COS_USE_ACCELERATE`	`false`	-	腾讯云 COS 是否使用全球加速域名。
`STORAGE_COS_CNAME_DOMAIN`	空	-	腾讯云 COS 自定义 CNAME 域名。
`STORAGE_COS_PROXY`	空	-	腾讯云 COS 代理地址。
`STORAGE_OSS_ENDPOINT`	空	-	阿里云 OSS Endpoint。
`STORAGE_OSS_CNAME`	`false`	-	阿里云 OSS 是否使用 CNAME。
`STORAGE_OSS_INTERNAL`	`false`	-	阿里云 OSS 是否使用内网 Endpoint。
`STORAGE_OSS_SECURE`	`false`	-	阿里云 OSS 是否使用 HTTPS。
`STORAGE_OSS_ENABLE_PROXY`	`true`	-	阿里云 OSS 是否启用代理访问。

日志、指标与追踪

变量	默认值	已弃用	说明
`LOG_ENABLE_CONSOLE`	`true`	-	是否输出控制台日志。
`LOG_CONSOLE_LEVEL`	`debug`	-	控制台日志等级，可选 `trace`、`debug`、`info`、`warning`、`error`、`fatal`。
`LOG_DEPTH`	`3`	-	历史模板变量，用于日志对象展开深度；当前新版结构化日志主要使用日志等级配置。
`LOG_ENABLE_OTEL`	`false`	-	是否启用 OpenTelemetry 日志上报。
`LOG_OTEL_LEVEL`	`info`	-	OTEL 日志等级。
`LOG_OTEL_SERVICE_NAME`	`fastgpt-client`	-	OTEL 日志服务名。
`LOG_OTEL_URL`	空	-	OTEL 日志上报地址。
`METRICS_ENABLE_OTEL`	`false`	-	是否启用 OpenTelemetry 指标上报。
`METRICS_EXPORT_INTERVAL`	`30000`	-	指标导出间隔，单位毫秒。
`METRICS_OTEL_SERVICE_NAME`	`fastgpt-client`	-	OTEL 指标服务名。
`METRICS_OTEL_URL`	空	-	OTEL 指标上报地址。
`TRACING_ENABLE_OTEL`	`false`	-	是否启用 OpenTelemetry 链路追踪。
`TRACING_OTEL_SERVICE_NAME`	`fastgpt-client`	-	OTEL 追踪服务名。
`TRACING_OTEL_URL`	空	-	OTEL 追踪上报地址。
`TRACING_OTEL_SAMPLE_RATIO`	空	-	追踪采样比例，范围 `0` 到 `1`。
`CHAT_LOG_URL`	空	-	对话日志推送服务地址；为空时不推送。
`CHAT_LOG_INTERVAL`	空	-	对话日志批量推送间隔，单位毫秒。
`CHAT_LOG_SOURCE_ID_PREFIX`	`fastgpt-`	-	对话日志来源 ID 前缀。
`TRACK_BATCH_UPDATE_TIME`	`10000`	-	事件计数批量写入间隔，单位毫秒。

域名、前端与运行时

变量	默认值	已弃用	说明
`FE_DOMAIN`	必填	-	客户端访问 FastGPT 时使用的地址（由协议、主机和可选端口组成），用于补全文件、图片等资源路径；本地开发可使用 `http://localhost:3000`。
`FILE_DOMAIN`	空	-	文件访问域名，通常也指向 FastGPT 服务；可独立域名隔离文件风险。
`FILE_URL_EXPIRED_DAYS`	`90`	-	聊天记录中持久化文件访问短链的有效期，单位天，支持小数。
`NEXT_PUBLIC_BASE_URL`	空	-	Next.js 子路径部署前缀，例如 `/fastgpt`；需要在构建镜像时确定。
`HOSTNAME`	`localhost`	-	服务本机 Host，用于内部 URL 与 SSRF 本地地址识别；容器中常设为 `0.0.0.0`。
`PORT`	`3000`	-	Next.js 服务监听端口，也用于本地地址识别。
`NODE_ENV`	空	-	标准 Node/Next.js 运行环境变量，生产镜像中为 `production`。
`NEXT_TELEMETRY_DISABLED`	`1`	-	生产镜像中关闭 Next.js Telemetry。
`NODE_OPTIONS`	`--max-old-space-size=4096`	-	生产镜像构建阶段使用的 Node.js 启动参数，用于提高构建内存上限。

安全配置

变量	默认值	已弃用	说明
`USE_IP_LIMIT`	`false`	-	是否启用部分接口的 IP 限流。
`CHECK_INTERNAL_IP`	`false`	-	是否启用内网 IP 检查，用于降低 SSRF 风险。仅作用于用户或工作流可控的出站 URL；部署方配置的服务地址（SSO/外部用户系统、模型地址、飞书/钉钉/语雀基础地址、自定义 PDF 解析、自定义安全校验、快速登录、对话日志、短信代理、发票 Webhook、企业认证等）不受影响。
`AUTH_COOKIE_SECURE`	`false`	-	是否为登录 Cookie 添加 `Secure` 属性；仅在全站 HTTPS 时启用。
`TRUSTED_PROXY_ENABLE`	`false`	-	是否启用可信反向代理客户端 IP 校验；关闭时兼容旧逻辑。
`TRUSTED_PROXY_IPS`	空	-	可信反向代理 IP/CIDR 列表，逗号或空白分隔。
`PASSWORD_LOGIN_MINUTE_LIMIT_COUNT`	`10`	-	单账号每分钟允许的密码登录请求次数。
`MAX_LOGIN_SESSION`	`10`	-	单账号最大登录客户端数量。
`ALLOWED_ORIGINS`	空	-	允许跨域来源，多个来源使用英文逗号分隔；为空默认允许所有跨域。
`MULTIPLE_DATA_TO_BASE64`	`false`	-	是否强制将图片转成 base64 传递给模型。
`DISABLE_CACHE`	`false`	-	是否关闭系统缓存命中，主要用于调试。
`HTTP_PROXY`	空	-	Node/worker 出站 HTTP 代理。
`HTTPS_PROXY`	空	-	Node/worker 出站 HTTPS 代理。
`NO_PROXY`	空	-	不走代理的地址列表。
`ALL_PROXY`	空	-	通用出站代理。

功能开关与限制

变量	默认值	已弃用	说明
`AGENT_ENGINE`	`fastAgent`	-	Agent 引擎，可选 `fastAgent` 或 `piAgent`。
`DEFAULT_TEAM_BASIC_PERMISSIONS_ENABLED`	`false`	-	新建团队时是否为默认全员组授予应用、Skill 和知识库创建权限，不影响已有团队。FastGPT 与 Pro Admin 服务应保持配置一致。
`SKIP_FILE_TYPE_CHECK`	`false`	-	是否跳过上传文件类型检查。
`WECHAT_CHANNEL_CONCURRENCY`	`1000`	-	微信渠道 poll worker 并发数，最小 `10`。
`SYSTEM_MIGRATION_BATCH_SIZE`	`100`	-	系统迁移任务每批处理的记录数，范围 `50`～`1000`。
`SYSTEM_MIGRATION_DELAY_SECONDS`	`0`	-	配置了 delay 的系统迁移任务延迟执行时间，单位秒，默认 `0` 为不延迟。
`XLSX_PARSE_MAX_ROWS`	`100000`	-	XLSX 单个工作表允许的最大绝对行号，范围 `1`～`1048576`。
`XLSX_PARSE_MAX_COLUMNS`	`1000`	-	XLSX 单个工作表允许的最大绝对列号，范围 `1`～`16384`。
`XLSX_PARSE_MAX_CELLS`	`1000000`	-	XLSX 工作簿允许的累计范围单元格数，最小 `1`。
`XLSX_PARSE_MAX_MERGED_CELLS`	`1000000`	-	XLSX 工作簿允许的累计合并单元格回填量，最小 `1`。
`PARSE_FILE_TIMEOUT_SECONDS`	`600`	-	文件解析单任务超时时间，单位秒。
`WORKFLOW_MAX_RUN_TIMES`	`500`	-	工作流最大运行次数，避免极端死循环。
`WORKFLOW_MAX_LOOP_TIMES`	`100`	-	循环/并行节点最大输入数组长度。
`WORKFLOW_PARALLEL_MAX_CONCURRENCY`	`10`	-	并行节点并发上限，且不能超过 `WORKFLOW_MAX_LOOP_TIMES`。
`SYSTEM_MAX_STRING_LENGTH_M`	`100`	-	系统变量替换等同步字符串处理最大字符数，单位 M；`1` 表示 `1,000,000` 字符，范围 `1` 到 `100`。
`CHAT_MAX_QPM`	`5000`	-	聊天 QPM 限制；若用户套餐另有限制，以套餐限制为准。
`SERVICE_REQUEST_MAX_CONTENT_LENGTH`	`10`	-	服务端接收请求体最大大小，单位 MB。
`MAX_FOLDER_DEPTH`	`4`	-	允许的最深文件夹层级，根目录下最多 4 层文件夹；范围 `2` 到 `20`。
`APP_FOLDER_MAX_AMOUNT`	`1000`	-	应用文件夹最大数量。
`DATASET_FOLDER_MAX_AMOUNT`	`1000`	-	数据集文件夹最大数量。
`UPLOAD_FILE_MAX_SIZE`	`1000`	-	最大上传文件大小，单位 MB。
`UPLOAD_FILE_MAX_AMOUNT`	`1000`	-	最大上传文件数量。
`LLM_REQUEST_TRACKING_RETENTION_HOURS`	`6`	-	LLM 请求追踪保留时长，单位小时。
`MAX_HTML_TRANSFORM_CHARS`	`1000000`	-	HTML 转 Markdown 的最大字符数，超过后不转换。

App 额外变量

以下变量主要由 projects/app 读取。其中部分变量当前定义在 packages/service/env.ts 中做统一校验，但实际消费点仍在 App 层。

变量	默认值	已弃用	说明
`DEFAULT_ROOT_PSW`	`123456`	-	初始化 root 用户默认密码。
`SYSTEM_NAME`	`AI`	-	页面标题默认系统名。
`SYSTEM_DESCRIPTION`	空	-	页面 Meta 描述，不配置时使用默认国际化文案。
`SYSTEM_FAVICON`	空	-	页面 favicon 地址，不配置时使用系统配置中的 favicon。
`CHINESE_IP_REDIRECT_URL`	空	-	前端配置中的中国 IP 跳转地址。
`PAY_FORM_URL`	空	-	前端配置中的付费表单地址。
`DISABLE_MARKETPLACE`	`false`	-	是否隐藏插件市场安装入口；设为 `true` 时仅保留本地文件安装。
`SHOW_COUPON`	`false`	-	是否展示兑换码功能。
`SHOW_DISCOUNT_COUPON`	`false`	-	是否展示优惠券功能。
`HIDE_CHAT_COPYRIGHT_SETTING`	`false`	-	是否隐藏版权信息配置项。
`WECOM_LOGIN_AUTO_REDIRECT`	`false`	-	是否允许企微终端自动跳转登录。
`APP_REGISTRATION_URL`	空	-	应用备案申请地址；当前主要作为兼容配置保留。
`PASSWORD_EXPIRED_MONTH`	空	-	密码过期月份数；为空表示不过期。
`OPENAPI_KEY_MAX_COUNT`	`100`	-	单个团队成员最多可创建的系统 API Key 数量，最小值为 1。
`SSE_MCP_SERVER_PROXY_ENDPOINT`	空	-	MCP SSE Server 代理地址，末尾不要带 `/`。发布 SSE MCP 应用时需要配置。

开源版特有

从 4.15.0 起，开源版不再读取 config.json。如果从旧版本升级，请删除该文件的 volume 挂载，并按下表将原配置改为环境变量。没有使用过这些可选配置时，无需额外添加。

原 `config.json` 字段	当前环境变量	默认值	已弃用	说明
`systemEnv.customPdfParse.url`	`CUSTOM_PDF_PARSE_URL`	空	-	自定义 PDF 解析服务地址。
`systemEnv.customPdfParse.key`	`CUSTOM_PDF_PARSE_KEY`	空	-	自定义 PDF 解析服务密钥。
`systemEnv.customPdfParse.doc2xKey`	`DOC2X_KEY`	空	-	Doc2x PDF 解析服务密钥。
`systemEnv.customPdfParse.textinAppId`	`TEXTIN_APP_ID`	空	-	合合信息 TextIn 服务 App ID。
`systemEnv.customPdfParse.textinSecretCode`	`TEXTIN_SECRET_CODE`	空	-	合合信息 TextIn 服务 Secret Code。
`systemEnv.hnswEfSearch`	`HNSW_EF_SEARCH`	`100`	-	向量检索的 `hnsw.ef_search` 参数，仅对 PG、OceanBase、openGauss 生效。
`systemEnv.hnswMaxScanTuples`	`HNSW_MAX_SCAN_TUPLES`	`100000`	-	向量检索最大扫描数据量，仅对 PG 生效。
`systemEnv.datasetParseMaxProcess`	`DATASET_PARSE_MAX_PROCESS`	`10`	-	知识库文件解析队列最大并发数。
`systemEnv.vectorMaxProcess`	`VECTOR_MAX_PROCESS`	`10`	-	向量训练队列最大并发数。
`systemEnv.qaMaxProcess`	`QA_MAX_PROCESS`	`10`	-	问答拆分队列最大并发数。
`systemEnv.vlmMaxProcess`	`VLM_MAX_PROCESS`	`10`	-	图片理解模型处理队列最大并发数。

PDF 增强解析配置

开源版支持接入自定义 PDF 解析服务、SoMark、TextIn 或 Doc2x。选择一种服务配置即可；如果同时配置多种服务，调用优先级为：自定义 PDF 解析服务、SoMark、TextIn、Doc2x。

使用 Sealos PDF 解析服务

打开 Sealos AI Proxy，申请 API Key。
将 API Key 配置到 FastGPT：

CUSTOM_PDF_PARSE_URL=https://aiproxy.hzh.sealos.run/v1/parse/pdf?model=parse-pdf
CUSTOM_PDF_PARSE_KEY=your-sealos-api-key

使用 SoMark

打开 SoMark Studio，创建 API Key。
将 API Key 配置到 FastGPT：

SOMARK_API_KEY=sk-your-api-key

SoMark 同步解析接口单文件最大支持 200 MB、300 页。完整限制和错误码见 SoMark API 文档。

使用其他自定义 PDF 解析服务

CUSTOM_PDF_PARSE_URL=https://your-pdf-parser.example.com/v2/parse/file
CUSTOM_PDF_PARSE_KEY=your-service-key

CUSTOM_PDF_PARSE_KEY 可选。配置后，FastGPT 会通过 Authorization: Bearer <CUSTOM_PDF_PARSE_KEY> 请求解析服务。解析服务需接收包含 file 字段的 multipart/form-data POST 请求，并返回以下 JSON：

{
  "pages": 10,
  "markdown": "Parsed Markdown content"
}

使用 TextIn

TEXTIN_APP_ID=your-app-id
TEXTIN_SECRET_CODE=your-secret-code

使用 Doc2x

DOC2X_KEY=your-api-key

修改环境变量后需要重启 FastGPT。然后在知识库导入文件或应用文件上传配置中勾选“PDF 增强解析”，上传的 PDF 才会使用已配置的增强解析服务；未勾选时仍使用 FastGPT 内置解析器。

Admin 额外变量

以下变量主要由 pro/admin 读取。Admin 同时也会使用上面的 App/Admin 共享变量。

变量	默认值	已弃用	说明
`PRO_TOKEN`	无，必填	-	FastGPT app 服务端调用 pro/admin 内部接口的服务间凭证，至少 32 位，需与 App 一致。
`EVAL_LINE_LIMIT`	`1000`	-	单次创建评估任务允许的最大数据行数，也会下发给前端配置。
`BATCH_UPDATE_TIME`	`3000`	-	钱包余额批量更新间隔，单位毫秒。
`INVOICE_FEISHU_WEBHOOK_URL`	空	-	发票申请通知飞书 Webhook 地址。
`INVOICE_FEISHU_WEBHOOK_CALLBACK_URL`	空	-	发票通知中按钮回调地址。
`SMS_PROXY`	空	-	短信发送代理服务地址。
`MAX_CRAWL_PAGE`	`2000`	-	网站同步最大抓取页面数。
`CRAWL_MAX_HTML_SIZE`	`10`	-	静态网页爬虫单页 HTML 估算大小上限，单位 MB。
`CRAWL_EXCLUDE_LIST`	空	-	爬虫排除域名或路径规则，多个值使用英文逗号分隔。
`SHOW_GIT`	`false`	-	是否在后台展示 Git 信息。
`CLEAR_FREE_ACCOUNT`	`false`	-	是否启用免费账号资源清理任务。
`SYNC_MEMBER_CRON`	空	-	成员自动同步 Cron 表达式；为空则不启动同步任务。
`WORKORDER_BASE_URL`	空	-	工单系统地址；配置后前端展示工单入口。
`WORKORDER_JWT_SECRET`	空	-	创建工单时签发 JWT 使用的密钥。
`EXTERNAL_USER_SYSTEM_BASE_URL`	空	-	外部用户系统地址。
`EXTERNAL_USER_SYSTEM_AUTH_TOKEN`	空	-	外部用户系统认证 Token。
`BAIDU_CONVERSION_TOKEN`	空	-	百度转化跟踪 Token。
`BAIDU_CONVERSION_BASE_URL`	空	-	百度转化跟踪接口地址。
`BING_ADS_DEVELOPER_TOKEN`	空	-	Bing Ads Developer Token。
`BING_ADS_CUSTOMER_ID`	空	-	Bing Ads Customer ID。
`BING_ADS_CUSTOMER_ACCOUNT_ID`	空	-	Bing Ads Customer Account ID。
`BING_ADS_CONVERSION_NAME`	`fastgptcn`	-	Bing Ads 转化目标名称。
`BING_OAUTH_CLIENT_ID`	空	-	Bing OAuth Client ID。
`BING_OAUTH_CLIENT_SECRET`	空	-	Bing OAuth Client Secret。
`BING_OAUTH_REFRESH_TOKEN`	空	-	Bing OAuth Refresh Token。
`SHOW_WECOM_CONFIG`	`false`	-	是否展示企业微信相关配置。
`WECOM_DEV`	`false`	-	企业微信支付相关开发模式开关。

Code Sandbox 变量

这些变量由 projects/code-sandbox/src/env.ts 加载和校验。App 调用沙箱时，CODE_SANDBOX_TOKEN 需要与这里的 SANDBOX_TOKEN 保持一致。

变量	默认值	已弃用	说明
`SANDBOX_PORT`	`3000`	-	Code Sandbox 服务监听端口。
`SANDBOX_TOKEN`	空	-	`/sandbox` 接口 Bearer Token；为空时不启用接口认证。仅允许 ASCII 可打印字符且不能包含空格。
`SANDBOX_POOL_SIZE`	`5`	-	JS/Python 预热 worker 数量，范围 `1` 到 `100`。
`SANDBOX_QUEUE_ID_CONCURRENCY`	空	-	同一个 `queueId` 同时可进入执行流程的请求数；为空时不启用 `queueId` 排队，范围 `1` 到 `100`。
`SANDBOX_API_MAX_BODY_MB`	`8`	-	`/sandbox` API JSON 请求体总大小上限，包含 `variables`，单位 MB，范围 `1` 到 `100`。
`SANDBOX_MAX_TIMEOUT`	`60000`	-	单次代码执行超时时间，单位毫秒，范围 `1000` 到 `600000`。
`SANDBOX_MAX_MEMORY_MB`	`256`	-	单个沙箱最大内存，单位 MB，范围 `32` 到 `4096`；运行时会额外预留 `50` MB 开销。
`SANDBOX_MAX_OUTPUT_MB`	`10`	-	单次代码执行输出 JSON 大小上限，包含返回值和日志，单位 MB，范围 `1` 到 `100`。
`CHECK_INTERNAL_IP`	`true`	-	是否在沙箱网络请求中启用内网 IP 检查。
`SANDBOX_REQUEST_MAX_COUNT`	`30`	-	单次代码执行允许发起的最大网络请求数，范围 `1` 到 `1000`。
`SANDBOX_REQUEST_TIMEOUT`	`60000`	-	沙箱内单次网络请求超时时间，单位毫秒，范围 `1000` 到 `300000`。
`SANDBOX_REQUEST_MAX_RESPONSE_MB`	`10`	-	沙箱内单次网络响应体最大大小，单位 MB，范围 `1` 到 `100`。
`SANDBOX_REQUEST_MAX_BODY_MB`	`5`	-	沙箱内单次网络请求体最大大小，单位 MB，范围 `1` 到 `100`。
`SANDBOX_JS_ALLOWED_MODULES`	`lodash,dayjs,moment,uuid,crypto-js,qs,url,querystring`	-	JS 代码允许导入的模块白名单，使用英文逗号分隔。
`SANDBOX_PYTHON_ALLOWED_MODULES`	内置常用标准库与 `numpy,pandas,matplotlib`	-	Python 代码允许导入的模块白名单，使用英文逗号分隔。
`NODE_ENV`	空	-	标准 Node.js 环境变量；`development` 下内网地址检查会放宽。
`HOSTNAME`	`localhost`	-	沙箱服务本机 Host，用于本地地址识别。
`PORT`	`3000`	-	沙箱本地服务端口识别；实际监听优先使用 `SANDBOX_PORT`。

Volume Manager 变量

这些变量由 projects/volume-manager/src/env.ts 加载和校验。FastGPT 侧 OpenSandbox 持久化 Volume 使用的 AGENT_SANDBOX_OPENSANDBOX_VOLUME_MANAGER_TOKEN 需要与这里的 VM_AUTH_TOKEN 保持一致。

变量	默认值	已弃用	说明
`PORT`	`3000`	-	Volume Manager 服务监听端口。
`VM_AUTH_TOKEN`	无，必填	-	Volume Manager API 鉴权 Token。
`VM_RUNTIME`	`kubernetes`	-	运行时类型，可选 `docker` 或 `kubernetes`。
`VM_DOCKER_SOCKET`	`/var/run/docker.sock`	-	Docker socket 路径，仅 `docker` 模式需要。
`VM_DOCKER_API_VERSION`	`v1.44`	-	Docker API 版本，仅 `docker` 模式需要。
`VM_K8S_NAMESPACE`	`opensandbox`	-	Kubernetes 命名空间，仅 `kubernetes` 模式需要。
`VM_K8S_PVC_STORAGE_CLASS`	`standard`	-	Kubernetes PVC StorageClass，仅 `kubernetes` 模式需要。
`VM_LOG_LEVEL`	`info`	-	日志等级，可选 `debug`、`info` 或 `none`。

环境变量说明

本页导航