Danswer Frontend Docker镜像文档

一、镜像概述和主要用途

镜像概述

Danswer Frontend 是开源项目 Danswer（一个 AI 驱动的问答系统）的前端组件，提供用户友好的交互界面，用于与 Danswer 后端服务通信，实现数据查询、问答交互、历史记录管理等核心功能。该镜像封装了前端应用的构建产物，可快速部署，无需手动配置前端开发环境。

主要用途

• 作为 Danswer 系统的可视化交互入口，供用户提交查询、查看回答结果
• 支持与 Danswer 后端服务联动，实现对多数据源（文档、知识库、数据库等）的统一查询
• 提供查询历史、收藏管理、结果筛选等辅助功能界面

二、核心功能和特性

核心功能

• 交互式问答界面：支持文本输入、语音输入（若后端支持），提供清晰的回答展示
• 多数据源整合：通过后端接口对接多种数据源，统一展示查询结果
• 历史记录管理：保存用户查询历史，支持重新查询、删除记录
• 结果筛选与排序：支持按相关性、时间等维度筛选回答结果

特性

• 轻量级部署：基于 Docker 容器化，部署简单，环境依赖少
• 响应式设计：适配桌面端和移动端
• 可配置化：通过环境变量调整接口地址、主题样式等
• 开源免费：遵循 MIT 许可证，支持二次开发

三、使用场景和适用范围

使用场景

• 企业内部知识库：员工通过前端界面查询公司文档、政策、技术手册
• 团队协作工具：研发团队查询代码文档、项目进度、会议记录
• 客户支持系统：客服人员通过界面快速检索产品FAQ、解决方案
• 教育机构：学生查询课程资料、作业指南、学术文献

适用范围

• 需搭建私有化问答系统的企业/组织
• 希望降低前端部署复杂度的开发团队
• 对数据隐私有较高要求（需本地化部署）的场景

四、使用方法和配置说明

前提条件

• 已安装 Docker Engine（20.10+）或 Docker Desktop
• 已部署 Danswer 后端服务（参考 Danswer 后端文档）

1. 快速启动（docker run）

通过以下命令启动前端容器，需指定后端 API 地址：

docker run -d \
  --name danswer-frontend \
  -p 3000:80 \  # 前端暴露端口（容器内默认80）
  -e REACT_APP_API_URL="[***]" \  # 后端API地址（需替换为实际后端地址）
  danswerai/danswer-frontend:latest

访问 http://localhost:3000 即可打开前端界面。

2. Docker Compose 部署（推荐）

与后端联动部署时，使用 docker-compose.yml 配置更便捷：

version: "3.8"

services:
  # Danswer 后端服务（需先部署，此处仅为示例）
  danswer-backend:
    image: danswerai/danswer-backend:latest
    ports:
      - "8080:8080"
    environment:
      - DATABASE_URL=postgresql://user:password@db:5432/danswer  # 后端数据库配置（示例）
    depends_on:
      - db

  # Danswer 前端服务
  danswer-frontend:
    image: danswerai/danswer-frontend:latest
    ports:
      - "3000:80"
    environment:
      - REACT_APP_API_URL="[***]"  # 后端API地址（与后端服务名关联）
    depends_on:
      - danswer-backend

  # 后端依赖的数据库（示例：PostgreSQL）
  db:
    image: postgres:15-alpine
    environment:
      - POSTGRES_USER=user
      - POSTGRES_PASSWORD=password
      - POSTGRES_DB=danswer
    volumes:
      - db-data:/var/lib/postgresql/data

volumes:
  db-data:

启动命令：

docker-compose up -d

3. 环境变量配置

通过环境变量自定义前端行为，常用参数如下：

4. 自定义配置

若需修改前端静态资源（如 Logo、主题色），可通过挂载本地目录覆盖容器内文件：

docker run -d \
  --name danswer-frontend \
  -p 3000:80 \
  -e REACT_APP_API_URL="[***]" \
  -v ./custom-assets:/usr/share/nginx/html/assets \  # 挂载自定义资源
  danswerai/danswer-frontend:latest

五、注意事项

1. 后端依赖：前端需与 Danswer 后端服务配合使用，确保 REACT_APP_API_URL 指向正确的后端地址
2. 版本兼容性：前端镜像版本需与后端版本匹配（建议使用 latest 或相同版本号）
3. 端口冲突：若宿主机 3000 端口被占用，可通过 -p <宿主机端口>:80 调整映射端口
4. 认证配置：若后端启用认证（如 OAuth2、API Key），需通过 REACT_APP_AUTH_ENABLED=true 及对应认证环境变量（如 REACT_APP_API_KEY）配置

六、参考链接

• Danswer 官方仓库
• Danswer 后端部署文档
• Docker Hub 镜像地址