# remote_shell
Remote shell through nats written by rust. The use scenarios include iot device with no fixed ip, home computer behind local network, etc. with remote shell installed on slave machine, you can access from host like normal ssh process.

## step 1: Start golang nats message queue:
```
nats-server --user test --pass test
```
## step 2: Revise  conf string in .env :
```
NATS_URL = localhost
NATS_ACCOUNT  = username
NATS_PWD=  password
REQ_DURATION  = 60
SLAVEID= yourid
```
SLAVEID is id for slave, the slave only response for request which specified by 'use' command. SLAVEID field is only needed for slave side.
NATS_URL is nats host,and the account,password is auth method provided by nats-io. 
## step 3: Start slave by     run slave::slave_dispatch::dispatch();
To use remote shell, 2 kinds of binary are needed to be build, the salve and the host. Step 3 is for slave side. 
## step 4: Start host by    run host::shell::run_shell();
To use remote shell, 2 kinds of binary are needed to be build, the salve and the host. Step 4 is for host side. 

## step 5: Use remote shell stared with "use <slave id which from step 2>", and send command as normal shell,like "cd /home" etc. 

## Others:
The remote_shell use color scheme might result in errors on win10 cmd or power_shell. But test is passed when use cmder instead. 

The buildin function include: 
### use <slave_id>
This command will specify the slave you want to control.You should run step3 on slave pc and config the slave id in the .env file. This salve_id (use arg) should be same with id in the .env file.

example: use remote
### wait <true_or_false>
If true,the shell should demo result immediately.If false,the order is sent async and wait no result, you should consider false when run damon application or forever loop programme.

example: wait true/false
### send <local_file_path> <remote_file_path>
Send local file to remote.

example: send C://test.txt /home/test.txt
### rec <local_file_path> <remote_file_path>
Receive file from remote.

example: rec C://test1.txt /home/test2.txt
### send_all <local_dir_path> <remote_dir_path> allow_extention/optional
Send local directory and all sub-dirs,sub-files to remote. Command send_all is the combinations of command send. If suffix given, the file with given suffix will be sent.

example: send_all C://test /home/test
example: send_all C://test /home/test py;html;js
### restart
Will restart remote computer.This command is sent by async message pub channel and act as the final rescue when shell crash. Pay attention to restart remote_shell automatically after system reboot.

example: restart

