用 YAML 配置文件控制 ESP32、ESP8266 等微控制器,并接入 Home Assistant 等智能家居系统。
shellhub-io/shellhub
面向 Linux 设备与服务器的集中式 SSH 网关,无需公网 IP 即可远程访问位于 NAT 或防火墙后的设备。
- Star
- 2,248
- Fork
- 203
- 未关闭 Issue
- 25
- 最近提交
- 16小时前
这是什么?
ShellHub 是一个面向 Linux 设备和服务器的集中式 SSH 网关。每台设备上运行一个轻量代理,主动连接到 ShellHub 服务端,因此设备无需公网 IP,也无需开放入站端口,无论是服务器、云主机还是现场部署的嵌入式设备都适用。之后可通过服务端使用 ssh、scp、sftp 或网页终端进行连接。
每次 SSH 登录都关联到具体的团队成员,而不是复制到 authorized_keys 中的密钥。访问策略可以统一定义哪些用户能访问哪些设备、以什么 Linux 用户身份登录;把成员移出团队后,其在所有设备上的访问即刻失效。会话日志记录用户、来源 IP 和目标设备。
项目可通过 Docker Compose 自托管,也可直接使用托管的 ShellHub Cloud。仓库提供 Yocto、Buildroot、FreeBSD 和 Snap 的安装包,设备还可以通过标签进行分组。
核心功能
- 01兼容标准 ssh、scp、sftp 及端口转发客户端。
- 02设备主动向外连接,无需公网 IP 或入站端口。
- 03按人员分配 SSH 身份,取代 authorized_keys 中的共享密钥。
- 04默认拒绝的访问策略,统一管理用户可访问的设备。
- 05会话日志记录每次连接的用户、来源 IP 和设备。
- 06支持在控制台中通过网页终端直接打开 shell。
适用场景
- 访问没有公网 IP 的服务器或云主机。
- 管理部署在现场的嵌入式 Linux 设备集群。
- 为团队成员提供可审计、可随时撤销的共享机器 SSH 访问。
- 自建替代商业 SSH 访问网关的方案。
快速上手
- 1
创建免费的 ShellHub Cloud 账户,或选择自托管(从第 2 步开始)
- 2
克隆 v0.27.0 标签的代码仓库
git clone -b v0.27.0 https://github.com/shellhub-io/shellhub.git - 3
进入项目目录
cd shellhub - 4
使用 Docker Compose 启动服务器,然后在服务器上打开 /setup 页面创建管理员账户
make start
使用前须知
- 自托管需要安装带 Compose 的 Docker,并且主机上的 80 和 22 端口必须空闲。
- 用于生产环境时,需要按部署指南额外配置 HTTPS 等设置。
收录于专题
标签
常见问题
- shellhub 是什么?
- 面向 Linux 设备与服务器的集中式 SSH 网关,无需公网 IP 即可远程访问位于 NAT 或防火墙后的设备。 ShellHub 是一个面向 Linux 设备和服务器的集中式 SSH 网关。每台设备上运行一个轻量代理,主动连接到 ShellHub 服务端,因此设备无需公网 IP,也无需开放入站端口,无论是服务器、云主机还是现场部署的嵌入式设备都适用。之后可通过服务端使用 ssh、scp、sftp 或网页终端进行连接。
- shellhub 可以免费使用吗?用的什么许可证?
- shellhub 以 Apache-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
- shellhub 还在维护吗?
- 活跃维护中。shellhub 最近一次提交是在 2026年11月6日。
- shellhub 适合用来做什么?
- 访问没有公网 IP 的服务器或云主机。 管理部署在现场的嵌入式 Linux 设备集群。 为团队成员提供可审计、可随时撤销的共享机器 SSH 访问。 自建替代商业 SSH 访问网关的方案。
- shellhub 怎么安装和运行?
- 创建免费的 ShellHub Cloud 账户,或选择自托管(从第 2 步开始) 克隆 v0.27.0 标签的代码仓库: git clone -b v0.27.0 https://github.com/shellhub-io/shellhub.git 进入项目目录: cd shellhub 使用 Docker Compose 启动服务器,然后在服务器上打开 /setup 页面创建管理员账户: make start
- 在哪里获取 shellhub?
- 源代码和安装说明在 GitHub 上:https://github.com/shellhub-io/shellhub
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
面向 macOS 和 Windows 的桌面图形工具,统一管理 SSH 隧道、Dev Tunnel、Cloudflare Tunnel 和 FRP。
自托管的服务器管理软件,支持通过 SSH、VNC 和 RDP 远程连接,并提供 SFTP、Docker 与 Proxmox 管理。
一款基于网页的 SSH 与 Telnet 客户端,可直接在浏览器中连接远程服务器的终端。
在 Ubuntu、Debian、CentOS 等 Linux 上搭建 OpenVPN 远程接入服务端并管理用户的 Shell 脚本。
开源的 Java GPS 追踪服务端,支持 200 多种设备协议和主流 SQL 数据库。