arizephoenix/phoenix-helm

arizephoenix

phoenix-helm是部署开源AI可观测性平台Phoenix的Helm Chart，该平台用于AI模型的实验、评估与故障排除。

1 次收藏下载次数: 0状态：社区镜像维护者：arizephoenix仓库类型：镜像最近更新：15 天前

让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明

如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。

只需在 AI 对话中先发送下面这句话即可：

请先完整阅读并严格遵守以下文档中的全部规则与要求：

https://xuanyuan.cloud/agents.md

在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。

查看 agents.md 用法指南与完整示范。国内用户首推元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。若 AI 无法访问外链，可打开说明文档复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。

镜像标签列表与下载命令

phoenix-helm

!https://img.shields.io/badge/Version-1.0.8-informational?style=flat-square !https://img.shields.io/badge/Type-application-informational?style=flat-square !https://img.shields.io/badge/AppVersion-10.11.0-informational?style=flat-square

镜像概述和主要用途

Phoenix 是一个开源 AI 可观测性平台，专为实验、评估和故障排除设计。它提供了全面的工具集，帮助开发者监控、评估和优化 LLM 应用程序的性能和行为。

主页: <[***]>

核心功能和特性

跟踪(Tracing) - 使用基于 OpenTelemetry 的工具跟踪 LLM 应用的运行时。
评估(Evaluation) - 利用 LLM 通过响应和检索评估来基准测试应用性能。
数据集(Datasets) - 创建用于实验、评估和微调的版本化示例数据集。
实验(Experiments) - 跟踪和评估提示、LLM 和检索的变化。
游乐场(Playground) - 优化提示、比较模型、调整参数和重放跟踪的 LLM 调用。
提示管理(Prompt Management) - 使用版本控制、标记和实验系统地管理和测试提示更改。

使用场景和适用范围

Phoenix 适用于以下场景：

LLM 应用程序的可观测性和监控
AI 模型性能评估和基准测试
提示工程和优化
模型和提示的版本控制与实验跟踪
数据集管理和模型微调
多模型比较和参数调优

维护者

名称	***	网址
arize	<***>	<[***]>

源代码

https://github.com/Arize-ai/phoenix

部署要求

仓库	名称	版本
oci://registry-1.docker.io/bitnamicharts	postgresql	16.7.8

部署方案示例

Docker Run 部署

bash
# 简单启动 Phoenix（使用内置 SQLite）
docker run -p 6006:6006 arizephoenix/phoenix:version-10.11.0-nonroot

# 使用外部 PostgreSQL 启动
docker run -p 6006:6006 \
  -e PHOENIX_POSTGRES_HOST=your-postgres-host \
  -e PHOENIX_POSTGRES_PORT=5432 \
  -e PHOENIX_POSTGRES_USER=postgres \
  -e PHOENIX_POSTGRES_PASSWORD=your-password \
  -e PHOENIX_POSTGRES_DB=phoenix \
  arizephoenix/phoenix:version-10.11.0-nonroot

Docker Compose 部署

yaml
version: '3.8'

services:
  phoenix:
    image: arizephoenix/phoenix:version-10.11.0-nonroot
    ports:
      - "6006:6006"
    environment:
      - PHOENIX_HOST=0.0.0.0
      - PHOENIX_PORT=6006
      - PHOENIX_POSTGRES_HOST=postgres
      - PHOENIX_POSTGRES_PORT=5432
      - PHOENIX_POSTGRES_USER=postgres
      - PHOENIX_POSTGRES_PASSWORD=postgres
      - PHOENIX_POSTGRES_DB=phoenix
      - PHOENIX_ENABLE_AUTH=true
      - PHOENIX_DEFAULT_ADMIN_PASSWORD=admin
    depends_on:
      - postgres

  postgres:
    image: postgres:14.5
    environment:
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=postgres
      - POSTGRES_DB=phoenix
    volumes:
      - postgres-data:/var/lib/postgresql/data

volumes:
  postgres-data:

Helm Chart 部署

bash
# 添加 Helm 仓库
helm repo add arize https://arize-ai.github.io/phoenix/helm-charts/

# 安装 Phoenix Helm Chart
helm install phoenix arize/phoenix --version 1.0.8

# 自定义配置安装
helm install phoenix arize/phoenix \
  --version 1.0.8 \
  --set auth.defaultAdminPassword=your-secure-password \
  --set service.type=LoadBalancer \
  --set postgresql.enabled=true

配置参数说明

认证配置

参数	类型	默认值	描述
auth.accessTokenExpiryMinutes	int	`60`	访问令牌过期并需要续订前的分钟数 (PHOENIX_ACCESS_TOKEN_EXPIRY_MINUTES)
auth.allowedOrigins	list	`[]`	允许跨域请求访问 Phoenix API 的 CORS 源列表 (PHOENIX_ALLOWED_ORIGINS)
auth.csrfTrustedOrigins	list	`[]`	用于 CSRF 保护的受信任源列表，以防止跨站请求伪造*** (PHOENIX_CSRF_TRUSTED_ORIGINS)
auth.defaultAdminPassword	string	`"admin"`	初始设置时管理员用户的默认密码，安全存储在 Secret 中
auth.enableAuth	bool	`true`	启用 Phoenix 的身份验证和授权 (PHOENIX_ENABLE_AUTH)
auth.name	string	`"phoenix-secret"`	包含身份验证凭据的 Kubernetes Secret 名称
auth.passwordResetTokenExpiryMinutes	int	`60`	密码重置令牌过期前的分钟数 (PHOENIX_PASSWORD_RESET_TOKEN_EXPIRY_MINUTES)
auth.refreshTokenExpiryMinutes	int	`43200`	刷新令牌过期前的分钟数 (PHOENIX_REFRESH_TOKEN_EXPIRY_MINUTES)
auth.secret[0].value	string	`""`	用于加密的主要 Phoenix 密钥的环境变量名，为空时自动生成
auth.secret[1].value	string	`""`	管理员密钥的环境变量名，为空时自动生成
auth.secret[2].value	string	`"postgres"`	PostgreSQL 密码的环境变量名，使用 postgres 时必须与 database.postgres.password 匹配
auth.secret[3].value	string	`""`	SMTP 密码的环境变量名，为空时自动生成
auth.secret[4].value	string	`""`	初始设置时管理员用户的默认密码环境变量名，为空时使用 defaultAdminPassword
auth.useSecureCookies	bool	`false`	启用安全 cookie（使用 HTTPS 时应设为 true）

数据库配置

参数	类型	默认值	描述
database.allocatedStorageGiB	int	`10`	数据库持久卷的存储分配（GiB）
database.defaultRetentionPolicyDays	int	`0`	跟踪的默认保留策略（天）。设为 0 可禁用自动跟踪清理。当设为正值时，超过此天数的跟踪将自动从数据库中删除。
database.postgres.db	string	`"phoenix"`	PostgreSQL 数据库名称 (PHOENIX_POSTGRES_DB)
database.postgres.host	string	`"phoenix-postgresql"`	Postgres 主机 (PHOENIX_POSTGRES_HOST)。当 postgresql.enabled=true 时，默认指向内置 PostgreSQL 服务。
database.postgres.password	string	`"postgres"`	PostgreSQL 密码（应与 auth.secret."PHOENIX_POSTGRES_PASSWORD" 匹配）
database.postgres.port	int	`5432`	PostgreSQL 连接端口 (PHOENIX_POSTGRES_PORT)
database.postgres.schema	string	`""`	要使用的 PostgreSQL 模式 (PHOENIX_SQL_DATABASE_SCHEMA)
database.postgres.user	string	`"postgres"`	PostgreSQL 用户名 (PHOENIX_POSTGRES_USER)
database.url	string	`""`	完整的数据库连接 URL（如果提供，将覆盖 postgres 设置）。用于外部数据库如 RDS。示例：postgresql://username:***:5432/phoenix。使用此选项时，确保 postgresql.enabled=false

镜像配置

参数	类型	默认值	描述
image.pullPolicy	string	`"IfNotPresent"`	Phoenix 容器的镜像拉取策略（Always、IfNotPresent 或 Never）
image.repository	string	`"arizephoenix/phoenix"`	Phoenix 的 Docker 镜像仓库
image.tag	string	`"version-10.11.0-nonroot"`	要部署的 Docker 镜像标签/版本

部署配置

参数	类型	默认值	描述
deployment.strategy	object	`{"type":"RollingUpdate","rollingUpdate":{"maxUnavailable":"25%","maxSurge":"25%"}}`	部署策略
replicaCount	int	`1`	Phoenix pod 副本数

健康检查配置

参数	类型	默认值	描述
healthChecks.livenessProbe	object	`{"initialDelaySeconds":0,"periodSeconds":10,"timeoutSeconds":5,"failureThreshold":3,"successThreshold":1}`	存活探针配置
healthChecks.readinessProbe	object	`{"initialDelaySeconds":0,"periodSeconds":5,"timeoutSeconds":3,"failureThreshold":3,"successThreshold":1}`	就绪探针配置
healthChecks.startupProbe	object	`{"enabled":true,"initialDelaySeconds":1,"periodSeconds":1,"timeoutSeconds":1,"failureThreshold":30,"successThreshold":1}`	启动探针配置

入口配置

参数	类型	默认值	描述
ingress.annotations	object	`{}`	要添加到入口资源的注释
ingress.apiPath	string	`"/"`	Phoenix API 的路径前缀
ingress.enabled	bool	`true`	启用入口控制器以进行外部访问
ingress.host	string	`""`	入口的主机名
ingress.labels	object	`{}`	要添加到入口资源的标签
ingress.pathType	string	`"Prefix"`	入口路径类型（Prefix、Exact 或 ImplementationSpecific）
ingress.tls.enabled	bool	`false`	为入口启用 TLS/HTTPS

日志配置

参数	类型	默认值	描述
logging.dbLevel	string	`"warning"`	数据库日志级别（debug、info、warning、error）
logging.level	string	`"info"`	应用程序日志级别（debug、info、warning、error）
logging.logMigrations	bool	`true`	启用数据库迁移操作的日志记录
logging.mode	string	`"default"`	日志模式配置（default 或 structured）

存储配置

参数	类型	默认值	描述
persistence.accessModes	list	`["ReadWriteOnce"]`	持久卷的访问模式
persistence.annotations	object	`{}`	要添加到 PVC 的注释
persistence.enabled	bool	`false`	为 Phoenix 主目录启用持久存储
persistence.inMemory	bool	`false`	启用 sqlite 策略的内存配置
persistence.labels	object	`{}`	要添加到 PVC 的标签
persistence.size	string	`"20Gi"`	Phoenix 主目录持久卷的大小
persistence.storageClass	string	`""`	Phoenix 主卷的 Kubernetes 存储类

PostgreSQL 配置

参数	类型	默认值	描述
postgresql.enabled	bool	`true`	启用 postgres 部署。如果您有自己的 postgres 实例（例如 RDS、CloudSQL），请设为 false。
postgresql.auth.database	string	`"phoenix"`	要创建的自定义数据库的名称
postgresql.auth.password	string	`""`	要创建的自定义用户的密码。如果提供了 postgresql.auth.existingSecret，则忽略
postgresql.auth.postgresPassword	string	`"postgres"`	"postgres" 管理员用户的密码。如果提供了 postgresql.auth.existingSecret，则忽略
postgresql.auth.username	string	`""`	要创建的自定义用户的名称
postgresql.primary.persistence.enabled	bool	`true`	为 PostgreSQL 数据启用持久存储
postgresql.primary.persistence.size	string	`"20Gi"`	PostgreSQL 持久卷的大小
postgresql.primary.persistence.storageClass	string	`""`	PostgreSQL 卷的 Kubernetes 存储类

资源配置

参数	类型	默认值	描述
resources	object	`{"limits":{"cpu":"1000m","memory":"2Gi"},"requests":{"cpu":"500m","memory":"1Gi"}}`	资源配置

安全上下文配置

参数	类型	默认值	描述
securityContext.container	object	`{"allowPrivilegeEscalation":false,"capabilities":{"add":[],"drop":["ALL"]},"enabled":true,"privileged":false,"procMount":"Default","readOnlyRootFilesystem":true,"runAsGroup":65532,"runAsNonRoot":true,"runAsUser":65532,"seccompProfile":{"type":"RuntimeDefault"}}`	容器级安全上下文设置
securityContext.pod	object	`{"enabled":true,"fsGroup":65532,"fsGroupChangePolicy":"OnRootMismatch","runAsGroup":65532,"runAsNonRoot":true,"runAsUser":65532,"seccompProfile":{"type":"RuntimeDefault"}}`	Pod 级安全上下文设置

服务配置

参数	类型	默认值	描述
service.type	string	`"NodePort"`	Phoenix 服务的服务类型（ClusterIP、NodePort、Load*** 或 ExternalName）
service.annotations	object	`{}`	要添加到 Phoenix 服务的注释（对服务网格配置有用）
service.labels	object	`{}`	要添加到 Phoenix 服务的标签

服务器配置

参数	类型	默认值	描述
server.enablePrometheus	bool	`false`	在端口 9090 上启用 Prometheus 指标端点
server.grpcPort	int	`4317`	OpenTelemetry gRPC 收集器的端口 (PHOENIX_GRPC_PORT)
server.host	string	`"0.0.0.0"`	绑定 Phoenix 服务器的主机 IP (PHOENIX_HOST)
server.hostRootPath	string	`""`	Phoenix UI 和 API 的根路径前缀 (PHOENIX_HOST_ROOT_PATH)
server.port	int	`6006`	Phoenix Web UI 和 HTTP API 的端口 (PHOENIX_PORT)
server.rootUrl	string	`""`	Phoenix 的外部根 URL (PHOENIX_ROOT_URL)
server.workingDir	string	`"/data"`	用于保存、加载和导出数据的工作目录 (PHOENIX_WORKING_DIR)
server.allowExternalResources	bool	`true`	允许调用外部资源，如 Web 界面中的 Google Fonts

SMTP 配置

参数	类型	默认值	描述
smtp.hostname	string	`""`	用于发送电子邮件的 SMTP 服务器主机名 (PHOENIX_SMTP_HOSTNAME)
smtp.mailFrom	string	`"noreply@arize.com"`	用作系统电子邮件发件人的电子邮件地址 (PHOENIX_SMTP_MAIL_FROM)
smtp.password	string	`""`	SMTP 身份验证密码 (PHOENIX_SMTP_PASSWORD)
smtp.port	int	`587`	SMTP 服务器端口（通常 587 用于 TLS）
smtp.username	string	`""`	SMTP 身份验证用户名 (PHOENIX_SMTP_USERNAME)
smtp.validateCerts	bool	`true`	验证 SMTP 服务器 TLS 证书 (PHOENIX_SMTP_VALIDATE_CERTS)

TLS 配置

参数	类型	默认值	描述
tls.caFile

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问标签列表页面。

轩辕镜像加速拉取命令点我查看更多 phoenix-helm 镜像标签

docker pull docker.xuanyuan.run/arizephoenix/phoenix-helm:<标签>

使用方法：

DockerHub 原生拉取命令

docker pull arizephoenix/phoenix-helm:<标签>

轩辕镜像配置手册

按平台快速找到配置文档

Docker

登录仓库拉取

登录认证 · 私有仓库

专属域名拉取

免登录 · 高速拉取

Linux

Docker 镜像配置

Windows / Mac

Docker Desktop 配置

MacOS OrbStack

OrbStack 容器

Apple Container

macOS 原生容器

Docker Compose

Compose 项目配置

NAS

群晖

Synology 配置

飞牛

fnOS 镜像配置

绿联

绿联 NAS

威联通

QNAP 配置

极空间

极空间 NAS

Unraid

Unraid NAS

企业仓库

其他仓库

ghcr · Quay · nvcr

Harbor 镜像源

Proxy Repository 对接

Portainer 镜像源

Registries 配置

Nexus 镜像源

Docker Proxy 缓存

开发工具

Dev Containers

VS Code 开发容器

Podman

Podman 配置指南

Singularity / Apptainer

HPC 科学计算容器

Kubernetes

K8s Containerd

Kubernetes · Containerd

K3s

轻量级集群

面板 / 网络

爱快路由

iKuai 镜像加速

宝塔面板

一键配置镜像源

AI

用 AI 使用轩辕镜像

agents.md · AI 对话 · 提示词

一键安装

一键安装 Docker

Linux Docker 一键安装

需要其他帮助？请查看我们的常见问题Docker 镜像访问常见问题解答或提交工单

镜像拉取常见问题

功能

版本功能对比

功能对比 · 版本选择

支持的镜像仓库

Docker Hub · GCR · GHCR

新手拉取配置

docker search 限制

专属域名 · Hub 搜索

不支持 push

仅支持 pull · 不支持

拉取速度原因

带宽 · 缓存 · 冷热镜像

错误码

402 与流量用尽

402 · 流量包 · 充值

401 认证失败

401 · docker login

manifest unknown

标签错误 · 镜像不存在

410 Gone 排查

410 · Docker 升级

429 限流

免费版 · 请求频率

其他报错

DNS 超时

DNS 解析 · 网络超时

TLS 证书失败

no matching manifest（架构）

账号

失败是否计费

manifest · blob · 计费

申请开发票（企业 / 个人）

企业 · 个人 · 工单

修改登录密码

网站 · 仓库 · 重置

注销账户

工单 · 数据 · 注销

原理

mirrors 不生效

daemon.json · 重启

去掉域名前缀

docker tag · 重命名

指定架构拉取

ARM64 · AMD64 · 多架构

latest 与「最新」

digest · 版本号 · 标签

查看全部问题→

用户好评

来自真实用户的反馈，见证轩辕镜像的优质服务

oldzhang

运维工程师

Linux服务器

"Docker访问体验非常流畅，大镜像也能快速完成下载。"