Updated README and version

pull/26/head v0.4.0
Sheng 2018-09-01 11:20:31 +08:00
parent 5f3641701e
commit bbb7d79b2a
3 changed files with 37 additions and 59 deletions

View File

@ -9,11 +9,6 @@
## Introduction ## Introduction
A simple web application to be used as an ssh client to connect to your ssh servers. It is written in Python, base on tornado, paramiko and xterm.js. A simple web application to be used as an ssh client to connect to your ssh servers. It is written in Python, base on tornado, paramiko and xterm.js.
```
+---------+ http +--------+ ssh +-----------+
| browser | <==========> | webssh | <=======> | ssh server|
+---------+ websocket +--------+ ssh +-----------+
```
## Features ## Features
@ -31,6 +26,13 @@ A simple web application to be used as an ssh client to connect to your ssh serv
![Terminal](https://github.com/huashengdun/webssh/raw/master/preview/terminal.png) ![Terminal](https://github.com/huashengdun/webssh/raw/master/preview/terminal.png)
### How it works
```
+---------+ http +--------+ ssh +-----------+
| browser | <==========> | webssh | <=======> | ssh server|
+---------+ websocket +--------+ ssh +-----------+
```
### Requirements ### Requirements
* Python 2.7/3.4+ * Python 2.7/3.4+
@ -44,18 +46,6 @@ A simple web application to be used as an ssh client to connect to your ssh serv
4. Input your data, submit the form. 4. Input your data, submit the form.
### Installation options
Install from the pypi repository, may not the latest version
```
pip install webssh
```
Install from the github repository, always the latest version
```
pip install https://github.com/huashengdun/webssh/archive/master.zip
```
### Server options ### Server options
```bash ```bash
@ -78,19 +68,10 @@ wssh --help
### Use console ### Use console
```javascript ```javascript
// set a new encoding for client to use
wssh.set_encoding(encoding);
// reset encoding to use the default one
wssh.reset_encoding();
// connect to your ssh server // connect to your ssh server
wssh.connect(hostname, port, username, password, privatekey); wssh.connect(hostname, port, username, password, privatekey);
// without an argument, wssh will use the form data to connect // define a object for wssh
wssh.connect();
// define a mapping object
var opts = { var opts = {
hostname: 'hostname', hostname: 'hostname',
port: 'port', port: 'port',
@ -100,6 +81,15 @@ var opts = {
}; };
wssh.connect(opts); wssh.connect(opts);
// without an argument, wssh will use the form data to connect
wssh.connect();
// set a new encoding for client to use
wssh.set_encoding(encoding);
// reset encoding to use the default one
wssh.reset_encoding();
// send a command to the server // send a command to the server
wssh.send('ls -l'); wssh.send('ls -l');
``` ```

View File

@ -10,12 +10,6 @@ A simple web application to be used as an ssh client to connect to your
ssh servers. It is written in Python, base on tornado, paramiko and ssh servers. It is written in Python, base on tornado, paramiko and
xterm.js. xterm.js.
::
+---------+ http +--------+ ssh +-----------+
| browser | <==========> | webssh | <=======> | ssh server|
+---------+ websocket +--------+ ssh +-----------+
Features Features
-------- --------
@ -32,6 +26,15 @@ Preview
|Login| |Terminal| |Login| |Terminal|
How it works
~~~~~~~~~~~~
::
+---------+ http +--------+ ssh +-----------+
| browser | <==========> | webssh | <=======> | ssh server|
+---------+ websocket +--------+ ssh +-----------+
Requirements Requirements
~~~~~~~~~~~~ ~~~~~~~~~~~~
@ -45,21 +48,6 @@ Quickstart
3. Open your browser, navigate to ``127.0.0.1:8888`` 3. Open your browser, navigate to ``127.0.0.1:8888``
4. Input your data, submit the form. 4. Input your data, submit the form.
Installation options
~~~~~~~~~~~~~~~~~~~~
Install from the pypi repository, may not the latest version
::
pip install webssh
Install from the github repository, always the latest version
::
pip install https://github.com/huashengdun/webssh/archive/master.zip
Server options Server options
~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~
@ -85,19 +73,10 @@ Use console
.. code:: javascript .. code:: javascript
// set a new encoding for client to use
wssh.set_encoding(encoding);
// reset encoding to use the default one
wssh.reset_encoding();
// connect to your ssh server // connect to your ssh server
wssh.connect(hostname, port, username, password, privatekey); wssh.connect(hostname, port, username, password, privatekey);
// without an argument, wssh will use the form data to connect // define a object for wssh
wssh.connect();
// define a mapping object
var opts = { var opts = {
hostname: 'hostname', hostname: 'hostname',
port: 'port', port: 'port',
@ -107,6 +86,15 @@ Use console
}; };
wssh.connect(opts); wssh.connect(opts);
// without an argument, wssh will use the form data to connect
wssh.connect();
// set a new encoding for client to use
wssh.set_encoding(encoding);
// reset encoding to use the default one
wssh.reset_encoding();
// send a command to the server // send a command to the server
wssh.send('ls -l'); wssh.send('ls -l');

View File

@ -1,2 +1,2 @@
__version_info__ = (0, 3, 9) __version_info__ = (0, 4, 0)
__version__ = '.'.join(map(str, __version_info__)) __version__ = '.'.join(map(str, __version_info__))