Modern VNC Server and client, web based and secure
Go to file
Matthew McClaskey d9b5b5db6a Merge branch 'feature/KASM-3527_http_headers' into 'master'
Resolve KASM-3527 "Feature/ http headers"

Closes KASM-3527

See merge request kasm-technologies/internal/KasmVNC!75
2022-11-09 10:35:42 +00:00
.ci Fix CI to mangle rpms to produce 0.9.4 2022-08-19 13:11:15 +00:00
builder KASM-3184 force the use of gcc11 2022-09-07 10:11:06 +00:00
centos Config-based KasmVNC 2022-08-19 17:54:11 +00:00
cmake Correct spelling of License file 2021-04-20 15:41:38 -04:00
common Add support for custom response headers 2022-11-08 18:16:16 +02:00
contrib Correct spelling of License file 2021-04-20 15:41:38 -04:00
debian Config-based KasmVNC 2022-08-19 17:54:11 +00:00
doc Resolve KASM-2346 "Feature/ extend mouse buttons" 2022-10-14 17:28:02 +00:00
docker Update README.md 2020-10-11 13:44:40 -04:00
kasmweb@c5350ba2d7 update novnc ref 2022-11-04 19:43:03 +00:00
opensuse Config-based KasmVNC 2022-08-19 17:54:11 +00:00
oracle Config-based KasmVNC 2022-08-19 17:54:11 +00:00
release Config-based KasmVNC 2022-08-19 17:54:11 +00:00
spec vncserver: don't require group memebership for cert readability check 2022-10-12 09:52:39 +00:00
tests Initial commit 2020-09-20 12:16:44 +00:00
unix change -H to -http-header 2022-11-08 20:40:16 +00:00
win Add support for notifying clients about pointer movements 2021-03-29 11:27:54 +03:00
.gitignore Config-based KasmVNC 2022-08-19 17:54:11 +00:00
.gitlab-ci.yml Config-based KasmVNC 2022-08-19 17:54:11 +00:00
.gitmodules point novnc ref to tip of master 2022-11-02 13:35:06 -04:00
ACKNOWLEDGEMENTS.md Correct spelling of License file 2021-04-20 15:41:38 -04:00
BUILDING.txt Initial commit 2020-09-20 12:16:44 +00:00
CMakeLists.txt Udp 2022-07-26 10:38:14 +00:00
config.h.in Silence clang deprecated warnings on macOS 2020-09-21 13:43:22 +03:00
DEBUGGING.md Resolve KASM-2301 "Feature/ debug docs" 2022-02-23 11:23:44 +00:00
LICENSE.TXT [skip CI] updates to docs 2021-04-13 10:23:00 -04:00
Pipfile Config-based KasmVNC 2022-08-19 17:54:11 +00:00
Pipfile.lock Config-based KasmVNC 2022-08-19 17:54:11 +00:00
README.md Config-based KasmVNC 2022-08-19 17:54:11 +00:00
run-specs Config-based KasmVNC 2022-08-19 17:54:11 +00:00

KasmVNC - Linux Web Remote Desktop

Kasm Technologies developed Kasm Workspaces, the Containerized Streaming Platform. Kasm has open-sourced the Workspace docker images, which include containerized full desktops and apps and base images intended for developers to create custimized streaming containers. These containers can be used standalone or within the Kasm Workspaces Platform 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:

  • 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.
  • 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.
  • Simplicity - KasmVNC aims at being simple to deploy and configure.

Releases

Since this is a fast evolving project, the documents on the tip of master are chaning rapidly and will not match releases. Be sure to use the README and other documentation from the release branch that matches the version of KasmVNC you are using. Do not use the README from the master branch, unless you are compiling KasmVNC yourself from the tip of master. All releases starting at 0.9.3 have a branch named in the format 'release/0.9.3', for example.

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
  • Full screen video detection, goes into configurable video mode for better full screen videoo playback performance.
  • Dynamic jpeg/webp image coompression quality settings based on screen change rates
  • Seemless clipboard support (on Chromium based browsers)
  • Binary clipboard support for text, images, and formatted text (on Chromium based browsers)
  • Allow client to set/change most configuration settings
  • Data Loss Prevention features
    • Key stroke logging
    • Clipboard logging
    • Max clipboard transfer size up and down
    • Min time between clipboard operations required
    • Keyboard input rate limit
    • Screen region selection
  • Deb packages for Debian, Ubuntu, and Kali Linux included in release.
  • RPM packages for CentOS, Oracle, OpenSUSE, Fedora. RPM packages are currently not updatable and not released, though you can build and install them. See build documentation.
  • Web API added for remotely controlling and getting information from KasmVNC
  • Multi-User support with permissions that can be changed via the API
  • Web UI uses a webpack for faster load times.
  • Network and CPU bottleneck statistics
  • Relative cursor support (game pointer mode)
  • Cursor lock
  • IME support for languages with extended characters
  • Better mobile support

Future Goals:

  • UDP transport for faster frame rates
  • H264 encoding

Installation

Debian-based

# Please choose the package for your distro here (under Assets):
# https://github.com/kasmtech/KasmVNC/releases
wget <package_url>

sudo apt-get install ./kasmvncserver_*.deb

# 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

# On the first run, vncserver will ask you to create a KasmVNC user and choose a desktop
# environment you want to run. It can detect Cinnamon, Mate, LXDE, LXQT, KDE, Gnome,
# XFCE. You can also choose to manually edit xstartup.
# After you chose a desktop environment or to manually edit xstartup,
# vncserver won't ask you again, unless you run it as:
vncserver -select-de

# You can select a specific Desktop Environment like this:
vncserver -select-de mate

# Tail the logs
tail -f ~/.vnc/*.log

Now navigate to your system at the urls printed by vncserver.

To stop the KasmVNC you started earlier on display 10:

vncserver -kill <display_number>

Settings can be modified via editing /etc/kasmvnc/kasmvnc.yaml or ~/.vnc/kasmvnc.yaml.

The options for vncserver:

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

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.

Real-time H264 encoding using NVIDIA and Intel encoding technology.

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.

Compiling From Source

See the builder/README.md. We containerize our build systems to ensure highly repeatable builds.

License and Acknowledgements

See the LICENSE.TXT and ACKNOWLEDGEMENTS.MD