LobeHub 怎么通过 FEATURE_FLAGS 环境变量控制功能开关【免费下载链接】lobehub LobeHub is your Chief Agent Operator, organizing your agents into 7×24 operations by hiring, scheduling, and reporting on your entire AI team.项目地址: https://gitcode.com/GitHub_Trending/lo/lobehub自托管部署 LobeHub 时你可能会遇到这类需求不想让用户看到欢迎建议或者想开放默认关闭的 API 密钥管理页面。LobeHub 提供了FEATURE_FLAGS环境变量来统一控制这些功能开关——所有功能特性都通过这唯一的特性标志配置变量来启停不需要改代码。本文介绍它的取值语法、完整配置项列表以及在部署时如何传入并在界面中确认开关生效。FEATURE_FLAGS的取值语法FEATURE_FLAGS是一个可选的环境变量默认值为-即不配置所有功能均采用各自默认值。取值规则来自 特性标志文档使用前缀启用一个功能-前缀关闭一个功能例如api_key_manage、-welcome_suggest多个功能标志之间使用英文逗号,隔开整个值最外层建议加上引号避免解析错误。文档给出的示例是-welcome_suggest按同样语法可以组合多个开关例如-welcome_suggest,api_key_manage以上为示例取值其中两个标志均出自下方配置项表。有两点需要特别注意不支持all关键字。与OPENAI_MODEL_LIST变量不同FEATURE_FLAGS不能一次性接管全部标志未显式配置的标志会保持各自的默认值需要手动逐个控制。引号不要省否则值可能被解析错误。在部署时配置在 Docker 部署中Dockerfile 在构建阶段声明了FEATURE_FLAGS构建参数ARG FEATURE_FLAGS并在最终运行阶段将其重置为空字符串。也就是说镜像内该变量默认为空你在容器启动时通过环境变量传入即可运行时传入的值会生效。常见的两种传入方式# docker-compose 示例在 LobeHub 服务的 environment 中追加 environment: - FEATURE_FLAGS-welcome_suggest,api_key_manage# docker run 示例你的LobeHub镜像 替换为你实际部署使用的镜像地址 docker run -d \ -p 3210:3210 \ -e FEATURE_FLAGS-welcome_suggest,api_key_manage \ 你的LobeHub镜像其中端口3210取自 Dockerfile 中PORT3210的默认值。环境变量在容器创建时生效修改配置后需要按你现有方式重建/重启容器。项目内置的部署编排文件可参考 docker-compose/deploy/docker-compose.yml在其中的 LobeHub 服务上追加同样的environment条目即可。可配置的功能标志列表特性标志文档 列出的配置项及默认值如下配置项解释默认值check_updates允许检查更新。开启provider_settings控制模型供应商设置的显示。开启openai_api_key允许用户自定义 OpenAI API Key。开启openai_proxy_url允许用户自定义 OpenAI 代理 URL。开启api_key_manage控制 API 密钥管理页面 (/profile/apikey) 的访问。关闭edit_agent允许用户编辑助手。开启ai_image控制 AI 图像生成功能和页面 (/image)。开启speech_to_text启用语音转文本功能。开启token_counter保留用于令牌计数器显示。开启welcome_suggest显示欢迎建议。开启changelog控制更新日志弹窗 / 页面的显示。开启market启用助手市场功能。开启knowledge_base启用知识库功能。开启rag_eval控制 RAG 评估功能 (/repos/[id]/evals)。关闭cloud_promotion控制用户菜单中云服务推广链接的显示。关闭commercial_hide_github隐藏设置页面底部的 GitHub 相关链接需要商业授权。关闭commercial_hide_docs隐藏文档和帮助菜单包括更新日志、文档和反馈需要商业授权。关闭文档同时指出最新的特性标志列表以 featureFlags 定义 为准。该文件中还定义了上表之外的标志例如agent_share、voice_dictation、workspace、auth_captcha等其中agent_self_iteration、agent_onboarding、dev_dock、onboarding_v2、workspace的默认值取决于是否处于开发环境development。另外commercial_hide_github、commercial_hide_docs两个标志仅限商业授权使用。从 解析实现 可以看到两个行为细节解析时会把中文逗号替换为英文逗号再按逗号拆分所以分隔符写错成中文逗号不会直接报错值只支持布尔开关/-。不在 schema 中的标志名或只接受用户 ID 数组的标志如dev_dock_workspaces不会被布尔值覆盖相当于被忽略。验证开关是否生效环境变量本身没有专门的查询接口验证方式是核对 特性标志文档 表格中各标志控制的界面入口在重启后是否按预期出现或消失-welcome_suggest首页不再显示欢迎建议-ai_imageAI 图像生成功能和/image页面入口消失api_key_manage可以访问默认关闭的 API 密钥管理页面/profile/apikey-changelog更新日志弹窗 / 页面不再显示-market助手市场入口消失。判断基准就是上表的默认值如果你没有设置FEATURE_FLAGS界面表现应与默认值一列一致设置后被/-显式控制的条目应发生翻转未列出的条目保持默认。限制与注意FEATURE_FLAGS不支持all关键字未列出的标志一律保持默认值必须逐个手动控制。多标志值要加引号、用英文逗号分隔中文逗号虽能被解析仍建议遵循文档写法。commercial_hide_github、commercial_hide_docs需要商业授权自托管场景下不要依赖它们实现隐藏。schema 注释 说明agent_share是仅云端的灰度开关自托管构建在服务端被ENABLE_BUSINESS_FEATURES硬性拦截在自托管环境配置该标志不会启用对应功能。功能标志的完整清单随版本演进部署前以 featureFlags schema 和 基础环境变量文档 中的说明为准。【免费下载链接】lobehub LobeHub is your Chief Agent Operator, organizing your agents into 7×24 operations by hiring, scheduling, and reporting on your entire AI team.项目地址: https://gitcode.com/GitHub_Trending/lo/lobehub创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考