sish项目多端口HTTP/TCP隧道配置实践

背景概述

在开发过程中，我们经常需要将本地开发环境暴露到公网进行测试或演示。sish作为一个SSH隧道工具，能够方便地将本地服务映射到公网域名。然而当应用涉及多端口通信时（如前端开发服务器同时使用HTTP和WebSocket端口），常规配置会遇到一些挑战。

典型场景分析

现代前端开发工具（如Vite、Webpack）通常采用以下架构：

• 主HTTP服务端口（如3000）
• 热更新(HMR)WebSocket端口（如3001）

当尝试通过sish同时暴露这两个端口时，开发者会遇到以下问题：

1. 同一子域名无法直接绑定多个端口
2. WebSocket端口被随机分配子域名
3. 浏览器无法直接访问TCP别名端口

解决方案详解

方案一：利用通配符DNS解析

sish服务器同时处理子域名和端口转发。只要所有子域名解析到同一服务器，可采用：

ssh -R dev:80:localhost:3000 -R 3001:localhost:3001 sish-server

此时：

• HTTP服务通过dev.sish-server访问
• WebSocket应连接dev.sish-server:3001

关键点：确保开发工具配置的WebSocket地址与转发端口一致。

方案二：路径转发

若无法修改端口，可将WebSocket通过特定路径转发：

1. 配置sish转发：

ssh -R dev:80:localhost:3000 -R dev/ws:localhost:3001 sish-server

2. 调整开发工具配置，指定WebSocket路径：

// Vite配置示例
export default defineConfig({
  server: {
    hmr: {
      path: '/ws'
    }
  }
})

方案三：SNI代理

对于需要TLS的场景：

1. 准备有效证书
2. 使用443端口转发：

ssh -R dev:443:localhost:3000 -R dev:443:localhost:3001 sish-server

3. 配置开发工具使用wss协议

多租户场景处理

当多个开发者需要相同端口时，sish的处理机制：

1. HTTP/HTTPS端口(80/443)支持多租户
2. 其他端口作为独立TCP隧道处理

解决方案：

1. 为每个实例分配不同WebSocket端口
2. 使用路径隔离（如/user1/ws和/user2/ws）
3. 采用SNI+TLS区分不同租户

性能优化建议

1. 对于开发环境，建议添加--idle-connection=false参数避免频繁重连
2. 生产环境应考虑使用固定子域名+负载均衡
3. WebSocket服务建议启用压缩减少延迟

总结

sish作为轻量级隧道工具，通过合理配置可以满足复杂开发场景的需求。理解其端口处理机制后，开发者可以灵活组合不同方案，构建稳定的远程开发环境。对于团队协作场景，建议提前规划端口分配策略或采用路径隔离方案。