部署实施 | 迪妙网络·蜜罐研究中心

00 · 环境要求

上线前 checklist

软件环境

项目	要求	说明
PHP	>= 7.4	8.x 兼容；需 CLI 模式（计划任务用）
扩展	curl / json	curl 缺失时情报拉取退回 stream 模式
Web服务	Nginx / Apache	伪静态非必需；绑定域名 mi.dimiao.cn
数据库	无需	v1.x 使用JSON文件存储，v2.0可选MySQL
Docker	可选	仅"蜜罐引擎"需要；平台本体纯PHP
计划任务	crontab	每30分钟执行 fetch_feeds.php

数据流与隔离边界

攻击者扫描/爆破/投递

→

HFish蜜罐独立VPC/容器

→

collect.php令牌鉴权

→

本站大屏/情报

蜜罐主机与业务网隔离，出方向仅放行分析服务器
情报拉取为出站只读，不暴露任何入站服务
install.lock 存在时 install.php 自动锁定

01 · 方式A：一键脚本（推荐 Linux）

install.sh 全自动安装

脚本依次完成：环境检测 → 目录权限 → 生成采集令牌 → 首次拉取情报源 → 注册crontab → 可选启动Docker蜜罐引擎。

执行命令

# 上传解压后，在站点根目录执行：
chmod +x install.sh
./install.sh              # 完整安装（含Docker蜜罐引擎）
./install.sh --no-docker  # 仅安装平台本体（PHP空间/虚拟主机场景）

环境检测
校验 PHP≥7.4、curl/json 扩展、data/ 与 logs/ 可写，任一不达标即中止并给出修复提示。
令牌生成
使用 /dev/urandom 生成 24字节随机 collect_token 写入 data/config.json，作为采集接口鉴权凭证。
首次情报拉取
调用 scripts/fetch_feeds.php 立即构建本地缓存；网络不通时告警但不中断安装。
计划任务注册
自动写入 crontab（*/30 分钟），crontab 不可用时打印手动配置命令。
蜜罐引擎
检测到 Docker 时自动 docker-compose up -d 拉起 HFish，并提醒 9001 管理端仅限内网。

02 · 方式B：网页安装向导

install.php 可视化安装

适用于宝塔/虚拟主机等不方便执行脚本的环境：浏览器访问 install.php，检测项全绿后点击"开始安装"即完成初始化，并生成 install.lock 锁定安装入口。

上传文件
将本目录全部文件上传至站点根目录（index.html 与PNG同级）。
访问向导
浏览器打开 https://mi.dimiao.cn/install.php，查看自动检测结果。
初始化
选择轮询间隔 → 开始安装 → 记录页面显示的 collect_token。
收尾
删除 install.php；按页面提示配置 crontab 定时执行 fetch_feeds.php。

03 · 方式C：Docker Compose

容器化完整栈

一条命令同时拉起"平台Web（php:7.4-apache）+ HFish蜜罐引擎"：

docker-compose.yml（已含在站点根目录）

docker-compose up -d    # 启动 web + hfish 两个容器

# 情报缓存刷新（容器内无cron，宿主机配置）：
# */30 * * * * docker exec dimiao-hp-web php /var/www/html/scripts/fetch_feeds.php

宿主22端口被占用时，将 compose 中 "22:22" 改为 "2222:22"
HFish 管理端 9001 仅放行办公IP，首登立即修改默认口令
平台数据卷为当前目录，升级仅需替换文件后 docker restart

04 · 数据源与缓存策略

真实情报从哪来

内置公开情报源（无需API Key，遵守各源条款）

数据源	格式	缓存TTL	内容
blocklist.de	iplist	30分钟	综合攻击IP（全球蜜罐社区回传）
GreenSnow	iplist	30分钟	扫描/攻击封禁IP
FireHOL Level1	netset	60分钟	聚合威胁清单（jsDelivr镜像回退）
Spamhaus DROP	netset	120分钟	垃圾邮件/僵尸网络网段
Feodo Tracker	json	60分钟	僵尸网络C2（abuse.ch官方）
URLhaus	csv	60分钟	活跃恶意软件下载URL

拉取-解析-归一化-合并全部由 api/lib/FeedFetcher.php 完成；新增数据源只需在 data/feeds.json 追加条目（id/urls/format/ttl），零代码改动。全部源不可达时，前端自动展示最近一次缓存或离线快照，页面永不白屏。

运维标准

logs/feeds.log 与 logs/events_raw.jsonl 每日轮转，保留90天
data/ 与 logs/ 权限 750，属主为PHP进程用户
collect_token 每90天轮换一次
备份范围：data/ 全量 + install.sh 同级配置
升级：替换文件 → 保留 data/ 与 logs/ → 执行 fetch_feeds.php 验证

故障排查

现象	原因	解决
IOC列表显示"离线快照"	未执行过fetch_feeds	php scripts/fetch_feeds.php
数据源全部FAIL	出站被墙/无外网	放行443出站或配置代理
collect.php 401	令牌错误	核对 data/config.json
事件流不动	HFish未配Webhook	按集群管理页指南配置
500错误	PHP版本过低	升级至7.4+

蜜罐部署实施