v0.4.6
This release improves MMDB/GeoIP workflows, test-result visibility in the CLI and TUI, Docker/runtime packaging, desktop integration, and cross-platform command behavior.
Highlights
- Renamed the
geoipcommand namespace tommdbfor clearer GeoLite2 database management. Usexrat mmdb ...for downloads, updates, status, lookup, and backend inspection. - Added richer config list test metadata: ICMP, TCP, real-delay, download/upload throughput, endpoint country/location/ASN, failure details, and latest test timestamps are now threaded into list output where available.
- Improved TUI config tables and detail/runtime cards so probe columns follow configured test stages, hide inactive metrics, show GeoIP metadata, clear stale values while tests are running, and use cleaner label formatting.
- Improved Docker images by bundling both Xray and sing-box from upstream runtime images instead of relying on only inline Xray download behavior.
- Improved Linux desktop integration so installed launchers/icons have stable taskbar identity and release/source installs no longer depend on fragile desktop icon symlink layouts.
CLI And Testing
xrat mmdb backendcan print backend configuration as JSON.- MMDB download/update progress now shows the expanded source URL and has more stable multi-download progress rendering.
- MMDB lookup now resolves hostnames before local lookup so domain endpoints can receive country/city/ASN enrichment.
xrat list confignow exposes latest test fields in human/JSON output and conditionally shows metric columns from enabled test settings.- Test command output hides disabled metric columns instead of reserving empty columns for skipped stages.
- Proxy shell handling and ICMP ping flags are more portable across Unix-like platforms.
TUI
- Config table probe columns now align with the configured TUI/rotation test stages, so
icmp + real-delayno longer shows TCP. - Config table/detail views can show ICMP, TCP, real-delay, download, upload, country, city/location, and ASN data when configured or available.
- Running a TUI test batch clears stale test cells for targeted configs while fresh results are pending.
- The TUI test bar displays the active configured stage label, such as
icmp + real-delay. - Detail and runtime card labels no longer include trailing colons.
Install, Docker, And Docs
- Release archives and
install.shrestore desktop icons from the consolidateddocs/src/mediaasset location. - Desktop installation now installs/copies desktop entries and icons in a way that avoids broken symlinks.
- Docker documentation now documents exposed runtime ports and proxy usage more clearly.
- Documentation media assets were consolidated under
docs/src/media. - Backlog documents were reorganized under
docs/backlog, with completed/stale notes removed.
Upgrade Notes
- Replace
xrat geoip ...commands withxrat mmdb .... - If you install desktop assets manually, use the updated release archive layout documented in the manual install guide.
- Docker users can rely on the image including both Xray and sing-box runtime binaries.
Full Changelog: v0.4.5...v0.4.6