使用Webpack/Browserify打包node ssh2失败的解决办法咨询

一、ssh2 + Browserify打包失败的解决办法 #

ssh2依赖Node.js核心模块（如net、crypto、zlib），浏览器环境没有这些模块，直接打包必然失败。目前可行的修复方案是用浏览器兼容的模块替换这些依赖：

• 打包时给Browserify指定替换规则，命令示例：

  browserify your-entry-file.js -o bundle.js \
    -r net:net-browserify \
    -r crypto:browserify-crypto \
    -r zlib:browserify-zlib
  

• 注意：替换后仍需服务器端配合WebSocket中转，因为浏览器不支持原生TCP连接，net-browserify本质是通过WebSocket模拟TCP。且ssh2的部分高级功能可能无法正常运行。

二、Chrome扩展实现SSH连接的替代思路 #

1. 用浏览器原生兼容的SSH库 #

• ssh2-browserify：ssh2的浏览器适配分支，已经内置了依赖替换，直接引入即可使用
• libssh-wasm：基于WebAssembly编译的libssh，性能更强，支持完整SSH特性，无需依赖Node.js模块

2. Native Messaging调用本地SSH客户端 #

通过Chrome的Native Messaging API，让扩展调用本地的OpenSSH等客户端，实际连接由本地程序处理。这种方式功能完整，但需要用户安装对应的本地辅助程序。

3. WebSocket中转方案 #

在服务器部署WebSocket转SSH的代理（比如websockify），扩展通过WebSocket连接代理，再由代理转发到目标SSH服务器。无需客户端额外安装，但依赖中间代理服务。

三、官方Secure Shell扩展能实现SSH功能的原因 #

官方的Secure Shell扩展（Chrome Secure Shell）用了两个关键技术：

• 采用WebAssembly编译的libssh，直接在浏览器中运行原生SSH代码，避开了Node.js模块的限制
• 利用Chrome扩展专属的chrome.sockets.tcpAPI，直接创建TCP连接，不需要WebSocket中转——这个API是扩展特有的权限，普通网页无法使用
• 终端界面基于xterm.js实现，配合Chrome的权限体系完成完整的终端交互

内容的提问来源于stack exchange，提问作者frgoe003