在管理 OPNsense 防火墙时，我们经常需要通过 SSH 登录系统执行命令、查看日志或者进行高级故障排查。虽然 OPNsense 提供了完善的 WebGUI，但对于习惯使用命令行的管理员来说，一个集成在浏览器中的终端往往更加方便。ttyd 是一个轻量级 Web Terminal 项目，可以将本地终端映射到浏览器中，实现真正的 Web SSH 体验。为了方便使用，我开发了一个OPNsense 插件，安装后即可通过浏览器直接访问系统终端。
开发思路
为了确保系统稳定，不对 OPNSense 防火墙造成安全隐患，本插件遵循以下开发思路：
- 不通过 PHP 执行系统命令
- 不绕过 pfSense 身份认证
- 不自行管理用户权限
- 不实现额外的 Shell 环境
浏览器连接后实际执行的是：
sh printf "login: "; read -r user; ssh -tt "[email protected]"
用户输入用户名和密码后，ttyd 会通过 SSH 登录本机：
127.0.0.1:22
因此：
- 身份认证由 OPNsense SSH 服务负责
- 用户权限由系统账户决定
- 操作日志仍保留在 SSH 体系内
- Shell 环境与普通 SSH 登录保持一致
这意味着不会引入额外的认证系统，也不会绕过现有安全机制。
测试平台
在最新版的OPNsense 26.1.9上测试通过。为了避免影响 OPNsense 自身的软件包系统，ttyd 运行时被安装到独立目录。即使未来 OPNsense 升级，也不会轻易影响 ttyd 的运行。
安装方法
pkg add -f os-ttyd.pkg
完成后刷新 OPNsense WebGUI，转到System>Diagnostics > ttyd 即可使用。如下图所示：
卸载方法
pkg delete os-ttyd
使用建议
由于ttyd拥有完全的shell权限，在使用时需要特别小心，避免造成不可预料的后果。