Commit bbb7d79b by Sheng

Updated README and version

parent 5f364170
...@@ -9,11 +9,6 @@ ...@@ -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 ...@@ -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 ...@@ -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 ...@@ -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 = { ...@@ -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');
``` ```
......
...@@ -10,12 +10,6 @@ A simple web application to be used as an ssh client to connect to your ...@@ -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 ...@@ -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 ...@@ -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 ...@@ -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 ...@@ -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');
......
__version_info__ = (0, 3, 9) __version_info__ = (0, 4, 0)
__version__ = '.'.join(map(str, __version_info__)) __version__ = '.'.join(map(str, __version_info__))
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment