一条命令把Krawl蜜罐服务器部署到Kubernetes:终极Helm Chart指南(含高可用配置与数据迁移)
一条命令把Krawl蜜罐服务器部署到Kubernetes:终极Helm Chart指南(含高可用配置与数据迁移)
Krawl 是一款开源的云原生蜜罐服务器与反爬虫(anti-crawler)工具,通过生成逼真的"漏洞百出"的假网站来诱捕攻击者和恶意爬虫。本文带你用一条 Helm 命令把 Krawl 部署到 Kubernetes,涵盖高可用(HA)配置、Prometheus/Grafana 监控接入,以及从 SQLite 到 PostgreSQL 的数据迁移完整流程,K8s 新手也能照着走完。
一、Krawl 是什么:一个会"钓鱼"的蜜罐服务器
Krawl 会为攻击者随机生成看起来漏洞满满的 Web 应用:假的管理后台、假的 .env 配置文件、假的数据库连接串,还可以用 AI 实时生成欺骗页面。攻击者自以为捡到"低垂的果实",实际上每一步操作都被记录、分类并自动封禁。
核心能力包括:
- 🕷️ 欺骗页面:无限随机链接 + 假凭据,拖慢并识别恶意爬虫
- 🛡️ 自动封禁:基于行为评分自动将攻击者 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> 即可进入管理看板。
三、高可用配置:两种部署模式怎么选?
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
高可用的三个关键点:
replicaCount ≥ 2:多个 Pod 共享同一个 PostgreSQL + Redis,滚动更新时服务不中断;- 务必修改默认密码:
postgres.password与redis.password占位值不可用于生产; - 可选外接数据库:已有云托管 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
四、数据迁移:从 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 不会自动删除,确认无误后可手动回收。
五、监控接入: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(),避免总数被副本数放大。
六、常见问题速查(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 模式,并用第五节的监控方案盯住每一个攻击者。




