KasmVNC/README.md

107 lines
6.0 KiB
Markdown
Raw Normal View History

2020-09-20 14:16:44 +02:00
# KasmVNC - Linux Web Remote Desktop
2021-06-25 16:04:26 +02:00
<a href="https://kasmweb.com"><img src="https://kasm-static-content.s3.amazonaws.com/logo_kasm.png" width="300"><a/>
[Kasm Technologies](https://www.kasmweb.com) developed Kasm Workspaces, the Containerized Streaming Platform. Kasm has open-sourced the Workspace docker images, which include containerized [full desktops and apps](https://github.com/kasmtech/workspaces-images) and [base images](https://github.com/kasmtech/workspaces-core-images) intended for developers to create custimized streaming containers. These containers can be used standalone or within the [Kasm Workspaces Platform](https://www.kasmweb.com) which provides a full Enterprise feature set. KasmVNC is used as the streaming tech for our container images, however, you can use KasmVNC for individual servers. While the term VNC is in the name, KasmVNC is not intended to remain compliant with the RFB spec and has different goals than other VNC projects:
2020-09-20 14:16:44 +02:00
- Web-based - KasmVNC is designed to provide a web accessible remote desktop. It comes with a web server and websocket server built in. There is no need to install other components. Simply run and navigate to your desktop's URL on the port you specify. While you can still tun on the legacy VNC port, it is disabled by default.
2021-06-25 11:59:14 +02:00
- Security - The RFB specification (VNC) limits the password field to 8 characters, so while the client may take a longer password, only the first 8 characters are sent. KasmVNC defaults to HTTPS with HTTP Basic Auth and disables the legacy VNC authentication method which is not sufficiently secure for internet accessible systems.
2020-09-20 14:16:44 +02:00
- Simplicity - KasmVNC aims at being simple to deploy and configure.
# New Features!
- Webp image compression for better bandwidth usage
- Automatic mixing of webp and jpeg based on CPU availability on server
- Multi-threaded image encoding for smoother frame rate for servers with more cores
2021-04-13 15:07:49 +02:00
- [Full screen video detection](https://github.com/kasmtech/KasmVNC/wiki/Video-Rendering-Options#video-mode), goes into configurable video mode for better full screen videoo playback performance.
- [Dynamic jpeg/webp image coompression](https://github.com/kasmtech/KasmVNC/wiki/Video-Rendering-Options#dynamic-image-quality) quality settings based on screen change rates
- Seemless clipboard support (on Chromium based browsers)
2020-09-20 14:16:44 +02:00
- Allow client to set/change most configuration settings
2021-04-13 15:07:49 +02:00
- [Data Loss Prevention features](https://github.com/kasmtech/KasmVNC/wiki/Data-Loss-Prevention)
2020-09-20 14:16:44 +02:00
- Key stroke logging
- Clipboard logging
- Max clipboard transfer size up and down
- Min time between clipboard operations required
- Keyboard input rate limit
2021-04-13 15:07:49 +02:00
- Screen region selection
2021-04-13 16:23:00 +02:00
- Deb packages for Debian, Ubuntu, and Kali Linux included in release.
- RPM packages for CentOS, Fedora. RPM packages are currently not updatable and not released, though you can build and install them. See build documentation.
- Web [API](https://github.com/kasmtech/KasmVNC/wiki/API) added for remotely controlling and getting information from KasmVNC
- Multi-User with ability to pass control to other users.
- Web UI uses a webpack for faster load times.
- Network and CPU bottleneck statistics
2020-09-20 14:16:44 +02:00
Future Goals:
- Support uploads and downloads
- Pre-build Packages for all major Linux distributions
### Installation
2021-03-14 11:25:53 +01:00
#### Debian-based
2020-09-20 14:16:44 +02:00
```sh
2021-03-14 11:25:53 +01:00
wget -qO- https://github.com/kasmtech/KasmVNC/releases/download/v0.9.1-beta/kasmvncserver_0.9.1~beta-1_amd64.deb
2020-10-05 21:10:59 +02:00
2021-03-14 11:25:53 +01:00
sudo dpkg -i kasmvncserver_0.9.1~beta-1_amd64.deb
sudo apt-get -f install
2020-09-20 14:16:44 +02:00
2021-03-14 11:25:53 +01:00
# We provide an example script to run KasmVNC at #
2021-03-15 10:37:48 +01:00
# /usr/share/doc/kasmvncserver/examples/kasmvncserver-easy-start. It runs a VNC
# server on display :10 and on interface 0.0.0.0. If you're happy with those
2021-03-14 11:25:53 +01:00
# defaults you can just use it as is:
sudo ln -s /usr/share/doc/kasmvncserver/examples/kasmvncserver-easy-start /usr/bin/
# Add your user to the ssl-cert group
sudo addgroup $USER ssl-cert
# You will need to re-connect in order to pick up the group change
2020-09-20 14:16:44 +02:00
2021-03-14 11:25:53 +01:00
# Create ~/.vnc directory and corresponding files.
kasmvncserver-easy-start -d && kasmvncserver-easy-start -kill
2020-09-20 14:16:44 +02:00
2021-03-14 11:25:53 +01:00
# Modify vncstartup to launch your environment of choice, in this example LXDE
# This may be optional depending on your system configuration
2020-09-20 14:16:44 +02:00
echo '/usr/bin/lxsession -s LXDE &' >> ~/.vnc/xstartup
2021-03-14 11:25:53 +01:00
# Start KasmVNC with debug logging:
kasmvncserver-easy-start -d
# Tail the logs
2021-03-14 11:25:53 +01:00
tail -f ~/.vnc/`hostname`:10.log
2020-09-20 14:16:44 +02:00
```
2021-03-14 11:25:53 +01:00
Now navigate to your system at https://[ip-address]:8443/
2020-10-05 21:10:59 +02:00
2021-03-14 11:25:53 +01:00
To stop a running KasmVNC:
```sh
kasmvncserver-easy-start -kill
```
The options for vncserver:
2020-09-20 14:16:44 +02:00
| Argument | Description |
| -------- | ----------- |
| depth | Color depth, for jpeg/webp should be 24bit |
| geometry | Screensize, this will automatically be adjusted when the client connects. |
| websocketPort | The port to use for the web socket. Use a high port to avoid having to run as root. |
| cert | SSL cert to use for HTTPS |
| sslOnly | Disable HTTP |
| interface | Which interface to bind the web server to. |
### Development
2021-06-25 16:04:26 +02:00
Would you like to contribute to KasmVNC? Please reachout to us at info@kasmweb.com. We have investigated or are working on the following, if you have experience in these fields and would like to help please let us know.
2020-09-20 14:16:44 +02:00
2021-06-25 16:04:26 +02:00
Real-time H264 encoding using NVIDIA and Intel encoding technology.
2020-09-20 14:16:44 +02:00
2021-06-25 16:04:26 +02:00
Windows version of KasmVNC. We have been able to get it to compile for Windows and increased the performance, but still not releasable. Experienced Windows developers with a background in cross compiling would help.
ARM version of KasmVNC, we have had requests for this and at one point we did have an ARM build of KasmVNC but it takes dev cycles to mainain and bring it back to life.
2020-09-20 14:16:44 +02:00
### Compiling From Source
2021-04-13 16:23:00 +02:00
See the [builder/README.md](https://github.com/kasmtech/KasmVNC/blob/master/builder/README.md). We containerize our build systems to ensure highly repeatable builds.
### License and Acknowledgements
2021-04-20 21:41:38 +02:00
See the [LICENSE.TXT](https://github.com/kasmtech/KasmVNC/blob/master/LICENSE.TXT) and [ACKNOWLEDGEMENTS.MD](https://github.com/kasmtech/KasmVNC/blob/master/LICENSE.TXT)