olegkarenkikh/langfuse

Langfuse 容器镜像文档

镜像概述

本镜像包含Langfuse的Web服务和Worker组件，设计用于最小化部署架构。该方案仅需PostgreSQL数据库和Redis缓存作为依赖，且确保无已知CVE（常见漏洞和暴露）漏洞，提供轻量、安全的Langfuse服务部署选项。

核心功能和特性

• 组件完整性：包含Langfuse Web服务（处理HTTP请求、提供Web界面）和Worker组件（处理后台任务、异步任务执行）
• 最小化依赖：仅需PostgreSQL（数据存储）和Redis（缓存/消息队列），降低部署复杂度
• 安全加固：镜像构建过程中已排除已知CVE漏洞，提升运行环境安全性
• 容器化部署：支持Docker容器化部署，便于集成到现有容器编排系统（如Docker Compose、Kubernetes）

使用场景和适用范围

• 中小型项目的Langfuse服务部署
• 对部署资源有限制的环境（轻量级架构需求）
• 对系统安全性有较高要求的场景（无CVE漏洞保障）
• 需要快速搭建Langfuse开发/测试环境的场景

使用方法和配置说明

前提条件

部署前需准备：

• PostgreSQL数据库实例（推荐版本13+）
• Redis实例（推荐版本6+）
• Docker环境（Docker 20.10+）或Docker Compose（2.0+）

Docker Run 示例

Web服务容器

bash
docker run -d \
  --name langfuse-web \
  -p 3000:3000 \
  -e DATABASE_URL=postgresql://user:password@postgres-host:5432/langfuse \
  -e REDIS_URL=redis://redis-host:6379 \
  langfuse:latest web

Worker容器

bash
docker run -d \
  --name langfuse-worker \
  -e DATABASE_URL=postgresql://user:password@postgres-host:5432/langfuse \
  -e REDIS_URL=redis://redis-host:6379 \
  langfuse:latest worker

Docker Compose 配置示例

yaml
version: '3.8'

services:
  postgres:
    image: postgres:14-alpine
    environment:
      POSTGRES_USER: langfuse
      POSTGRES_PASSWORD: secure-password
      POSTGRES_DB: langfuse
    volumes:
      - postgres-data:/var/lib/postgresql/data

  redis:
    image: redis:7-alpine
    volumes:
      - redis-data:/data

  langfuse-web:
    image: langfuse:latest
    command: web
    ports:
      - "3000:3000"
    environment:
      DATABASE_URL: postgresql://langfuse:secure-password@postgres:5432/langfuse
      REDIS_URL: redis://redis:6379
    depends_on:
      - postgres
      - redis

  langfuse-worker:
    image: langfuse:latest
    command: worker
    environment:
      DATABASE_URL: postgresql://langfuse:secure-password@postgres:5432/langfuse
      REDIS_URL: redis://redis:6379
    depends_on:
      - postgres
      - redis

volumes:
  postgres-data:
  redis-data:

关键环境变量说明