A modern and elegant dashboard for network traffic visualization and analysis.
release: v1.4.2 — community fixes for geoIP, Stash, WS auth, Surge devices; local-day trends
luolei1287f3e0bd9e
diff --git a/CHANGELOG.en.md b/CHANGELOG.en.mdindex f580df4..581ce42 100644--- a/CHANGELOG.en.md+++ b/CHANGELOG.en.md@@ -5,6 +5,34 @@ All notable changes to this project will be documented in this file.The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).+## [1.4.2] - 2026-10-09++This release merges community bug-fix PRs and finishes the timezone part of #82. Thanks to @MaxwellChang98, @yafeishi, @heroixinu and @GodD6366.++### Fixed++- **Region details shifted in device, domain and other lists** (PR [#81], thanks @MaxwellChang98) 🐛+ - GeoIP arrays are positional (country, country name, city, ASN organization). `filter(Boolean)` dropped an empty city, which moved the ASN organization into the city slot. Empty slots are now kept. Three parsers the PR missed (rule and proxy lists) are fixed too, with a regression test+- **Stash gateway shows zero traffic** (PR [#97], thanks @yafeishi) 🐛+ - Stash reports per-connection upload/download as `{ total, current, max }` objects and uses numeric connection IDs. They are now normalized to cumulative byte counts and string IDs at ingestion. mihomo/Clash are unaffected+- **Live updates drop after login (WebSocket 4003)** (PR [#92], thanks @heroixinu) 🐛+ - The session cookie is URL-encoded when set, but the WebSocket server parsed cookies itself without decoding and also cut the token at any `=` inside it, so tokens containing `+`, `/` or `=` failed authentication. It now splits on the first `=` only and decodes the value; the auth service also accepts encoded tokens+- **Every device shows the Surge gateway's own IP** (PR [#90], thanks @GodD6366) 🐛+ - The device IP now comes from Surge's `sourceAddress` (the client that sent the request) instead of `localAddress` (the gateway's own address). Requests made by the Surge host itself report a loopback `sourceAddress` and stay attributed to the host's LAN IP+ - **Behavior change**: LAN devices behind Surge are now counted by their real IPs. History recorded under the gateway IP before the upgrade is not migrated+- **Daily trend buckets follow the local day** ([#82] follow-up) 🐛+ - For daily trends the web sends the browser's timezone offset, and SQLite, ClickHouse and realtime data are bucketed by the viewer's local day instead of the UTC day (UTC+8 buckets were shifted by 8 hours). Callers that don't send an offset are unchanged. For non-whole-hour offsets (e.g. +5:30), SQLite still aligns day boundaries to whole hours++### Agent (shipped as `agent-v1.4.7`)++- Surge device IP now comes from `sourceAddress`, with the same rules as above (PR [#90]). The report protocol version is unchanged++[#81]: https://github.com/foru17/neko-master/pull/81+[#82]: https://github.com/foru17/neko-master/issues/82+[#90]: https://github.com/foru17/neko-master/pull/90+[#92]: https://github.com/foru17/neko-master/pull/92+[#97]: https://github.com/foru17/neko-master/pull/97+## [1.4.1] - 2026-10-09This release addresses bug and compatibility reports from GitHub issues.diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 4985011..46c9399 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -5,6 +5,34 @@格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/),并且本项目遵循 [语义化版本](https://semver.org/lang/zh-CN/spec/v2.0.0.html)。+## [1.4.2] - 2026-10-09++本版本合入社区提交的 bug 修复 PR,并补完 #82 的时区问题。感谢 @MaxwellChang98、@yafeishi、@heroixinu、@GodD6366。++### 修复++- **设备/域名等列表的地区信息错位**(PR [#81],感谢 @MaxwellChang98)🐛+ - GeoIP 数组按位置存放(国家、国家名、城市、ASN 组织),城市为空时被 `filter(Boolean)` 过滤掉,ASN 组织就挤到了城市的位置。现在保留空位;PR 漏掉的规则与代理列表 3 处解析也一并修复,并加了回归测试+- **Stash 网关流量一直为 0**(PR [#97],感谢 @yafeishi)🐛+ - Stash 把每条连接的上传/下载报成 `{ total, current, max }` 对象,连接 ID 是数字。现在在接收数据时统一转成累计字节数和字符串 ID,mihomo/Clash 不受影响+- **登录后实时推送断开(WebSocket 4003)**(PR [#92],感谢 @heroixinu)🐛+ - 会话 cookie 写入时会做 URL 编码,WebSocket 服务端自己解析 cookie 时却没有解码,还会在 token 内的 `=` 处截断,token 含 `+`、`/`、`=` 时鉴权失败。现在只按第一个 `=` 切分并解码;鉴权服务同时兼容编码过的 token+- **Surge 网关下所有设备都显示成网关自己的 IP**(PR [#90],感谢 @GodD6366)🐛+ - 设备 IP 改用 Surge 的 `sourceAddress`(发起请求的客户端),不再用 `localAddress`(网关本机地址)。Surge 主机自身发出的请求 `sourceAddress` 是回环地址,这类请求仍记在主机的局域网 IP 上+ - **行为变化**:Surge 用户局域网内的设备会按真实 IP 分开统计;升级前记在网关 IP 上的历史数据不迁移+- **趋势图日桶按本地日划分**([#82] 残留)🐛+ - 按天查看趋势时,前端会把浏览器时区偏移传给服务端,SQLite、ClickHouse 与实时数据都按查看者的本地日分桶,不再按 UTC 日(此前东八区每个日桶偏 8 小时)。不传偏移的旧调用方行为不变。非整小时时区(如 +5:30)的日界线在 SQLite 下仍按整小时对齐++### Agent(随 `agent-v1.4.7` 发布)++- Surge 设备 IP 改用 `sourceAddress`,规则与上面一致(PR [#90])。上报协议版本不变++[#81]: https://github.com/foru17/neko-master/pull/81+[#82]: https://github.com/foru17/neko-master/issues/82+[#90]: https://github.com/foru17/neko-master/pull/90+[#92]: https://github.com/foru17/neko-master/pull/92+[#97]: https://github.com/foru17/neko-master/pull/97+## [1.4.1] - 2026-10-09本版本集中处理 GitHub 上反馈的 bug 与兼容问题。diff --git a/package.json b/package.jsonindex 2aedb78..41e1127 100644--- a/package.json+++ b/package.json@@ -1,6 +1,6 @@{"name": "neko-master",- "version": "1.4.1",+ "version": "1.4.2","description": "Modern traffic analytics for edge gateways","private": true,"workspaces": [