哥斯拉插件开发指南——初入茅庐

什么是哥斯拉工具？

哥斯拉是下一代webshell管理工具。
学会编写哥斯拉插件，你不仅可以绕过waf，还可以编写更多的功能，甚至哥斯拉的服务端可以脱离webshell，在数据库中运行，如SqlServer的CLR。

首先简单阅读哥斯拉插件Api：

https://beichendream.github.io/godzillaApi/

接下来我们将简单的学习一下怎么搭建环境，并编写插件。在后续的文章中我们会编写带有实际功能的插件，本文我们只是简单了解一下。

新建一个哥斯拉插件项目

首先打开IntelliJ?IDEA，新建一个Java项目

一直点Next

写一个项目名

新建好之后，点击项目配置

点击加号

选择哥斯拉Jar包的路径，并点击OK

选择依赖模式，编译

然后点击Apply应用即可

然后右击Src文件夹，选择新建一个包

包名的最后建议填入网络ID、作者名

我这里填beichendream

shells.plugins.你的网络Id
shells.plugins.beichendream

编写插件

我们可以做一些有意思的操作了。
在下面的代码我们实现了获取哥斯拉的版本，当前web路径，当前用户名，添加一条shell，克隆当前的shell。

代码如下：

package?shells.plugins.beichendream;

import?java.awt.*;
import?java.awt.event.*;

import?core.ApplicationContext;
import?core.Db;
import?core.annotation.PluginnAnnotation;
import?core.imp.Payload;
import?core.shell.ShellEntity;
import?core.ui.MainActivity;
import?util.Log;

import?javax.swing.*;

@PluginnAnnotation(payloadName?=?"PhpDynamicPayload",Name="FirstGodzillaPlugin")?//有效载荷的名字以及插件名??(插件名唯一不可重复)
public?class?FirstGodzillaPlugin?implements?core.imp.Plugin{
????private?JPanel?contentPanel;//?组件内容容器
????private?JLabel?currentGodzillaVersionLabel;//当前哥斯拉版本
????private?JLabel?currentDirLabel;//当前web路径
????private?JLabel?currentUsernameLabel;//当前用户名
????private?JButton?insertShellButton;//添加一条哥斯拉shell的按钮
????private?JButton?copyShellButton;//克隆当前的shell



????private?ShellEntity?shellEntity;
????private?Payload?payload;


????public?FirstGodzillaPlugin(){
????????contentPanel=new?JPanel();//创建组件内容容器

????????currentGodzillaVersionLabel=new?JLabel();//创建标签
????????currentDirLabel=new?JLabel();//创建标签
????????currentUsernameLabel=new?JLabel();//创建标签
????????insertShellButton=new?JButton("添加shell");//创建按钮
????????copyShellButton=new?JButton("克隆当前shell");//创建按钮
????????insertShellButton.addActionListener(new?AbstractAction()?{//响应单击事件
????????????@Override
????????????public?void?actionPerformed(ActionEvent?e)?{
????????????????insertShellButtonClick(e);
????????????}
????????});
????????copyShellButton.addActionListener(new?AbstractAction()?{//响应单击事件
????????????@Override
????????????public?void?actionPerformed(ActionEvent?e)?{
????????????????copyShellButtonClick(e);
????????????}
????????});
????????contentPanel.add(currentGodzillaVersionLabel);//添加组件到容器
????????contentPanel.add(currentDirLabel);//添加组件到容器
????????contentPanel.add(currentUsernameLabel);//添加组件到容器
????????contentPanel.add(insertShellButton);//添加组件到容器
????????contentPanel.add(copyShellButton);//添加组件到容器
????}

????private?void?copyShellButtonClick(ActionEvent?e){

????????Db.addShell(this.shellEntity);//添加当前shell到数据库
????????ShellEntity?resultShell=Db.getOneShell(Db.getAllShell().lastElement().get(0));//因为我们刚才添加了一条shell?所以最后一条shell就是我们添加的
????????MainActivity.getMainActivityFrame().refreshShellView();//刷新shell管理界面的视图
????????Log.log(?String.format("我添加了一条Id为:%s的shell",?resultShell.getId()));//打印日志到控制台
????????JOptionPane.showMessageDialog(this.shellEntity.getFrame(),?String.format("我添加了一条Id为:%s的shell",?resultShell.getId()));//弹框告诉用户添加成功
????}
????private?void?insertShellButtonClick(ActionEvent?e){
????????ShellEntity?shellEntity=new?ShellEntity();//创建一个shell实体
????????shellEntity.setUrl("http://127.0.0.1/shell.php");//设置URL
????????shellEntity.setPassword("pass");//设置连接密码
????????shellEntity.setSecretKey("SuperGodzilla");//设置加密秘钥
????????shellEntity.setPayload("JavaDynamicPayload");//设置有效载荷的名字
????????shellEntity.setCryption("JAVA_AES_IIOP_T3_HTTP");//设置加密器的名字
????????shellEntity.setRemark("这是插件添加的webshell");//设置一个备注
????????shellEntity.setProxyHost("127.0.0.1");//设置代理地址
????????shellEntity.setProxyPort(8888);//设置代理端口
????????shellEntity.setProxyType("NO_PROXY");//设置代理类型?类型种类请看哥斯拉开发Api
????????shellEntity.setEncoding("UTF-8");//设置编码类型
????????Db.addShell(shellEntity);//添加一条shell到数据库
????????ShellEntity?resultShell=Db.getOneShell(Db.getAllShell().lastElement().get(0));//因为我们刚才添加了一条shell?所以最后一条shell就是我们添加的
????????MainActivity.getMainActivityFrame().refreshShellView();//刷新shell管理界面的视图
????????Log.log(?String.format("我添加了一条Id为:%s的shell",?resultShell.getId()));//打印日志到控制台
????????JOptionPane.showMessageDialog(this.shellEntity.getFrame(),?String.format("我添加了一条Id为:%s的shell",?resultShell.getId()));//弹框告诉用户添加成功
????}

????/***
?????*?插件初始化的时候回调用此方法??你可以在这里做一些初始化的操作?比如获取当前路径?但不建议在此处调用payload.include()方法
?????*?*/
????@Override
????public?void?init(ShellEntity?shellContext)?{

????????this.shellEntity=shellContext;//把shell上下文储存到类变量
????????this.payload=this.shellEntity.getPayloadModel();//获取有效载荷并存储到类变量

????????this.currentGodzillaVersionLabel.setText(String.format("哥斯拉版本:%s",?ApplicationContext.VERSION));
????????this.currentDirLabel.setText(String.format("当前web路径:%s",?payload.currentDir()));
????????this.currentUsernameLabel.setText(String.format("当前用户名:%s",?payload.currentUserName()));
????}

????@Override
????public?JPanel?getView()?{
????????return?contentPanel;//返回内容容器
????}

}

编译插件

然后我们编译导出JAR工件

点击OK即可

删除导出哥斯拉Jar包，然后点击Apply应用

点击打包工件

选择我们添加的添加的工件即可

我们看到我们的插件已经编译成功

编写添加到shell管理主页面的插件

随便新建一个类，但是包名必须是shells.plugins.任意字符为开头

然后使用以下Api分别把弹出菜单注册到不同位置

MainActivity.registerJMenu(menu);//注册一个单独的菜单在主页面
MainActivity.registerPluginJMenuItem(pluginMenuItem);//注册一个菜单元素在插件菜单栏下
MainActivity.registerShellViewJMenuItem(shellViewMenuItem);//注册一个菜单元素在Shell管理主页面的右击弹出菜单中

必须在static静态代码块中完成注册菜单。
代码如下：

package?shells.plugins.beichendream;

import?core.ui.MainActivity;

import?javax.swing.*;
import?java.awt.event.ActionEvent;

public?class?FirstGodzillaPluginForMainActivity?{
????static?{
????????JMenu?menu?=?new?JMenu("我是单独的主选项");
????????menu.addActionListener(new?AbstractAction()?{
????????????@Override
????????????public?void?actionPerformed(ActionEvent?e)?{
????????????????JOptionPane.showMessageDialog(MainActivity.getMainActivityFrame(),?"我是单独的主选项?click");
????????????}
????????});

????????JMenuItem?pluginMenuItem=new?JMenuItem("我是插件选项下面的选项");
????????pluginMenuItem.addActionListener(new?AbstractAction()?{
????????????@Override
????????????public?void?actionPerformed(ActionEvent?e)?{
????????????????JOptionPane.showMessageDialog(MainActivity.getMainActivityFrame(),?"我是插件选项下面的选项?click");
????????????}
????????});

????????JMenuItem?shellViewMenuItem?=?new?JMenuItem("我是shell管理页面的右键菜单");
????????shellViewMenuItem.addActionListener(new?AbstractAction()?{
????????????@Override
????????????public?void?actionPerformed(ActionEvent?e)?{
????????????????JOptionPane.showMessageDialog(MainActivity.getMainActivityFrame(),?"我是shell管理页面的右键菜单?click");
????????????}
????????});

????????MainActivity.registerJMenu(menu);//注册一个单独的菜单在主页面
????????MainActivity.registerPluginJMenuItem(pluginMenuItem);//注册一个菜单元素在插件菜单栏下
????????MainActivity.registerShellViewJMenuItem(shellViewMenuItem);//注册一个菜单元素在Shell管理主页面的右击弹出菜单中
????}
}

然后按照上面的编译方式进行编译，加载成功后如下，独立的主菜单需要重启哥斯拉后生效。

总结

在上面的插件编写中，我们一共用到了以下Api

ApplicationContext.VERSION?哥斯拉的版本
Db.addShell();//添加一条shell
Db.getOneShell();//根据插件Id获取一条shell
Log.log();//打印日志到控制台
this.shellEntity.getPayloadModel();//获取shell上下文的有效载荷(实际功能模块)
MainActivity.getMainActivityFrame().refreshShellView();//刷新shell管理界面的视图
MainActivity.registerJMenu(menu);//注册一个单独的菜单在主页面
MainActivity.registerPluginJMenuItem(pluginMenuItem);//注册一个菜单元素在插件菜单栏下
MainActivity.registerShellViewJMenuItem(shellViewMenuItem);//注册一个菜单元素在Shell管理主页面的右击弹出菜单中

上面的代码我已经传到Github，大家可以自由学习发挥。
https://github.com/BeichenDream/GodzillaPluginDemo

更多Api骚操作请看哥斯拉Api:?

https://beichendream.github.io/godzillaApi/

敬请期待，在后续的文章中，我会手把手教大家编写，哥斯拉PHP/CSharp/Java的插件。

你的关注是我更新的动力。~比心?