FastGPT V4.15.0版本升级包含环境变量变更与配置调整,覆盖fastgpt-app、fastgpt-pro、代码沙箱(code-sandbox)与插件服务(fastgpt-plugin)四大模块,升级前需完成对应变量的检查与配置,避免服务启动异常。
配置操作步骤
- fastgpt-app与fastgpt-pro配置 需检查并配置三类变量:一是必配且两个服务需保持一致的密钥变量,包括AES256SECRETKEY、FILETOKENKEY、INVOKETOKENSECRET(INVOKETOKENSECRET长度至少32位);二是新增必配变量SSEMCPSERVERPROXYENDPOINT,无需SSE功能可忽略;三是可选变量,如PARSEFILEWORKERS默认值为10,PARSEFILETIMEOUTSECONDS默认600秒,SYNCINDEX需设置为布尔字符串如
true,TRUSTEDPROXYENABLE默认值为false。开源版需移除config.json配置文件,改用环境变量,可配置CUSTOMPDFPARSEURL、DOC2XKEY、TEXTINAPPID等解析相关变量,以及HNSWEFSEARCH默认100、DATASETPARSEMAX_PROCESS默认10等性能参数。 - code-sandbox配置 新增多项安全与性能相关环境变量,默认值分别为:SANDBOXAPIMAXBODYMB为8MB、SANDBOXMAXOUTPUTMB为10MB、CHECKINTERNALIP为
true、SANDBOXMAXTIMEOUT为60000毫秒。可通过SANDBOXQUEUEIDCONCURRENCY配置同一queueId的并发执行上限,未配置则不启用排队功能。 - fastgpt-plugin配置 需新增AUTHTOKEN(长度≥32位)与FASTGPTBASEURL变量,修改MONGODBURI变量;同时将fastgpt-app与fastgpt-pro的PLUGINTOKEN设置为与fastgpt-plugin的AUTHTOKEN保持一致。
易错点与边界说明
部分密钥类环境变量需在fastgpt-app与fastgpt-pro中保持一致,否则会引发接口签名验证失败。code-sandbox的内网IP检查默认开启,可降低SSRF风险,如需关闭需调整CHECKINTERNALIP变量。fastgpt-plugin的AUTHTOKEN长度不足32位时,服务无法正常启动。开源版不再支持通过volumn挂载config.json文件,所有配置需通过环境变量完成。部分变量如MAXFOLDER_DEPTH默认值为4,取值范围为2~20,超出范围可能引发配置异常。
来源:FastGPT 官方文档