# spug

**Repository Path**: jicky168/spug

## Basic Information

- **Project Name**: spug
- **Description**: 开源运维平台：面向中小型企业设计的无 Agent的自动化运维平台，整合了主机管理、主机批量执行、主机在线终端、文件在线上传下载、应用发布、任务计划、配置中心、监控、报警等一系列功能。
- **Primary Language**: Python
- **License**: AGPL-3.0
- **Default Branch**: 4.0
- **Homepage**: https://spug.cc
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 978
- **Created**: 2026-09-07
- **Last Updated**: 2026-09-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

English | [简体中文](./README-zh_CN.md) 

<h1 align="center">Spug</h1>

<div align="center">

Spug is a lightweight agent-free automatic operation and maintenance platform designed for small and medium-sized enterprises. It integrates host management, host batch execution, host online terminal, file management, application release and deployment, pipelines, online task planning, configuration center, monitoring, alarm and so on.

</div>



## Demo

Demo：https://demo.spug.cc

The demo environment runs the latest version and resets its data every hour, both the English and the Simplified Chinese interface are available from the globe icon in the header.



## 🔥Push Assistant 

Push Assistant is a message push platform that integrates multiple channels such as telephone, SMS, email, Feishu, DingTalk, WeChat, and WeChat Work. It can realize telephone and SMS alarms of Zabbix, Prometheus, Nightingale and other monitoring systems in 3 minutes. Click to experience: [https://push.spug.cc](https://push.spug.cc)


## Features

- **Host Management**: Manage hosts by group, import them from cloud providers or an Excel file, and check connectivity in batch
- **Host Batch Execution**: Support host batch online command execution, with parameterized commands, reusable templates and execution history
- **Host Online Terminal**: The host supports browser online terminal login
- **Host File Management**: Support host files online upload and download
- **File Distribution**: Distribute files and directories from one host to many hosts
- **Build and Deploy**: Support application custom build deployment, with review flow, canary release and rollback
- **Pipelines**: Orchestrate parameter, build, remote command, data transfer, data upload and DingTalk / Feishu / WeChat Work / Push Assistant notification nodes into a workflow, with conditional branches and a live console
- **Task Planning**: It supports online configuration of crontab, interval and other task schedules
- **Configuration Center**: Support KV, text, json and other formats online configuration
- **Monitoring Center**: Support site, port, process, ping, custom script and other monitoring
- **Alarm Center**: Support email, WeChat, DingTalk, WeChat Work, Feishu and other alarm methods
- **Credential Management**: Keep passwords and private keys in one place and share them across hosts
- **Permission Control**: Fine-grained role and permission control, LDAP login and MFA are supported
- **Bilingual UI**: Full English and Simplified Chinese interface, switchable from the header
- **Elegant and beautiful**: UI interface based on Ant Design
- **Open source and free**: The front-end and back-end code is completely open source


## Environment

* Python 3.8+
* Django 4.2
* Node.js 18+
* React 16.13
* Redis 5.0+

## Install Doc

- Home Page：https://ops.spug.cc/docs/install-docker/
- Useage Doc：https://ops.spug.cc/docs/about-spug/
- Change Log：https://ops.spug.cc/docs/change-log/
- FAQ：https://ops.spug.cc/docs/faq/
- Spug Push：https://push.spug.cc


## Recommended 
[Yearning — MYSQL open source SQL statement review platform](https://github.com/cookieY/Yearning)


## PreView

### Workbench
![workbench](docs/img/4.0/en/workbench.jpg)

### Dashboard
![dashboard](docs/img/4.0/en/dashboard.jpg)

### Host Management
![hosts](docs/img/4.0/en/host.jpg)

#### Host Online Terminal
![web terminal](docs/img/4.0/en/web-terminal.jpg)

#### File Online Upload and Download
![file manager](docs/img/4.0/en/file-manager.jpg)

#### Host Batch Execution
![batch execution](docs/img/4.0/en/host-exec.jpg)
![batch execution output](docs/img/4.0/en/host-exec2.jpg)

### Pipelines
Orchestrate build, command, data transfer, upload and notification nodes into a workflow.

![pipeline editor](docs/img/4.0/en/pipeline.jpg)
![built-in pipeline modules](docs/img/4.0/en/pipeline-modules.jpg)
![pipeline node config](docs/img/4.0/en/pipeline-node.jpg)
![pipeline console](docs/img/4.0/en/pipeline-console.jpg)

### Application Release
![deploy configuration](docs/img/4.0/en/deploy.jpg)
![deploy request](docs/img/4.0/en/deploy-request.jpg)
![deploy console](docs/img/4.0/en/deploy-console.jpg)

### Task Planning
![scheduled tasks](docs/img/4.0/en/schedule.jpg)

### Configuration Center
![configuration center](docs/img/4.0/en/config.jpg)

### Monitoring and Alarm
![monitoring](docs/img/4.0/en/monitor.jpg)
![alarm](docs/img/4.0/en/alarm.jpg)



## Sponsor
<table>
  <thead>
    <tr>
      <th align="center" style="width: 115px;">
        <a href="https://www.ucloud.cn/site/active/kuaijie.html?invitation_code=C1xD0E5678FBA77">
          <img src="https://cdn.spug.cc/img/ucloud.png" width="115px"><br>
          <sub>UCloud</sub><br>
          <sub>5 元/月云主机</sub>
        </a>
      </th>
        <th align="center" style="width: 115px;">
        <a href="https://www.aliyun.com/minisite/goods?userCode=8vdj3myc">
          <img src="https://cdn.spug.cc/img/aliyun_quan.png" width="115px"><br>
          <sub>阿里云通用券</sub><br>
          <sub>300元限量免费领</sub>
        </a>
      </th>
      <th align="center" style="width: 125px;">
        <a href="http://www.magedu.com">
          <img src="https://cdn.spug.cc/img/magedu-logo.jpeg" width="115px"><br>
          <sub>马哥教育</sub><br>
          <sub>IT人高薪职业学院</sub>
        </a>
      </th>
    </tr>
  </thead>
</table>

## Developer Group
#### Follow the Spug operation and maintenance public number to add WeChat group, QQ group, and get the latest product dynamics
<div >
   <img src="https://cdn.spug.cc/img/spug-club.jpg" width = "300" height = "300" alt="spug-qq" align=center />
<div>
 
 
## License & Copyright
[AGPL-3.0](https://opensource.org/licenses/AGPL-3.0)