一个用户态欺骗层,将 DDoS 和机器人滥用转化为徒劳无功。
Net Ward 作为反向代理位于你的 HTTP 服务前端。真实流量原样通过。已知的探测和洪水攻击会收到无害的镜像响应,消耗机器人的精力且永远不会到达你的应用——无需内核钩子、无需载荷、无需反击,设计上故障开放。
由 Dragon Lady 构建和维护 — github.com/Dragon-Lady · X: @answerislove2 独立安全研究员,追踪野外的实时供应链和机器人滥用活动。
网站: dragon-lady.github.io/netward-standalone
版本 0.5.0 扩展了探测匹配,刷新了定义同时保留操作者设置和历史记录,并在上游不可用时对未匹配请求返回 503。升级前请停止代理并备份其数据库;请查阅下方的定义刷新和回滚指南。
python -m pip install --upgrade "netward>=0.5.0"
# Create config.json in a directory owned by your user (not directly in /tmp).
cat > config.json <<'JSON'
{
"node_id": "netward-local",
"upstream_target": "http://127.0.0.1:9000",
"listen_address": "127.0.0.1:8080",
"storage_path": "netward.db"
}
JSON
# Edit upstream_target to point at your running app before starting.
python -m netward --config config.json
0.5.0 或更高版本是新安装和升级的推荐基线。旧版本仍可用于复现;新部署应使用当前版本。
或从源码安装:
git clone https://github.com/Dragon-Lady/netward-standalone
cd netward-standalone
pip install -e .
Net Ward 监听 listen_address,并将干净流量转发至 upstream_target。
对于 PyPI 安装,请使用上面的最小 config.json。完整的 example_config.json 是仓库文件,而非安装后的 wheel 资源。从源代码检出时,复制该文件并编辑上游目标:
cp example_config.json config.json
在启动 Net Ward 之前,请将 upstream_target 指向一个真实的 HTTP 服务。如果上游不可达,未匹配的请求将返回 503 Service Unavailable。已匹配的探测请求仍会收到其配置的诱饵响应。
必填字段:
| 字段 | 含义 |
|---|---|
node_id | 此 Net Ward 实例的稳定名称 |
upstream_target | 受保护的 HTTP 服务 |
listen_address | Net Ward 绑定的主机和端口 |
可选字段用于控制镜像强度、本地存储、网格占位符、告警通道、上游超时以及探测日志保留。模式匹配或请求洪泛开始时会在 SQLite 中记录一条告警。告警按类型、来源和模式在五分钟内去重。alert_channels 列表为空时输出到 stdout;可选择 stdout、email、slack 和 ntfy 的任意组合以显式投递。出站投递在后台运行,并会重试失败的通道。最近未投递的告警会在启动时重试。
Email 需要 alert_email、alert_smtp_host 和 alert_smtp_from。设置 alert_smtp_port 和 alert_smtp_security(starttls、ssl 或 none);none 仅允许用于回环 SMTP 服务器。如需身份验证,请将 alert_smtp_username 和 alert_smtp_password_env 设置为包含密码的环境变量名称。Slack 需要 alert_slack_webhook。ntfy 需要 alert_ntfy_topic(ntfy.sh 上的主题或完整的自托管主题 URL);对于受保护的主题,请将 alert_ntfy_token_env 设置为包含其 bearer token 的环境变量名称。HTTP 目标必须使用 HTTPS,回环地址除外。alert_timeout_secs 默认为五秒。Net Ward 会在启动时检查所请求的目标,并将成功投递的回执存储在 alerts 表中。告警消息包含源 IP、模式 ID 和分类;不包含原始请求体或请求头。
| 可选字段 | 默认值 | 含义 |
|---|---|---|
upstream_timeout_total | 10 | 上游调用的整体请求预算,单位为秒 |
upstream_timeout_connect | 3 | 连接(DNS + TCP + TLS)超时,单位为秒 |
upstream_timeout_sock_read | 5 | 上游套接字读取之间的空闲时间,单位为秒 |
upstream_max_concurrency | 64 | 进行中的上游请求数 |
upstream_max_body_bytes | 8388608 | 缓冲的上游响应体最大值(8 MiB)。未匹配请求的更大响应体将返回 503 |
probe_retention_secs | 604800 | 探测日志 TTL(7 天) |
probe_max_rows | 10000 | 写入时清除后的探测日志最大行数 |
alert_timeout_secs | 5 | 出站告警投递的每通道超时,单位为秒 |
python -m netward --config config.json
示例拓扑:
| 组件 | 地址 |
|---|---|
| Net Ward | 127.0.0.1:8080 |
| 上游应用 | http://127.0.0.1:9000 |
| 存储 | netward.db |
将你的负载均衡器或 Web 服务器指向 Net Ward。在可能的情况下,保持上游应用仅可从主机或受信任网络访问。
仅当你确实希望 Net Ward 可在 localhost 之外访问时,才将 listen_address 设置为 0.0.0.0:<port>。
在 Linux/macOS 上,保持 storage_path 不可被所有用户写入。例如:chmod 600 netward.db,或仅当你确实需要为监控提供读取权限时才使用 chmod 644 netward.db。
Net Ward 可持续维持其文档所述的每台机器容量,但 Python 运行时内存池在持续高负载后可能会保留工作集状态。在持续高流量下运行 Net Ward 的运维人员应监控进程资源使用情况,并定期重启守护进程,例如每周一次,或在 RSS 超过基线 2 倍时重启。v0.5 将根据运维人员反馈和本地测试观察(而非自动遥测)完善此指导。
干净的请求应能到达上游:
curl -i http://127.0.0.1:8080/
已知探针应被镜像:
curl -i http://127.0.0.1:8080/wp-admin/
WordPress 探测会为 /wp-admin、/wp-admin/ 及其子路径(例如 /wp-admin/login.php)以及 /wp-login.php 返回一个伪造的登录页面。匹配不区分大小写,且不包含 /wp-administer 这类相似路径。当渲染成功时,上游服务不会收到该请求。
在保护真实管理面板之前: 如果你的应用使用 /admin 或 /admin/login,请禁用 generic_admin_login_probe;如果它提供 WordPress 管理路径,请禁用 wordpress_admin_probe。参见操作员命令。镜像渲染错误则会以 fail-open 方式转发到上游,并以 ERROR 级别记录日志。
检查失败与上游不可用是两种不同的情况:
Cache-Control: no-store 和 Retry-After: 30。当转发失败时,分类器失败也遵循同一规则。这些响应不计为镜像或干净透传事件。监控系统可以观察到该故障。共有五个默认变体,由源 ID 和路径的稳定摘要选择。相同的源 ID 和路径会得到相同的变体;正文内生成的字段可能有所不同。当源查找不可用时,基于每个客户端的确定性回退 ID 可保持重复请求的稳定性。在较旧的已存储 ID 与回退 ID 之间切换可能会使变体改变一次。
| 状态 | 默认响应 |
|---|---|
| 200 | 带 ID 和时间戳的 JSON 状态 |
| 429 | 带 Retry-After: 30 的 JSON 速率限制响应 |
| 503 | HTML Service Unavailable 页面 |
| 200 | 带 data: null 和 next: null 的 JSON |
| 200 | 纯文本 OK |
在上游故障期间,未匹配的 curl -i http://127.0.0.1:8080/healthz 会返回 503。上述变体仅适用于匹配探测的回退。匹配健康端点的自定义规则仍会拦截它;请将监控路径排除在此类规则之外。
默认超时为连接 3 秒、套接字读取之间 5 秒、总计 10 秒。转发异常、超时和正文上限回退以 WARNING 级别记录日志,不包含上游 URL、请求数据或异常消息。
如果可写 SQLite 启动失败,Net Ward 会记录一条警告并仍然开始提供服务。它首先尝试以只读方式打开现有数据库,保留可读的操作员模式和禁用项。当已检查点的 WAL 数据库无法在不创建附属文件的情况下读取时,它会在确认源未发生变化且没有 WAL、共享内存或回滚日志文件后,使用私有只读快照。正常的 SQLite 读取器会处理现有 WAL 文件,因此 WAL 中已提交的策略更改会被保留;快照回退绝不会忽略它们。快照策略在重启前保持固定。如果两条读取路径都不可用、数据库已损坏或没有模式,它将在无持久化的情况下运行,使用内置的探测模式和内存中的镜像正文。临时快照仅用于读取,并在干净关闭时删除,包括在支持事件循环信号支持的平台上收到 SIGTERM 时,以及监听器设置失败时。它不是可写数据库的替代品。SIGKILL、断电以及不支持优雅信号处理的平台可能会留下该私有目录。
在运行时,模式刷新失败会保留上一次成功读取的模式集,包括有意设置为空的情况。若从未成功读取过,则内置默认值也会覆盖首次请求。厂商镜像查找失败时可以使用其内置响应体。未匹配的请求会继续转发到真实应用。
限制: 当存储及其缓存配置均不可用时,自定义模式和有意禁用无法恢复;内置默认值可能会镜像你的真实应用所使用的路径。在没有可写存储的情况下,报告、计数器、持久化告警队列和投递回执都不可靠。警告会指明失败的操作和异常类,绝不会包含私有异常消息,并且每个存储操作最多每分钟重复一次。恢复数据库访问并重启,以退出只读/无持久化的启动模式。格式错误的配置以及显式的全局可写路径安全检查仍会拒绝启动。
用于测试时,在已打开的 Linux 数据库上更改模式位可能无法阻止通过现有描述符进行的写入。请使用一个全新的进程,配合只读文件和目录,或在隔离测试中注入真实的存储错误。不要为了测试此行为而对生产数据库制造故障。
使用上面的示例拓扑,一次健康的首轮运行应如下所示:
127.0.0.1:9000 上启动一个小型上游服务。127.0.0.1:8080 上启动 Net Ward。/,确认上游响应能够返回。/wp-admin/,确认返回的是镜像响应。预期结果:正常流量到达上游应用,而已知探测请求由 Net Ward 的镜像层处理。这是代理路径、模式匹配和镜像响应均正常工作的最简单信号。
安装或刷新内置的厂商模式集:
python -m netward.cli --db netward.db install-patterns
python -m netward.cli --db netward.db install-patterns --force
本次开发更新会在启动时自动刷新厂商定义。 升级前请停止代理并备份数据库。重启前请审阅新的规则 族:新的默认规则会变为启用状态,而可选 规则初始为禁用状态。现有的启用、禁用、创建时间戳和匹配 历史在正常刷新和强制刷新后均会保留,即使所有现有厂商 规则都被禁用。过期清理会保留已禁用的厂商策略记录。
厂商拥有的匹配字段和诱饵内容会被刷新。请将自定义规则 放在单独的运营方来源 ID 下。非厂商规则及其引用的现有镜像 会被保留。刷新要么作为一个事务完成,要么回滚;格式错误的包 无法部分安装。在离线 CLI 刷新后请重启,以便代理 立即使用更新后的定义。
这些保证适用于本次更新。在 0.4.14 及更早版本中,包升级
不会刷新定义,且 install-patterns --force 可能会重置禁用状态
和匹配历史。
默认包新增了 PHP 诊断文件、命名环境文件、
服务账号凭据、私有凭据文件、仓库元数据、
基础设施状态、诊断日志和源代码备份。重复斜杠仅在
匹配时被折叠。转发路径和查询字符串保留其
原始编码。分类还会解析 . 和 .. 路径段,并
移除末段填充(尾部点、NUL 和空白)、;... 路径
参数以及不区分大小写的 ::$data 后缀。这仅更改匹配
副本,包括 HTTP 服务器已解码的编码形式。它不会
进行第二次解码,也不会从中间目录名中剥离后缀。通用
应用程序页面不会被添加到默认值中。
以下规则以禁用状态安装,因为真实站点可能会提供 这些路径。仅启用你的应用程序未使用的规则族:
| 可选规则 | 可拦截的内容 |
|---|---|
short_php_diagnostic_probe | 短 PHP 名称,例如测试或信息页面 |
framework_diagnostic_route_probe | 框架诊断和服务器状态路由 |
deployment_file_probe | 部署和自动化配置下载 |
runtime_configuration_file_probe | 公共运行时配置和通用 JSON 键文件 |
database_download_probe | 命名 SQL 下载 |
archive_download_probe | 命名站点归档下载 |
cms_manifest_probe | CMS 清单和开发库路径 |
例如,在审阅你的路由之后:
python -m netward.cli --db netward.db enable-pattern framework_diagnostic_route_probe
刷新会保留此启用状态,直到你再次显式禁用该规则。