Spug 是面向中小型企业设计的轻量级、无 Agent 的自动化运维平台，整合了主机管理、主机批量执行、主机在线终端、应用发布部署、在线任务计划、配置中心、监控、报警等一系列功能。它前后端代码完全开源，UI 基于 Ant Design，无需在被管主机上安装客户端。
一、项目官方信息
| 项目 | 信息 |
|---|---|
| GitHub 仓库 | https://github.com/openspug/spug |
| 官方网站 | https://spug.cc |
| 开源协议 | AGPL-3.0 |
| 主要语言 | Python（约 58.5%） |
| Star 数 | 约 11.0k |
| 演示环境 | https://demo.spug.cc |
Spug 的技术栈：Python 3.6+、Django 2.2、Node 12.14、React 16.11。核心功能包括批量执行、在线终端、文件管理、任务计划、发布部署、配置中心、监控中心与报警中心。
二、官方图片
主机批量执行（命令在线批量下发）：
主机在线终端（浏览器直接登录主机）：
文件在线上传下载：
应用管理：
应用发布部署：
三、环境要求
- 已安装 Docker（推荐，官方镜像一键部署）。
- 服务器开放 80 端口（容器默认映射）。
- 若用源码部署：Python 3.6+、Django 2.2、Node 12.14、React 16.11。
- 被管主机无需安装 Agent，Spug 通过 SSH 连接即可。
四、完整部署步骤
1. 拉取官方镜像
docker pull registry.aliyuncs.com/openspug/spug
2. 启动容器（带数据持久化）
docker run -d --restart=always --name=spug -p 80:80 -v /mydata/:/data registry.aliyuncs.com/openspug/spug
-p 80:80：把容器 80 端口映射到宿主机 80；-v /mydata/:/data：把容器内代码与数据目录持久化到宿主机/mydata/，升级或重建容器后数据不丢；--restart=always：开机自启。
3. 初始化管理员账户
docker exec spug init_spug admin spug.dev
该命令会创建用户名为 admin、密码为 spug.dev 的管理员账户（可把 spug.dev 换成你自己的密码）。
4. 重启容器使配置生效
docker restart spug
5. 访问登录
浏览器打开 http://你的服务器IP:80，用 admin / spug.dev 登录，即可进入工作台。
五、使用方法
主机管理
在"主机管理"中添加被管主机，支持表格批量导入。添加后即可：
- 批量执行：在线批量下发命令，支持把常用脚本保存为模板；
- 在线终端：浏览器直接登录主机，体验与本地 SSH 一致；
- 文件管理：命令执行过程中在线上传/下载文件。
任务计划
灵活的在线任务计划，支持间隔执行、一次性执行、Crontab 风格执行。
应用发布部署
支持自定义发布流程，可发布 PHP、Java、Node.js、Go 等任意语言应用；支持工单流程发布、标准发布、自定义发布。发布过程包含建连、发布准备、检出前任务、执行检出、检出后任务、执行打包等环节。
配置中心
支持 KV、文本、JSON 等格式配置管理，并保留配置历史版本。
监控与报警
- 监控中心：支持站点、端口、进程、自定义脚本等监控；
- 报警中心：支持短信、邮件、钉钉、微信、企业微信等报警方式。
推送助手
Spug 还提供推送助手（https://push.spug.cc），集成电话、短信、邮件、飞书、钉钉、微信、企业微信等多通道消息推送，只需调用一个简单 URL 即可完成多通道推送。
六、常见问题 FAQ
1. 初始化后登录提示密码错误？
初始化命令执行后必须 docker restart spug 重启容器，新管理员账户才会生效。
2. 数据会丢吗？升级怎么办？
启动时用 -v /mydata/:/data 把数据持久化到宿主机目录，升级时只需拉新镜像、用同样的挂载目录启动即可，数据保留。
3. 被管主机要装 Agent 吗？ 不需要。Spug 是无 Agent 架构，通过 SSH 连接被管主机，添加主机时填入 SSH 连接信息即可。
4. 80 端口被占用怎么办？
启动时改映射，例如 -p 8080:80，然后通过 http://IP:8080 访问。
5. 默认账号密码是什么？如何修改？
初始化后默认 admin / spug.dev（或你在 init 命令里指定的密码）。登录后在系统管理里修改密码。
6. 想试用但不部署？ 官方提供演示环境 https://demo.spug.cc ，可直接体验全部功能。
七、跳转链接
- GitHub 仓库：https://github.com/openspug/spug
- 官方网站与文档：https://spug.cc/docs/about-spug/
- 演示环境：https://demo.spug.cc
- 常见问题：https://spug.cc/docs/faq/
- 推送助手：https://push.spug.cc