pyroscope在linux服务器上部署简单轻量，适合开发测试快速过渡到生产环境；核心是启动server并接入agent推送剖析数据，资源占用低、无复杂依赖。

Pyroscope 在 Linux 服务器上部署简单、轻量，适合从开发测试快速过渡到生产环境。核心是启动服务端（Server），再让应用通过 Agent 推送剖析数据。整个过程无需复杂依赖，对系统资源占用极低（CPU

一键 Docker 部署（推荐）

这是最稳妥、隔离性好、适配性强的方式，适用于绝大多数 Linux 发行版（Ubuntu/CentOS/Debian 等）：

• 确保已安装 Docker（≥20.10）和 docker-compose（可选）
• 拉取并运行官方镜像：
  docker run -d --name pyroscope -p 4040:4040 -v /opt/pyroscope/data:/var/lib/pyroscope grafana/pyroscope:latest
• 映射本地目录 /opt/pyroscope/data 用于持久化存储，避免容器重启后数据丢失
• 访问 http://你的服务器IP:4040 即可打开 Web UI，看到“Ready”状态表示服务正常

二进制方式（无 Docker 环境）

适用于受限环境（如某些安全加固的生产节点），直接运行可执行文件：

宝塔Linux面板11.8.1

宝塔Linux面板11.8.1为官网当前正式版，新增AI建站能力并经过宝塔网站工程师深度调教，开放自定义AI功能API，同时对WAF进行界面重构和深度优化，提升拦截能力与运维效率。

下载

• 下载对应架构的二进制（如 Linux AMD64）：
  curl -fL https://github.com/grafana/pyroscope/releases/download/v1.10.0/pyroscope_1.10.0_linux_amd64.tar.gz | tar xvz
• 赋予执行权限并启动：
  chmod +x pyroscope && ./pyroscope --server.http-listen-port=4040 --storage.local-path=/opt/pyroscope/data
• 建议用 systemd 托管，创建 /etc/systemd/system/pyroscope.service，启用开机自启

基础配置要点（YAML 文件）

若需定制行为（如启用认证、切换存储后端），推荐使用配置文件。创建 /etc/pyroscope/config.yml：

• 监听与日志：设置 server.http_listen_port 和 log.level: info
• 存储路径：指定 storage.local.path，确保目录有写权限
• 安全选项：生产环境建议开启 auth.enabled: true 并配置 JWT 或 basic auth
• 配置生效方式：docker run -v /etc/pyroscope/config.yml:/etc/pyroscope/config.yml -e PYROSCOPE_CONFIG=/etc/pyroscope/config.yml ...

验证与连通性检查

部署完成后，务必确认服务可达且能接收数据：

• 本地检查健康状态：curl http://localhost:4040/ready → 应返回 OK
• 查看实时配置：curl http://localhost:4040/api/v1/status/config
• 集成一个测试应用（如 Python 或 Go SDK）后，等待 1–2 分钟，在 UI 的 “Explore Profiles” 中应出现对应 application_name 的火焰图
• 若无数据，重点排查：Agent 是否正确配置 server_address、网络是否通（telnet 服务器IP 4040）、防火墙是否放行端口