Skip to main content
本页面介绍如何在 LangChat Pro 中嵌入第三方服务页面(独立运行的 Web 应用),用于增强绘图、搜索与模型管理能力。这些服务需单独部署并在后端进行 URL 配置。

概述

当前支持嵌入以下服务:
  • Excalidraw:白板/手绘风绘图
  • SearXNG:开源元搜索引擎
  • Xinference:模型推理与管理平台
以上均需单独部署 Docker 服务,LangChat Pro 仅以 IFrame/反向代理等方式进行嵌入展示。

部署

建议使用项目 docs/docker 目录下提供的 docker-compose 脚本进行快速部署。

配置

在后端 application-dev.yml 中配置服务地址:
langchat:
  searxng:
    enabled: true
    duration: 10
    url: http://127.0.0.1:8081
    max-results: 10
    max-results-limit: 50
  excalidraw:
    url: http://127.0.0.1:3000
  xinference:
    url: http://127.0.0.1:9997
  • enabled:是否启用该服务的嵌入
  • url:服务的基础访问地址
  • duration/max-results:SearXNG 搜索相关配置,用于控制超时与返回数量

预览

image-20250926230010625 image-20250926230111396

安全与网络

  • 同源与 CORS:若使用 IFrame 嵌入,需允许跨源嵌入策略
  • 身份与鉴权:如服务需要登录/Key,建议通过反向代理注入或单点登录
  • 内网优先:建议将第三方服务部署在内网,并通过反向代理暴露必要入口
  • 限流与隔离:对外部服务增加限流与资源隔离,避免影响核心业务

最佳实践

  • 使用独立的域名/路径前缀管理各服务的访问地址
  • 为搜索服务设置合理的超时与结果上限,防止长尾阻塞
  • 将服务健康检查接入监控平台,异常时自动告警
  • 区分开发/测试/生产环境配置,避免误指向与权限泄露