Repository navigation
HighWall v0.9.0
HighWall v0.9.0
本版本聚焦“可安全变更”:在不停机、不混合新旧配置的前提下完成配置和证书切换。
新增
- 原子配置重载:先加载、校验并构建新运行时与 TLS 上下文;失败保留当前配置继续服务。
- TLS 证书热轮换:替换证书/私钥文件或路径后,通过
POST /reload让新握手使用新证书。 - 优雅排空停机:
SIGINT/SIGTERM/SIGBREAK后停止接收新连接,等待在途请求,超时后关闭剩余连接。 - 新增
server.shutdown_timeout,默认 30 秒,可配置 0–300 秒。 - 管理面新增受 Bearer token 保护的
POST /reload;/healthz返回config_generation。 - 新增
config_reloads_total、config_reload_failures_total、drain_rejections_total和config_generation指标。 - POSIX 支持
SIGHUP触发重载。
安全与并发
- 在途请求固定使用取得时的运行时和上游快照。
- 旧运行时在请求结束后释放;未变化的限速、封禁、威胁状态、指标、告警发送器按配置安全复用。
- 修复连接准入期间的 IP 配额释放竞态。
- 上游目标变化时重置熔断状态,避免把旧上游的失败状态带到新目标。
- 监听地址/端口、
max_connections、max_inflight_requests、TLS 启用状态和管理面监听仍需滚动重启。
验证
- 284 项测试通过:Ubuntu/Windows × Python 3.10/3.11/3.12。
compileall、示例配置校验、git diff --check通过。- 构建
highwall-0.9.0-py3-none-any.whl并确认包含highwall/control.py。
完整说明见 README 和 docs/DEPLOYMENT.md。