WebSSH 部署与使用教程（Docker + 源码编译）

WebSSH 是一个基于 Go + Vue 的 Web 终端项目，通过浏览器就能方便地连接和管理服务器，非常适合在日常运维和学习中使用。本文分享一下如何快速拉取和部署 WebSSH。

一、项目获取

GitHub 地址：
https://github.com/eooce/webssh

克隆到本地：

git clone https://github.com/eooce/webssh.git
cd webssh

二、使用 Docker 快速部署（推荐）

项目已经打包好了镜像，直接运行即可。

1. 使用 Docker 运行

docker run -d \
  -p 8888:8888 \
  -e USER=你的用户名 \
  -e PASS=你的密码 \
  --name webssh \
  eooce/webssh:latest

浏览器访问 http://服务器IP:8888 即可。
如果设置了 USER 和 PASS，则需要登录后才能使用。

2. 使用 docker compose

在项目根目录新建 docker-compose.yml：

version: '3'
services:
  webssh:
    image: eooce/webssh:latest
    container_name: webssh
    ports:
      - "8888:8888"
    environment:
      - USER=admin
      - PASS=admin123
      - PORT=8888
    restart: unless-stopped

启动：

docker compose up -d

三、源码编译部署（可选）

如果想自己编译：

1. 安装依赖：

   • Go 1.21+

   • Node.js 14+

2. 构建前端：

   cd frontend
   npm install
   npm run fix && npm run build
   

3. 启动后端：

   cd ..
   go run main.go
   

默认运行在 http://127.0.0.1:8888

四、效果预览

• 支持 Web 端 SSH 登录

• 支持多标签管理多个会话

• 界面简洁，开箱即用

• 支持用户名/密码认证（可选）

五、总结

如果你只是想快速体验，直接用 Docker 一行命令就能跑起来；如果需要二次开发，可以选择源码编译。WebSSH 是一个轻量级的 Web SSH 管理工具，非常适合在学习 Linux 或日常管理中使用。