节点连接下降时,值班人员可能先怀疑网络故障,却忽略了手工封禁清单。listbanned把Bitcoin Core内部的IP或子网封禁变成可审计对象。它能说明当前规则和时间,不负责判断对端一定恶意,也看不到宿主机防火墙等其他层。
每个条目有一条完整时间轴
listbanned列出所有手工封禁的IP或子网。
每项包含address、ban_created、banned_until、ban_duration和time_remaining。
| 字段 | 含义 | 审计用途 |
|---|---|---|
| address | 被封禁IP或子网 | 核对范围是否过宽 |
| ban_created | 创建的Unix时间 | 回查操作与日志 |
| banned_until | 预计到期时间 | 安排复核 |
| ban_duration | 原始持续秒数 | 判断策略是否合规 |
| time_remaining | 当前剩余秒数 | 看板倒计时 |
采集时保存节点时钟、时区转换规则和原始Unix值。展示层可以转成本地时间,但数据库不覆盖原值。ban_duration与time_remaining不同:前者描述设置时长,后者会随时间减少。
address可能覆盖整个子网
看到一个熟悉IP不能只删除单条字符串;先确认条目是单地址还是CIDR子网,评估它会影响多少合法peer。IPv4与IPv6范围分别处理,界面展示前缀长度,避免把/16之类的大范围误当一个主机。
封禁证据应包括触发原因、相关日志、连接时间、节点版本和操作者。没有原因记录的历史条目进入复核队列,而不是默认永久保留或批量清空。
setban的相对和绝对时间不能混用
setban支持add或remove,并可用bantime与absolute控制相对或绝对到期语义。
setban add可配置bantime;absolute决定数值被解释为持续秒数还是绝对Unix时间。自动化使用具名参数并在提交前计算预期banned_until,再与listbanned回读对齐。时间单位或时区错误可能导致过短或异常长的封禁。
规则变更采用两阶段:先生成计划并由第二人复核地址范围和到期,再执行add;执行后立即回读,确认address与时间字段符合计划。失败保留原始RPC错误,不重试扩大范围。
单项解除优先于clearbanned
clearbanned会清空全部手工封禁,批量处置前应先导出listbanned证据,不能用作日常单项删除。
误封一个地址时,用setban remove针对目标处理,并在回读中证明其他条目保持不变。clearbanned会清除全部手工封禁,适合隔离环境重置或经过批准的全量恢复,不应成为“网络不通”的第一步。
必须批量清除时,先导出完整listbanned、计算条目数量与地址范围、保存恢复脚本并设置短维护窗口。清除后观察连接数、入站来源与异常流量,必要时按原记录恢复。
Core清单不包含所有网络控制层
云安全组、iptables、反向代理、DDoS防护和上游网络策略可能继续阻断连接。listbanned为空,只能说明Bitcoin Core手工封禁层没有条目;排障看板把每一层分开,不用一个绿色灯覆盖所有网络。
反过来,Core里存在条目也不等于主机防火墙同步封禁。安全策略需要在哪一层执行,取决于攻击面、证据和变更权限,不能未经评估把地址自动扩散到全部系统。
用到期复核替代永久遗忘
为每个条目设置复核时间,在到期前检查原始原因是否仍成立、对端是否为合法基础设施以及继续封禁的影响。自动到期降低陈旧规则,但高风险事件仍需按策略重新评估,不能机械续期。
监控关注条目数量突增、超大子网、异常长duration、即将到期和没有原因的规则。告警只触发审查,不自动清除或扩大封禁。本文是防御性节点运维指南,不提供攻击方法,也不构成对任何对端的恶意认定。
封禁是可审计的临时控制,不是攻击归因
导出地址、创建、持续、到期和剩余时间,再结合原始日志决定续期或解除。单项误封用remove处理;clearbanned影响全部条目,必须单独批准并保留回滚证据。
资料台账与适用边界
- Bitcoin Core 31 listbanned:封禁对象与五个字段。
- Bitcoin Core 31 setban:添加、移除与时间语义。
- Bitcoin Core 31 clearbanned:全量清除边界。
资料访问时间为2026-08-08。仍需按实际环境复核:反向代理、宿主机防火墙和上游DDoS规则不在listbanned中,节点报告不能代表全部网络封禁层。
相关站内主题:getpeerinfo连接质量、getnodeaddresses抽样、getnetworkinfo连接。本文用于技术教育与防御性运维,不构成投资、收益、交易或资产安全承诺。
发表评论
还没有评论,来说两句吧。
评论区为展示样式,提交不会被处理。