自定义基本路径

自定义基本路径

默认情况下，Langfuse 服务于域的根路径，例如 https://langfuse.yourdomain.com、https://yourdomain.com。

在某些情况下，当将 Langfuse 集成到现有基础设施时，可能需要在自定义基本路径上部署 Langfuse, 例如 https://yourdomain.com/langfuse。

设置

由于此基本路径内联在静态资源中，因此您不能使用 Web 容器 (langfuse/langfuse) 的预构建 docker 映像。您需要从源代码构建映像，并在构建时设置 NEXT_PUBLIC_BASE_PATH 环境变量。Worker 容器 (langfuse/langfuse-worker) 可以使用预构建的映像运行。

更新环境变量

使用自定义基本路径时，必须将 NEXTAUTH_URL 设置为完整的 URL, 包括基本路径和 /api/auth。例如，如果要在 https://yourdomain.com/langfuse-base-path 部署 Langfuse, 则需要设置：

NEXT_PUBLIC_BASE_PATH="/langfuse-base-path"
NEXTAUTH_URL="https://yourdomain.com/langfuse-base-path/api/auth"

从源代码生成 Langfuse Web 图像

使用 NEXT_PUBLIC_BASE_PATH 作为构建参数，从源代码中为 Langfuse Web 容器 (langfuse/langfuse) 构建映像：

# clone repo
git clone https://github.com/langfuse/langfuse.git
cd langfuse

# checkout production branch
# main branch includes unreleased changes that might be unstable
git checkout production

# build image with NEXT_PUBLIC_BASE_PATH
docker build -t langfuse/langfuse --build-arg NEXT_PUBLIC_BASE_PATH=/langfuse-base-path -f ./web/Dockerfile .

运行 Langfuse

当根据其中一个部署指南部署 Langfuse 时，请将 Web 容器 (langfuse/langfuse) 的预构建映像替换为您从源代码生成的映像。

Kubernetes/Helm 部署：当使用 Kubernetes/Helm 的自定义基本路径时，必须更新生命周期和就绪探测路径以包含自定义基本路径。在 Helm values.yaml 文件中的 langfuse.web.livenessProbe.path 和 langfuse.web.readynessProbe.path 下更新这些内容。

连接到 Langfuse

一旦您的 Langfuse 实例运行，您就可以通过配置的自定义基本路径访问 API 和控制台。当通过 SDK 连接时，请确保在主机名中包含自定义基本路径。