bifrost0x/webssh

这是什么？

核心功能

• 01支持多个 SSH 会话，提供标签页和 1、2、4 分屏布局。
• 02SFTP 文件工作区支持上传、下载、预览和在线编辑。
• 03多用户账户，支持 Passkey、TOTP、恢复码以及 OIDC 或 LDAP 登录。
• 04SSH 私钥加密存储，并按用户记录主机密钥信任决定。
• 05提供 Docker Compose 部署方式，数据持久化到卷中，并带健康检查接口。
• 06内置备份与恢复功能，操作需显式确认。

适用场景

• 在手机或浏览器中管理多台家庭实验室服务器，无需安装桌面 SSH 客户端。
• 为小团队提供带个人账户和密钥的共享 SSH 与 SFTP 访问，并保留审计记录。
• 借助共享传输队列在 SFTP 或 SMB 服务器之间迁移文件。
• 为经常维护的 Linux 主机保存可复用的命令集和诊断信息。

快速上手

1. 1

   创建部署目录

   mkdir webssh-deployment
2. 2

   进入部署目录

   cd webssh-deployment
3. 3

   下载 docker-compose.yml 文件

   curl -O https://raw.githubusercontent.com/bifrost0x/webssh/main/docker-compose.yml
4. 4

   使用 Docker Compose 启动 WebSSH，然后打开 http://localhost:5000 并创建第一个管理员

   docker compose up -d

使用前须知

• !随附的 Compose 文件面向评估和可信家庭实验室网络，直接暴露到互联网前需要完成生产环境配置。
• !SMB 功能默认关闭，需要显式配置服务器白名单；不支持访客访问、DFS 和 Kerberos。

收录于专题

标签

常见问题

webssh 是什么？

可自托管的浏览器 SSH 终端与 SFTP 文件工作台，支持多用户、Passkey、OIDC 和加密密钥存储。 WebSSH 是一个可自托管的 Web 应用，把 SSH 终端、SFTP 文件管理、常用命令、系统诊断和笔记整合到同一个浏览器工作区中。支持标签页与分屏多会话、跳板机、密钥或密码认证，目标机器安装了 tmux 时可保持远程会话持续运行。

webssh 可以免费使用吗？用的什么许可证？

webssh 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

webssh 还在维护吗？

活跃维护中。webssh 最近一次提交是在 2026年11月5日。

webssh 适合用来做什么？

在手机或浏览器中管理多台家庭实验室服务器，无需安装桌面 SSH 客户端。 为小团队提供带个人账户和密钥的共享 SSH 与 SFTP 访问，并保留审计记录。 借助共享传输队列在 SFTP 或 SMB 服务器之间迁移文件。 为经常维护的 Linux 主机保存可复用的命令集和诊断信息。

webssh 怎么安装和运行？

创建部署目录: mkdir webssh-deployment 进入部署目录: cd webssh-deployment 下载 docker-compose.yml 文件: curl -O https://raw.githubusercontent.com/bifrost0x/webssh/main/docker-compose.yml 使用 Docker Compose 启动 WebSSH，然后打开 http://localhost:5000 并创建第一个管理员: docker compose up -d

在哪里获取 webssh？

源代码和安装说明在 GitHub 上：https://github.com/bifrost0x/webssh