Skip to content

Commit

Permalink
Merge pull request #34 from antoor/v1.2-dev
Browse files Browse the repository at this point in the history
Update to v1.2.0
  • Loading branch information
antoor committed Apr 18, 2016
2 parents 4c0d3eb + a2649f4 commit e3fdfd9
Show file tree
Hide file tree
Showing 63 changed files with 1,650 additions and 1,646 deletions.
18 changes: 18 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,24 @@
> 同时也欢迎大家的参与!感谢各位朋友的支持! .TAT.
## 2016/04
### /16 `(v1.2.0)`
1. 重新架构核心模块编码器
2. 优化shellmanager添加/编辑功能
3. 重构语言模板加载方案
4. 增加中文部分开发文档

### /14
1. 增加文件管理模块拖拽文件上传功能

### /13
1. 完全重写优化核心代码架构
2. 增强文件下载功能,支持稳定下载大文件
3. 优化HTTP请求函数
4. 增加显示文件管理左侧目录数

### /12
1. 修复文件管理模板XSS安全问题

### /10 `(v.1.1.2)`
1. 增加文件管理中可执行文件的提示样式
2. 调整文件管理中任务面板默认折叠(当有任务时自动展开
Expand Down
111 changes: 39 additions & 72 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,100 +1,67 @@
# AntSword - 中国蚁剑
> 一剑在手,纵横无忧!
# AntSword
> AntSword is an `open source` and `cross-platform`'s **Web Site Administration Tool**.
> You can use it easily and intuitively to management your website(webshell).
**中国蚁剑是一款开源的跨平台网站管理工具,它主要面向于合法授权的渗透测试安全人员以及进行常规操作的网站管理员。**
**任何人不得将其用于非法用途以及盈利等目的,也禁止未经允许私自修改打包进行发布,否则后果自行承担并将追究其相关责任!**
[![node](https://img.shields.io/badge/node-4.0+-green.svg?style=flat-square)](https://nodejs.org/en/download/)
[![release](https://img.shields.io/badge/release-v1.2.0-blue.svg?style=flat-square)](https://github.com/antoor/antSword/releases/tag/1.2.0)

[![node](https://img.shields.io/badge/node-v4.0+-green.svg?style=flat-square)](https://nodejs.org/en/download/)
[![release](https://img.shields.io/badge/release-v1.1.2-blue.svg?style=flat-square)](https://github.com/antoor/antSword/releases/tag/1.1.2)
[中文说明][url-doccn] | [开发文档][url-document] | [CHANGELOG][url-changelog]

## 设计思想
> 中国蚁剑采用了[Electron](http://electron.atom.io/)作为外壳,`ES6`作为前端代码编写语言,搭配`Babel`&&`Webpack`进行组件化构建编译,外加`iconv-lite`编码解码模块以及`superagent`数据发送处理模块还有`nedb`数据存储模块,组成了这个年轻而又充满活力的新一代大杀器。
## Start
If you do not care about how to write the code, you can go to the [Release Page](https://github.com/antoor/antSword/releases) to download the corresponding archive decompression, and then executed directly to use!

这里附上一个简单的开发思维导图,让大家了解蚁剑是如何工作的:
![思维导图](screenshots/gliffy.png)
**If you are interested in this code, we welcome you to join!**

如图所示,中国蚁剑推崇模块化的开发思想,遵循着**开源,就要开得漂亮**的原则,致力于为不同层次的人群提供最简单易懂、方便直接的代码展示及其修改说明,努力让大家可以一起为这个项目贡献出的力所能及的点点滴滴,让这款工具真正能让大家用得顺心、舒适,让它能为大家施展出最人性化最适合你的能力。
It does not require much coding knowledge you have, you just need to know what it means and how to modify the code on it!

## 开始使用
如果你是个正常使用普通用户,不需要关心代码如何编写以及没有改动等需求,那可以进入[release](https://github.com/antoor/antSword/releases)页面,选择你的系统版本进行下载对应压缩包,解压使用即可!
## Start with source code

> **注意**: OSX因安全设置,可能在运行时提示未知开发者而无法运行,此时进入系统偏好设置->安全性与隐私->通用->允许任何来源的程序运行即可。
#### 0x01. Get the source code

如果你是个喜欢编码喜欢个性化的自由主义者,那么,欢迎一起探讨学习,一起打怪升级!

### 下载源码
``` sh
$ git clone https://github.com/antoor/antSword.git
$ cd antSword
```

### 安装模块
``` sh
$ npm install
or

Click the download url below:

```
> 安装`electron-prebuilt`模块过程中会自动下载`electron`程序,由于网络原因下载速度可能较慢,此时不要终止结束安装,如若不小心在没下载完成之前`Ctrl+C`结束掉了安装脚本,那只需要重新卸载此模块在此安装即可。
> 如果遇到问题(国内速度慢)
```sh
$ npm install -g cnpm -—registry=https://registry.npm.taobao.org
$ cnpm install [email protected]
$ npm install
https://github.com/antoor/antSword/archive/master.zip
```

#### 0x02. Install node_modules

``` sh
$ cd antSword
$ npm install
```

注意到源码目录的`source`目录了吗?对,我们主要的修改点就是它啦!
**目前开发文档指南正在抽空编写中,各位可自行提前研究**
在修改后,我们需要进行一项重要的操作:编译!否则修改会无法起效~
#### 0x03. Build the sources

### 编译源码
``` sh
$ npm run build
```
> **提示**:你可以在执行编译的时候不关闭终端窗口保持监听编译进程,然后在修改源码保存后即可实时进行编译处理,此时重启应用就可以看到效果啦。

### 启动应用
#### 0x04. Began to enjoy

``` sh
$ npm start
```
> **提示**:应用启动后,如果修改了代码并进行了编译处理,则可不必关闭应用再重新打开。
> 直接点击菜单栏的调试->重启应用或者快捷键`Ctrl+R`刷新页面即可。
### 应用截图
> 如果在没开始之前瞧瞧这款工具都能干些什么,那么,就瞅瞅这几张截图提前了解吧!
#### 数据配置管理
![数据配置管理](screenshots/win-shellmanager.png)
#### 虚拟终端
![虚拟终端](screenshots/linux-terminal.png)
#### 文件管理
![文件管理](screenshots/osx-filemanager.png)
#### 数据库管理
![数据库管理](screenshots/osx-database.png)

## 开发进度
**本项目起始于2015年底的一个小想法:**
使用浏览器访问我们的一句话eval服务端脚本,然后通过浏览器加载一条JS资源,将其页面转换为具有全功能的管理控制面板。
后来在编写中发现,有一个问题很难解决:**编码**
前端处理编码比较复杂,以本人目前功力暂无法突破,只能暂时使用服务端进行处理实现。

所以,这个使用`Electron`进行包装的工具就出现了。
其中有优点也有缺点,比如跨平台支持、数据编码存储操作方便,比如文件过大、好像没啥缺点了。

但不管怎样,时代在进步,我相信这款工具也能跟随着大家一起进步。
我不追求它功能有多强大,能否名扬万里,能否取代xxx,只希望它对每一位使用者都能提供帮助,能让每一位爱好者都能学到点滴。

目前功能已经完成了三大主流脚本的支持,包括`php``asp``aspx`以及自定义`custom`脚本,还有三大主要功能模块的实现,包括`文件管理``虚拟终端``数据库管理`以及正在开发中的`插件中心`等核心功能。
虽能满足基本的需求,但因测试有限,仍有部分BUG等待解决。

> 目前版本所有的脚本代码均来源于伟大的**中国菜刀**,本人只是进行了解密以及一些改动,在此感谢作者并向其致敬!致敬每一位为网络安全做出贡献的新老前辈!

## 开源协议
本项目遵循`MIT`开源协议,详情请查看[LICENSE](LICENSE)
## Join us
* Email: [[email protected]][url-email]
* HomePage: [http://uyu.us][url-homepage]
* MyWeibo: [http://weibo.com/antoor][url-weibo]

## 加入我们
> 我们欢迎对本工具有兴趣、有追求、有能力改进的人才加入,一起学习探讨深入研究!
## License
This project is licensed under the terms of the [MIT license][url-mit]

**你可以通过下列方式加入我们**:

* Q群: [130993112](http://shang.qq.com/wpa/qunwpa?idkey=51997458a52d534454fd15e901648bf1f2ed799fde954822a595d6794eadc521)
* 官网: [http://uyu.us](http://uyu.us)
* 微博: [蚁逅](http://weibo.com/antoor)
[url-doccn]: README_CN.md
[url-changelog]: CHANGELOG.md
[url-homepage]: http://uyu.us
[url-email]: mailto:[email protected]
[url-weibo]: http://weibo.com/antoor
[url-mit]: LICENSE
[url-document]: http://doc.uyu.us
104 changes: 104 additions & 0 deletions README_CN.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,104 @@
# AntSword - 中国蚁剑
> 一剑在手,纵横无忧!
**中国蚁剑是一款开源的跨平台网站管理工具,它主要面向于合法授权的渗透测试安全人员以及进行常规操作的网站管理员。**
**任何人不得将其用于非法用途以及盈利等目的,也禁止未经允许私自修改打包进行发布,否则后果自行承担并将追究其相关责任!**

[![node](https://img.shields.io/badge/node-4.0+-green.svg?style=flat-square)][url-nodejs-download]
[![release](https://img.shields.io/badge/release-v1.2.0-blue.svg?style=flat-square)][url-release]

[英文说明][url-docen] | [开发文档][url-document] | [CHANGELOG][url-changelog]

## 开发栈
- [Electron][url-electron]
- [ES6][url-es6]
- [Webpack][url-webpack]
- [dhtmlx][url-dhtmlx]
- [Nodejs][url-nodejs]
- 以及其他在项目中调用到的库

中国蚁剑推崇模块化的开发思想,遵循着**开源,就要开得漂亮**的原则,致力于为不同层次的人群提供最简单易懂、方便直接的代码展示及其修改说明,努力让大家可以一起为这个项目贡献出的力所能及的点点滴滴,让这款工具真正能让大家用得顺心、舒适,让它能为大家施展出最人性化最适合你的能力。

## 开始使用
如果你是个正常使用普通用户,不需要关心代码如何编写以及没有改动等需求,那可以进入[release][url-release]页面,选择你的系统版本进行下载对应压缩包,解压使用即可!

> **注意**: OSX因安全设置,可能在运行时提示未知开发者而无法运行,此时进入系统偏好设置->安全性与隐私->通用->允许任何来源的程序运行即可。
如果你是个喜欢编码喜欢个性化的自由主义者,那么,欢迎一起探讨学习,一起打怪升级!

### 下载源码
``` sh
$ git clone https://github.com/antoor/antSword.git
$ cd antSword
```

### 安装模块
``` sh
$ npm install
```
> 安装`electron-prebuilt`模块过程中会自动下载`electron`程序,由于网络原因下载速度可能较慢,此时不要终止结束安装,如若不小心在没下载完成之前`Ctrl+C`结束掉了安装脚本,那只需要重新卸载此模块在此安装即可。
> 如果遇到问题(国内速度慢)
```sh
$ npm install -g cnpm -—registry=https://registry.npm.taobao.org
$ cnpm install [email protected]
$ npm install
```


### 编译源码
``` sh
$ npm run build
```
> **提示**:你可以在执行编译的时候不关闭终端窗口保持监听编译进程,然后在修改源码保存后即可实时进行编译处理,此时重启应用就可以看到效果啦。
### 启动应用
``` sh
$ npm start
```
> **提示**:应用启动后,如果修改了代码并进行了编译处理,则可不必关闭应用再重新打开。
> 直接点击菜单栏的调试->重启应用或者快捷键`Ctrl+R`刷新页面即可。
## 开发进度
当前最新版本为`1.2+`,从开源到现在前前后后修复了大量的BUG,大大提升了使用稳定性能,也逐步添加优化了多处功能。
目前支持三大主流服务端脚本:`PHP``ASP``ASPX`以及自定义`CUSTOM`脚本,提供三大主功能操作:`文件管理``命令终端``数据库管理`**随着文档以及部分功能的添加,未来将会支持更多的服务端脚本以及功能模块**

## 未来展望
**目前的功能已经基本满足常规的管理操作。但是,其还远远没达到最终所希望的样子。**
那么,未来的中国蚁剑应该长啥样呢?
- **健全的插件中心模块(类atom插件管理)**:用户可以快速地使用我们封装好的API,编写出符合自己所需功能的大大小小插件,比如文件扫描、代码审计、漏洞修复等等;
- **自由的扩展中心模块**:在扩展中心里,我们可以自定义给自己的程序添加各种方便的小功能,比如服务端脚本生成、文件管理功能增强、UI美化、数据导入导出备份加密等等;
- **多种多样的支持脚本**:在web如此发达的时代,各式各样的web服务脚本如雨后春笋般涌出,nodejs、python、golang。。这些都应该用一个工具就能全部管理,那就是我们未来的**中国蚁剑**

## 致敬感谢
> 目前版本所有的脚本代码均来源于伟大的**中国菜刀**,本人只是进行了解密以及一些改动,在此感谢作者并向其致敬!致敬每一位为网络安全做出贡献的新老前辈!
同时,也对参与开发以及意见改进还有捐助本项目的朋友们表示感谢!
**感谢你们一路的陪伴,才能让它有机会越走越远!**

## 开源协议
本项目遵循`MIT`开源协议,详情请查看[LICENSE](LICENSE)

## 加入我们
> 我们欢迎对本工具有兴趣、有追求、有能力改进的人才加入,一起学习探讨深入研究!
**你可以通过下列方式加入我们**:

* Q群: [130993112](http://shang.qq.com/wpa/qunwpa?idkey=51997458a52d534454fd15e901648bf1f2ed799fde954822a595d6794eadc521)
* 官网: [http://uyu.us][url-homepage]
* 微博: [蚁逅][url-weibo]


[url-docen]: README.md
[url-changelog]: CHANGELOG.md
[url-document]: http://doc.uyu.us
[url-nodejs-download]: https://nodejs.org/en/download/
[url-release]: https://github.com/antoor/antSword/releases/tag/1.2.0
[url-electron]: http://electron.atom.io/
[url-es6]: http://es6.ruanyifeng.com/
[url-webpack]: http://webpack.github.io/
[url-dhtmlx]: http://dhtmlx.com/
[url-nodejs]: https://nodejs.org/
[url-weibo]: http://weibo.com/antoor
[url-homepage]: http://uyu.us
[url-release]: https://github.com/antoor/antSword/releases
3 changes: 1 addition & 2 deletions app.js
Original file line number Diff line number Diff line change
Expand Up @@ -44,5 +44,4 @@ app
['menubar', 'request', 'database', 'cache', 'update'].map((_) => {
new ( require(`./modules/${_}`) )(electron, app, mainWindow);
});

});
});
Loading

0 comments on commit e3fdfd9

Please sign in to comment.