Last changes
This commit is contained in:
parent
48ed611563
commit
c15207e780
|
@ -2,52 +2,11 @@ This app packages Guacamole 0.9.10-incubating.
|
||||||
|
|
||||||
Apache Guacamole is a clientless remote desktop gateway. It supports standard protocols like VNC, RDP, and SSH.
|
Apache Guacamole is a clientless remote desktop gateway. It supports standard protocols like VNC, RDP, and SSH.
|
||||||
|
|
||||||
#### What is Guacamole?
|
#### Features
|
||||||
|
|
||||||
Guacamole is an HTML5 web application that provides access to desktop environments using remote desktop protocols (such as VNC or RDP). Guacamole is also the project that produces this web application, and provides an API that drives it. This API can be used to power other similar applications or services.
|
* VNC protocol
|
||||||
|
* RDP protocol (Remote Desktop)
|
||||||
|
* SSH
|
||||||
|
* Telnet
|
||||||
|
|
||||||
"Guacamole" is most commonly used to refer to the web application produced by the Guacamole project using their API. This web application is part of a stack that provides a protocol-agnostic remote desktop gateway. Written in JavaScript and using only HTML5 and other standards, the client part of Guacamole requires nothing more than a modern web browser or web-enabled device when accessing any of the desktops served.
|
|
||||||
|
|
||||||
Historically, Guacamole was an HTML5 VNC client, and before that, a JavaScript Telnet client called RealMint ("RealMint" is an anagram for "terminal"), but this is no longer the case. Guacamole's architecture has grown to encompass remote desktop in general, and can be used as a gateway for any number of computers. Originally a proof-of-concept, Guacamole is now performant enough for daily use, and all Guacamole development is done over Guacamole.
|
|
||||||
|
|
||||||
As an API, Guacamole provides a common and efficient means of streaming text data over a JavaScript-based tunnel using either HTTP or WebSocket, and a client implementation which supports the Guacamole protocol and renders the remote display when combined with a Guacamole protocol stream from the tunnel.
|
|
||||||
|
|
||||||
It provides cross-browser mouse and keyboard events, an XML-driven on-screen keyboard, and synchronized nestable layers with hardware-accelerated compositing. Projects that wish to provide remote desktop support over HTML5 can leverage the years of research and development that went into Guacamole by incorporating the API into their application or service.
|
|
||||||
|
|
||||||
#### Why use Guacamole?
|
|
||||||
|
|
||||||
The principle reason to use Guacamole is constant, world-wide, unfettered access to your computers.
|
|
||||||
|
|
||||||
Guacamole allows access one or more desktops from anywhere remotely, without having to install a client, particularly when installing a client is not possible. By setting up a Guacamole server, you can provide access to any other computer on the network from virtually any other computer on the internet, anywhere in the world. Even mobile phones or tablets can be used, without having to install anything.
|
|
||||||
|
|
||||||
As a true web application whose communication is over HTTP or HTTPS only, Guacamole allows you to access your machines from anywhere without violating the policy of your workplace, and without requiring the installation of special clients. The presence of a proxy or corporate firewall does not prevent Guacamole use.
|
|
||||||
|
|
||||||
#### Access your computers from any device
|
|
||||||
|
|
||||||
As Guacamole requires only a reasonably-fast, standards-compliant browser, Guacamole will run on many devices, including mobile phones and tablets.
|
|
||||||
|
|
||||||
Guacamole is specifically designed to not care whether you have a mouse, keyboard, touchscreen, or any combination of those.
|
|
||||||
|
|
||||||
One of the major design philosophies behind Guacamole is that it should never assume you have a particular device (ie: a mobile phone) just because your browser has or is missing a specific feature (ie: touch events or a smallish screen). Guacamole's codebase provides support for both mouse and touch events simultaneously, without choosing one over the other, while the interface is intended to be usable regardless of screen size.
|
|
||||||
|
|
||||||
Barring bugs, you should be able to use Guacamole on just about any modern device with a web browser.
|
|
||||||
|
|
||||||
#### Keep a computer in the "cloud"
|
|
||||||
|
|
||||||
Ignoring the buzzword, it's often useful to have a computer that has no dedicated physical hardware, where its processing and storage power are handled transparently by redundant systems in some remote datacenter.
|
|
||||||
|
|
||||||
Computers hosted on virtualized hardware are more resilient to failures, and with so many companies now offering on-demand computing resources, Guacamole is a perfect way to access several machines that are only accessible over the internet.
|
|
||||||
|
|
||||||
In fact, all Guacamole development is done on computers like this. This is partly because we like the mobility, and partly because we want to ensure Guacamole is always performant enough for daily use.
|
|
||||||
|
|
||||||
#### Provide easy access to a group
|
|
||||||
|
|
||||||
Guacamole allows you to centralize access to a large group of machines, and specify on a per-user basis which machines are accessible. Rather than remember a list of machines and credentials, users need only log into a central server and click on one of the connections listed.
|
|
||||||
|
|
||||||
If you have multiple computers which you would like to access remotely, or you are part of a group where each person has a set of machines that they need remote access to, Guacamole is a good way to provide that access while also ensuring that access is available from anywhere.
|
|
||||||
|
|
||||||
#### Adding HTML5 remote access to your existing infrastructure
|
|
||||||
|
|
||||||
As Guacamole is an API, not just a web application, the core components and libraries provided by the Guacamole project can be used to add HTML5 remote access features to an existing application. You need not use the main Guacamole web application; you can write (or integrate with) your own rather easily.
|
|
||||||
|
|
||||||
If you host an on-demand computing service, adding HTML5-based remote access allows users of your service more broad access; users need nothing more than a web browser to see their computers' screens.
|
|
||||||
|
|
12
README.md
12
README.md
|
@ -1,15 +1,15 @@
|
||||||
# Minio Cloudron App
|
# Guacamole Cloudron App
|
||||||
|
|
||||||
This repository contains the Cloudron app package source for [Minio](http://www.minio.io/).
|
This repository contains the Cloudron app package source for [Guacamole](http://guacamole.incubator.apache.org/).
|
||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
|
|
||||||
[![Install](https://cloudron.io/img/button.svg)](https://cloudron.io/button.html?app=io.minio.cloudronapp)
|
[![Install](https://cloudron.io/img/button.svg)](https://cloudron.io/button.html?app=org.apache.incubator.guacamole.cloudronapp)
|
||||||
|
|
||||||
or using the [Cloudron command line tooling](https://cloudron.io/references/cli.html)
|
or using the [Cloudron command line tooling](https://cloudron.io/references/cli.html)
|
||||||
|
|
||||||
```
|
```
|
||||||
cloudron install --appstore-id io.minio.cloudronapp
|
cloudron install --appstore-id org.apache.incubator.guacamole
|
||||||
```
|
```
|
||||||
|
|
||||||
## Building
|
## Building
|
||||||
|
@ -17,7 +17,7 @@ cloudron install --appstore-id io.minio.cloudronapp
|
||||||
The app package can be built using the [Cloudron command line tooling](https://cloudron.io/references/cli.html).
|
The app package can be built using the [Cloudron command line tooling](https://cloudron.io/references/cli.html).
|
||||||
|
|
||||||
```
|
```
|
||||||
cd minio-app
|
cd guacamole-app
|
||||||
|
|
||||||
cloudron build
|
cloudron build
|
||||||
cloudron install
|
cloudron install
|
||||||
|
@ -28,7 +28,7 @@ cloudron install
|
||||||
The e2e tests are located in the `test/` folder and require [nodejs](http://nodejs.org/). They are creating a fresh build, install the app on your Cloudron, perform tests, backup, restore and test if the repos are still ok. The tests expect port 29418 to be available.
|
The e2e tests are located in the `test/` folder and require [nodejs](http://nodejs.org/). They are creating a fresh build, install the app on your Cloudron, perform tests, backup, restore and test if the repos are still ok. The tests expect port 29418 to be available.
|
||||||
|
|
||||||
```
|
```
|
||||||
cd minio-app/test
|
cd guacamole-app/test
|
||||||
|
|
||||||
npm install
|
npm install
|
||||||
export PATH=$PATH:node_modules/.bin
|
export PATH=$PATH:node_modules/.bin
|
||||||
|
|
BIN
logo.png
BIN
logo.png
Binary file not shown.
Before Width: | Height: | Size: 36 KiB After Width: | Height: | Size: 3.6 KiB |
Binary file not shown.
Before Width: | Height: | Size: 57 KiB |
Binary file not shown.
After Width: | Height: | Size: 31 KiB |
Binary file not shown.
After Width: | Height: | Size: 294 KiB |
Binary file not shown.
After Width: | Height: | Size: 80 KiB |
Loading…
Reference in New Issue