Repository navigation
Releases
Terminal-DSM 1.1.1(右侧留白 + 关窗格提示修复)
Terminal-DSM 1.1.1
本版修两个体验问题:终端右侧留白、关闭窗格时的提示闪烁。
修复:终端右侧留白
现象:终端内容(含 tmux 状态栏)右侧总有一条空白,宽度约 1.5 个字符。
原因:xterm 在初始化时会算一个 scrollBarWidth:
this.scrollBarWidth = viewport.offsetWidth - scrollArea.offsetWidth || 15;FitAddon.proposeDimensions() 计算列数时会无条件扣掉这个宽度:
const r = scrollback === 0 ? 0 : viewport.scrollBarWidth;
cols = Math.floor((width - padding - r) / cell.width);即使滚动条已被 CSS 隐藏,它仍按"有滚动条"扣掉约 15px。
修复:term.open() 之后把该预留值置 0,并补全局零宽滚动条样式。
| 指标 | 修复前 | 修复后 |
|---|---|---|
| 容器宽 | 918px | 918px |
| 内容宽 | 902px | 910px |
| 列数 | 117 | 118 |
| 右侧余量 | 14px | 约 6px |
剩下的几像素是字符网格取整的固有余量(不足一格),所有字符终端都如此。
修复:关闭窗格时闪 kill-pane #0? (y/n)
现象:点「关闭窗格」并确认后,终端左上角会闪一下 tmux 的确认提示。
原因:双重确认——先是我们自己的应用内确认框,确认后发送 Ctrl+B x,tmux 那边又弹它自己的 confirm-before 提示,200ms 后才由前端补发 y 关掉。若期间窗口被关闭,y 可能发不出,提示会残留在屏幕上。
修复:
- tmux 侧改为
bind x kill-pane(去掉confirm-before) - 前端只发一次
Ctrl+B x,不再补发y - 页面
pagehide/beforeunload时先隐藏内容,避免关闭瞬间闪现最后一条 tmux 消息
安装
- 下载
terminal_1.1.1.spk(DSM 7.x / x86_64) - 套件中心 → 手动安装(可直接覆盖 1.1.0)
- 安装后如提示需要 root 权限:
sudo sed -i 's/"package"/"root"/g; s/package/root/g' /var/packages/terminal/conf/privilege sudo synopkg restart terminal - 关掉 Terminal 窗口重新打开
Terminal-DSM 1.1.0(工具栏 + 快捷键精简)
Terminal-DSM 1.1.0
本次是功能版:新增工具栏,把最常用的 tmux 操作变成按钮;同时把 tmux 快捷键精简到只剩三个动作,避免误触。
新增:工具栏
窗口顶部新增一排按钮(位于 tmux 状态栏之上):
| 按钮 | 行为 |
|---|---|
A− / 字号 / A+ |
调整字号(9~28),记忆在浏览器本地,也支持 Ctrl+滚轮 |
| 左右分屏 | 发送 Ctrl+B % |
| 上下分屏 | 发送 Ctrl+B " |
| 关闭窗格 | 弹应用内确认框(非浏览器弹窗),确认后发送 Ctrl+B x + y |
? 帮助 |
快捷键说明,Esc 或点击空白处关闭 |
图标使用内联 SVG,不依赖字体字形;深色主题与终端一致。
变更:右键
- 右键恢复为浏览器原生菜单(复制 / 粘贴 / 检查元素等)
- tmux 自身的右键菜单被抑制(右键事件在 xterm 之前被挡下,不发给 tmux)
- 粘贴仍可用
Ctrl+Shift+V
变更:tmux 快捷键精简
本套件固定只有一个窗口(分屏 = 窗格),因此清空 prefix 表,只保留三个动作:
unbind -a
bind % split-window -h
bind '"' split-window -v
bind x confirm-before -p "kill-pane #P? (y/n)" kill-pane
bind C-b send-prefix新建窗口、切换窗口、缩放窗格、切换窗格(键盘)、分离会话、翻历史等快捷键全部解绑;鼠标滚轮、点击选中窗格、双击选词等鼠标行为保留。
修复:应用窗口最小尺寸
- 最小尺寸 640 × 420
- DSM 会记住上次窗口大小,若恢复出来的尺寸低于最小值,打开时会自动拉回
修复:前端缓存
- 终端页面资源改为带内容哈希的 URL
- DSM 应用脚本版本号提升(
terminal.js?v=0.17),避免改动不生效
版本号
- 套件版本改为 1.1.0(不再带
-N小版本后缀)
安装
- 下载
terminal_x64-7.0_1.1.0.spk(DSM 7.x / x86_64) - 套件中心 → 手动安装
- 安装后如提示需要 root 权限,执行一次:
sudo sed -i 's/"package"/"root"/g; s/package/root/g' /var/packages/terminal/conf/privilege sudo synopkg restart terminal - 关掉 Terminal 窗口重新打开(应用脚本 URL 已变)
Terminal-DSM 1.0.0-2(安全修复)
安全修复版。
修复
SYNO.Core.Desktop.Initdata 对未登录请求同样返回 success: true(isLogined: false、无 user 字段),
而旧实现只判断了 success,导致携带伪造 cookie 的请求被当成有效会话(页面返回 200)。
由于此时拿不到用户名,WebSocket 仍会被拒绝(拿不到 shell),但这属于鉴权判定缺陷,已修复:
- 会话校验改为同时要求
isLogined == true且user非空 - 不满足时再用
SYNO.FileStation.Info/SYNO.Core.System.info复核(这两个接口对无效会话返回error 119)
验证
| 请求 | 结果 |
|---|---|
无 cookie → /terminal/ |
302 |
无 cookie → /terminal/ws |
401 |
伪造 cookie → /terminal/ |
302 |
| 伪造 cookie + 伪造 token | 302 |
| 有效管理员会话 | 200,进 root shell |
安装
下载 terminal_x64-7.0_1.0.0-2.spk,套件中心手动安装;安装后如提示需要 root,执行:
sudo sed -i 's/"package"/"root"/g; s/package/root/g' /var/packages/terminal/conf/privilege
sudo synopkg restart terminalTerminal-DSM 1.0.0
首个正式版:单二进制重写(不再依赖 ttyd)。
主要特性
- DSM 登录即认证:校验 cookie +
SynoToken,未登录 302 到登录页;服务端只监听 unix socket,不占任何 TCP 端口 - 权限分级:administrators 打开即
root;其他 DSM 用户以本人账号运行(uid/gid 降权、独立家目录) - tmux 内建:会话保持、多窗口/分屏、5 万行历史、状态栏置顶、右键 tmux 菜单
- 剪贴板可用:OSC 52 + 选中自动复制 +
Ctrl+Shift+C/V,右键菜单不再弹浏览器菜单 - 提示符:
root@HNAS:/path#/user@HNAS:/path$ - 升级不吃旧缓存:静态资源带内容哈希
- 出错可见:非管理员 / 无法识别账号时给出明确 403 说明页,而不是白窗口
安装
- 下载
terminal_x64-7.0_1.0.0-1.spk - 套件中心 → 手动安装
- 首次安装后执行一次(DSM 会重置 privilege):
sudo sed -i 's/"package"/"root"/g; s/package/root/g' /var/packages/terminal/conf/privilege sudo synopkg restart terminal - DSM 九宫格打开 Terminal,或访问
https://<NAS>:5001/terminal/
说明
- 目前只提供
x64-7.0(DSM 7.x / x86_64) - 权限开关:
/var/packages/terminal/var/terminal.conf的ALLOW_ALL_USERS(true时普通用户可用自己账号;false仅管理员) - 基于 RROrg/syno-apps 的 terminal 套件(原作者 wjz304)重写,原项目 GPLv2