当前位置：首页 > backend >正文

Popeye

backend 2025/5/19 5:51:09

概览与定位

Popeye 是由 derailed 团队开源的 Kubernetes 集群资源 “Sanitizer”，它以只读方式扫描集群内的各种资源（如 Pod、Service、Ingress、PVC、RBAC 等），并基于社区最佳实践给出问题等级及修复建议，覆盖配置误区、资源浪费及失效对象等场景，帮助运维/SRE 团队快速定位隐患并闭环治理。

轻量 & 多平台：支持 Linux/macOS/Windows
多种输出格式：彩色终端、高亮 JSON、HTML 报表、Prometheus 指标
可定制 SpinachYAML：细粒度调整 Linter 阈值、排除规则、自定义严重级别(测试未到到预期)
CronJob & 容器化：能以 Kubernetes CronJob、GitHub Actions、GitLab CI 等方式实现持续扫描

安装方式

1. 官方二进制包（跨平台）

从 GitHub Releases 页面下载适合平台的 tarball，解压后将 popeye 可执行文件放入 $PATH：

curl -LO https://github.com/derailed/popeye/releases/download
tar zxvf popeye_X.Y.Z_Linux_x86_64.tar.gz
sudo mv popeye /usr/local/bin/

:contentReference[oaicite:5]{index=5}

2. Homebrew / Linuxbrew（macOS & Linux）

brew install derailed/popeye/popeye

自动拉取最新稳定版，安装更简洁。

3. Go Install (Go ≥1.21)

go install github.com/derailed/popeye@latest

可执行文件位于 $GOPATH/bin/popeye。

4. 源码编译

git clone https://github.com/derailed/popeye.git
cd popeye
make build              # 或 go run main.go
sudo mv ./bin/popeye /usr/local/bin/

若需定制，也可在 go.mod 中添加 replace 语句后编译。

5. 容器化运行

docker run --rm \-v ~/.kube/config:/root/.kube/config \derailed/popeye:vX.Y.Z

适合 GitOps 流水线或 Kubernetes CronJob 场景。

基础使用

查看版本与环境

popeye version

输出版本号、Go 版本、日志目录、配置路径等。

扫描集群

默认扫描（当前上下文 & 命名空间）
```
popeye
```
扫描所有命名空间
```
popeye -A
```
指定命名空间
```
popeye -n kube-system
```
按资源类型
```
popeye -s pod,svc,ingress
```
指定上下文
```
popeye --context production-cluster
```

输出 JSON / HTML 报表

popeye --out json  # 终端打印 JSON
POPEYE_REPORT_DIR=./reports popeye --save --out html --output-file report.html

输出指标到 push-gateway

 popeye --push-gtwy-url http://172.30.80.207:9091

日志与调试

调试级别日志
```
popeye -v4 --logs /tmp/popeye.log
```
查看命令行帮助
```
popeye help
```

集成与自动化

1. Kubernetes CronJob（持续审计）

apiVersion: batch/v1
kind: CronJob
metadata:name: popeyenamespace: popeye
spec:schedule: "0 * * * *"      # 每小时执行jobTemplate:spec:template:spec:serviceAccountName: popeye-sarestartPolicy: Nevercontainers:- name: popeyeimage: derailed/popeye:vX.Y.Zargs:- "-o"             - "yaml"          - "--force-exit-zero"volumeMounts:- name: configmountPath: /root/.kubevolumes:- name: configsecret:secretName: kubeconfig-secret