更新日志

本页面记录 Nexus Terminal 的重要版本更新和变更。

v1.5.1（2026-05-19）

⚠️ 破坏性变更（Breaking Change）

容器运行用户由 root 调整为非 root 用户，出于安全最佳实践，自 v1.5.1 起所有 Docker 容器不再以 root 身份运行。升级后需要关注以下变更：

变更项	影响	操作
端口调整	Frontend 容器内部 nginx 监听端口从 80 改为 8080；Remote Gateway WebSocket 端口从 8080 改为 8081	更新 docker-compose.yml 和宿主机 Nginx 配置中的端口引用
数据目录权限	容器内创建 appuser/guacd 用户，./data 目录属主会在启动时被自动修复	首次升级后检查 ./data 目录权限是否正常
密钥文件安全	data/.env 文件权限收紧为 600（仅 owner 可读写）	如需在宿主机直接读取 data/.env，需使用 sudo
环境变量默认值更新	REMOTE_GATEWAY_WS_PORT 默认值改为 8081，相关 URL 变量同步更新	检查 .env 中是否显式设置了旧值，如有则更新

升级步骤：

1. 停止旧版本容器：docker compose down
2. 更新 docker-compose.yml（参考下方端口对照表）
3. 更新宿主机 Nginx 反向代理配置（/guacamole/ 代理目标端口改为 8081）
4. 拉取新镜像并启动：docker compose pull && docker compose up -d
5. 检查容器日志确认启动正常：docker compose logs -f

详细配置请参考 Docker 部署教程 和 Nginx 反向代理配置。

新增

• ✨ 文件编辑器换行符切换 — 支持在 LF 和 CRLF 之间切换，解决 Windows 复制粘贴时换行符不一致的问题
• ✨ 自动检测换行符类型 — 打开文件时自动识别 CRLF/LF/CR 换行符格式
• 🔒 容器安全加固 — 所有容器切换为非 root 用户运行，遵循最小权限原则

改进

• 文件编辑器头部新增换行符选择下拉菜单，与编码选择器风格一致
• 支持混合换行符文件的统一转换
• 数据目录权限自动修复，entrypoint 启动时自动创建缺失子目录并设置正确权限
• 密钥文件（data/.env）权限收敛为 600，提升安全性

v1.5.0（2026-05-15）

新增

• ✨ AI 调试模式 — 现在可以在 AI 设置中启用特殊的 debug 模式，查看详细的请求、响应和错误日志，并可随时清除
• ✨ 扩展通知事件 — 现在可以接收更多操作的提醒，如 Passkey 变更、SSH 断开连接、备份成功/失败、Docker 容器变更等
• ✨ WebSocket 多路复用与压缩 — 连接现在可以通过单一链路承载多个会话并使用压缩，提供更快更流畅的实时交互（附 CDN 边缘部署指南）

改进

• ⚡ 启动更快 — 应用现在会显示加载屏幕直到确认登录，不再出现短暂的已登录页面闪烁
• 📱 更好的移动端控件 — 命令栏按钮和终端标签在手机上更大，虚拟键盘现在包含字母和修饰键，便于触控操作
• 🚀 性能提升 — 虚拟滚动在组件间共享，后台 Worker 处理繁重任务，路由自动预加载，UI 响应更灵敏

修复

• 🐛 修复连接崩溃 — SSH、RDP 和 VNC 会话现在稳定运行，不再暴露敏感令牌
• 🐛 修复 UI 溢出 — 命令输入和其他面板现在保持在容器内，不再溢出屏幕
• 🐛 修复通知问题 — 移除重复或缺失的事件类型，事件处理现在更加可靠

v1.4.4（2026-05-09）

新增

• 改进批量命令执行，提供更好的历史记录跟踪和输入稳定性
• 简化 AI 设置，支持下拉选项和更新默认模型
• 支持为 AI 模型选择 API 端点

改进

• 应用加载速度显著提升，后端性能升级和前端压缩
• 日志更加规范安全，结构化数据和调度格式化
• Docker 容器卡片和仪表盘布局更清爽，间距和工具优化
• 代码审查和质量检查更加详细

修复

• 修复关键安全漏洞，防止未授权网络和命令访问
• 修复数据备份、导入和导出功能，防止数据丢失和错误

v1.4.3（2026-05-05）

新增

• ♿ 文本和标签现在更好地支持屏幕阅读器

改进

• 🎨 应用视觉效果更流畅，颜色与主题正确匹配
• 💾 文件保存现在可靠，不会丢失数据
• 🌍 系统状态详情支持多语言显示

修复

• ⚡ 电脑功率使用百分比现在正确计算
• 🔌 SSH 连接状态不再显示为"未知"
• 📁 修复保存文件时的数据丢失问题

v1.4.2（2026-05-04）

改进

• 📁 跨设备文件保存更可靠
• ⚡ 文件切换速度大幅提升
• 🤖 AI 助手响应更智能

修复

• 💾 文件保存后不再消失或变为空

v1.4.1（2026-05-04）

新增

• 📦 新增数据备份与恢复工具

改进

• 🐳 移动端/平板设备上的设置更简便
• 🌍 改进的地理位置服务帮助更快找到设备

修复

• 💾 文件保存不再改变格式

v1.4.0（2026-05-04）

新增

• 🌍 通过地图可视化和 IP 追踪查看连接来源
• 📂 支持一次性上传整个文件夹，提供更好的文件和目录控制
• 🐳 更简单的部署，减少运行的应用容器数量
• ⌨️ 快速退出文本编辑器或使用智能粘贴安全复制代码

改进

• 📱 手机虚拟键盘处理更好，智能调整屏幕尺寸和触控目标
• 🎨 仪表盘外观更清爽，悬停效果现代，信息卡片组织有序
• ⚡ 系统数据采集速度提升最高 85%

修复

• 🔐 文件上传现在保持正确的权限和会话
• 🛡️ 修复备份导入和 IP 地址解析的安全问题
• 🐳 Docker 容器现在在更多 Linux 系统变体上可靠启动

v1.3.9（2026-05-01）

新增

• 🚀 改进的 AI 问题分析：更丰富的上下文和更可靠的功能
• 🔄 新增通过评论重新触发 AI 分析的选项
• 🔄 增强的文件上传功能，支持整个文件夹结构

改进

• ⚡ 大文件上传稳定性更好
• 🧹 AI 问题审查输出更清晰、更有条理

修复

• 🐛 修复大文件上传时的文件损坏问题
• 🐛 修复 SFTP 会话意外断开的场景
• 🐛 修复拖拽文件时文件路径显示为 '[object Object]' 的问题
• 🐛 修复文件无法正确加载的问题
• 🐛 修复某些文件状态更新被阻止的问题

v1.3.8（2026-04-26）

修复

• 🐛 修复前端 tsconfig ignoreDeprecations 无效值导致 pre-commit 失败
• 🐛 修复审计日志操作类型前后端不一致及 i18n 翻译对齐
• 🐛 修复搜索 sessionId 非响应式和排序 tie-break 方向问题
• 🐛 修复 CodeRabbit PR 审查发现的 10 项问题

文档

• 📝 精简技术债务文档，更新 README 改进方向

v1.3.7（2026-04-21）

新增

• ✨ 升级 AI 智能回复工作流并增加调试权限检查

改进

• 🛠️ 增强审计日志 503 容错与 GET 瞬时重试
• 📝 更新多语言文件中会话挂起提示信息的详细说明

修复

• 🐛 防止 SFTP 文件意外打开，同时保留快速目录导航
• 🐛 延迟仪表盘初始化并规避 manifest 跨域噪音
• 🐛 修复 503 日志处理并注册图表 Filler 插件

v1.3.6（2026-04-09）

修复

• 🐛 修复挂起会话旧 SID 导致误失败并补充注释
• 🐛 修复静默命令与未执行输入拼接导致路径同步失败

文档

• 📝 更新多语言文件中会话挂起提示信息的详细说明
• 📝 补齐代码变量文档覆盖

v1.3.5（2026-04-08）

修复

• 🐛 修复挂起列表 429 轮询并优化通知

文档

• 📝 补齐代码变量文档覆盖
• 📝 补充通知超时变量与 Docker 构建说明

v1.3.4（2026-04-08）

修复

• 🐛 对齐 CodeMirror 锁文件以修复前端类型冲突
• 🩹 恢复远程桌面术语并仅保留桌面端 release 清理
• ✨ 修复 GHCR 拉取地址并强制提交 emoji 规范
• 🐛 修复 GHCR 镜像大小写并清理文档桌面端表述

v1.3.3（2026-04-06）

新增

• ✨ 增加静默命令执行时抑制终端提示符的功能
• ✨ 增加中文提交校验钩子并修复 eslint-plugin-import 异常
• ✨ 完成 WebSocket 路径同步和右键菜单行为（Issues #6-#8）

修复

• 🐛 修复同步终端路径时提示符回显
• 🐛 修复 lint 阻断并补齐缓存回归
• 🐛 修复 IP 管控开关与设置页语言响应问题
• 🐛 修复同步终端路径解析失败
• 🐛 修复终端路径同步超时并统一工具栏中文文案

优化

• 🔧 放宽依赖审计门限至生产关键依赖
• 🔧 优化 CI 工作流依赖关系

v1.3.2（2026-03-02）

新增

• ✨ 引入统一缓存管理器和错误提取器，优化连接列表性能
• ✨ 实现虚拟化文件管理器列表和防抖搜索
• ✨ 配置 Dependabot 自动依赖更新

修复

• 🐛 修复 11 个 high/critical 依赖漏洞，Dependency Audit 工作流恢复通过
• 🐛 修复 axios 和 qs 高危依赖漏洞
• 🐛 修复 tar 包的高危漏洞 (GHSA-8qq5-rm4j-mr97)
• 🐛 修复 qs 包的高危 DoS 漏洞 (GHSA-6rw7-vpxm-498p)

优化

• 🔧 统一初始化 API 并优化前端加载流程以提升启动性能
• 🔧 技术债务清零 — P0/P1 优先级任务完成
• 🔧 重构 SFTP 上传管理器并增强错误处理
• 🔧 类型安全的错误处理（catch unknown）

文档

• 📝 更新 README 文件，包含与上游的区别及详细改进
• 📝 新增安全审计报告并更新技术债务追踪
• 📝 架构文档增量更新

v1.3.1（2025-12-28）

修复

• 🐛 修复 SSH 终端光标位置错乱和输出顺序异常问题
• 🔧 移除 SSH 连接中的手动 TCP_NODELAY 配置

v1.3.0（2025-12-28）

新增

• ✨ 新增终端外观实时预览功能
• ✨ 新增强制键盘交互式认证选项，支持 TOTP/2FA 服务器认证
• ✨ 接入 remote-gateway 根测试并添加 HTTP 集成测试
• ✨ 速率限制现可通过环境变量配置

修复

• 🐛 优化 SSH 终端输入延迟
• 🐛 修复 TerminalPreview 骨架屏死锁与性能优化
• 🐛 修复键盘交互式认证描述文本
• 🐛 修复强制键盘交互式认证无法保存及位置调整
• 🐛 修复类型定义缺失导致的构建失败
• 🐛 修复 OpenAI token 参数对齐与回退逻辑

优化

• 🔧 重构 nl2cmd 模块并优化 AI 命令生成
• 🔧 统一长行换行格式

v1.2.2（2025-12-26）

新增

• ✨ 实现 NL2CMD 功能，支持多提供商 AI 集成（后端/前端）
• ✨ 将 AI 助手重构为底部工具栏的内联展开式输入框

修复

• 🐛 增强 429 错误处理，透传上游详细错误信息并记录调试日志
• 🐛 优化 trust proxy 配置以解决 express-rate-limit 误报错误
• 🐛 优化空命令处理逻辑，增加异常时的详细日志记录
• 🐛 修复 API 404 错误并优化 AI 助手 UI 样式
• 🐛 修复安全问题与功能缺陷，补充单元测试

优化

• 🔧 重构 nl2cmd 模块并优化 AI 命令生成
• 🔧 统一开关样式为标准 Checkbox 风格
• 🔧 强制转换 enabled 字段为布尔值以解决开关状态丢失问题
• 🔧 支持掩码密钥下的连接测试并优化 UI 提示与消息时长
• 🔧 优化 AI 设置存储和 Claude API 处理逻辑

v1.2.1（2025-12-24）

新增

• ✨ 增强 WebSocket 消息类型支持与 SSH 输入处理

修复

• 🐛 修复 SSH 终端输入和 WebSocket 连接的后端数据格式问题
• 🐛 修复 2FA 登录时未发送 tempToken 导致的 401 错误
• 🐛 修复 Passkey 登录时 fetch 未携带 credentials 导致的 400 错误
• 🐛 修复 2FA 登录时 session 未正确保存导致的 401 错误
• 🐛 保留上游代理的 X-Forwarded-Proto 头

优化

• 🔧 优化终端性能与字体渲染，减少输出延迟与模糊问题
• 🔧 优化认证模块的日志输出和 WebSocket 白名单配置
• 🔧 优化 Docker 构建流程，支持按需构建镜像

v1.2.0

新增

• 文档站点 agent-readiness 支持（robots.txt、sitemap.xml、API 目录发现）
• MCP Server Card 和 Agent Skills 发现端点
• RFC 8288 Link 响应头支持

修复

• 修复 PR #43 审查发现的 5 项连接问题
• 修复 SSH/RDP/VNC 连接功能的多个安全与健壮性问题
• 修复数据备份导出功能并增强 UX
• 修复数据备份导入的字段映射与回滚统计
• 修复 AI 助手第三方 API 测试连接失败（system 角色兼容性）

优化

• 测试覆盖率大幅提升 + 技术债务报告重构
• AI 助手设置页面优化 — Endpoint 下拉选择器与默认模型更新
• 优化发布工作流的变更日志生成逻辑

文档

• 新增 VitePress 文档站点
• 精简文档结构，新增设计文档模板
• 更新 README 中英文文档

v1.1.9（2025-12-24）

修复

• 🐛 修复认证路由限流策略导致 Passkey 登录 429 错误

v1.1.8（2025-12-24）

新增

• ✨ 实现完整测试框架（E2E + 集成测试 + 测试规范）
• ✨ 添加终端输出增强器开关设置
• ✨ 增强认证系统安全性并添加 WebSocket 消息验证

修复

• 🐛 提升密码安全性并实现加密密钥轮换机制
• 🐛 修复全部 24 项技术债务
• 🐛 修复 npm 依赖冲突与 husky 钩子

优化

• 🔧 大幅提升单元测试覆盖率并优化 ESLint 配置
• 🔧 统一错误处理模式并修复 TypeScript 类型错误

文档

• 📝 更新项目文档以反映安全增强与技术债务清零
• 📝 更新项目文档与子包配置

v1.1.7（2025-12-22）

新增

• ✨ 增强版本检查逻辑并优化 Docker 标签策略

v1.1.6（2025-12-22）

新增

• ✨ 实现仪表板图表的深色主题适配与视觉效果增强
• ✨ 现代化 UI 重构 — 深色主题与玻璃拟态设计

修复

• 🐛 关闭 Nginx access log 减少容器日志噪音
• 🐛 工作流自动更新 VERSION 文件 + 还原版本号显示逻辑
• 🐛 使用 raw.githubusercontent.com 替代 GitHub API 检查版本
• 🐛 前端版本号显示优化 — dev 版本显示
• 🐛 浅色主题回归与菜单栏可读性优化

优化

• 🔧 移除前端 nginx 条件日志映射配置
• 🔧 优化 Docker 构建版本号与标签逻辑

v1.1.5（2025-12-22）

新增

• ✨ 引入命令输出增强器，支持语法高亮、表格格式化、链接检测和折叠

修复

• 🐛 修复环境兼容性和日志优化问题
• 🐛 修复性能、安全和错误处理问题

优化

• 🔧 优化仪表盘界面布局和交互体验
• 🔧 优化仪表盘代码质量和性能
• 🔧 现代化仪表盘布局，使用响应式网格和 Tailwind

v1.1.4（2025-12-22）

修复

• 🐛 修复前端打包配置冲突导致页面初始化失败

v1.1.3（2025-12-22）

新增

• ✨ 完善增强仪表盘功能；移除传输策略
• ✨ 新增文件传输策略和仪表盘功能模块
• ✨ 新增 Nexus Terminal 个人使用路线图

修复

• 🐛 在头部导航栏显示条件中添加身份验证检查
• 🐛 添加 aiAssistant 和 batchExec 到 PaneName 类型定义
• 🐛 修复侧栏配置验证和 AI 查询 SQL 错误
• 🐛 添加 common.selectAll 和 common.deselectAll 中文翻译
• 🐛 修复 repository_dispatch 触发时的构建类型判断

v1.1.2（2025-12-21）

新增

• ✨ 恢复命令面板中的 UI 主题切换
• ✨ 添加布局存储、虚拟键盘和批量操作的单元测试

修复

• 🐛 修复国际化与 Nginx 日志配置
• 🐛 修复审计删除消息中的 i18n 类型问题

v1.1.1（2025-12-21）

新增

• ✨ 新增日志级别和审计日志的设置界面
• ✨ 新增日志级别和审计日志控制功能

修复

• 🐛 排除测试文件并修正 WebSocket 类型以确保构建通过
• 🐛 启用 AI 助手面板选择并同步 VERSION

v1.1.0

新增

• Passkey（WebAuthn）无密码认证支持
• 数据备份导入/导出功能
• Prometheus 指标监控端点
• IP 地理位置查询
• Telegram 通知支持

修复

• 修复多个 WebSocket 连接稳定性问题
• 修复 SFTP 文件传输中断恢复
• 修复移动端触控操作兼容性

优化

• 终端性能优化，减少渲染延迟
• Docker 镜像体积优化
• ARM 架构支持（ARM64 完全支持）

v1.0.0

首个正式版本

• SSH 终端（基于 Xterm.js）
• SFTP 文件管理（双面板布局）
• RDP 远程桌面（基于 Guacamole）
• VNC 远程桌面
• 多标签页管理
• 会话挂起与恢复
• 用户认证系统（密码 + TOTP 2FA）
• 审计日志
• 通知系统（Webhook / Email）
• Docker Compose 一键部署
• 100+ iTerm2 终端主题
• 移动端适配
• AI 智能助手（基础版）
• 批量命令执行
• 快速命令模板