FastGPT V4.17.0 升级要点：AI Proxy 必配、自动升级任务与多项交互优化

FastGPT 发布 V4.17.0。升级前须先升级到 V4.16.2，并执行完 V4.16.x 要求的所有旧升级脚本；本版本的自动升级机制只管理从本版本开始登记的任务，不会补跑历史脚本。

部署必改项

• 必须部署或接入 AI Proxy，并在 FastGPT App 及商业版 Admin 服务中设置 AIPROXY_API_ENDPOINT（服务根地址，不带 /v1）和 AIPROXY_API_TOKEN（与服务端一致的非空管理员 Token）。
• OPENAI_BASE_URL、CHAT_API_KEY 及旧的 systemEnv.oneapiUrl/chatApiKey 覆盖配置已弃用并移除；模型服务商地址和密钥改在管理员模型渠道中维护。缺少任一 AI Proxy 配置会导致启动校验失败，单模型的 requestUrl/requestAuth 不能替代。
• 新增 CSRF_ENABLED=true 用于防御 HTML 标签携带 Cookie 直接请求接口。

升级机制

从本版本起，登记到系统升级机制的任务会自动执行，通过 lease 抢占避免多节点并发，并支持心跳检测；可在“管理员 > 版本升级”查看状态。分批迁移默认每批 100 条，可通过 SYSTEM_MIGRATION_BATCH_SIZE 调整为 50～1000。

可选配置

• SANDBOX_DISABLE_SECCOMP=true：仅在宿主机内核不支持应用内 seccomp 时使用；只关闭 seccomp，chroot、no_new_privs 与 UID/GID 降权仍启用，但不再从内核层阻断网络、建进程等系统调用，不建议在支持 seccomp 的环境使用。
• DEFAULT_TEAM_BASIC_PERMISSIONS_ENABLED=true：默认 false，仅对新建团队授予默认全员组应用、Skill 和知识库创建权限，不改已有团队；Pro 需在 FastGPT 与 Admin 两服务保持一致。

其他变化

新增 SSO Service 的 LDAP 成员与组织架构同步、钉钉用户与部门同步；Workflow Tool 文件上传字段可由 Agent 生成；Agent V2 增加 TTS 配置；AI 对话节点展示首 Token 响应时间；团队所有者转让支持多团队；列表筛选与分页、表格滚动等交互统一优化。

镜像更新：fastgpt-app 与 fastgpt-pro 为 v4.17.0，fastgpt-plugin 为 v1.1.3，fastgpt-code-sandbox 为 v4.17.0。模型自定义请求地址将于未来版本弃用，当前仍兼容，建议改用渠道管理。

修复项包括：DB_MAX_LINK 限制在 10～1000（官方模板默认 20）；团队插件安装开关被绕过；模型请求字段映射覆盖错误；OpenAPI 参数分配与可选 Cookie 参数阻断请求；隐藏多模态配置导致媒体未进入模型请求；MCP/HTTP 工具定义随快照过期；HTML 表格转 Markdown 缺列等。