一条命令把Krawl蜜罐服务器部署到Kubernetes:终极Helm Chart指南(含高可用配置与数据迁移)

原创2026-10-26 20:19:541,723 阅读

一条命令把Krawl蜜罐服务器部署到Kubernetes:终极Helm Chart指南(含高可用配置与数据迁移)

Krawl 是一款开源的云原生蜜罐服务器与反爬虫(anti-crawler)工具,通过生成逼真的"漏洞百出"的假网站来诱捕攻击者和恶意爬虫。本文带你用一条 Helm 命令把 Krawl 部署到 Kubernetes,涵盖高可用(HA)配置、Prometheus/Grafana 监控接入,以及从 SQLite 到 PostgreSQL 的数据迁移完整流程,K8s 新手也能照着走完。

一、Krawl 是什么:一个会"钓鱼"的蜜罐服务器

Krawl 会为攻击者随机生成看起来漏洞满满的 Web 应用:假的管理后台、假的 .env 配置文件、假的数据库连接串,还可以用 AI 实时生成欺骗页面。攻击者自以为捡到"低垂的果实",实际上每一步操作都被记录、分类并自动封禁。

Krawl蜜罐服务器生成的假漏洞网页与钓鱼页面

核心能力包括:

  • 🕷️ 欺骗页面:无限随机链接 + 假凭据,拖慢并识别恶意爬虫
  • 🛡️ 自动封禁:基于行为评分自动将攻击者 IP 加入 banlist,可导出为 iptables/nftables 防火墙规则
  • 🧠 AI 生成内容:对接大模型为任意路径动态生成逼真的"漏洞页面"
  • 📊 可视化看板:追踪 IP 攻击类型、凭据捕获、攻击来源分布

更多原理细节可参考 docs/honeypot.md 与 docs/architecture.md。

二、一条命令把 Krawl 部署到 Kubernetes

环境要求(3 个前提)

组件 版本要求
Kubernetes 1.19+
Helm 3.0+
存储 集群需支持动态 PVC 供给(数据库持久化用)

Chart 元信息见 helm/Chart.yaml,当前版本为 2.4.0,生产环境建议锁定 image.tag: "2.4.0" 而不是 latest。

一键安装步骤

# 1. 获取仓库
git clone https://gitcode.com/gh_mirrors/kr/Krawl
cd Krawl

# 2. 一条命令部署(默认 scalable 高可用模式,内置 PostgreSQL + Redis)
helm install krawl ./helm -n krawl-system --create-namespace

这条命令会自动创建 Krawl Deployment、内置的 PostgreSQL 与 Redis StatefulSet、Service、Ingress 以及网络策略。安装完成后:

# 查看入口 IP
kubectl get svc krawl -n krawl-system

# 查看看板秘密路径(自动生成,别用默认值)
kubectl get secret krawl-server -n krawl-system \
  -o jsonpath='{.data.dashboard-path}' | base64 -d && echo

然后访问 http://<EXTERNAL-IP>:5000/<dashboard-path> 即可进入管理看板。

Krawl蜜罐服务器Kubernetes部署架构图:反向代理在前端,后端为看板与欺骗服务

三、高可用配置:两种部署模式怎么选?

Helm Chart 通过 mode 参数提供两种部署模式(详见 docs/deployment-modes.md):

对比项 standalone(单机) scalable(高可用,默认)✅
数据库 SQLite(单文件 + PVC) PostgreSQL
缓存 进程内内存 Redis 多级 TTL 缓存
副本数 固定 1 个 Pod 支持多副本横向扩展
更新策略 Recreate(文件锁限制) RollingUpdate(滚动更新,零停机)
适用场景 开发、测试、低流量 生产环境、高流量

3.1 Scalable 高可用模式(生产推荐)

helm install krawl ./helm -n krawl-system --create-namespace \
  --set replicaCount=3 \
  --set postgres.password=your-password \
  --set redis.password=your-redis-password

高可用的三个关键点:

  1. replicaCount ≥ 2:多个 Pod 共享同一个 PostgreSQL + Redis,滚动更新时服务不中断;
  2. 务必修改默认密码:postgres.password 与 redis.password 占位值不可用于生产;
  3. 可选外接数据库:已有云托管 PostgreSQL/Redis 时,设置 postgres.enabled=false + postgres.host=你的地址 即可跳过内置实例。

仓库自带两份开箱即用的精简配置,推荐直接修改后使用:

完整参数(PostgreSQL 调优、Redis 缓存 TTL、资源限制等)可查阅 helm/README.md 和 helm/values.yaml。

3.2 Standalone 轻量模式

没有外部依赖、单 Pod + SQLite PVC,适合学习和小规模使用:

helm install krawl ./helm -n krawl-system --create-namespace \
  --set mode=standalone \
  --set postgres.enabled=false \
  --set redis.enabled=false

Krawl蜜罐服务器攻击者看板:Top IP地址、User-Agent与访问路径统计

四、数据迁移:从 SQLite 平滑升级到 PostgreSQL

单机模式跑了一段时间后想升级到高可用?Chart 内置了一个迁移 Job(模板见 helm/templates/migration-job.yaml,脚本为 scripts/migrate_sqlite_to_postgres.py),把 SQLite PVC 中的数据批量搬进 PostgreSQL,全程只需 4 条命令:

# 1. 先备份!然后把副本缩到 0(释放 SQLite 文件锁)
helm upgrade krawl ./helm \
  --set replicaCount=0 \
  --set migration.enabled=true \
  --set postgres.password=your-password

# 2. 等待迁移 Job 完成
kubectl wait --for=condition=complete job/krawl-migrate --timeout=600s

# 3. 检查日志,核对源库与目标库行数是否一致
kubectl logs job/krawl-migrate

# 4. 切换为 scalable 高可用模式
helm upgrade krawl ./helm \
  --set mode=scalable \
  --set migration.enabled=false \
  --set replicaCount=2

⚠️ 迁移注意事项:

  • 迁移前务必备份 krawl.db,迁移过程中 Krawl 必须完全停止(副本为 0);
  • Job 默认每批插入 1000 行(migration.batchSize),失败自动重试 3 次,完成后 1 小时自动清理;
  • 切换成功后旧 SQLite PVC 不会自动删除,确认无误后可手动回收。

Krawl蜜罐服务器看板攻击类型分布:SQL注入、路径穿越等攻击检测统计

五、监控接入:Prometheus + Grafana 一键打通

Krawl 默认在 /<看板路径>/metrics 暴露 Prometheus 指标,Chart 同时支持自动生成 Grafana 看板 ConfigMap(看板 JSON 源文件为 helm/files/grafana-dashboard.json):

helm upgrade krawl ./helm \
  --set serviceMonitor.enabled=true \
  --set grafanaDashboard.enabled=true \
  --set config.dashboard.secret_path=/my-secret-dashboard

三个要点:

  • 必须固定 config.dashboard.secret_path,指标路径由它派生,自动生成值无法被采集;
  • serviceMonitor 需要集群已安装 Prometheus Operator,可用 labels 匹配 kube-prometheus-stack 的 selector;
  • 多副本部署时每个 Pod 的累计计数器由 Redis 共享,Grafana 查询请用 max() 聚合而不是 sum(),避免总数被副本数放大。

Krawl蜜罐服务器Grafana监控面板:访问量、蜜罐触发与凭据捕获趋势图

六、常见问题速查(FAQ)

Q1:部署后外部访问不通? 先确认 kubectl get svc krawl -n krawl-system 的 EXTERNAL-IP 已分配;若前面还有 Traefik/nginx 反向代理,需配置 externalTrafficPolicy: Local 并信任代理 IP,否则 Krawl 记录到的是代理 IP 而非真实攻击者 IP(官方说明见 docs/reverse-proxy.md)。

Q2:如何升级到新版本?

helm upgrade krawl ./helm --set image.tag=2.4.0 -f values.yaml

Q3:不想用 Helm,能直接上 YAML 吗? 可以,仓库提供了 All-in-One 清单 kubernetes/krawl-all-in-one-deploy.yaml。

Q4:如何彻底卸载?

helm uninstall krawl -n krawl-system

Q5:部署出问题怎么排查?

helm lint ./helm                    # 校验 Chart 语法
helm install krawl ./helm --dry-run --debug   # 预演渲染结果
kubectl logs -l app.kubernetes.io/name=krawl  # 查看 Pod 日志

至此,一条命令部署、高可用配置、数据迁移、监控接入全部完成。建议从单机模式开始体验 Krawl 的蜜罐能力,生产环境再按本文第三节切换为 scalable 模式,并用第五节的监控方案盯住每一个攻击者。

登录后查看全文
Krawl