前置条件​

• 已经安装并配置好了Zabbix5以上版本监控系统。
• 提前下载电话短信报警媒介：https://cdn.spug.cc/push/usage/zabbix/SpugPush_AlarmMedia.json

步骤一：导入报警媒介类型​

在Zabbix管理界面，依次点击左侧 管理 / 报警媒介类型 / 点击右上角的“导入”按钮，选择下载好的SpugPush_AlarmMedia.json报警媒介文件，导入报警媒介

步骤二：打开推送助手官网，选择Zabbix模板​

推送助手官网push.spug.cc / 模板市场 / Zabbix模板 / 使用模版 / 配置模板对象

步骤三：拷贝保存模板编码​

配置完成推送对象后，拷贝保存模板ID

步骤四：配置报警用户​

1、在Zabbix管理界面，依次点击左侧 管理 / 用户 / 创建用户 / 用户权限需要给超级管理员权限

2、配置报警媒介

• 类型选择刚才导入的报警媒介：SpugPush推送助手
• 收件人填写上面步骤三的模板ID

步骤五：配置报警动作​

1. 在Zabbix管理界面，点击左侧“配置”，然后选择“动作”。

2. 点击右上角的“创建动作”按钮。

3、动作配置

• 名称：【电话短信机器人报警】

• 条件：根据自己的配置，可以选择自己监控的主机组 4、操作配置

• 报警操作：发送用户选择前面创建的电话短信机器人报警用户，发送渠道选择SpugPush推送助手

• 报警恢复操作：报警用户选择前面创建的电话短信机器人报警用户，发送渠道选择SpugPush推送助手

验证电话、短信、机器人报警​

完成以上配置后，我们可以进行测试，验证报警是否正常工作。

1、在Zabbix管理界面，点击左侧“监控”，然后选择“仪表盘”。

2、登录监控的主机，执行命令stress -c 8消耗一些CPU产生报警

3、如果CPU使用率超过了80%，则会触发刚才创建的报警动作，发送报警通知到配置的电话、短信、飞书、钉钉、微信或邮件中。

4、推送助手平台 / 推送日志 也可以看到发送的历史消息。

结论​

以上就是Zabbix电话、短信、飞书、钉钉、微信和邮件报警的配置过程。通过以上配置，可以及时地收到各种报警通知，帮助我们更好地管理和维护监控系统。

如果你是Zabbix4版本参考：Zabbix4电话短信钉钉飞书微信报警

关于Spug推送助手:​

推送助手是一个集成了电话、短信、邮件、飞书、钉钉、微信、企业微信等多通道的消息推送平台。 用户只需要调用一个简单的URL，就可以完成多通道的消息推送。链接：push.spug.cc

更多资讯、视频、欢迎关注公众号： Spug社区

推送助手是一个集成了电话、短信、邮件、飞书、钉钉、微信、企业微信等多通道的消息推送平台，用户只需要调用一个简单的URL，就可以完成多通道的消息推送。

目前推送助手已经内置了Zabbix、Prometheus、夜莺（N9e）等监控系统的消息模版，可以通过推送助手3分钟实现电话短信报警的能力。

近期功能更新：​

1、内置函数​

推送助手内置了一些函数，可以在模版内容里配置后对数据进一步处理，我们以如下报警消息体作为例子来说明内置函数的用法：

{
    "id": 20,
    "rule_name": "CPU usage",
    "trigger_time": 1660791492,
    "trigger_value": 92,
    "is_recovered": false
}

datetime()​

用于将时间戳转换为时间格式，不传参数时返回当前时间，例如：

${datetime(trigger_time)}
${datetime()}
将会输出：

2022-08-18 10:58:12
2023-03-24 11:40:30

date()​

用于将时间戳转换为日期格式，不传参数时返回当前时间，例如：

${date(trigger_time)}
${date()}
将会输出：

2022-08-18
2023-03-24

time()​

用于将时间戳转换为时间格式，不传参数时返回当前时间，例如：

${time(trigger_time)}
${time()}
将会输出：

10:58:12
11:40:30

upper()​

用于将字符串转换为大写，例如：

${upper(rule_name)}
将会输出：

CPU USAGE

lower()​

用于将字符串转换为小写，例如：

${lower(rule_name)}
将会输出：

cpu usage

2、电话报警重试次数​

现在电话推送重试次数，可以自定义设置了，0表示不尝试重复呼叫，最多尝试10次。

推送助手 / 个人中心 / 个人设置 / 语音重试

你的想法​

如果你对内置函数和其他功能还有想法，可以在这里反馈：https://support.qq.com/product/406949

更多资讯、视频、欢迎关注公众号“Spug社区”

HTTPS证书监控可能是很多企业缺失的监控，大部分HTTPS证书有效期都是一年，每年都需要定时更换，这就需要想个办法一年后提醒来更换证书，常见的Zabbix、Prometheus都不能很好的直接监控证书，这时候就可以用Spug证书监控工具来帮你监控证书到期。

证书监控工具​

Spug证书监控是专门用来监控HTTPS证书的SAAS监控工具，免安装，一次添加永久监控，到期前可以设置电话、短信、钉钉、飞书、微信等多个时间段反复提醒

如何使用​

打开推送助手官网(https://push.spug.cc) / 应用市场 / SSL证书监控 / 新建一个监测项，填写域名、告警规则和告警通知对象就可以完成证书的监控，非常简单方便！

好了，证书监控以后交给我们。从此，你就可以忘掉这件事了 😄

更多资讯、视频、欢迎关注公众号“Spug社区”

2021年1月，Spug用户向我们反应，老男孩教育于2020年底推出了新的课程《运维自动化专题课程》，其中涉及的软件项目Hippo，从功能介绍到界面布局，看上去都和Spug项目几乎一模一样。老男孩教育在宣传课程资料中，有好几处甚至连Spug文字水印都没去掉。在对外宣传的内容上，直接拿我们的开源项目换个名字，就变成了老男孩自己的项目了！！甚至有不知情的用户以为Spug项目是抄袭Hippo项目的，我们发现这种行为后，积极联系对方，但是对方根本不理我们，随后我们发文章声明：《致老男孩教育的维权声明 - Spug运维》，在文章中指出了老男孩自动化运维课程和Spug项目的相似之处，并声明会对这种侵权行为维权。

对方回应​

我们的声明发表后，对方发文《对Spug运维维权问题回应说明》，在文章中，老男孩指责Spug对老男孩教育公开进行名誉诋毁，并侵犯老男孩名誉权，并表示会采取法律措施维护权益，还在文章中说明“老男孩教育Python自动化hippo项目，是来自老男孩由老男孩教育Python教研团队和企业一线运维人员共同开发实现整套代码”

“至于宣传文件有spug截图是hippo项目还未开发完，编辑人员也没有注意直接将spug项目界面截图截进去了。”

我方回应​

针对老男孩的回应，我方感觉老男孩在颠倒黑白，满口谎言，我方律师先后主动联系老男孩八次，对方始终在推脱不解决问题，针对Hippo项目我方也贴出了更多证据，证明Hippo的功能介绍、功能截图和部分代码与Spug开源项目相似或相同。随后我方发表回应文章《老男孩教育抄袭之后使出了八大"绝招"，撒谎水平爆炸！真相在这里！》

最终的结果：​

经过我方律师一年多的努力，本来2022年3月17日要在上海知识产权法院开庭审理此案，但是由于上海的疫情，导致上海法院停摆，后来上海知识产权法院组织线上开庭审理调解了此案，法院令老男孩教育发文澄清，消除对Spug的影响，并赔偿。最终老男孩发文《关于 2021 自动化运维平台项目课程的澄清声明》承认老男孩自动化运维项目Hippo，借鉴了Spug开源运维平台项目的部分代码和功能介绍，承认在宣传资料中使用了Spug开源运维平台的功能截图。

想说的话​

开源项目虽然开源，但不代表可以被任意践踏，任意商业化，开源项目都有开源协议，使用开源代码是需要遵循相关的软件许可协议，开源不等于是没有版权，开源不等于慈善。

国内很多开源项目都是个人或者小团队开发者，在遇到开源项目被商业公司利用，一定要找个律师维护自己权益，发现侵权后，可以把一切事务交给律师，律师会帮你分析不同方案的利弊，平衡风险和收益，并 收集证据、固定证据、起诉、诉讼等，开庭现场也可以由律师全权代理，项目作者要做的就是配合律师，然后坐等结果，这里我可以推荐一下帮我们维权的【上海博拓律师事务所】程序员出身的蒋圣阳律师。

关于Spug​

Spug是面向中小型企业设计的无 Agent的自动化运维平台，整合了主机管理、主机批量执行、主机在线终端、文件在线上传下载、应用发布、任务计划、配置中心、监控、报警等一系列功能。开源链接：github.com/openspug/spug

最近我们又发布了「Spug推送助手」帮助快速实现电话、短信、邮件、飞书、钉钉、微信、企业微信等多通道消息快速推送。用户只需要调用一个简单的URL，就可以完成多通道的消息推送。链接：push.spug.cc

更多资讯、视频、欢迎关注公众号“Spug社区”

Zabbix是现在企业用的比较多的开源监控系统，Zabbix电话短信报警更是运维不可缺少的报警渠道。

前面一篇介绍了Zabbix5.4版本如何通过Spug推送助手发送电话短信报警，但用户反馈Zabbix4.x版本有很大不同，这篇文章就基于Zabbix4.x版本介绍一下如何实现Zabbix电话短信和各种机器人报警，配置完发现，这篇使用文档在Zabbix5配置步骤同样适用！😊

打开推送助手官网，选择Zabbix模板​

推送助手官网push.spug.cc / 模板市场 / Zabbix模板 / 使用模版 / 配置模板对象

拷贝保存模板编码​

配置完成推送对象后，拷贝模板ID

Zabbix添加报警媒介​

• Zabbix / Administration / Media Types / create media type

  Name：推送助手报警
  Type：Script
  Script name：spug_push_alert.sh
  Script parameters1：abPampgaabc   //粘贴上面拷贝的推助手模版编码
  Script parameters2：{ALERT.MESSAGE}

添加zabbix报警报警脚本​

登录zabbix-server服务器，添加zabbix执行的报警媒介脚本

$ vim /usr/lib/zabbix/alertscripts/spug_push_alert.sh

#!/bin/bash
/usr/bin/curl -X POST -d "$2" https://push.spug.cc/send/$1


# 添加脚本执行权限
$ chmod +x  /usr/lib/zabbix/alertscripts/spug_push.sh

添加Zabbix报警用户​

Zabbix / Administration / Users / create user / Media选择上面创建的[推送助手报警] / 用户权限需要给超级管理员权限

添加Zabbix触发器​

Zabbix / Configuration / Action / create action

• Action / Operations / 复制添加下面的Operations-Default message默认消息内容
• Opeartions / New / operation detail / Send to User / 选择推送助手电话短信报警用户 / Add 保存

# Operations - Default message：
status={TRIGGER.STATUS}&name={EVENT.NAME}&severity={EVENT.SEVERITY}&date={EVENT.DATE}&time={EVENT.TIME}&age={EVENT.AGE}&ip={HOST.IP}&hostname={HOST.NAME}&key={TRIGGER.KEY1}&value={ITEM.LASTVALUE}

• Action / Recovery options / default message / 复制添加下面的Recovery options - Default message 默认消息内容
• Opeartions / New / operation detail / Send to User / 选择推送助手电话短信报警用户 / Add 保存

# Recovery options - Default message：
status={TRIGGER.STATUS}&name={EVENT.NAME}&severity={EVENT.SEVERITY}&date={EVENT.DATE}&time={EVENT.TIME}&age={EVENT.AGE}&ip={HOST.IP}&hostname={HOST.NAME}&key={TRIGGER.KEY1}&value={ITEM.LASTVALUE}&recovery_date={EVENT.RECOVERY.DATE}&recovery_time={EVENT.RECOVERY.TIME}

验证电话、短信、机器人报警​

• 可以使用stress压测命令手动触发一下报警，测试一下报警发送。

查看日志​

推送助手平台 / 推送日志 也可以看到发送的历史消息。

关于Spug推送助手:​

推送助手是一个集成了电话、短信、邮件、飞书、钉钉、微信、企业微信等多通道的消息推送平台。 用户只需要调用一个简单的URL，就可以完成多通道的消息推送。链接：push.spug.cc

更多资讯、视频、欢迎关注公众号： Spug社区

Zabbix是现在企业用的比较多的开源监控系统，Zabbix电话短信报警更是运维不可缺少的报警渠道，假如半夜正在睡觉服务器异常了，这时候电话报警就非常必要。

Spug推送助手针对常见的报警系统，内置好了很多报警模版，可以让用户简单快捷的配置常见的报警通知，下面以Zabbix为例，看一下如何快速配置电话、短信、邮件、钉钉、飞书、企业微信等报警通知。

打开推送助手官网，选择Zabbix模板​

推送助手官网push.spug.cc / 模板市场 / Zabbix模板 / 使用模版 / 配置模板对象

拷贝保存模板编码​

配置完成推送对象后，拷贝模板ID

Zabbix添加报警媒介​

• Zabbix / 报警媒介类型 / 添加

  名称：推送助手报警
  类型：脚本
  脚本名称：spug_push_alert.sh
  脚本参数1：abPampgaabc   //粘贴上面拷贝的推助手模版编码
  脚本参数2：{ALERT.MESSAGE}

• 配置 Message templates，添加报警发送内容
• 将下面的消息内容拷贝到你的zabbix templates消息里面，主题可以自己随便定义

• Message type： 问题

status={TRIGGER.STATUS}&name={EVENT.NAME}&severity={EVENT.SEVERITY}&date={EVENT.DATE}&time={EVENT.TIME}&age={EVENT.AGE}&ip={HOST.IP}&hostname={HOST.NAME}&key={TRIGGER.KEY1}&value={ITEM.LASTVALUE}

• 添加报警恢复内容
• 将下面的消息内容拷贝到你的zabbix templates消息里面，主题可以自己随便定义

• Message type：Problem recovery

status={TRIGGER.STATUS}&name={EVENT.NAME}&severity={EVENT.SEVERITY}&date={EVENT.DATE}&time={EVENT.TIME}&age={EVENT.AGE}&ip={HOST.IP}&hostname={HOST.NAME}&key={TRIGGER.KEY1}&value={ITEM.LASTVALUE}&recovery_date={EVENT.RECOVERY.DATE}&recovery_time={EVENT.RECOVERY.TIME}

添加zabbix报警报警脚本​

登录zabbix-server服务器，添加zabbix执行的报警媒介脚本

$ vim /usr/lib/zabbix/alertscripts/spug_push.sh

#!/bin/bash
/usr/bin/curl -X POST -d "$2" https://push.spug.cc/send/$1


# 添加脚本执行权限
$ chmod +x  /usr/lib/zabbix/alertscripts/spug_push.sh

添加Zabbix报警用户​

Zabbix / 管理 / 用户 / 关联推送助手报警媒介 / 用户权限需要给超级管理员权限

添加Zabbix触发器​

Zabbix / 配置 / 动作 / Trigger Action / 创建动作 / 配置报警发送用户和恢复信息发送用户

验证电话、短信、机器人报警​

• 可以手动触发一下报警，测试一下报警发送。

• 推送助手平台 / 推送日志 也可以看到发送的历史消息。

关于Spug推送助手:​

推送助手是一个集成了电话、短信、邮件、飞书、钉钉、微信、企业微信等多通道的消息推送平台。 用户只需要调用一个简单的URL，就可以完成多通道的消息推送。链接：push.spug.cc

更多资讯、视频、欢迎关注公众号： Spug社区

1、配置电话短信模板​

打开推送助手(push.spug.cc) / 消息模版 / 新建 / 选择电话短信 / 配置模板 / 配置通知手机号

2、配置完模板，复制模板 URL，就可以用脚本打电话发短信​

3、先测试一下是否能正常打电话​

# 命令执行curl命令测试打电话发短信，key1 和key2 是模板里面接受的二个变量

[root@manage]# curl "https://push.spug.cc/send/byPj9N3xxxYQ?key1=测试报警&key2=服务器IPxxxx"
{"code": 200, "msg": "请求成功"}

4、编写脚本监控Mysql和主从同步，发生异常推送电话短信报警​

[root@manage]# vim mysql_alert.sh

#!/bin/bash
mysql_user="repl"
mysql_pass="repl@password"


mysql_status=`netstat -nl | awk 'NR>2{if ($4 ~ /.*:3306/) {print "Yes";exit 0}}'`

if [ "$mysql_status" == "Yes" ];then
        slave_status=`mysql -u${mysql_user} -p${mysql_pass} -e"show slave status\G" | grep "Running" | awk '{if ($2 != "Yes") {print "No";exit 1}}'`
        if [ "$slave_status" == "No" ];then
                echo "slave is not working!"
                
                # 主从同步异常推送电话短信报警
                curl "https://push.spug.cc/send/byPj9N3xxxYQ?key1=Mysql主从同步&key2=服务器IP:192.168.100.1"
        else
                echo "slave is working."
        fi
else
        [ ! -f "/tmp/mysql_down" ] && echo "Mysql Server is down!" | mail -s "Warn!MySQL server is down!" ${email_addr}
        
        # mysql进程异常电话短信报警
        curl "https://push.spug.cc/send/byPj9N3xxxYQ?key1=Mysql进程&key2=192.168.100.1"
fi

5、验证电话短信报警​

6、支持更多渠道报警发送​

如果想让脚本支持邮件、钉钉、飞书、企业微信报警，只需要在推送助手平台上编辑模板，把邮件、钉钉、飞书、企业微信打开配置一下就可以实现不改动脚本的情况下实现。

飞书、钉钉、企业微信、邮件报警模板内容：​

## <font color='#f90202'> ${key1} 发生异常 </font> ##
**报警项目：** ${key1} 
**报警主机：** ${key2} 

飞书群收到的报警​

钉钉群收到的报警​

关于推送助手​

上海时巴克科技有限公司旗下的推送产品，公司旗下现有产品「Spug开源运维平台」「Spug推送助手」「监控助手」「SSL证书监控」，公司专注为中小企业服务，推送助手帮助用户简单快速实现电话、短信、邮件、飞书、钉钉、微信、企业微信等多通道消息推送。 官网链接：push.spug.cc

更多资讯、视频、欢迎关注公众号“Spug社区”

Nightingale | 夜莺监控，一款先进的开源云原生监控分析系统，采用 All-In-One 的设计，集数据采集、可视化、监控告警、数据分析于一体，与云原生生态紧密集成，提供开箱即用的企业级监控分析和告警能力。于 2022 年 5 月 11 日，捐赠予中国计算机学会开源发展委员会(CCF ODC)，为 CCF ODC 成立后接受捐赠的首个开源项目

官方地址：https://n9e.github.io/

夜莺配置电话短信报警​

夜莺监控社区版是使用人数最多的版本，但社区版本的夜莺监控不支持电话短信报警，对于运维来说电话报警是很重要的报警渠道，最近就有很多用户跟我们建议，让Spug推送助手来支持一下夜莺监控电话短信报警，下面就以夜莺监控社区版本如何支持电话短信报警来描述一下配置过程

使用夜莺监控模版​

• 打开推送助手官网 / 模版市场 / 夜莺监控 / 使用模版

• 配置要推送报警的电话/短信报警手机号

• 配置完成推送对象后，拷贝模板URL

  

夜莺通知配置​

• 编辑告警规则的通知配置，回调地址栏填写上一步拷贝的URL

  

验证电话、短信、机器人报警​

• 可以手动触发一下报警，测试一下报警发送。

• 推送助手平台 / 推送日志 也可以看到发送的历史消息。

  

其他监控系统支持​

如果你希望推送助手支持其他监控系统，可以在这里反馈：https://support.qq.com/product/406949

更多资讯、视频、欢迎关注公众号“Spug社区”

推送助手是一个集成了电话、短信、邮件、飞书、钉钉、微信、企业微信等多通道的消息推送平台。

用户只需要调用一个简单的URL，就可以完成多通道的消息推送。

推送助手场景：​

推送助手可以用来做登录短信验证、报警消息短信电话通知、重置密码邮件接收、飞书机器人、钉钉机器人、微信机器人等消息推送，可以满足不同渠道消息推送。

为什么选推送助手？​

• 使用超级简单：只需要调用简单的url就可以实现不同渠道的消息推送
• 快速接入：不需要对接多种平台接口，一分钟实现短信、电话、邮件等推送能力，节省时间成本
• 高效稳定：系统支持高并发、高可靠性，快速推送目标渠道

如何使用？​

• 1、微信扫一扫注册用户
• 2、选择消息通道，创建消息模版
• 3、复制 URL，发送消息

短信发送​

群组是什么？​

当你想把一条消息，同时推送给多个人时就可以通过创建群组功能，在执行URL时添加group参数就可以

关于推送助手​

上海时巴克科技有限公司旗下的推送产品，公司旗下现有产品「Spug开源运维平台」「Spug推送助手」，公司专注为中小企业服务，推送助手帮助用户快速实现电话、短信、邮件、飞书、钉钉、微信、企业微信等多通道消息快速推送。 官网链接：push.spug.cc

更多资讯、视频、欢迎关注公众号“Spug社区”

推送助手是一个集成了电话、短信、邮件、飞书、钉钉、微信、企业微信等多通道的消息推送平台。

用户只需要调用一个简单的URL，就可以完成多通道的消息推送。

推送助手场景：​

推送助手可以用来做登录短信验证、报警消息短信电话通知、重置密码邮件接收、飞书机器人、钉钉机器人、微信机器人等消息推送，可以满足不同渠道消息推送。

为什么选推送助手？​

• 使用超级简单：只需要调用简单的url就可以实现不同渠道的消息推送
• 快速接入：不需要对接多种平台接口，一分钟实现短信、电话、邮件等推送能力，节省时间成本
• 高效稳定：系统支持高并发、高可靠性，快速推送目标渠道

如何使用？​

• 1、微信扫一扫注册用户
• 2、选择消息通道，创建消息模版
• 3、复制 URL，发送消息

短信发送​

群组是什么？​

当你想把一条消息，同时推送给多个人时就可以通过创建群组功能，在执行URL时添加group参数就可以

关于推送助手​

上海时巴克科技有限公司旗下的推送产品，公司旗下现有产品「Spug开源运维平台」「Spug推送助手」，公司专注为中小企业服务，推送助手帮助用户快速实现电话、短信、邮件、飞书、钉钉、微信、企业微信等多通道消息快速推送。 官网链接：push.spug.cc

更多资讯、视频、欢迎关注公众号“Spug社区”

本次更新对 Web 终端做了很多的改进和增强。

文件管理模式​

当某些时候只想让一些用户能够查看服务器上文件但不需要操作命令行时，可以只给这些用户分配 文件管理 权限。

这时用户访问 Web 终端 时看到如下效果

标签栏菜单​

在主机标签栏新增了右键菜单及双击标签快速复制的功能。

窗口宽度自由调整​

再也不怕主机名称过长显示不完整了

批量执行模版参数化​

现在的模版支持配置参数了，提供在执行时的交互能力，目前仅支持3种创建的参数类型

当执行模版时会弹出交互的参数输入框

自定义发布配置调整动作顺序​

现在自定义发布的动作顺序可以自由调整，不需要删了再加了

补偿发布功能​

在之前每次发布都会完整执行所有关联主机的发布，现在可以在发布异常后，仅发布失败的主机。

其他优化更新​

• 工作台的便捷导航模块新增了几个默认图标，省得找logo了
• 主机excel导入增加密码字段并优化导入体验，再也不用一个个点着验证了
• Webhook自动发布支持Coding
• 优化发布申请列表页展示效果（展示字段很多，可以通过表格右上角的设置来控制显示隐藏字段）
• 优化发布配置的克隆功能
• 优化角色关联账户显示问题，感谢 @Lucius-chen 的贡献
• 发布配置里的Git仓库配置难到一些同学，新增了对私有仓库的辅助配置功能
• 新建主机现在默认选中当前分组
• 自定义发布新建发布申请已支持文件拖拽上传

注意事项​

• 自 3.1.0 开始不再使用系统自身（~/.ssh/目录下）的密钥，如果有主机依赖这些密钥则可能需要重新验证。

主机分组​

在主机管理 / 主机分组 可以鼠标右键创建、重命名、删除分组

新建主机​

新主机可以通过多种方式添加：

• 1、通过页面表单新建
• 2、通过Excel表格导入
• 3、也可以通过输入阿里云、腾讯云Access密钥Key同步到spug系统里面

spug平台不会在数据库保存目标主机的账号密码，用户第一次输入账号密码后，后续spug会使用自动生成的密钥对进行主机连接

默认Spug会自动生成一个新密钥对，然后使用生成的密钥去链接目标主机，你也可以在【 系统管理 / 系统设置 / 密钥设置 】将自己管理机（例如公司的跳板机服务器）的密钥上传到Spug系统里面，这样就可以直接通过上传的密钥去添加管理主机

主机扩展信息​

添加完主机spug会自动获取主机配置，点击主机名称，可以打开主机扩展信息（内存、cpu、硬盘、IP信息）也可以对扩展信息进行编辑

WEB在线终端​

主机管理 / Web终端 / 双击要链接的主机后，就可以在线Console管理主机，也可以多次双击主机打开多个窗口

在线文件管理​

打开主机Web终端后，可以在线对主机文件进行在线管理，可以在线上传、下载、删除文件

更多资讯、视频、欢迎关注公众号“Spug社区”

以 若依管理系统 https://gitee.com/y_project/RuoYi 作为例子，最终大概是这样子的。

安装 jdk / maven​

如果已安装可跳过该步骤，这里以安装 jdk-8u251 和 maven-3.6.3 为例，如果你使用 Docker 部署的 Spug，可参考以下步骤进行安装

因 Oracle JDK 下载需要登录账户请自行下载，这里直接使用下载完成的 jdk-8u251-linux-x64.tar.gz 文件。

# 自行至 https://www.oracle.com/java/technologies/javase/javase-jdk8-downloads.html 下载jdk
# 把已下载的压缩包拷贝进容器
docker cp jdk-8u251-linux-x64.tar.gz spug:/
docker exec -it spug bash
tar xf jdk-8u251-linux-x64.tar.gz -C /opt

# 安装maven
curl -o apache-maven-3.6.3-bin.tar.gz http://apache.mirrors.pair.com/maven/maven-3/3.6.3/binaries/apache-maven-3.6.3-bin.tar.gz
tar xf apache-maven-3.6.3-bin.tar.gz -C /opt/

# 全局设置环境变量
echo -e 'export JAVA_HOME=/opt/jdk1.8.0_251\nexport PATH=$PATH:$JAVA_HOME/bin:/opt/apache-maven-3.6.3/bin' > /data/spug/env

# [可选]配置阿里云镜像加速下载，在159-164行（<mirrors\>标签内）添加以下内容
vi /opt/apache-maven-3.6.3/conf/settings.xml

    159     <mirror>
    160       <id>aliyunmaven</id>
    161       <mirrorOf>*</mirrorOf>
    162       <name>阿里云公共仓库</name>
    163       <url>https://maven.aliyun.com/repository/public</url>
    164     </mirror>

# 退出并重启容器
exit
docker restart spug

文件过滤​

只需要发布编译过的 jar 包，所以这里选择了 包含 规则。

ruoyi-admin.jar

自定义变量​

该例子中并不需要特殊的 全局变量，如果你需要的话可以在这里定义，然后在下边的钩子中类似 $SPUG_DEPLOY_ID 那样去引用。

代码检出前​

该例子中也不需要执行。

代码检出后​

在这里进行项目的依赖包安装和编译工作，该钩子中当前目录即为按发布申请中选择 Git 分支/版本 检出后的代码目录。

# 执行maven编译
mvn clean package -Dmaven.test.skip=true
cp ruoyi-admin/target/ruoyi-admin.jar .

这里拷贝 ruoyi-admin.jar 至项目根目录，因为咱们文件过滤规则指定的就是相对于项目根目录。

应用发布前​

发布前停止现有的服务。

# 停止服务
PID=$(ps -ef | grep ruoyi-admin | grep -v grep | awk '{print $2}')
if [ ! -z $PID ]; then
   kill -9 $PID
fi

应用发布后​

在这里启动服务。

# 添加jdk至PATH变量
PATH=$PATH:/usr/local/jdk1.8.0_231/bin
nohup java -jar ruoyi-admin.jar &> run.log &

更多资讯、视频、欢迎关注公众号“Spug社区”

以 Spug 的前端 spug_web 作为例子来说下前端项目的配置，最终大概是这样子的。

安装 node(npm)​

如果已安装可跳过该步骤，这里以目前的最新版 v12.18.1 为例，如果你使用 Docker 部署的 Spug，可参考以下步骤进行安装。

# 进入容器
docker exec -it spug bash
curl -o node-v12.18.1-linux-x64.tar.xz https://nodejs.org/dist/v12.18.1/node-v12.18.1-linux-x64.tar.xz
tar xf node-v12.18.1-linux-x64.tar.xz -C /opt

# 全局设置环境变量
echo 'export PATH=$PATH:/opt/node-v12.18.1-linux-x64/bin' > /data/spug/env

# 安装yarn，推荐使用yarn 或 pnpm来代替npm
source /root/.bashrc
npm install -g yarn

# 退出并重启容器
exit
docker restart spug

文件过滤​

前端项目发布的时候只需要编译后的内容就可以，这里选择了 包含 条件，内容为 spug_web/build，这样最终发布到目标主机上的代码仅包含 spug_web/build，并不会把 spug_api 及 spug_web 中的前端源代码发布出去。

自定义变量​

该例子中并不需要特殊的全局变量，如果你需要的话可以在这里定义，然后在下边的钩子中类似 $SPUG_DEPLOY_ID 那样去引用。

代码检出前​

作为前端项目免不了要处理项目依赖包的问题，依赖安装一般在 package.json 所在的目录（在本示例中即spug_web）中执行 npm install 或 yarn 来安装。这里使用了 全局环境变量 中的 SPUG_REPOS_DIR 和 SPUG_DEPLOY_ID 来切换到源码目录创建公共的 node_modules 目录，以后每次发布时都通过软链接的形式使用它来避免每次 发布都需要全量安装依赖包。

# 创建公共node_modules目录
mkdir -p $SPUG_REPOS_DIR/$SPUG_DEPLOY_ID/node_modules

代码检出后​

在这里进行项目的依赖包安装和编译工作，该钩子中当前目录即为按发布申请中选择 Git 分支/版本 检出后的代码目录，我们需要先把上一步创建的公共 node_modules 目录链接到当前目录（这样可以避免每次都完整的执行npm install来重复安装依赖包），然后执行 yarn build 来进行项目编译。

# 创建软链接，指向公共的node_modules,避免每次发布重复安装依赖包
cd spug_web
ln -s $SPUG_REPOS_DIR/$SPUG_DEPLOY_ID/node_modules .
# 执行依赖安装
yarn
# 执行 编译
yarn build

编译后也就生成了我们在 文件过滤 中设置的 spug_web/build 目录。

应用发布前​

由于我们设置的文件过滤规则 spug_web/build，所以传输到目标主机上文件结构也是 spug_web/build/xx，我们需要调整下目录结构， 让 spug_web/build 目录下内容放到项目的根目录中。

# 调整目录结构，把编译结果放在项目根目录
mv spug_web/build/* .
rm -rf spug_web

应用发布后​

前端项目编译后就是纯静态的 html、js 和一些静态文件，这里一般就不需要额外的处理了。

更多资讯、视频、欢迎关注公众号“Spug社区”