极空间部署 Spug：集中管理主机、批量执行脚本与 Web 终端

前言

当需要管理的服务器从一台变成多台以后，问题往往不再是"会不会写 Shell 脚本"，而是这些主机、账号、命令和执行记录应该放在哪里统一管理。

Spug 提供的就是这样一个 Web 运维入口。它并不是用图形界面完全替代命令行，而是把原本分散执行的主机连接、脚本任务、文件操作等工作集中起来，让常用运维动作可以在浏览器中完成，同时保留实际命令和执行结果。

本文会在极空间上使用 Docker Compose 部署 Spug。按照原文的实际配置，Spug 服务会和 MySQL 容器共同运行，对外使用 8086 端口。完成管理员账号初始化以后，再添加需要管理的目标主机，实际测试 Web 终端、Shell/Python 脚本执行以及文件上传等功能。

如果运维平台还需要在公司之外使用，后面还会通过 cpolar 给 8086 端口增加公网访问入口，并进一步配置固定二级子域名。

整篇文章关注的不是"以后再也不用写脚本"，而是另一件更实际的事：把服务器连接、脚本执行和日常操作从零散的终端窗口里收拢到一个统一的运维控制台。

1.什么是Spug？

Spug是一个开源、轻量级、无依赖的可视化运维管理平台，专为中小团队或个人开发者设计，旨在简化日常的服务器运维、任务调度和自动化操作。它通过Web界面将原本需要在命令行中执行的脚本、命令、部署流程等操作图形化、集中化，显著降低运维门槛，提升效率与安全性。

核心特点：

零依赖部署

Spug采用Python编写，内置Web服务和数据库（SQLite），无需额外安装MySQL、Redis 等组件，一条命令即可启动，部署极其简单。

可视化操作

所有主机管理、脚本执行、定时任务、应用发布等操作均可通过浏览器完成，支持实时查看命令执行输出，告别"盲打"脚本。

多用户 & 权限控制

支持多账号协作，可按角色分配权限（如管理员、普通用户），并对主机、任务、应用等资源进行细粒度授权，保障操作安全。

批量执行 & 主机分组

可对单台或多台服务器批量执行Shell/Python脚本，支持主机组管理，适用于集群运维场景。

任务计划（定时任务）

内置类似crontab的定时任务功能，可通过界面配置周期性脚本执行，并记录历史日志。

应用发布（CI/CD轻量支持）

提供简单的应用部署流程，支持从Git拉取代码、执行构建脚本、远程同步文件、重启服务等，满足基础持续交付需求。

操作审计 & 日志追踪

所有用户操作均有完整日志记录，包括执行人、时间、命令内容、输出结果等，便于回溯与审计。

完全开源 & 社区活跃

项目托管于GitHub（https://github.com/spug-dev/spug），采用MIT协议，免费商用，社区持续更新维护。

适用场景：

中小型企业DevOps自动化
运维人员日常批量操作
开发团队自助部署测试环境
替代手写Shell脚本 + crontab的传统方式
需要可视化、可追溯、可协作的轻量级运维平台

简而言之，Spug = 可视化 + 自动化 + 安全协作，是现代高效运维的"轻骑兵"。如果你厌倦了在终端里反复敲打命令、管理散落各处的脚本，Spug或许正是你一直在寻找的解决方案。

2.前提条件

2.1ssh远程连接到极空间

开启【SSH 服务】
使用终端（Windows PowerShell / Mac Terminal）登录：

shell 复制代码

ssh root@IP

没有ssh的小伙伴可以参考这篇文章：

连接成功：极空间别再吃灰了！开启SSH，秒变全能服务器！ - cpolar 极点云官网

2.2验证docker是否开启

使用命令：

shell 复制代码

docker -v 
systemctl status -v

没有docker的小伙伴可以参考这篇文章：极空间开箱实录：从拆箱到远程访问保姆级教程，30分钟上手！ - cpolar 极点云官网

3.部署Spug

通过Docker部署Spug：

在开始部署之前，确保你的系统已经安装了Docker。可以通过以下命令检查 Docker 是否已安装：

shell 复制代码

docker --version

shell 复制代码

mkdir -p /docker/spug
chmod -R 777 /spug

创建并编辑 docker-compose.yml文件：

shell 复制代码

vi docker-compose.yml

shell 复制代码

version: "3.3"
services:
  db:
    image: mysql:8.0
    container_name: spug-db
    restart: always
    networks:
      - spug-net
    #command: --port 3306 --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci
    command:
      - --default-authentication-plugin=mysql_native_password
      - --character-set-server=utf8mb4
      - --collation-server=utf8mb4_unicode_ci
    volumes:
      - ./mysql:/var/lib/mysql
    environment:
      - MYSQL_DATABASE=spug
      - MYSQL_USER=spug
      - MYSQL_PASSWORD=spug.cc
      - MYSQL_ROOT_PASSWORD=spug.cc
  spug:
    image: openspug/spug-service
    container_name: spug
    privileged: true
    restart: always
    networks:
      - spug-net
    volumes:
      - ./service:/data/spug
      - ./repos:/data/repos
    ports:
      # 如果8086端口被占用可替换为其他端口，例如: - "8000:80"
      - "8086:80"
    environment:
      - MYSQL_DATABASE=spug
      - MYSQL_USER=spug
      - MYSQL_PASSWORD=spug.cc
      - MYSQL_HOST=db
      - MYSQL_PORT=3306
    depends_on:
      - db
networks:
  spug-net: