如何禁用 Web UI 让 InsightFace Server 以 API-only 模式运行【免费下载链接】insightfaceState-of-the-art 2D and 3D Face Analysis Project项目地址: https://gitcode.com/GitHub_Trending/in/insightfaceInsightFace Server 是一个自托管的人脸识别服务默认同时提供 Web UI、交互式 API 文档和/v1REST API。如果你的部署环境里所有调用方都走 REST 接口或 Python SDK不需要给人打开浏览器界面可以把服务切成 API-only 模式保留/v1与/openapi.json不再注册/、/docs、指南内容和前端静态资源等 UI 路由。这个开关写在 server.toml 的[web]段里属于进程启动时一次性读取的配置没有运行时修改接口改完必须重启容器才生效。CPU 部署默认端口是18097CUDA 部署是18098。前提服务器已经按常规流程跑起来在改配置之前先确认你有一套可正常启动的部署例如 用户指南 中的 CPU 路径要求 Linux x86_64 主机装好 Docker Engine 和 Docker Compose宿主机不需要 Python、OpenCV、ONNX Runtime、CUDA 或 cuDNNmkdir -p server/.models docker compose -f server/deploy/compose.cpu.yml pull docker compose -f server/deploy/compose.cpu.yml run --rm models install buffalo_l docker compose -f server/deploy/compose.cpu.yml up -d curl -fsS http://127.0.0.1:18097/v1/healthNVIDIA GPU 部署把compose.cpu.yml换成compose.cuda12.yml端口换成18098。模型安装器会在下载前展示模型许可公开的 InsightFace 预训练模型默认仅限非商业研究用途商用需要单独的许可。如果服务已对外暴露给其他人注意 用户指南 的提示捆绑的 Compose 文件默认auth_enabledfalse对外使用前应通过环境变量开启认证INSIGHTFACE_AUTH_ENABLEDtrue和INSIGHTFACE_API_KEY这与是否禁用 Web UI 无关但同一份配置里最好一起确认。修改 [web].disabled 配置server/deploy/compose.cpu.yml 把仓库里的 server/config/server.toml 以只读方式挂载到容器内/etc/insightface/server.toml。这个文件只在进程启动时读取一次所以操作顺序是先改文件再重启容器。server.toml 的[web]段当前是[web] # false (default): serve the Web UI, interactive API reference and guides. # true: API-only mode; keep /v1 and /openapi.json, but do not register UI routes. disabled false把它改成[web] disabled true两点约束需要记住disabled必须是布尔值。配置解析代码config.py对非布尔值会抛出[web].disabled must be a boolean容器起不来写true这类字符串是无效的。文档明确说明 Settings are read once; there is no runtime settings API即不存在运行时开关接口改完只能靠重启生效。改完后重启容器。用户指南 给出的停止命令是docker compose ... down不要带-v-v会永久删除命名数据卷docker compose -f server/deploy/compose.cpu.yml down docker compose -f server/deploy/compose.cpu.yml up -d验证 API-only 模式是否生效按下面顺序检查全部符合即表示切换成功健康检查仍然可用。/v1/health是公开的 readiness 端点不需要认证curl -fsS http://127.0.0.1:18097/v1/health启动完成且 SQLitequick_check通过时返回 200 和status: readyapi.md 中的文档示例输出为{status:ready,auth_enabled:false,request_id:...}模型、数据库或索引未就绪时是503 not_ready。UI 路由全部消失。请求原 Web UI 入口应得到 404错误码为route_not_found这一点在服务端测试 test_system_auth_errors.py 中对/、/docs、/assets/app.mjs、/guide-content/...等路径逐一断言过curl -sS http://127.0.0.1:18097/ curl -sS http://127.0.0.1:18097/docsAPI 本体仍在。/openapi.json正常返回 200/v1/system的safe_config中web_ui_disabled应为true可用它做最终确认curl -sS http://127.0.0.1:18097/v1/system -H ${AUTH_HEADER}其中AUTH_HEADER按 api.md 的约定设置认证关闭时不要发送空的Authorization头直接省略该头即可。生效后的行为边界禁用 Web UI 只去掉前端路由/v1下的 29 个 REST 操作和/openapi.json不受影响SDK 调用user-guide.md 第 8 节的insightface_server.Client示例照常工作。RTSP Monitor 独立于浏览器在服务端运行关闭页面或禁用 UI 都不会停止已启用的监控任务UI 的视频预览本来就默认关闭。如果之后要恢复 Web UI把disabled改回false并再次重启容器即可数据都在持久化卷里down/up -d不影响/data。排查启动问题时看System诊断对应的/v1/system响应、容器日志以及每个响应里携带的x-request-id改错配置例如disabled true会直接导致进程启动失败容器日志中会有上面的校验错误。【免费下载链接】insightfaceState-of-the-art 2D and 3D Face Analysis Project项目地址: https://gitcode.com/GitHub_Trending/in/insightface创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考