Skip to main content
本指南帮助你在首次使用 LangChat Pro 时，完成必要的外观与环境配置。包含：移除内置小组件、修改产品名称/Logo、切换与维护后端环境配置等。

​
前端基础配置

​
删除登录用户名填充

启动前端服务langchat-ui后，登录页面会默认填充用户名和密码，如果你不需要默认的填充，可以按照如下方式修改
  1. 切换路径
cd langchat-ui/apps/langchat/src/views/_core/authentication/login.vue
  1. 删除掉表单填充代码
image-20260221172520814

​
删除水印

同样的修改前端配置：langchat-ui/apps/langchat/src/preferences.ts 找到如下配置并注释掉： 
  app: {
    name: 'LangChat Pro',
        layout: 'header-nav',
        accessMode: 'mixed',
        dynamicTitle: true,
        enableCheckUpdates: true,
        defaultHomePath: '/explore',
    // watermark: true, 注释这一行
},
修改后需要清除浏览器缓存才会生效 如需自定义产品名称与 Logo，需要修改前端项目的两处配置：
  • langchat-ui/apps/langchat/.env
  • langchat-ui/apps/langchat/src/preferences.ts

​
1) 修改 .env 的标题

image-20250926231811186

​
2) 修改 preferences.ts（标题/主题/Logo 等偏好）

image-20250926231847867
如果需要修改 Logo，也在 preferences.ts 中进行调整；图片资源请确保路径与尺寸符合前端要求。
修改后请清空浏览器缓存并强制刷新（如 Cmd/Ctrl + Shift + R），以确保最新配置生效。

​
后端基础配置

​
切换后端环境配置

LangChat Pro 为 Spring Boot 多模块的单体项目，核心配置位于 langchat-bootstrap 模块下。

​
1) 切换激活环境

首次运行，请将 spring.profiles.active 从 local 切换为 dev：
  • 打开配置文件：langchat-bootstrap/src/main/resources/application.yml
  • 修改 spring.profiles.active 的值
image-20250926232201051

​
2) 维护开发环境配置

项目的核心运行参数（数据库、Redis、OSS、第三方服务地址等）均在 application-dev.yml 中维护。
  • 路径：langchat-bootstrap/src/main/resources/application-dev.yml
  • 建议按环境（dev/test/prod）区分不同配置文件与凭据
常见必填项：
  • 数据源（JDBC URL、用户名、密码）
  • Redis（host、port、password）
  • OSS/对象存储（endpoint、bucket、accessKey）
  • 外部服务（搜索/绘图/推理等）地址

​
外部服务接入

具体查看 application-dev.yml ，涉及外部服务接入的配置项如下： 
langchat:
  # MinerU PDF解析服务配置
  mineru:
    base-url: http://localhost:8888
    timeout: 300
  # Gotenberg文档转换服务配置
  gotenberg:
    base-url: http://localhost:3000
    timeout: 60
  searxng:
    enabled: true
    duration: 10
    url: http://127.0.0.1:8081
    max-results: 10
    max-results-limit: 50
  firecrawl:
    base-url: http://127.0.0.1:3002
  excalidraw:
    url: http://127.0.0.1:3000
  xinference:
    url: http://127.0.0.1:9997
  gpustack:
    url: http://127.0.0.1:8080
根据服务名称，这些服务基本都是外部的python服务，因此需要单独部署，然后在这里配置服务的URL即可。 不过我们在项目根目录的 langchat-pro/docs/docker 目录下提供了这些服务的所有docker-compose脚本，可以直接拉取镜像部署服务。 外部服务部署完成后，直接在这里替换IP和端口即可。
注意：接入外部服务，直接在这里配置对应服务的访问域名即可，无需再额外做其他配置。配置后重启项目生效

​
最佳实践

  • 配置前请在版本库创建特性分支，变更经测试后再合并
  • 将敏感信息通过环境变量或配置中心托管，避免明文提交到仓库
  • 前端外观改动与后端环境切换分别验证，防止联动影响
  • 重要变更（标题/Logo/路由等）记录到变更日志，便于团队协作与回溯