Public | Automated Build

Last pushed: a year ago
Short Description
基于Golang、WebSocket、TermJS的SSH远程终端
Full Description

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

开源捐献日志(感谢各位网友的支持)

2016.05.16

@玩蝴蝶的法师(qq:43588476)  捐献:50.00 元(人民币)

更新日志

2016.05.25

修证:

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

2016.05.21

修证:

    1、SSH Session 退出异常 BUG

2016.05.17

新增:
    添加跨域白名单的支持。(conf/conf.json     cors_white_list:"127.0.0.1,www.xxx.com");

感谢 @玩蝴蝶的法师 提出的功能建议。

2016.05.13

修证:
    1、修证 Ubuntu 下无法使用 VIM 的 BUG;

替换:
    2、更换 Gorilla 的 Websocket 库。

感谢 @玩蝴蝶的法师 提出的建议和BUG。

2016.03.05

新增:
    1、增加 Dockerfile

2016.03.04 发布 v1.1

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

2016.03.03

修证:
    1、修改独立模式时登陆JS验证问题.

新增:
    1、增加后台运行模式(conf/conf.json.  daemon:true/false);
    2、增加程序运行时的PID文件(log/apibox.pid);

大概的数据流向:

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

Git@OSC: http://git.oschina.net/shibingli/webconsole
Github: https://github.com/shibingli/webconsole

演示地址: http://www.pangu.cloud (通过DaoCloud的Docker服务构建)

程序包结构:
├── bin
│ └── apibox
├── conf
│ ├── ssl_cert.crt (默认不存在)
│ ├── ssl_cert.key (默认不存在)
│ ├── conf.json
│ └── mime.types
├── log
├── pkg
├── static
│ ├── images
│ └── scripts
└── template

运行环境要求:

1、x86 架构
2、Linux Kernel 3.x/x86_64 及更高版本
3、建议 Linux 发行版 CentOS 7.0+ / Ubuntu 14.04+
4、启用支持 SSL/TLS 模式访问时,需要生成对应的 SSL 证书文件且放置到 "conf" 文件夹下并配置 "conf.json" 文件
5、客户端要求使用 IE9、Chrome 40、Firefox 38、Safari 9 或更高版本的浏览器访问
6、服务器端需要对防火墙开启对应的外部访问端口。具体需要开放的端口请参考 "conf" 文件夹下的 "conf.json" 文件中的端口部分的配置
7、本程序只能对 Linux 类的操作系统且支持 SSH 协议的 OS 进行远程操作
8、基于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、程序部署完成后,直接通过浏览器访问即可。如: http(s)://ip:port。

2、外部系统引用步骤:

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:

        $.post("/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) {
                alert(json.data.en_addr);
            }
        });
Docker Pull Command
Owner
jim3mar
Source Repository