v2.6.0

EasyTier v2.6.0 Release Notes

📝 更新日志（v2.5.0 → v2.6.0）

🚀 关键新功能 / Key Features

• 新增 Secure Mode - v2.6.0 首次引入 secure mode。该模式以 Noise handshake 建立加密通道，并在其上提供更完整的接入与认证路径：管理节点可签发临时凭据，节点可在不分发 network_secret 的前提下加入网络；凭据支持撤销与信任传播；同时 relay 与 web-core 链路补充了端到端加密能力。整体上，secure mode 为共享节点、临时设备和需要分级授权的网络接入提供了统一的认证与 E2EE 基础 @KKRainbow #1808 #1968 #1960 #1976
• Web 管理面增强 - Web 端新增 OIDC SSO、禁用自注册、webhook 托管机器接入，以及 full-power RPC、typed JSON proxy endpoint、多实例 CLI 支持。整体上补齐了身份接入、自动化管理和外部系统集成所需的基础能力 @xzzpig #1943 #1948 @KKRainbow #1983 #1989
• Apple 平台支持扩展 - 新增 iOS 支持与 macOS Network Extension 支持，并补充 unix socket 等底层接入能力，完善了 Apple 平台上的系统级集成路径 @chenx-dust #1777 #1779 #1902
• 运维与分发链路改进 - GUI 支持记住上次使用的实例，普通模式可直接开放 RPC 端口；Web / GUI 新增按实例流量统计与实例级接收限速；CLI 补充 connector add/remove；同时增加 PowerShell 安装脚本、Nushell completion 与 RPM 包构建，便于自动化部署与批量管理 @xzzpig #1762 @KKRainbow #2011 #2027 @fanyang89 #2058 @Deardrops #1975

🔐 安全 / 配置

• 复杂接入环境兼容性增强 - 支持中文域名；config server 的 WSS 支持 path 并可从路径末段识别用户名；HTTP 连接器会附带 X-Network-Name 与 User-Agent；Web / API 监听地址也可单独配置。结合 TLS 1.2 兼容增强后，反向代理、网关和旧环境下的接入配置更完整 @Huchangzhi #1739 @cfdworld #1917 @xzzpig #1948 #1839 @zkitefly #1900
• 特性裁剪与兼容策略调整 - zstd 与 faketcp 拆分为独立 feature，在无 AES-GCM 环境下默认回退到 XOR，便于定制构建与旧平台兼容 @chenx-dust #1861 @ZnqbuZ #1923

🖥️ GUI / Web / 运维

• GUI / Web 操作流程调整 - 记住上次使用的 network instance ID，URL 输入与布局更清晰，公共服务器和 standalone 的初始 peer 配置被统一，减少了重复配置步骤 @xzzpig #1762 #1819 @KKRainbow #2017
• 可观测性与限流能力补充 - 修复运行网络时配置丢失，同时新增按实例统计流量，并将实例级接收限速暴露给 GUI / Web，便于多实例场景下的观测与带宽控制 @KKRainbow #1802 #2011 #2027
• 安装与分发补充 - 新增 PowerShell 安装脚本、Nushell completion 与 RPM 包构建，完善 Windows 和 Linux 环境下的自动化部署链路 @Deardrops #1975 @Copilot #1756 @ZnqbuZ #2044

🐞 关键修复 / Bug Fixes

• 连接建立与路由修复 - 修复 ACL 未正确丢弃出站数据包、子网代理误与本地接口建立直连、自连接判断、avoid_relay_data 处理、peer id 不匹配时的清理逻辑，以及 webhook 管理配置 reconcile / disable_p2p 判断问题 @AsakuraMizu #1766 @KKRainbow #1782 #1844 #2057 @fanyang89 #1935 #1941
• QUIC / Tunnel / DNS 稳定性 - 修复 tun_fd 请求与强制设置流程、QUIC 端口 0 panic、poll_reserve permit 泄漏、短 tunnel 包 panic、Magic DNS IP 变化后陈旧记录，以及 foreign network 代理 CIDR 重叠问题 @burningtnt #1734 @chenx-dust #1860 @fanyang89 #1904 #1905 #1906 @ZnqbuZ #1858 #2024
• 平台兼容性修复 - 修复 FreeBSD TUN 编辑、Android VPN 权限授予、Windows / FakeTCP 的 pnet 接口枚举 panic、KSU 挂载兼容，以及 macOS Network Extension feature cfg 限制 @deddey #1823 @KKRainbow #2023 #2029 #2031 #1962 @Whuihuan #1761
• 网络稳定性修复 - 修复 WebSocket peer 连接超时、反向代理 remote_addr 追加、PeerCenter RPC 注册缺失，以及 OSPF 在连接抖动下的路由同步风暴 @sky96111 #1939 @ZnqbuZ #2034 @fanyang89 #1929 #2063

⚡ 性能与稳定性 / Performance & Stability

• 链路与资源管理优化 - 为 peer 接收与实例级接收新增 limiter，提升 udp->ring 传输可靠性，优化 foreign network remove_network、DashMap 热路径与慢退出问题，并引入 lazy P2P demand tracking 以减少不必要的连接开销 @KKRainbow #1842 #1851 #1847 #1854 #1970 #2003 #2027
• 日志与内部抽象改进 - 统一使用 tracing 输出日志，重构 listener / connector 协议抽象，为后续协议扩展与排障打下基础 @ZnqbuZ #1856 #2026

👥 新贡献者 / New Contributors

• 🎉 @cfdworld 首次贡献于 #1744
• 🎉 @Whuihuan 首次贡献于 #1761
• 🎉 @rinnein 首次贡献于 #1755
• 🎉 @AsakuraMizu 首次贡献于 #1766
• 🎉 @chenx-dust 首次贡献于 #1777
• 🎉 @deddey 首次贡献于 #1823
• 🎉 @zkitefly 首次贡献于 #1900
• 🎉 @dependabot[bot] 首次贡献于 #1922
• 🎉 @Deardrops 首次贡献于 #1975
• 🎉 @TsXor 首次贡献于 #1997
• 🎉 @zhourenke 首次贡献于 #1964

🔗 完整更新记录: 点击查看完整变更

---

📝 Release Notes (v2.5.0 → v2.6.0)

🚀 Key Features

• Introducing Secure Mode - v2.6.0 introduces secure mode. It uses a Noise handshake to establish the encrypted channel, then adds a more complete access and authentication path on top: admin nodes can issue temporary credentials, nodes can join without distributing the main network_secret, credentials can be revoked and propagated through the network, and relay / web-core paths now provide end-to-end encryption. Overall, secure mode provides a unified authentication and E2EE foundation for shared nodes, temporary devices, and delegated-access scenarios @KKRainbow #1808 #1968 #1960 #1976
• Web Management Enhancements - The web layer now supports OIDC SSO, disabling self-registration, webhook-managed machine access, full-power RPC, a typed JSON proxy endpoint, and multi-instance CLI access. These changes extend the management plane for identity integration, automation, and external system control @xzzpig #1943 #1948 @KKRainbow #1983 #1989
• Apple Platform Support Expansion - Added iOS support, macOS Network Extension support, and unix socket integration, extending the system-level integration path on Apple platforms @chenx-dust [#1...

v2.5.0

EasyTier v2.5.0 Release Notes

📝 更新日志（v2.4.5 → v2.5.0）

🚀 关键新功能 / Key Features

• GUI 支持服务模式 - GUI 可注册为系统服务运行，避免开机启动时弹出 UAC @xzzpig #1540
• TCP 打洞 - 新增 TCP hole punching，提升复杂网络下的直连成功率 @KKRainbow #1713
• 实验性 FakeTCP Tunnel - 新增实验性 Fake TCP tunnel 选项，感谢 udp2raw 与 phantun 项目提供的启发 @KKRainbow #1673

🌐 DNS / 配置

• Magic DNS / IDN 增强 - 支持中文域名；重构 IDN 与 URL 处理逻辑；支持自定义 TLD zone 并修复 tld_dns_zone 相关问题 @Huchangzhi #1462 @xzzpig #1533 @agustim #1436 @changyun233 #1686
• 配置能力增强 - 配置文件支持环境变量解析；运行时配置管理通过 ConfigRpc 统一 @xzzpig #1640 #1397
• 新增 P2P-only 配置选项 - 提供仅 P2P 连接的配置模式，满足更严格的直连场景 @KKRainbow #1598
• QUIC 监听端口可配置 - 新增 quic-listen-port 参数，支持自定义 QUIC 代理监听端口 @ZnqbuZ #1473

🖥️ GUI / Web / 易用性

• GUI 远程管理与服务模式 - GUI 支持连接 config server、支持服务模式运行，并优化网络列表加载与网络名展示 @xzzpig #1596 #1578 #1503
• 节点信息 NAT 类型展示 - 节点信息界面新增 NAT type 展示，方便排障与选路 @taurusxin #1464
• 端口转发体验提升 - 端口转发能力增强，GUI 端口转发配置支持响应式布局 @KKRainbow #1662 @xzzpig #1530
• macOS 体验改进 - macOS UX 优化与图标更新，并修复 GUI 打开日志目录不工作的问题 @xzzpig #1631 @XuDaojie #1723 @CrazyBoyFeng #1714

🐞 关键修复 / Bug Fixes

• Android VPN 稳定性与 DNS - VpnService 下 Magic DNS 支持增强；修复 VPN 启动失败、IPv6、DNS 选择、路由更新与日志不可达等问题 @CrazyBoyFeng #1617 #1615 #1710 @xzzpig #1628 #1717 @sky96111 #1612
• Windows / 网络栈稳定性 - 修复睡眠唤醒重连、子网代理死循环等稳定性问题 @KKRainbow #1711 #1492 @datasone #1593
• 安全与策略修复 - 修复未启用 TUN 时数据未加密问题；修复白名单/应答包被误丢弃等策略问题 @KKRainbow #1435 #1660 #1725

⚡ 性能与资源

• 内存与性能优化 - 释放 dashmap 内存；优化 kcp_proxy/socks5 内存释放；减少 clone 并提升路由效率 @KKRainbow #1485 @21paradox #1721 @Tunglies #1663 @KKRainbow #1512

👥 新贡献者 / New Contributors

• 🎉 @iamr0s 首次贡献于 #1417
• 🎉 @ZnqbuZ 首次贡献于 #1428
• 🎉 @niuhuan 首次贡献于 #1440
• 🎉 @Ahua9527 首次贡献于 #1439
• 🎉 @agustim 首次贡献于 #1436
• 🎉 @taurusxin 首次贡献于 #1464
• 🎉 @imdingtalk 首次贡献于 #1422
• 🎉 @Huchangzhi 首次贡献于 #1462
• 🎉 @kuaifan 首次贡献于 #1497
• 🎉 @CrazyBoyFeng 首次贡献于 #1615
• 🎉 @sky96111 首次贡献于 #1612
• 🎉 @lwb-2021 首次贡献于 #1634
• 🎉 @MajoSissi 首次贡献于 #1621
• 🎉 @datasone 首次贡献于 #1593
• 🎉 @changyun233 首次贡献于 #1686
• 🎉 @burningtnt 首次贡献于 #1689
• 🎉 @XuDaojie 首次贡献于 #1723

🔗 完整更新记录: 点击查看完整变更

---

📝 Release Notes (v2.4.5 → v2.5.0)

🚀 Key Features

• GUI Service Mode - GUI can register as a system service to avoid UAC prompts on startup @xzzpig #1540
• TCP Hole Punching - Added TCP hole punching to improve direct connectivity in complex networks @KKRainbow #1713
• Experimental FakeTCP Tunnel - Added an experimental Fake TCP tunnel option; thanks to udp2raw and phantun for inspiration @KKRainbow #1673

🌐 DNS / Configuration

• Magic DNS / IDN Improvements - Added Chinese domain support; refactored IDN & URL handling; added customizable TLD zone and fixed tld_dns_zone issues @Huchangzhi #1462 @xzzpig #1533 @agustim #1436 @changyun233 #1686
• More Powerful Configuration - Supported environment variables in config files; unified runtime configuration management via ConfigRpc @xzzpig #1640 #1397
• New P2P-only Configuration Option - Added a P2P-only connectivity option for stricter direct-connection scenarios @KKRainbow #1598
• Configurable QUIC Listen Port - Added quic-listen-port flag to customize the port used by QUIC proxy @ZnqbuZ #1473

🖥️ GUI / Web / UX

• Remote Management & Service Mode in GUI - GUI can connect to config server, supports service mode, and improves network list loading and naming display @xzzpig #1596 #1578 #1503
• NAT Type Display in Node Info - Added NAT type display in node information UI to improve troubleshooting @taurusxin #1464
• Better Port Forwarding UX - Enhanced port forwarding and made port forward config responsive in the GUI @KKRainbow #1662 @xzzpig #1530
• macOS Improvements - Improved macOS UX, updated app icon, and fixed “open log directory” in GUI @xzzpig #1631 @XuDaojie #1723 @CrazyBoyFeng #1714

🐞 Bug Fixes

• Android VPN Stability & DNS - Enhanced Magic DNS support via VpnService; fixed VPN startup failures, IPv6, DNS selection, route updates, and unreachable logs @CrazyBoyFeng #1617 #1615 #1710 @xzzpig #1628 #1717 @sky96111 #1612
• Windows / Network Stack Stability - Improved stability around sleep-wake reconnect and subnet proxy dead loops @KKRainbow #1711 [...

v2.4.5

EasyTier v2.4.5 Release Notes

📝 更新日志（v2.4.4 → v2.4.5）

🚀 新功能 / Feature Enhancements

• 前端统计信息显示 - 前端界面新增统计信息展示功能，提供更直观的网络状态监控 @KKRainbow #1410
• USB 共享网络转发支持 - 新增对 USB 共享网络的转发支持，扩展网络连接方式 @ThermalEng #1411

🐞 问题修复 / Bug Fixes

• 日志和配置修复
  • 修复日志目录不工作的问题 @KKRainbow #1393
  • 修复从文件读取 STUN 配置不工作的问题 @KKRainbow #1393
  • 修复 GUI 中打开日志目录不工作的问题 @KKRainbow #1403
• 平台特定修复
  • 修复 macOS 上 IPv6 地址绑定失败的问题 @KKRainbow #1398
  • 修复 Windows 防火墙规则安全问题 @KKRainbow #1407
• 网络协议修复
  • 修复 SOCKS5 代理崩溃问题 @KKRainbow #1409

👥 新贡献者 / New Contributors

• 🎉 @ThermalEng 首次贡献于 #1411

🔗 完整更新记录: 点击查看完整变更

---

📝 Release Notes (v2.4.4 → v2.4.5)

🚀 Feature Enhancements

• Frontend Statistics Display - Added statistics display functionality to the frontend interface for more intuitive network status monitoring @KKRainbow #1410
• USB Shared Network Forwarding Support - Added support for USB shared network forwarding, expanding network connection options @ThermalEng #1411

🐞 Bug Fixes

• Logging and Configuration Fixes
  • Fixed log directory not working issue @KKRainbow #1393
  • Fixed STUN configuration from file not working issue @KKRainbow #1393
  • Fixed open log directory not working in GUI @KKRainbow #1403
• Platform-specific Fixes
  • Fixed macOS bind failure when address is IPv6 @KKRainbow #1398
  • Fixed Windows firewall rule security issue @KKRainbow #1407
• Network Protocol Fixes
  • Fixed SOCKS5 proxy panic issue @KKRainbow #1409

👥 New Contributors

• 🎉 @ThermalEng made their first contribution in #1411

🔗 Full Changelog: View Full Changes

v2.4.4

EasyTier v2.4.4 Release Notes

📝 更新日志（v2.4.3 → v2.4.4）

🚀 新功能 / Feature Enhancements

• GUI macOS 停靠栏图标控制 - 新增 macOS 停靠栏图标可见性控制功能 @wuhao1477 #1328
• 自定义 STUN 服务器设置重构 - 更新和改进自定义 STUN 服务器配置功能 @fanyang89 #1310
• Android JNI 支持 - 新增 Android JNI 接口支持 @KKRainbow #1340
• CLI 对等体表格显示优化 - 改进小屏幕显示的对等体表格，使用更短的列名 @fanyang89 #1342
• 标准输入配置读取 - 支持从标准输入读取配置文件 @fanyang89 #1354
• GUI/CLI IPv6/IPv4 隧道区分 - 在 GUI 和 CLI 中区分显示 IPv6 和 IPv4 隧道 @KKRainbow #1373
• 配置验证标志 - 新增配置验证命令行标志 @fanyang89 #1376
• CLI 日志控制 - 允许通过 CLI 启用日志记录并限制日志大小 @KKRainbow #1384

🐞 问题修复 / Bug Fixes

• 端口转发修复 - 修复初始转发列表为空时 CLI 添加端口转发失败的问题 @KKRainbow #1324
• CLI 默认 STUN 服务器隐藏 - 在 CLI 中隐藏默认 STUN 服务器显示 @fanyang89 #1334
• macOS Jemalloc 警告修复 - 修复 macOS 上的 Jemalloc 警告问题 @fanyang89 #1344
• 网络连接修复
  • 修复外部网络与映射监听器的直连问题 @KKRainbow #1363
  • 为 UDP/ICMP 设置正确的路由策略 @KKRainbow #1361
  • 修复 IPv4 冲突和变更时的 OSPF IPv4 映射错误 @KKRainbow #1359
  • 修复 smoltcp 序列号下溢问题 @KKRainbow #1360
  • 避免向不存在的对等点发送数据包导致路由循环 @KKRainbow #1378
  • 修复 WireGuard 监听问题 @KKRainbow #1382
• 配置和服务器问题修复
  • 修复从 Web 配置时 STUN 服务器列表为空的问题 @KKRainbow #1371
  • 修复某些机器上 networksetup 超时问题 @KKRainbow #1372
• 文档更新 - 更新 README 修复脚本安装命令 @KKRainbow #1341

👥 新贡献者 / New Contributors

• 🎉 @wuhao1477 首次贡献于 #1328

🔗 完整更新记录: 点击查看完整变更

---

📝 Release Notes (v2.4.3 → v2.4.4)

🚀 Feature Enhancements

• GUI macOS Dock Icon Control - Added macOS dock icon visibility control functionality @wuhao1477 #1328
• Custom STUN Server Settings Refactor - Updated and improved custom STUN server configuration functionality @fanyang89 #1310
• Android JNI Support - Added Android JNI interface support @KKRainbow #1340
• CLI Peer Table Display Optimization - Improved peer table display with shorter columns for small screens @fanyang89 #1342
• Configuration Reading from Stdin - Added support for reading configuration from standard input @fanyang89 #1354
• GUI/CLI IPv6/IPv4 Tunnel Distinction - Distinguished IPv6 and IPv4 tunnels in GUI and CLI displays @KKRainbow #1373
• Configuration Validation Flag - Added configuration validation command-line flag @fanyang89 #1376
• CLI Log Control - Enabled log control via CLI with log size limitations @KKRainbow #1384

🐞 Bug Fixes

• Port Forwarding Fix - Fixed CLI port forwarding failure when initial forward list is empty @KKRainbow #1324
• CLI Default STUN Server Hiding - Hidden default STUN servers from CLI display @fanyang89 #1334
• macOS Jemalloc Warning Fix - Fixed Jemalloc warning issues on macOS @fanyang89 #1344
• Network Connection Fixes
  • Fixed foreign network direct connection with mapped listeners @KKRainbow #1363
  • Set correct route policy for UDP/ICMP @KKRainbow #1361
  • Fixed OSPF IPv4 mapping error when IPv4 conflicts and changes @KKRainbow #1359
  • Fixed smoltcp sequence number underflow issue @KKRainbow #1360
  • Avoided packets sending to non-existent peers causing route loops @KKRainbow #1378
  • Fixed WireGuard listening issues @KKRainbow #1382
• Configuration and Server Issue Fixes
  • Fixed empty STUN server list when configuration is from web @KKRainbow #1371
  • Fixed networksetup timeout on some machines @KKRainbow #1372
• Documentation Update - Updated README to fix script installation command @KKRainbow #1341

👥 New Contributors

• 🎉 @wuhao1477 made their first contribution in #1328

🔗 Full Changelog: View Full Changes

v2.4.3

📝 更新日志（v2.4.2 → v2.4.3）

🚀 新功能 / Feature Enhancements

• 自定义 STUN 服务器 - 支持在配置中指定自定义 STUN 服务器，提高 NAT 穿透成功率 @fanyang89 #1212
• Magisk 模块增强
  • 新增热点局域网转发功能，便于移动端共享网络 @ThermalEng #1252
  • 支持自定义启动参数，满足高级用户需求 @TigerBeanst #1236
• 共享节点在线监控 - 为 EasyTier 公共共享节点引入在线时长监控，方便运维与统计 @KKRainbow #1250
• 基于分组的 ACL 规则 - ACL 新增 group-based 规则及配套结构，实现更灵活的访问控制 @xzzpig #1265
• tokio-console 支持 - 集成 tokio-console，便于异步任务调试与性能分析 @fanyang89 #1259
• LoongArch64 内存优化 - Linux LoongArch64 平台改用 mimalloc，避免页面大小问题导致启动失败 @Glavo #1257
• Android 开发体验 - 新增 Android 专用 flake.nix，简化本地开发、测试与构建流程 @21paradox #1237
• CLI/GUI 体验优化
  • CLI 将本地 IP 置顶显示，一目了然 @fanyang89 #1256
  • GUI 节点列表支持排序，便于快速定位 @fanyang89 #1278
  • 托盘菜单将“退出”项移至底部，减少误操作 @fanyang89 #1291

🐞 问题修复 / Bug Fixes

• 流量统计修正 - 修复代理流量未被计入统计的问题，确保数据准确 @KKRainbow #1229
• Dockerfile 修复 - 修正构建镜像时可能遇到的依赖与路径问题 @KKRainbow #1219
• 时间溢出 panic - 修复 std::Instant 溢出导致的 panic，提升稳定性 @KKRainbow #1243
• 死锁与 panic 修复
  • 解决 tokio-smoltcp 中的潜在死锁 @KKRainbow #1270
  • 避免 smoltcp socket accept 时 panic @KKRainbow #1272
• QUIC 传输修复 - 修复 QUIC 传输层偶现的连接失败与异常断开 @KKRainbow #1293
• KCP 行为修正 - 修复 KCP 在特定场景下未按预期工作的问题 @KKRainbow #1285
• TUN 设备重试 - 当 TUN 设备被异常关闭时自动重试创建，保障网络连续性 @KKRainbow #1279
• Magic DNS 健壮性 - 增强域名检查逻辑，避免因异常输入导致解析失败 @KKRainbow #1288
• 禁用 NAT4 打洞选项 - 新增开关，允许在特定网络环境中关闭 NAT4 打洞以提升兼容性 @KKRainbow #1277
• TCP 代理 Keepalive - 修复已接受的 TCP 代理连接 keep-alive 失效问题 @KKRainbow #1302
• IPv6 MTU 设置 - 修复设置 IPv6 MTU 时可能导致 TUN 初始化失败的问题 @KKRainbow #1300
• OSPF 路由 Panic - 修复 OSPF 路由计算过程中可能出现的 panic @KKRainbow #1304

🛠️ 构建与文档

• Nix Flake 重构 - 重构 Nix Flake 并迁移 Android 支持，提升跨平台构建一致性 @xzzpig #1280
• README 更新 - 更新中英文 README 中的 QQ 群联系方式，方便社区交流 @KKRainbow #1275 #1274

👥 新贡献者 / New Contributors

• 🎉 @TigerBeanst 首次贡献于 #1236
• 🎉 @ThermalEng 首次贡献于 #1252

🔗 完整更新记录: 点击查看完整变更

---

📝 Release Notes (v2.4.2 → v2.4.3)

🚀 Feature Enhancements

• Custom STUN Servers – Introduce support for configuring custom STUN servers to improve NAT traversal success rate @fanyang89 #1212
• Magisk Module Enhancements
  • Add local hotspot-to-LAN forwarding for easy mobile network sharing @ThermalEng #1252
  • Allow custom command-line arguments for advanced users @TigerBeanst #1236
• Shared Node Uptime Monitor – Track uptime of EasyTier public shared nodes to help with operations and statistics @KKRainbow #1250
• Group-based ACL Rules – Extend ACL with group-based rules and related structures for more flexible access control @xzzpig #1265
• tokio-console Support – Integrate tokio-console for asynchronous task debugging and performance analysis @fanyang89 #1259
• LoongArch64 Memory Optimizations – Switch to mimalloc on Linux LoongArch64 to avoid page size issue @Glavo #1257
• Android Development Experience – Provide a dedicated flake.nix for Android to streamline local development, testing, and building @21paradox #1237
• CLI / GUI Usability Improvements
  • CLI now lists the local IP first for instant visibility @fanyang89 #1256
  • GUI peer list can be sorted to quickly locate nodes @fanyang89 #1278
  • Tray menu moves “Quit” to the bottom to reduce accidental clicks @fanyang89 #1291

🐞 Bug Fixes

• Traffic Accounting Fix – Proxy traffic is now correctly counted in statistics @KKRainbow #1229
• Dockerfile Corrections – Resolve dependency and path issues encountered during image builds @KKRainbow #1219
• Instant Overflow Panic – Eliminate panic caused by std::Instant overflow under certain conditions @KKRainbow #1243
• Deadlocks & Panics
  • Fix potential deadlock in tokio-smoltcp @KKRainbow #1270
  • Prevent panic when accepting smoltcp sockets @KKRainbow #1272
• QUIC Transport Fixes – Address sporadic connection failures and unexpected disconnects in QUIC transport @KKRainbow #1293
• KCP Behavior Correction – Resolve cases where KCP did not behave as expected @KKRainbow #1285
• TUN Device Retry – Automatically recreate TUN device if it is unexpectedly closed, ensuring network continuity @KKRainbow #1279
• Magic DNS Robustness – Strengthen domain validation to prevent resolution failures with malformed input @KKRainbow #1288
• Disable NAT4 Hole Punching – New option to turn off NAT4 hole punching in networks where it causes compatibility issues @KKRainbow #1277
• TCP Proxy Keepalive – Fixed keep-alive not working on accepted TCP proxy connections @KKRainbow #1302
• IPv6 MTU Setting – Fixed TUN initialization failure caused by setting IPv6 MTU @KKRainbow #1300
• OSPF Route Panic – Eliminated potential panic in OSPF route calculation @KKRainbow #1304

🛠️ Build & Documentation

• Nix Flake Refactor – Refactor the Nix Flake and migrate Android support for consistent cross-platform builds @xzzpig #1280
• README Updates – Refresh QQ group contact details in both Chinese and English README files for easier community access @KKRainbow #1275 #1274

👥 New Contributors

• 🎉 @TigerBeanst made their first contribution in #1236
• 🎉 @ThermalEng made their first contribution in #1252

🔗 Full Changelog: View Full Changes

v2.4.2

EasyTier v2.4.2 Release Notes

📝 更新日志（v2.4.1 → v2.4.2）

🚀 新功能 / Feature Enhancements

• CLI 对等体排序优化 - CLI 中的节点现在按 IPv4 地址和主机名排序，提升可读性 @fanyang89 #1191
• 统计计数器 - 新增统计计数器功能，便于监控和调试网络状态 @KKRainbow #1207
• GUI 端口转发功能 - GUI 界面增加端口转发配置功能 @FuturePrayer #1198
• 增强加密选项 - 新增 XOR 和 ChaCha20 加密算法，针对低端设备进行了优化，并支持 OpenSSL @CyiceK #1186
• Android 无 TUN 模式优化 - 为 Android 的 no_tun 模式添加 FOREGROUND_SERVICE，不再依赖 VPN 服务 @21paradox #1203

🐞 问题修复 / Bug Fixes

• IPv6 路由修复 - 修复 IPv6 数据包路由问题，并避免路由循环 @KKRainbow #1187
• Jemalloc Prof 特性修复 - 修复了 Jemalloc 的 prof 特性编译问题 @KKRainbow #1201
• 直连死循环修复 - 修复了当目标节点启用 disable-p2p 时，直连器中可能出现的死循环问题，导致大量网络占用 @KKRainbow #1206
• KCP 启用条件优化 - 优化了 KCP 协议的启用条件，提升网络适应性 @KKRainbow #1210
• QUIC 传输崩溃修复 - 修复了 QUIC 传输协议可能引发的 panic 问题 @KKRainbow #1216
• 代码质量提升 - 进行了 Clippy 代码检查和清理，提升了代码质量 @KKRainbow #1214
• Docker 工作流更新 - 更新了 Docker 相关的持续集成工作流配置 @KKRainbow #1217

👥 新贡献者 / New Contributors

• 🎉 @21paradox 首次贡献于 #1203
• 🎉 @CyiceK 首次贡献于 #1186

🔗 完整更新记录: 点击查看完整变更

---

📝 Release Notes (v2.4.1 → v2.4.2)

🚀 Feature Enhancements

• CLI Peer Sorting Optimization - Peers in the CLI are now sorted by IPv4 address and hostname for better readability @fanyang89 #1191
• Statistics Counters - Added statistics counters for monitoring and debugging network status @KKRainbow #1207
• GUI Port Forwarding - Added port forwarding configuration functionality to the GUI interface @FuturePrayer #1198
• Enhanced Encryption Options - Added XOR and ChaCha20 encryption algorithms with optimizations for low-end devices and OpenSSL support @CyiceK #1186
• Android No-TUN Mode Optimization - Added FOREGROUND_SERVICE for Android no_tun mode, eliminating dependency on VPN service @21paradox #1203

🐞 Bug Fixes

• IPv6 Routing Fix - Fixed IPv6 packet routing issues and prevented route looping @KKRainbow #1187
• Jemalloc Prof Feature Fix - Resolved compilation issues with the Jemalloc prof feature @KKRainbow #1201
• Direct Connect Dead Loop Fix - Fixed a potential infinite loop in the direct connector when the destination peer has disable-p2p enabled @KKRainbow #1206
• KCP Enable Condition Optimization - Optimized the conditions for enabling the KCP protocol, improving network adaptability @KKRainbow #1210
• QUIC Transport Panic Fix - Fixed a potential panic issue in the QUIC transport protocol @KKRainbow #1216
• Code Quality Improvement - Performed Clippy code checks and cleanup, enhancing code quality @KKRainbow #1214
• Docker Workflow Update - Updated Docker-related continuous integration workflow configurations @KKRainbow #1217

👥 New Contributors

• 🎉 @21paradox made their first contribution in #1203
• 🎉 @CyiceK made their first contribution in #1186

🔗 Full Changelog: View Full Changes

v2.4.1

📝 更新日志（v2.4.0 → v2.4.1）

🚀 新功能 / Feature Enhancements

• 端口转发和 TCP 白名单 CLI 支持 - 新增命令行工具支持端口转发和 TCP 白名单管理 @KKRainbow #1165
  • 提供更便捷的端口转发配置命令
  • 支持通过 CLI 管理 TCP 白名单规则
• Linux RISC-V 64 架构支持 - 新增对 RISC-V 64 位架构的支持 @Glavo #1159
• Nix Flake 配置更新 - 更新和改进 Nix 开发环境配置 @xzzpig #1163

🐞 问题修复 / Bug Fixes

• 网络连接优化
  • 修复端口范围不应转换为单端口的问题 @KKRainbow #1154
  • 修复 ACL 在 KCP 和 QUIC 协议下不工作的问题 @KKRainbow #1152
  • 避免 UDP 打洞流量通过 TUN 接口 @KKRainbow #1155
• 平台特定修复
  • 修复 macOS 上 socket2::Type::RAW 编译错误 @Tunglies #1169
  • 修复 macOS 权限提升问题 @KKRainbow #1177
• 稳定性改进
  • 修复错误发生时的退出代码处理 @KKRainbow #1173
  • 启动时 DNS 查询失败不再导致程序退出 @KKRainbow #1172
  • 密钥不匹配时不再向客户端发送密钥摘要 @KKRainbow #1172

👥 新贡献者 / New Contributors

• 🎉 @Glavo 首次贡献于 #1159
• 🎉 @Tunglies 首次贡献于 #1169

🔗 完整更新记录: 点击查看完整变更

---

📝 Release Notes (v2.4.0 → v2.4.1)

🚀 Feature Enhancements

• Port Forward and TCP Whitelist CLI Support - Added command-line tools for port forwarding and TCP whitelist management @KKRainbow #1165
  • Provides convenient port forwarding configuration commands
  • Support TCP whitelist rule management via CLI
• Linux RISC-V 64 Architecture Support - Added support for RISC-V 64-bit architecture @Glavo #1159
• Nix Flake Configuration Update - Updated and improved Nix development environment configuration @xzzpig #1163

🐞 Bug Fixes

• Network Connection Optimization
  • Fixed port range should not be converted to single port @KKRainbow #1154
  • Fixed ACL not working with KCP and QUIC protocols @KKRainbow #1152
  • Avoided UDP hole punch traffic going through TUN interface @KKRainbow #1155
• Platform-specific Fixes
  • Fixed socket2::Type::RAW compilation error on macOS @Tunglies #1169
  • Fixed macOS privilege elevation issues @KKRainbow #1177
• Stability Improvements
  • Fixed exit code handling when errors occur @KKRainbow #1173
  • DNS query failures during startup no longer cause program exit @KKRainbow #1172
  • No longer send secret digest to client when secret mismatch @KKRainbow #1172

👥 New Contributors

• 🎉 @Glavo made their first contribution in #1159
• 🎉 @Tunglies made their first contribution in #1169

🔗 Full Changelog: View Full Changes

v2.4.0

📝 更新日志（v2.3.2 → v2.4.0）

🚀 新功能 / Feature Enhancements

• 访问控制列表 (ACL) - 实现完整的 ACL 功能，支持流量过滤和安全控制 @KKRainbow #1140
  • 支持 TCP/UDP 白名单模式：easytier-core -d --tcp-whitelist 1000
  • 提供完整的 ACL 配置文件支持，包括规则链、优先级、状态跟踪等
  • 新增 easytier-cli acl stats 命令查看 ACL 统计信息
• VPN 内 IPv6 支持 - 完整支持 IPv6 网络，实现双栈网络通信 @DavHau #1061
• OpenHarmony (OHOS) 平台支持 - 新增对华为鸿蒙系统的原生支持 @FrankHan052176 #974
• LoongArch 架构支持 - 新增对龙芯架构的支持 @KKRainbow #1146
• 运行时监听器管理 - 支持通过 RPC 在运行时动态修改映射监听器 @liusen373 #1107
• Shell 补全支持 - 新增命令行自动补全功能，支持多种 Shell @shenjiangqiu #1103
  • 使用方法：easytier-core --generate fish > ~/.config/fish/completions/easytier-core.fish
• 多线程控制 - 允许设置多线程数量，优化性能表现 @KKRainbow #1056
• 地理位置信息 - Web 设备列表中新增地理位置信息显示 @KKRainbow #1052
• GUI/Web 增强
  • 新增禁用 IPv6 选项 @KKRainbow #1127
  • 改进 Web 界面用户体验 @KKRainbow #1048
  • 更新 GUI 占位符文本 @KKRainbow #1062
  • 修复配置生成器夜间模式下背景色问题 @xzzpig #1029

🐞 问题修复 / Bug Fixes

• 内存优化 - 大幅减少内存使用，解决高内存占用问题 @KKRainbow #1133
  • 优化 Mimalloc 线程缓存，减少 13M+ 内存占用
  • 优化 QUIC 端点内存使用（减少 3MB）
  • 优化 Smoltcp TCP 监听器内存使用（减少 2MB）
• 网络连接优化
  • 修复 DNS 查询可能导致线程挂起的问题 @KKRainbow #1138
  • 修复 STUN 查询失败时的死循环问题 @KKRainbow #1138
  • 修复 QUIC 输入错误处理，避免致命错误 @KKRainbow #1138
  • 修复环形隧道内存泄漏问题 @KKRainbow #1138
  • 正确处理对等连接关闭 @KKRainbow #1082
  • 需要加密 RPC（如果目标在对等映射中）@KKRainbow #1151
• 路由和连接管理
  • 修复公共服务器延迟优先路由问题 @KKRainbow #1129
  • 关闭来自虚拟网络的远程地址对等连接 @KKRainbow #1123
  • 在打洞客户端中将禁用 P2P 的对等点加入黑名单 @KKRainbow #1038
• 平台特定修复
  • 修复 Linux 上无法启动 GUI 的问题 @lazebird #1090
  • Windows 使用 WinAPI 配置 IP 和路由（移除对 netsh 的依赖）@KKRainbow #1079
  • 为 Windows TUN 接口添加防火墙规则 @KKRainbow #1130
  • 在设备不存在时尝试创建 TUN 设备 @KKRainbow #1131
• 配置和 RPC
  • 修复配置文件中 RPC 门户白名单不生效的问题 @xzzpig #1042
  • 修复错误的配置检查 @KKRainbow #1086
  • 修复 cargo install 失败问题 @KKRainbow #1054
• 其他修复
  • 修复令牌桶内存泄漏 @KKRainbow #1055
  • 限制外部网络管理器的最大连接数 @KKRainbow #1041
  • 修复 Windows 卸载脚本 @dawn-lc #1036
  • 使用更大的 Smoltcp TX/RX 缓冲区大小 @KKRainbow #1085

👥 新贡献者 / New Contributors

• 🎉 @dawn-lc 首次贡献于 #1023
• 🎉 @FrankHan052176 首次贡献于 #974
• 🎉 @DavHau 首次贡献于 #1061
• 🎉 @reneleonhardt 首次贡献于 #1088
• 🎉 @lazebird 首次贡献于 #1090

🔗 完整更新记录: 点击查看完整变更

---

📝 Release Notes (v2.3.2 → v2.4.0)

🚀 Feature Enhancements

• Access Control List (ACL) - Implemented comprehensive ACL functionality for traffic filtering and security control @KKRainbow #1140
  • Support TCP/UDP whitelist mode: easytier-core -d --tcp-whitelist 1000
  • Complete ACL configuration file support with rule chains, priorities, and stateful tracking
  • Added easytier-cli acl stats command for ACL statistics
• IPv6 Support within VPN - Full IPv6 network support for dual-stack communication @DavHau #1061
• OpenHarmony (OHOS) Platform Support - Native support for Huawei HarmonyOS @FrankHan052176 #974
• LoongArch Architecture Support - Added support for LoongArch architecture @KKRainbow #1146
• Runtime Listener Management - Support for dynamically modifying mapped listeners via RPC at runtime @liusen373 #1107
• Shell Completion Support - Added command-line auto-completion for multiple shells @shenjiangqiu #1103
  • Usage: easytier-core --generate fish > ~/.config/fish/completions/easytier-core.fish
• Multi-threading Control - Allow setting thread count for performance optimization @KKRainbow #1056
• Geolocation Information - Added geo info display in web device list @KKRainbow #1052
• GUI/Web Enhancements
  • Added disable IPv6 option @KKRainbow #1127
  • Improved web interface user experience @KKRainbow #1047
  • Updated GUI placeholder text @KKRainbow #1062
  • Fixed config generator background color in dark mode @xzzpig #1029

🐞 Bug Fixes

• Memory Optimization - Significantly reduced memory usage, resolving high memory consumption issues @KKRainbow #1133
  • Optimized Mimalloc thread cache, reducing 13M+ memory usage
  • Optimized QUIC endpoint memory usage (reduced 3MB)
  • Optimized Smoltcp TCP listener memory usage (reduced 2MB)
• Network Connection Optimization
  • Fixed DNS query potentially hanging threads @KKRainbow #1138
  • Fixed infinite loop when STUN query fails due to no IPv4 address @KKRainbow #1138
  • Made QUIC input errors non-fatal @KKRainbow #1138
  • Fixed ring tunnel memory leak @KKRainbow #1138
  • Properly handle peer connection closure @KKRainbow #1082
  • Need encrypt RPC if dst is in peer map @KKRainbow #1151
• Routing and Connection Management
  • Fixed latency-first routing for public servers @KKRainbow #1129
  • Close peer connections if remote address is from virtual network @KKRainbow #1123
  • Blacklist peers that disable P2P in hole-punching client @KKRainbow #1038
• Platform-specific Fixes
  • Fixed GUI startup issues on Linux @lazebird #1090
  • Use WinAPI for IP and route configuration on Windows (remove netsh dependency) @KKRainbow #1079
  • Added Windows firewall rules for TUN interfac...

v2.3.2

📝 更新日志（v2.3.1 → v2.3.2）

🚀 新功能 / Feature Enhancements

• 支持 QUIC 代理 @KKRainbow
• 支持子网代理映射功能 @KKRainbow
• easytier-core 支持多配置文件加载 @xzzpig
• 添加转发带宽速率限制功能（bps limiter）@KKRainbow
• Web 支持 IPv4/IPv6 双栈访问 @BlackLuny
• 支持通过命令行设置机器 UID @KKRainbow
• 添加 RPC 门户白名单，默认仅允许本地访问 @xzzpig
• GUI / Web 支持 Toml 配置的导入、导出和编辑 @xzzpig

🐞 问题修复 / Bug Fixes

• 修复 roaming 后 WireGuard peer 表丢失的问题 @imkiva
• 修复 OSPF 路由条目残留的问题 @KKRainbow
• 修复内置 STUN 服务未使用 XOR-MAPPED 地址的问题 @KKRainbow
• 移除 macOS 上 utun 设备的默认路由设置 @KKRainbow
• 添加对 RPC 数据包合法性的检查（Fix #963）@BlackLuny
• 更新 default_port 与 SNI 逻辑，提升反向代理可达性 @thezzisu
• 支持 --proxy-forward-by-system 与 --enable-exit-node 同时使用 @imkiva
• KCP 支持自动重连机制 @KKRainbow
• 批量压缩代替流式压缩，降低内存使用 @KKRainbow
• 为 PeerConn 添加 is_hole_punched 属性，取代原打洞状态表 @liusen373

📄 其他改动 / Other Changes

• 更新 core.yml，使用 UPX 4.2.4 进行打包优化 @KKRainbow

👥 新贡献者 / New Contributors

• 🎉 @thezzisu 首次贡献于 #947
• 🎉 @imkiva 首次贡献于 #954
• 🎉 @BlackLuny 首次贡献于 #953
• 🎉 @tianxiayu007 首次贡献于 #1004
• 🎉 @liusen373 首次贡献于 #1001

🔗 完整更新记录: 点击查看完整变更

---

📝 Release Notes (v2.3.1 → v2.3.2)

🚀 Feature Enhancements

• Added support for QUIC proxy @KKRainbow
• Added subnet proxy mapping support @KKRainbow
• easytier-core now supports loading multiple configuration files @xzzpig
• Added bandwidth rate limiting for forwarding traffic (bps limiter) @KKRainbow
• Web interface now supports IPv4/IPv6 dual-stack access @BlackLuny
• Allow setting machine UID via command line @KKRainbow
• Added RPC portal whitelist, local access only by default @xzzpig
• GUI/Web now supports importing, exporting, and editing Toml configurations @xzzpig

🐞 Bug Fixes

• Fixed issue where WireGuard peer table was lost after client roaming @imkiva
• Fixed OSPF route residue by adjusting route entry management @KKRainbow
• Fixed internal STUN server to use XOR-MAPPED address @KKRainbow
• Removed default route on macOS utun devices @KKRainbow
• Added sanity check for incoming RPC packets (Fix #963) @BlackLuny
• Improved reverse proxy reachability by updating default_port and SNI logic @thezzisu
• Enabled --proxy-forward-by-system to work with --enable-exit-node @imkiva
• Added KCP reconnect mechanism @KKRainbow
• Replaced streaming compression with bulk compression to reduce memory usage @KKRainbow
• Introduced is_hole_punched property to PeerConn, replacing global punch state table @liusen373

📄 Other Changes

• Updated core.yml to use UPX 4.2.4 for binary packing optimization @KKRainbow

👥 New Contributors

• 🎉 @thezzisu made their first contribution in #947
• 🎉 @imkiva made their first contribution in #954
• 🎉 @BlackLuny made their first contribution in #953
• 🎉 @tianxiayu007 made their first contribution in #1004
• 🎉 @liusen373 made their first contribution in #1001

🔗 Full Changelog: View Full Changes

---

v2.3.1

⸻

📝 发布说明（v2.3.1）

🚀 新增功能
• Web 前端现已支持通过 WebSocket 进行连接。
• 支持使用 --api-host 参数自定义 Web 前端的 API 服务器地址。
• 增加「私有模式（private_mode）」，提升部署的私密性与安全性。
• 节点信息展示新增隧道协议字段，便于协议区分与诊断。

🛠 性能优化
• 路由生成逻辑优化，显著提升处理性能。
• Zstd 压缩逻辑调整，复用压缩上下文以避免大规模内存映射带来的开销。
• OSPF 路由连接映射引入版本信息，提高兼容性与正确性。

🐛 关键修复
• 修复使用 musl 时可能导致的下载异常问题。
• 修复点击系统托盘图标恢复窗口时，最小化状态无法正常显示的问题。
• 修改 SNI 逻辑：统一使用 localhost，避免因目标 IP 被封锁而导致连接失败。

👥 新贡献者
• 感谢 @FuturePrayer、@initialencounter 与 @chenxudong2020 的首次贡献！

👉 完整更新日志

⸻

📝 Release Notes (v2.3.1)

🚀 New Features
• Added WebSocket support in the EasyTier Web frontend.
• Support for specifying the API server via --api-host parameter.
• Introduced private_mode to enable private deployments for enhanced security.
• Tunnel protocol field added in node information display for better visibility and diagnosis.

🛠 Performance Improvements
• Optimized route generation logic to improve overall performance.
• Reused Zstd compression context to avoid expensive memory mappings.
• OSPF route connection map now includes versioning for better compatibility.

🐛 Key Fixes
• Fixed an issue where downloading with musl toolchain could fail.
• Fixed GUI bug where clicking the tray icon did not restore the window correctly when minimized.
• Modified SNI logic to always use "localhost" to avoid issues with IP-based blocking.

👥 New Contributors
• Thanks to @FuturePrayer, @initialencounter, and @chenxudong2020 for their first contributions!

👉 Full Changelog

⸻