wwt / guac Goto Github PK

View Code? Open in Web Editor NEW

120.0 11.0 47.0 247 KB

Apache Guacamole client ported to Go

License: Apache License 2.0

Go 100.00%

guacamole guacamole-client

guac's Introduction

guac

A port of the Apache Guacamole client to Go.

Apache Guacamole provides access to your desktop using remote desktop protocols in your web browser without any plugins.

Development

First start guacd in a container, for example:

docker run --name guacd -d -p 4822:4822 guacamole/guacd

Next run the example main:

go run cmd/guac/guac.go

Now you can connect with the example Vue app. By default, guac will try to connect to a guacd instance at 127.0.0.1:4822. If you need to configure something different, you can do so by configuring environment variables; see the configurable parameters below.

Guac listens on http://0.0.0.0:4567. If you have a need for the connection to Guac to be secure, you will need to pass a certificate and keyfile to it using the CERT_PATH and CERT_KEY_PATH environment variables; it will then listen on https://0.0.0.0:4567. The secure connection uses TLS 1.3.

Configurable parameters

Environment Variable	Description	Default Value	Required?
`CERT_PATH`	Full path, including filename, to a certificate file in order for guac to listen on HTTPS (TLS 1.3)		No
`CERT_KEY_PATH`	Full path, including filename, to the certificate keyfile in order for guac to listen on HTTPS (TLS 1.3)		No
`GUACD_ADDRESS`	The address and port that guacd is listening on	127.0.0.1:4822	No

Acknowledgements

Initially forked from https://github.com/johnzhd/guacamole_client_go which is a direct rewrite of the Java Guacamole client. This project no longer resembles that one but it helped it get off the ground!

Some of the comments are taken directly from the official Apache Guacamole Java client.

guac's People

Contributors

Stargazers

Watchers

guac's Issues

satori/go.uuid is unmaintained

Switch to a maintained dependency.

create v1 tag

Issue with Vue webpack

We have a web app where we want to connect to remote terminal. I bundled Vue code (webpack) and integrated in my web app. Getting below error

However, when I run individual Vue bundled code on some HTTP server, its working fine.
Any clue helps?

streams are UTF-8

Thanks to @kriive for pointing this out in #8.

Currently the streaming is counted by bytes, but it should be counted by UTF-8 rune.

In addition to updating Parse, we need to update ReadSome. Are there any other places?

Make guacd host and port configurable

In some scenarios it would be nice to make guacd host and port configurable via environment variables. One example would be running guacd and guac inside kubernetes.

support guacctl to download files

1。 How to transfer files? I said in the document to use guacctl to download. File. I don't know how to use it

In the document, it is said that stream stream can transmit documents, and I don't know how to use it

Authentication failure because sanitisedCfg

the config's password is changed when you change the sanitisedCfg's password.
so stream.Handshake always take a wrong password.

	sanitisedCfg := config
	sanitisedCfg.Parameters["password"] = "********"
	logrus.Debugf("Starting handshake with %#v", config)
	err = stream.Handshake(config)

If Session is ideal for 5-6 min gets disconnected

error reading message from wswebsocket: close 1005 (no status)

Print functionality is not working after passing print configuration.

After taking RDP access i was trying to print document .Guacamole printer is visible after selecting the printer getting error while printing.

didn't find any error's in client , found error in server (gaucd) which works fine with (https://github.com/apache/guacamole-client) client .

guacd[3754]: INFO: Connected to RDPDR 1.13 as client 0x0002
guacd[3754]: INFO: RDPDR user logged on
guacd[3754]: INFO: Print job created
guacd[3754]: INFO: Created PDF filter process PID=3779
guacd[3779]: INFO: Running gs
guacd[3754]: INFO: User explicitly aborted print stream.
GPL Ghostscript 9.27: Unrecoverable error, exit code 1
GPL Ghostscript 9.27: ERROR: ioerror (-12) on closing pdfwrite device.
guacd[3754]: INFO: Accepted format: 16-bit PCM with 2 channels at 44100 Hz

Not sure if problem is with go client or vue.js code

URL tips\examples

Hey! Trying to use guac but cant understand whic URL should I use to connect to guacd. I already have working guacamole but looking for alternate web-clients. I keep getting "HTTP tunnel request rejected: Invalid tunnel operation: scheme=rdp&hostname=ovpnserv&ignore-cert=true&nla=true&username=username&password=password" when I try to run "go run cmd/guac/guac.go". Can you please give me some tips or examples on how to use it, thanks!