shellhub
SHA-256集中式 SSH 网关，通过网页或手机 App 远程管理任意 Linux 设备，无需公网 IP 或 VPN。
一键远程 SSH 连接，免公网 IP 免 VPN，支持会话录制与容器访问。
核心功能
- 原生 SSH 支持（可用 OpenSSH 等标准工具直接连接）
- SCP/SFTP 文件传输，无需额外客户端
- SSH 端口转发及 SOCKS 代理
- 公钥认证，便于多用户管理
- 防火墙规则，细粒度控制连接权限
避坑指南
- •开发模式下 TenantID 硬编码为全零，切勿用于生产。生产环境务必修改密钥并配置 HTTPS。会话录制文件占用磁盘空间，建议定期清理。
适用场景
- 远程管理无公网 IP 的 IoT 设备或边缘服务器
- 统一管控多数据中心 Linux 服务器，替代跳板机
- 安全访问内网 Docker 容器进行调试维护
详细介绍
ShellHub 是一个集中式 SSH 网关，让你随时随地通过浏览器或手机 App 远程访问和管理 Linux 服务器及设备。它充当安全中转站，无需公网 IP、VPN 或跳板机。支持原生 SSH/SCP/SFTP、端口转发、公钥认证、防火墙规则、审计日志、会话录制以及容器远程访问。适用于数据中心服务器管理、物联网设备控制、边缘计算节点等场景。提供自部署版本和云托管服务。
常见问题与排障 (2)
故障排除为什么在ShellHub的Web Endpoint上启用TLS（HTTPS）不起作用？
这是从commit b4a0fbc5引入的一个已知回归。TLS到后端的逻辑在多流重构中被删除，导致“启用TLS”开关失效。请手动应用缺失的代码：在ssh/http/handlers.go::HandleHTTPProxy中，拨号设备后，使用endpoint.TLS.Domain和MinVersion TLSv1.3将连接包装为tls.Client，设置req.Host，并使用正确的主机:端口重构req.URL。完整补丁在issue #6316中。请关注该issue以获取官方修复。
故障排除为什么在开发环境中编辑 OpenAPI 规范文件后会出现 '@typescript-eslint/no-unsafe-assignment' 错误？
该错误发生的原因是当OpenAPI规范变更时，ui-react容器不会自动重新生成TypeScript客户端类型。ui-react/apps/console/src/client/中生成的文件会过时，导致类型解析为any并触发ESLint错误。解决方法：手动重新创建openapi和ui-react容器。这会强制开发入口点重新打包合并后的规范并重新生成客户端。使用docker-compose up -d --force-recreate openapi ui-react或等效命令。永久解决方案（自动监视模式）正在考虑中。
标签
快速上手
安装软件
双击下载的安装程序，按提示完成安装
选择方式：使用云服务（免费注册 https://cloud.shellhub.io）或自部署
自部署：克隆仓库后执行 make keygen，设置环境变量 echo 'SHELLHUB_ENV=development' >> .env.override
启动环境：make start，等待服务就绪后创建管理员用户
- 选择方式：使用云服务（免费注册 https://cloud.shellhub.io）或自部署
- 自部署：克隆仓库后执行 make keygen，设置环境变量 echo 'SHELLHUB_ENV=development' >> .env.override
- 启动环境：make start，等待服务就绪后创建管理员用户
已提供 SHA-256 校验码，下载后可自行核对文件完整性
该校验码提取自 GitHub 官方 Release 页面
SHA256 校验码
89a7ad4dd48df84d6ad2cf66eaae26f0dd22735714be22f90d715cc255ab561b该校验码提取自 GitHub Release 页面，下载后请自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
自部署环境：在项目目录执行 docker-compose down -v 移除所有容器和数据卷。云服务：在控制台删除设备即可。
无额外依赖
下载后即可直接使用，无需安装其他运行环境
遇到问题？查看下方 FAQ
2 FAQs