Updated README and version
This commit is contained in:
@@ -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
|
|||||||

|

|
||||||
|
|
||||||
|
|
||||||
|
### 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');
|
||||||
```
|
```
|
||||||
|
|||||||
+19
-31
@@ -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');
|
||||||
|
|
||||||
|
|||||||
+1
-1
@@ -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__))
|
||||||
|
|||||||
Reference in New Issue
Block a user