2、LangFuse 安装说明（Docker Compose）

LangFuse 安装说明（Docker Compose）

本指南将引导您完成在本地或使用 Docker Compose 在虚拟机上部署 Langfuse 的过程。我们将使用 docker-compose.yml 文件。这是运行 Langfuse 最简单的方法，值得一试。

如果你使用 AWS、GCP 或 Azure 等云提供商，你将需要部署虚拟机的权限。

对于高可用性和高吞吐量，我们建议使用 Kubernetes (部署指南)。docker 组件设置缺乏高可用性、扩展能力和备份功能。

此方式不适合生产使用，因为数据库不是持久性的，并且环境变量也不是保密的。对于生产就绪的设置，请遵循自托管指南或考虑使用由 Langfuse 团队维护的 Langfuse Cloud 。

官方文档：https://langfuse.com/docs/deployment/local

本地环境

要求

• Git
• Docker & docker compose -> 在 Mac 或 Windows 上使用 Docker Desktop

克隆 Langfuse 仓库

获取最新 Langfuse 仓库的副本：

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

启动应用程序

更新 docker-compose.yml 中的密钥，然后使用以下命令运行 langfuse docker compose:

docker compose up

观察容器启动和日志流入。大约 2-3 分钟后，langfuse-web-1 容器应该会显示 “准备就绪”。此时，你可以继续下一步。

完成

你已经准备好出发了！在浏览器中打开 http://localhost:3000, 访问 Langfuse UI。

虚拟机

启动一个新实例并通过 SSH 登录

输入您的云提供商界面，导航到 VM 实例部分。这是 AWS 上的 EC2、GCP 上的计算引擎和 Azure 上的虚拟机。创建一个新实例。

我们建议您使用至少 4 个核心和 16GiB 的内存，例如 AWS 上的 t3.xlarge。如果您想从外部源发送跟踪，请指定一个公共 IP 地址。由于可观测性数据往往容量较大，请选择足够的存储空间，例如 100GiB。

本指南的其余部分将假设您的 VM 上运行着 Ubuntu 操作系统，并通过 SSH 连接。

安装 Docker 和 Docker Compose

安装 Docker (另请参阅官方指南)。设置 Docker 的 apt 仓库：

# Add Docker's official GPG key:
sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Add the repository to Apt sources:
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update

安装 Docker 包：

sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

验证安装：

sudo docker run hello-world

克隆 Langfuse 仓库

获取最新 Langfuse 仓库的副本：

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

更新密钥

我们强烈建议您更新 docker-compose 文件中的密码。 所有敏感行都标记为# CHANGEME。 请确保为所有密码选择长且随机的密码。

更新网络参数 (可选)

只有 langfuse-web 容器和 minio 必须可以从实例外部访问。 因此，我们建议在您的实例中添加一个安全组或防火墙，将传入流量限制为：3000 和：9090 端口。

启动应用程序

docker compose up

观察容器启动和日志流入。 大约 2-3 分钟后，langfuse-web-1 容器应该会显示 “准备就绪”。 此时，您可以继续下一步。

完成

准备就绪！在浏览器中打开 http://<instance-ip>:3000, 访问 Langfuse UI。

根据您的配置，您可能需要打开一个 SSH 隧道到您的 VM 来访问 IP。请参考您的云提供商的文档以了解如何执行此操作。

更新 Langfuse

Docker 具有强大的缓存功能。要获取最新的 Langfuse 容器，您需要运行 docker-compose pull. 否则，Docker 将使用 Langfuse 容器的缓存版本。

# Navigate to the Langfuse directory
cd langfuse

# Stop the server and database
docker compose down

# Fetch the latest changes
git pull
docker-compose pull

# Restart the server and database
docker compose up

设置开发环境

参考 CONTRIBUTING.md 有关如何设置开发环境的详细说明。