欢迎大家踊跃报名,利用业余时间来拓展此项目,增加更多的功能服务大家。

常规部署

1、下载 go1.8.1.linux-amd64.tar.gz
2、tar zxvf go1.8.1.linux-amd64.tar.gz -C /usr/local
3、echo 'export PATH="/usr/local/go/bin:$PATH"' >> /etc/profile
4、source /etc/profile
5、cd /opt && git clone --recurse-submodules https://github.com/shibingli/webconsole.git && cd webconsole && git submodule update --init --recursive
6、cd /opt/webconsole/src/apibox.club/apibox
7、GOPATH=/opt/webconsole go install
8、设置开机自动启动
 cp /opt/webconsole/bin/webconsole /etc/init.d/ && chmod 755 /etc/init.d/webconsole 
 chkconfig --add webconsole && chkconfig webconsole on && service webconsole start
 

容器部署

1、下载并安装 Docker
2、cd /opt && git clone --recurse-submodules https://github.com/shibingli/webconsole.git && cd webconsole && git submodule update --init --recursive
3、cd /opt/webconsole/src/apibox.club/apibox
4、GOPATH=/opt/webconsole go install
5、cd /opt/webconsole
6、docker build -t webconsole:latest .
7、docker run -d -p 8080:8080 --restart=always --name webconsole webconsole:latest

更新日志

更新:
 1、更新核心js库
 2、合并 pczchen 提交的分支,支持 Docker 容器访问
 3、常规修复

更新:
 1、更新 xTerm.js

修证:
 1、修证UTF-8字符集展示BUG;
 2、修证大文件展示BUG。

更新:
 1、删除 build.sh
 2、添加部署说明

修证:
 1、修证一些页面的展示BUG。
更新:
 1、更新xTerm库。
 2、添加外部引用例子。

更新:
 1、添加对 JSONP 的支持,解决 JQuery 跨域请求的需求。
 2、配置文件新增 JSONP 的支持。

修证:
 1、修证粘贴字串的BUG。
更新:
 1、更新 xTerm 库。

修证:
 1、修证 wss 协议适配 BUG
更新:
 1、删除根目录 golang 程序包。如果运行脚本,请自行下载对应 golang 包(go1.8.linux-amd64.tar.gz)放置根目录。

修证:
 1、修改部分BUG
 2、更新 Golang 到 1.8 版本
 3、修证 Golang 1.8 版本中 url.Parse 解析地址 BUG
 4、替换 term.js 为 xterm.js
 5、更新对CJK(中文、日文、韩文)字符集和IME的支持
 6、更友好地支持 Linux 下主流程序,如:VIM、Tmux等

修证:
 1、修证 log 目录不存在而引起的无法启动程序的 BUG
 2、Dockerfile 无法 Build 项目的 BUG 

修证:
 1、SSH Session 退出异常 BUG

新增:
 添加跨域白名单的支持。(conf/conf.json cors_white_list:"127.0.0.1,www.xxx.com");
感谢 @玩蝴蝶的法师 提出的功能建议。

修证:
 1、修证 Ubuntu 下无法使用 VIM 的 BUG;
替换:
 2、更换 Gorilla 的 Websocket 库。
感谢 @玩蝴蝶的法师 提出的建议和BUG。

新增:
 1、增加 Dockerfile

新增:
 1、增加命令行的启动、停止、状态查看功能. 如: ./apibox start/stop/status

修证:
 1、修改独立模式时登陆JS验证问题.
新增:
 1、增加后台运行模式(conf/conf.json. daemon:true/false);
 2、增加程序运行时的PID文件(log/apibox.pid);

大概的数据流向:

 浏览器--》WebSocket--》SSH--》Linux OS

代码地址

程序包结构:

├── bin
│  └── apibox
├── conf
│  ├── ssl_cert.crt (默认不存在)
│  ├── ssl_cert.key (默认不存在)
│  ├── conf.json
│  └── mime.types
├── log
├── pkg
├── static
│  ├── images
│  └── scripts
└── template
运行环境要求:
1、Linux Kernel 3.x/x86_64 及更高版本
2、建议 Linux 发行版 CentOS 7.0+ / Ubuntu 14.04+
3、启用支持 SSL/TLS 模式访问时,需要生成对应的 SSL 证书文件且放置到 "conf" 文件夹下并配置 "conf.json" 文件
4、客户端要求使用 IE9、Chrome 40、Firefox 38、Safari 9 或更高版本的浏览器访问
5、服务器端需要对防火墙开启对应的外部访问端口。具体需要开放的端口请参考 "conf" 文件夹下的 "conf.json" 文件中的端口部分的配置
6、本程序只能对 Unix/Linux 类的操作系统,且支持 SSH 协议的 OS 进行远程操作
7、基于Go1.6+,原生支持 http2 
一、部署
1、将程序解压或下载至任一目录,运行 "build.sh" 编译可执行文件
2、然后运行 "bin" 文件夹下的 "apibox" 文件即可。如:"./apibox start/stop"
3、配置文件在 "conf" 文件夹下,核心配置文件为 "conf.json",部署的时候需要添加跨域白名单来支持其他机器的访问
4、后台运行可以配置 "conf" 文件夹下的 "conf.json" 文件,将 "daemon" 项配置为 "true" 
5、运行时日志文件存放在 "log" 文件夹下,以当天时期命名
6、也可以配置程序以 Nginx 的 fcgi 模式运行,以 Nginx 做为访问入口

1)、以 GET 或 POST 的方式,提交 "vm_addr" 参数至 "http(s)://ip:port/console/chksshdaddr" ,成功后可获取到加密后的 "en_addr" 信息。注:vm_addr 格式为: "ip:port" ,若不携带端口,默认端口为 "22" 。
 获取到的结果为 JSON 格式(注:以下数据为测试数据):
 成功:
 {
 "ok": true,
 "msg": "",
 "data": { "en_addr": "0b-nDgcazQKTmUw4oBLfxott", "sshd_addr": "192.168.220.173:22" }
 }
 失败:
 { "ok": false, "msg": "Unable to resolve host address.", "data": null }
2)、成功获取到加密的 en_addr 信息后,以 GET 或 POST 方式访问 "http(s)://ip:port/console/login/'en_addr'" 即可。注: "en_addr" 是通过第 1)步操作获取的数据。

JQuery Demo:

第一种方式(需要二次登陆,同一个域的情况,同样可以使用跨域的方式访问):

var protocol = (location.protocol === "https:") ? "https://" : "http://";
var addr = protocol + location.hostname + ((location.port) ? (":" + location.port) : "")
$.post(addr+"/console/chksshdaddr?rnd=" + Math.random(), {
 "vm_addr": "192.168.220.177:22"
}, function(data) {
 var json = data;
 if (typeof(data) != "object") {
 json = $.parseJSON(data);
 }
 if (json.ok) {
 location.href = addr + json.data.sshd_addr;
 }
});

第二种方式(直接输入远端的主机地址、用户名、密码,然后直接登陆。跨域的情况):

<button class="btn btn-primary" onclick="testDemo();">Test</button>
<script type="text/javascript">
 //注意,如果远程主机的访问地址是以IP形式出现的,可以忽略此步骤,直接调用 login 方法。具体登陆地址端口请根据实际情况更改.
 var testDemo = function() {
 $.ajax({
 url: "http://a.com:8081/console/chksshdaddr?rnd=" + Math.random(),
 method: "POST",
 data: {
 "vm_addr": "172.16.18.223:22",
 },
 dataType: "jsonp",
 cache: false,
 }).done(function(data) {
 var json = data;
 if (typeof(data) != "object") {
 json = $.parseJSON(data);
 }
 if (json.ok) {
 console.log("en_addr:", json.data.sshd_addr);
 login(json.data.sshd_addr, "shibingli", "cloud123456");
 } else {
 alert("登陆失败,请确认您的主机信息。");
 }
 }).fail(function() {
 alert("未知失败,请联系管理员。");
 });
 };
 //注意,如果远程主机的访问地址是以域名或主机形式出现的,可以执行上面步骤后,再调用本方法。具体登陆地址端口请根据实际情况更改.
 var login = function(enVMAddr, username, password) {
 $.ajax({
 url: "http://a.com:8081/console/login?rnd=" + Math.random(),
 method: "POST",
 data: {
 "vm_addr": enVMAddr,
 "user_name": username,
 "user_pwd": password
 },
 dataType: "jsonp",
 cache: false,
 }).done(function(data) {
 var json = data;
 if (typeof(data) != "object") {
 json = $.parseJSON(data);
 }
 if (json.ok) {
 location.href = "http://a.com:8081" + json.data;
 } else {
 alert("登陆失败,请确认您的登陆信息。");
 }
 }).fail(function() {
 alert("未知失败,请联系管理员。");
 });
 };
</script>