Skip to content

加固 SSH 安全与连接生命周期,优化前端加载和交互 - #1

Merged
azzliang6 merged 3 commits into
mainfrom
fix/security-reliability-frontend
Sep 11, 2026
Merged

azzliang6 merged 3 commits into
mainfrom
fix/security-reliability-frontend

Conversation

@azzliang6

@azzliang6 azzliang6 commented Sep 11, 2026 •

Copy link
Copy Markdown
Owner

变更

安全与数据可靠性

  • 用独立、持久化的随机 JWT / AES 密钥替代公开默认值,密钥文件以 0600 保存;旧默认密钥加密的凭据在启动时事务性迁移,自定义密钥保持不变。
  • 引入版本化 SQLite 迁移,失败回滚并报错;make clean 不再删除数据库,数据重置改为显式确认命令。
  • 原子创建首位管理员,登录/初始化限流,加强 JWT 校验,API 不返回凭据密文,应用日志不记录查询 token。
  • 为目标机和跳板机分别验证 SHA256 主机指纹,前端提供配置和独立核对说明,不自动信任观察到的指纹。

连接与文件传输

  • 统一持有、取消和释放整条 SSH 连接链,补握手、PTY、SFTP 初始化超时。
  • WebSocket 同源校验、消息上限、输入队列、写超时和独立清理,修复阻塞 I/O 和跳板连接泄漏。
  • SFTP 上传使用私有临时文件,检查关闭结果再原子发布,保留现有普通文件权限和 UID/GID;失败不截断原文件。

前端与工程化

  • 工作区、终端、文件管理和表单按需加载;保留非活动终端,避免切换标签重建 SSH。
  • 修复重连旧回调、主题/字号捕获、终端尺寸同步、目录请求乱序和过期操作确认;大段输入按 16 KiB 分块发送。
  • 手机端服务器抽屉、显式操作按钮、键盘可用的标签页/目录、真实连接状态和文件分页。
  • 类型检查成为构建前置步骤,新增 Vitest、Go 回归测试和 GitHub Actions;调整 Docker 构建和文档。

外观精修(保留原有风格)

  • 保留深蓝紫终端底色、>_ 标识、五种主题色和深浅主题,不改变终端工作流。
  • 统一侧栏卡片、分组计数、选中状态、标签页、字号控制和快捷键条的间距、边框、字体层级。
  • 登录与初始化页共享卡片布局,文件/服务器弹窗统一样式,修正目录面包屑和小屏滚动边界。
  • 将内联视觉样式集中为主题变量与 CSS,兼顾键盘焦点及 reduced-motion;截图使用隔离的演示数据。

构建体积

包含静态共享依赖的首屏 JavaScript,使用 Vite 构建报告口径:

修改前 当前版本
原始压缩 JS 1,480.96 KB 约 696.5 KB
gzip 估算 462.36 KB 约 233.4 KB

首屏 gzip JS 约减少 49.5%。主要收益是延后非首屏代码,不代表页面加载时间同比减少。

验证

  • go vet ./...
  • go test -race -count=1 ./...,含真实协议的本地 SSH/SFTP 测试端点
  • 前端 20 项测试、TypeScript 检查、生产构建和嵌入前端的 Go 构建通过
  • 生产依赖 npm audit:0 vulnerabilities
  • 本地 Docker 原生构建通过
  • Chrome + 隔离 OpenSSH:初始化、未配置指纹拒绝连接、独立核对后保存指纹、手动重连、执行命令、SFTP 目录浏览
  • 390px 手机视口下验证抽屉和终端布局
  • 在临时目录验证 make clean 保留数据库/密钥,未确认的数据重置被拒绝

升级注意

  1. 停止旧服务,备份数据库及原有密钥;自定义 OPSUP_ENCRYPTION_KEY 必须继续使用原值。
  2. 原先使用公开默认值的部署会生成新持久化密钥并迁移旧凭据,默认 JWT 会失效,需要重新登录。
  3. 为每台目标机及跳板机独立验证并保存主机指纹后才能连接。
  4. 上传请求体上限 256 MiB,SFTP 操作上限 15 分钟;无 POSIX rename 的服务器不允许覆盖现有文件。断线可能残留隐藏上传临时文件。
  5. WebSocket 仍使用 query token,反向代理日志也需脱敏。仅支持一个直接跳板机,不提供多租户隔离。

未修改或部署线上数据。完整操作步骤见 README / README_CN。

View in Indent
Tag @indent to continue the conversation here.

@azzliang6
azzliang6 merged commit 3fc18ba into main Sep 11, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant