yesyunxin/webssh

WebSSH

镜像概述

WebSSH是一款融合Go后端与Vue2前端技术的现代化Web端SSH连接及任务调度平台，不仅提供流畅的Web终端体验与SFTP文件管理能力，还内置强大的定时任务调度系统与多渠道通知服务，是运维人员的高效管理工具。

核心功能

• Web终端：基于Xterm.js的高性能终端，支持自定义主题、字体、快捷连接及会话管理。
• 文件管理：集成SFTP面板，支持拖拽上传、下载及实时浏览服务器文件。
• 定时任务：
  • 支持精确到秒的标准Cron表达式；
  • 支持多步骤命令链；
  • 支持随机延迟执行，避免任务特征检测；
  • 任务执行日志持久化与结果回溯。
• 消息通知：
  • 支持SMTP邮件通知；
  • 支持*** Bot消息推送；
  • 支持iOS Bark实时推送；
  • 可配置任务执行失败/成功时的即时告警。
• 安全认证：
  • 独立Web登录系统（JWT认证）；
  • 支持SSH密码与密钥认证。
• 现代化设计：毛玻璃拟态UI，响应式布局，支持夜间模式。

使用场景

• 远程服务器运维管理；
• 批量定时执行服务器命令；
• 跨设备访问服务器文件；
• 任务执行结果实时告警通知。

配置说明与部署示例

Docker镜像启动（推荐）

bash
docker run -d \
  -p 8888:8888 \
  -e USER=admin        # 初始管理员用户名
  -e PASS=admin123     # 初始管理员密码
  -e TZ=Asia/Shanghai  # 设置时区（影响定时任务触发时间）
  --name webssh \
  --restart always \
  ghcr.io/workerspages/webssh:latest

Docker Compose部署

yaml
version: '3.8'
services:
  webssh:
    image: ghcr.io/workerspages/webssh:latest
    container_name: webssh
    ports:
      - "8888:8888"
    environment:
      - USER=admin        # 自定义用户名
      - PASS=admin123     # 自定义密码
      - TZ=Asia/Shanghai  # 时区设置（对Cron任务至关重要）
    volumes:
      - ./data:/app/data  # 挂载数据目录持久化数据库
    restart: unless-stopped

技术栈

• 前端：Vue 2.7、Element UI、Xterm.js、Axios
• 后端：Go 1.24、Gin、GORM（SQLite）、Gorilla WebSocket、Robfig Cron
• 部署：Docker、GitHub Actions

开源协议

MIT License ===FULL_DESC===