计费与定价行为
Hina 的 billing/pricing 用于展示节点流量配额、公开价格标签、到期时间和相关告警。它不会主动限速或断开 Agent;超额与到期状态主要用于展示、筛选和告警。
每个节点可以配置一个流量配额、计费模式和重置日。
| 字段 | 说明 |
|---|---|
| 配额 | 当前计费周期内允许使用的流量。0 表示不限量,也不会参与配额告警。 |
| 计费模式 | 决定 usedBytes 如何计算:sum 为下载 + 上传,rx 只看下载,tx 只看上传,max 取下载和上传中的较大值。 |
| 重置日 | 取值 1..31,按 UTC 日期计算当前计费周期。 |
计费周期使用 UTC 日期边界,而不是站点时区。公开页面和管理页面展示的当前周期流量都基于同一套 UTC 周期计算。
重置日表示每月哪一天开始新的计费周期。例如重置日为 15 时,4 月 15 日 UTC 起进入新周期。
如果某个月没有配置的日期,Hina 会把该月的有效重置点视为下个月 1 日 UTC。例如:
- 重置日为
31时,2 月没有 31 日;3 月 1 日 UTC 会成为有效重置点。 - 重置日为
30时,非闰年 2 月没有 30 日;3 月 1 日 UTC 会成为有效重置点。
因此,建议生产环境优先使用 1..28 作为重置日;只有确实需要按月末语义展示时,再使用 29..31。
价格与到期时间
Section titled “价格与到期时间”Pricing 信息包含货币、金额、计费周期和到期时间,主要用于公开页面展示价格标签,以及驱动到期提醒告警。
支持的计费周期:
| 周期 | 自动续期步长 |
|---|---|
monthly | 1 个月 |
quarterly | 3 个月 |
semiannual | 6 个月 |
annual | 1 年 |
biennial | 2 年 |
triennial | 3 年 |
lifetime | 不自动续期 |
到期时间为空时,节点不会被视为即将到期。lifetime 周期不会被自动续期。
服务端会每小时检查一次已过期的非 lifetime 节点,并按计费周期把到期时间推进到未来。
自动续期只处理最近 72 小时 内上报过数据的节点。长时间离线的节点不会被自动续期,直到它重新上报后才会重新进入检查范围。
按月推进到期时间时,如果目标月份没有原日期,会钳制到目标月份最后一天。例如 1 月 31 日按月续期到 2 月时,会变成 2 月最后一天。
quota_exceeded 告警使用当前计费周期内的 usedBytes / quotaBytes 计算百分比。只有配额大于 0 的节点会参与评估。
告警条件是严格大于阈值,而不是大于等于。例如:
- 阈值为
80:使用量超过 80% 时触发。 - 阈值为
100:正好 100% 不触发,超过 100% 才触发。
更多告警生命周期、触发延迟和恢复通知行为见 告警。