mirror of https://github.com/huashengdun/webssh
parent
5f3641701e
commit
bbb7d79b2a
44
README.md
44
README.md
|
@ -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');
|
||||||
```
|
```
|
||||||
|
|
50
README.rst
50
README.rst
|
@ -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,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__))
|
||||||
|
|
Loading…
Reference in New Issue