AimiliVPN V2.1.1 正式版

V2.1.1 是一次以稳定性、浏览器兼容性和 VPS 实际使用体验为重点的维护更新。本次版本已在 Ubuntu 22.04 VPS 上通过安装、节点获取、代理出口、节点切换、断开与恢复测试。

Bug 修复

• 修复 Edge 和部分 Chromium 浏览器打开管理页面后高占用、卡顿甚至浏览器失去响应的问题：移除高成本的 backdrop-filter、固定背景和远程字体依赖，并为“减少动态效果”系统设置提供兼容处理。
• 修复前端每 10 秒轮询时，即使节点和状态完全没有变化，仍会重新排序、生成表格 HTML 和刷新页面的问题；相同快照现在会直接跳过渲染。
• 修复节点列表已经按每页 50 条分页，但分页栏始终隐藏，导致第 51 条之后的节点无法查看的问题。
• 修复多个轮询请求可能重叠、页面切到后台后仍持续刷新，以及日志窗口重复拉取和渲染过多内容造成的卡顿。
• 修复连接、断开、单节点检测、收藏和设置操作可能被连续点击重复提交的问题，并为网络请求增加合理的超时与失败恢复。
• 修复弹窗关闭、键盘焦点、Esc、Tab 循环和移动端滚动在不同浏览器中的不一致行为。
• 修复登录和管理密码被意外删除首尾空格的问题；前端和 ml password 现在保持一致。
• 修复 SOCKS5 客户端未提供“无需认证”方法时，服务端仍错误接受连接的问题。
• 修复 ml status 一直显示旧版 v2.0，以及首次安装提示 5-30 秒但实际最多等待 90 秒的问题。
• 修复 ml update 重启服务后可能读取上一次连接留下的节点 ID、过早提示“已就绪”的竞态；现在会清理旧状态，并确认 OpenVPN 进程和 tun0 均已建立后才报告成功。
• 修复正式版 GitHub Actions 发布脚本的 Shell 块问题。

性能与体验优化

• 节点接口继续移除不需要发送到浏览器的 OpenVPN 配置正文，约百个节点的响应保持在较小体积。
• 节点请求自动合并；页面不可见时暂停普通轮询；节点表最多渲染 50 行，日志窗口最多渲染最近 300 行，服务端最多读取最近 500 条日志。
• 国家多选、状态筛选、IP 类型筛选、收藏面板和分页均在前端即时响应，不需要重新请求节点数据。
• 管理弹窗补齐标准对话框语义、可见焦点、焦点恢复和屏幕阅读器状态提示。
• 登录、节点更新、代理检测、节点切换、断开、设置保存和日志接口统一加入超时控制，网络异常时不会无限等待。
• 安装器生成的账号、密码和安全路径改用 Python secrets 加密安全随机源。

文档与功能更新

• Web 管理端版本标识和更新检测升级为完整的 V2.1.1 正式版，仍只跟踪 GitHub main 稳定分支和正式 Release。
• README 重新整理快速安装、代理连接、VPS 推荐、项目推广和法律使用边界，删除重复的版本流水账与虚拟币赞助内容。
• 保留简体中文主文档，并提供 English、日本語、한국어说明。
• 正式版继续提供 HTTP 和 SOCKS5 两种代理协议，兼容不同 VPS 和客户端环境。

验证结果

• Ubuntu 22.04 x86_64 VPS 一键安装成功，服务保持运行且无异常重启。
• HTTP 与 SOCKS5 代理出口验证通过。
• 节点测试、切换、断开和恢复原节点的完整流程通过。
• 本地 35 项单元测试、Python 编译、前端 JavaScript 语法、install.sh 语法和 Docker Compose 配置检查通过。
• 99 个节点分页为 50/49，国家多选、空状态、收藏、设置、网关、日志和 Web 更新检测均通过浏览器交互测试。
• 11.5 秒空闲轮询观测期间，相同节点快照产生 0 次 DOM 变更。
• 390x844 手机视口和 1440x900 桌面视口没有页面级横向溢出或控件重叠。

下载与兼容架构

• GitHub Release 提供 aimilivpn-v2.1.1-linux-source.tar.gz 通用 Linux Python 源码包和 sha256sums.txt。
• GHCR 发布 2.1.1、2.1、latest 三组镜像标签。
• Docker 镜像在发布前分别对 linux/amd64、linux/386、linux/arm64、linux/arm/v7 执行构建和导入冒烟测试。
• Docker 需要 Linux、/dev/net/tun、host 网络以及 NET_ADMIN、NET_RAW 能力。

更新方式

Python 源码安装：

:::bash
ml update

Docker Compose：

:::bash
docker compose pull
docker compose up -d