GhostJ

说明

GhostJ实现了实时执行指令、截图、文件操作、鼠标键盘控制、操作监控等功能

此项目架构较为复杂，可读性较差

声明

此项目展示了一种具有实践性的远程控制协议及其实现，使用此类代码进行未经允许的远程控制属于违法行为，本项目及作者不向违法行为提供任何支持

联系方式

问题发至issue 讨论细节邮件至1010553892@qq.com或QQ联系

依赖

fastjson 阿里巴巴的json解析类库
RFT 自己开发的文件上传类库可在主页找到开源仓库
RFTX2 自己开发的文件双向传输类库可在主页找到开源仓库

分支

master 正在开发的主分支
classic 重构服务端之前的经典服务端代码

目录结构

src 源代码
libs 依赖库

项目结构

主要包

com.ghostj.client 客户端主程序，被控端
com.ghostj.master 主控端程序，javaSwing开发的可视化操作桌面程序
com.ghostj.server_old 服务端程序，处理客户端和主控端的连接、管理文件、转发消息等功能
com.ghostj.util 通用的类和方法

client

已使用策略模式重构

cmd 命令处理逻辑的model(独立出来的代码见 https://github.com/rockchinq/rcp)
conn 建立并管理客户端到服务端的连接
core 客户端的启动类，包含命令行执行线程类、控制命令解析类
func 所有客户端支持的控制指令，由Processor类解析控制指令并调用
util 客户端实用类

*注意：此处控制命令(指客户端收到的由主控端或服务端发出的控制指令)有别于命令行的命令(将被cmd.exe执行的指令)
事实上，客户端执行命令行指令的逻辑也被归类为一个控制指令

执行逻辑

被启动后，启动HandleConn线程，尝试建立与服务端的连接，堵塞接收指令解析并执行。
当检测到连接断开后，重新尝试连接

master

有待重构，目前可读性很低

conn 管理与服务端的连接
core 批处理类和模拟控制台的缓冲区
gui 管理所有界面
util 实用类

master界面

server

服务端代码有待重构，目前未使用设计模式来构建服务端代码。可读性很低 server启动 server命令

指令说明

GhostJ平台有两种级别的指令:Server级别、Client级别
Server级别的由单个半角惊叹号(!)开始,Client级别的由两个半角惊叹号(!!)开始

可以直接在运行Server的控制台输入指令并回车执行
或者在Master底端的文本框输入并回车执行
Master传到Server的指令无法识别的,将直接发到当前被聚焦的Client

Server级别

以下指令均运行于Server,实现代码详见server包的TransCmd类

!help

输出指令列表
使用此指令输出的命令列表不完整
详见TransCmd.java

!list

输出在线客户端列表

!echo <Message>

输出Message
所有在线Master均可见

!pw <NewPassword>

修改Master连接Server的密码为NewPassword

!focus <Client>

聚焦到指定客户端
Client为目标客户端的名称或&+客户端编号
e.g. 聚焦到名称为test、编号为3的客户端:!focus test或!focus tes或!focus &3

!dfocus

取消聚焦
若是改变聚焦目标,可直接focus到新目标,无需dfocus目前目标

!test [TimeOut]

测试所有客户端的在线状态
并断开意外断连的客户端
TimeOut为客户端响应超时时间,毫秒,未指定时默认为200毫秒

!chname <Client> <NewName>

修改客户端名称
Client指定客户端,修改其名称为NewName

!lstag

列出所有已记录的TagLog名称
TagLog是用于记录客户端在线时间的功能

!rmtag <tagName>

删除tag名称为tagName的所有在线时间记录

!lsmst

列出所有当前在线Master的列表
此消息所有Master可见

!rft <chdir|dir|task|stop> <params>

RFT是管理GhostJ平台中传输文件的指令
!rft chdir <NewPath>修改RFT接收的文件储存目录为NewPath
!rft dir输出当前RFT接收的文件储存目录
!rft task输出当前RFT正在接收的文件列表
!rft stop <TaskIndex>中断指定的传输任务

!jre <view|reg|tag|rmtag>

管理免安装JRE登记表
此登记表需结合安装器使用,见GhostPioneer项目

!note <Message>

设置新note,在Master登录时会向Master发送此Message

!exit <-m|-a|-lv|ClientName>

通知客户端退出并断开客户端连接
!exit -m退出名称相同的更靠后的客户端
!exit -a退出所有客户端
!exit -lv退出相同名称的客户端中版本较低的连接
!exit <ClientName>退出指定名称的客户端,此处名称必须为完整名称

!hst

!hst输出近期Server输出记录

!log <flush|len>

!log flush刷新日志缓冲区
!log len输出日志缓冲区大小及已占用大小

!all <Content>

向所有客户端发送Content

!ban <add|ls> <params>

封禁
!ban add <Address>封禁来自Address的所有连接
!ban ls列出所有封禁地址

!startup [rm|Content]

操作客户端连接上Server时发送给Client的指令
!startup查看目前指令
!startup rm删除指令
!startup <Content>设置指令为Content

!stop

关闭服务端

Client级别

以下指令均运行于Client,其实现代码详见client包中的func包

!!audio [Length]

录音并上传到Server
Length为录音时长毫秒,未指定时设置为5000

!!bat <reset|add|view|run> [params]

Client提供一个储存指令的缓存
!!batch reset清除缓存
!!batch add <Content>在缓存中追加一行内容
!!batch view输出缓存中所有指令
!!batch run逐行运行缓存中的指令

!!cfg <ls|write|set|rm> <params>

管理客户端的配置文件,操作不当可能导致断连
!!cfg ls列出客户端所有配置字段
!!cfg write将运行时修改的配置字段写入配置文件
!!cfg set <Field> <Value>设置运行时中的配置字段Field为Value
!!cfg rm <Field>删除字段
set和rm之后需要执行write才能写入文件,否则重启客户端之后将丢失修改结果

!!exit <ClientName>

退出客户端
ClientName必须为客户端完整名称

!!gget <URL> <SavePath> <SaveName>

http下载器
将url的文件下载到目录SavePath,重命名为SaveName

!!help

输出客户端指令帮助

!!info

运行时信息

!!kmr <mouse|key> <params>

控制鼠标和模拟键盘输入

!!proc <focus|ls|bg|new|disc> <params>

管理客户端上启动的子进程
!!proc ls列出所有子进程
!!proc new [Name] [Command]新建名为Name的子进程并执行命令Command并聚焦到此子进程,若未设置命令则执行cmd
!!proc bg [Name] [Command]新建子进程并执行命令,但不聚焦到此子进程
!!proc focus <ProcessName>聚焦到名称以ProcessName开头的子进程,之后Client收到的来自Server的内容都将发送到Process中
!!proc disc <ProcessName>断连名称以ProcessName开头的子进程,此操作并不会停止目标子进程,且Client之后将无法操作此子进程

!!scr <params>

屏幕截图并发送到Server
!!scr <FileName>全屏截图并储存到文件
!!scr <FileName> <ResolutionCompressRate>全屏截图并进行分辨率压缩(范围0.0-+∞)然后储存到文件
!!scr <FileName> <ResolutionCompressRate> <ColorCompressRate>全屏截图并进行分辨率压缩(范围0.0-+∞),进行颜色压缩(范围0.0-1.0),然后储存到文件
!!scr <FileName> <ResolutionCompressRate> <ColorCompresseRate> <Width> <Height> <XOnScreen> <YOnScreen> <ColorFormat>
从屏幕坐标(x,y)为(XOnScreen,YOnScreen)的像素开始向右下角截图宽为Width长为Height的截图,并对图像的分辨率进行比率为ResolutionCompressRate(范围0.0-+∞)的压缩,
对图像色彩进行比率为ColorCompressRate(范围0.0-1.0)的压缩,使用编码为ColorFormat的颜色格式编码到文件FileName
每次截图之后都会自动上传到Server,除非命令第四个参数为nosend

!!rfe <dir|cd|upload|download|dsk|del> <params>

为GhostJ设计的文件浏览指令,详见client包中func包中的FuncRFE.java

!!rft upload <FileOnClientHost> <TargetPathOnServerHost>

使用文件传输库传输文件
将客户端本地的FileOnClientHost文件上传到Server主机上相对于Server上RFT根目录的路径TargetPathOnServerHost
设置Server上RFT的根目录参见!rft指令

!!reconn

使该客户端断连并尝试重新连接Server

!!startup [set|rm]

管理Client的启动任务,客户端将在每次启动时自动运行此任务
!!startup set <Content>设置启动任务为Content
!!startup rm删除启动任务