Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/changkun/occamy
🖥️ a modern remote desktop proxy written in Go
https://github.com/changkun/occamy
go golang guacamole proxy rdp remote-desktop-protocol ssh vnc websocket
Last synced: 2 days ago
JSON representation
🖥️ a modern remote desktop proxy written in Go
- Host: GitHub
- URL: https://github.com/changkun/occamy
- Owner: changkun
- License: mit
- Created: 2019-01-18T11:10:22.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2021-12-16T08:31:34.000Z (almost 3 years ago)
- Last Synced: 2024-11-03T18:34:07.853Z (8 days ago)
- Topics: go, golang, guacamole, proxy, rdp, remote-desktop-protocol, ssh, vnc, websocket
- Language: Go
- Homepage: https://github.com/changkun/occamy
- Size: 8.81 MB
- Stars: 313
- Watchers: 17
- Forks: 54
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Occamy
[![Latest relsease](https://img.shields.io/github/v/tag/changkun/occamy?label=latest)](https://github.com/changkun/occamy/releases)
[![Build Status](https://github.com/changkun/occamy/workflows/Builds/badge.svg)](https://github.com/changkun/occamy/actions)
[![Go Report Card](https://goreportcard.com/badge/github.com/changkun/occamy)](https://goreportcard.com/report/github.com/changkun/occamy)Occamy is an open source protocol and proxy for modern remote desktop control that written in Go.
## To start using Occamy
### Build
Occamy support deployment with Docker or container orchestration tool, e.g. K8s.
To build Occamy, you need:```
git clone https://github.com/changkun/occamy.git
cd occamy
make build
```Then you should be able to run occamy with:
```
docker run -itd occamy:latest
```### APIs
Occamy offers two APIs:
- `/api/v1/login` distributes JWT tokens for authentication and
- `/api/v1/connect` is used for WebSocket based Occamy connection.If you build Occamy with web client, you can also access `/static` for web client demo.
### Demo
To run a demo, you need build an occamy client first:
```
cd client/occamy-web
npm install && npm run build
```With docker-compose, you should be able to run a working demo with:
```
make build
make run
make stop
```Here is a working video demo:
## Contributing
Easiest way to contribute is to provide feedback! We would love to hear
what you like and what you think is missing. PRs are welcome.
Please follow the given PR template before you send your pull request.## Why Occamy and how it works?
Occamy implements a generic remote desktop protocol with modern approaches.
It currently performs [Guacamole](https://guacamole.apache.org/) protocol
and eventually intends to redesign and propose Occamy protocol.The benefits of Occamy that differ from Guacamole are:
- Authentication supports
- Simplified architecture
- Streaming compression and optimization
- Modern with GoOccamy server side currently simplifies Guacamole proxy and
Guacamole servlet client in a single middleware application.
Any client that involves Guacamole protocol and uses WebSocket
for authentication can directly switch to interact to Occamy
without any changes.Read more details in [docs](./docs/README.md).
## License
[Occamy](https://github.com/changkun/occamy) | [MIT](./LICENSE) © 2019 [Ou Changkun](https://changkun.de)