Skip to content

v1.0.0

Latest
Latest

Choose a tag to compare

View all tags
@github-actions github-actions released this 13 Jun 04:06
v1.0.0
37dbd4f
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

v1.0.0 是第一个稳定版本。 自此遵循语义化版本：HTTP API、错误格式、配置文件结构与 WHOIS_* 环境变量在 1.x 内保持稳定，不兼容变更只会出现在未来的主版本。稳定承诺的具体范围见 README「版本与稳定性」。

自 v0.10.0 以来无 API / 配置格式变更，以下为运维加固：

  • 未配置 auth.keys 时启动打印警告，提示该实例对任何能访问到它的来源开放（当 mcp.localhostProtection 关闭时，额外提示 /mcp 无 DNS 重绑定保护）。仅新增警告，行为不变。
  • IANA RDAP bootstrap 拉取上限 2 MiB，与 WHOIS/RDAP 上游读取上限一致，超限拒绝而非无界读取。
  • 数值型配置项为负值时启动直接报错并指明键名（cache.negativeExpiration 保留其“负值=禁用”语义），不再延后崩溃或静默异常。
  • WHOIS_PROXY_SUFFIXES 环境变量逐项去除空白并丢弃空项，与 WHOIS_AUTH_KEYS 一致；"com, net" 现在能匹配 net 而非无法匹配的 " net"。

从 0.x 升级：API 响应格式、错误格式与配置文件结构曾在 0.8.0 有一轮对齐 RDAP 的破坏性调整，详见 CHANGELOG。

九层之台，起于累土；千里之行，始于足下。 ——《老子·道德经》

从 0.1 到 1.0，每一个 0.x 都是一抔累土。稳定不是终点，而是新的起点。感谢一路同行的每一位。🚀

v1.0.0 is the first stable release. From here the project follows Semantic Versioning: the HTTP API, error format, configuration file layout and WHOIS_* environment variables are stable within 1.x; incompatible changes only land in a future major. See "Versioning & Stability" in the README for the exact scope.

No API or configuration-format changes since v0.10.0; the following is operational hardening:

  • A startup warning is logged when no auth.keys are configured, noting the instance accepts requests from anyone who can reach it (and, when mcp.localhostProtection is off, that /mcp has no DNS-rebinding protection). Warning only; no behavior change.
  • IANA RDAP bootstrap fetches are capped at 2 MiB, matching the WHOIS/RDAP upstream read limit; oversized responses are rejected instead of read without bound.
  • Negative values in numeric settings now fail at startup with the offending key named (cache.negativeExpiration keeps its negative "disable" semantics), instead of crashing later or misbehaving silently.
  • WHOIS_PROXY_SUFFIXES values are trimmed and empty entries dropped, matching WHOIS_AUTH_KEYS; "com, net" now matches net instead of the unmatchable " net".

Upgrading from 0.x: the API response format, error format and configuration layout went through one RDAP-alignment breaking change in 0.8.0 — see the CHANGELOG.

"A tower nine stories high begins with a basket of earth; a journey of a thousand miles begins with a single step." — Laozi, Tao Te Ching

From 0.1 to 1.0, every 0.x was a basket of earth. Stability is not the destination, but a new beginning. Thank you to everyone who walked this road. 🚀

Assets 21
Loading