# RustDesk API This project implements the RustDesk API using Go, and includes both a web UI and web client. RustDesk is a remote desktop software that provides self-hosted solutions.
## Prerequisites ### [Rustdesk](https://github.com/rustdesk/rustdesk) 1. The PC client version used is ***1.3.0***, and versions ***1.2.6+*** have been tested to work. 2. The server must specify a key, and not use the auto-generated key, otherwise there may be connection failures or timeouts. ```bash hbbs -r -k hbbr -k ``` Example: ```bash hbbs -r -k abc1234567 hbbr -k abc1234567 ``` ## Features ### API Service: Basic implementation of the PC client's primary interfaces. #### Login - Added `GitHub` login, which can be used after configuration in the admin panel. See the OAuth configuration section for details. - Added authorization login for the web admin panel. ![pc_login](docs/pc_login.png) #### Address Book ![pc_ab](docs/pc_ab.png) #### Groups: Groups are divided into `shared groups` and `regular groups`. In shared groups, everyone can see the addresses of all group members, while in regular groups, only administrators can see all members' addresses. ![pc_gr](docs/pc_gr.png) ### **Web UI**: The frontend and backend are separated to provide a user-friendly management interface, primarily for managing and displaying data. ***Frontend code is available at [rustdesk-api-web](https://github.com/lejianwen/rustdesk-api-web)*** ***Admin panel URL: `http://[:port]/_admin/`. The default username and password for the initial installation are `admin` `admin`, please change the password immediately.*** 1. Admin interface: ![web_admin](docs/web_admin.png) 2. Regular user interface: ![web_user](docs/web_admin_user.png) 3. You can change your password from the top right corner: ![web_resetpwd](docs/web_resetpwd.png) 4. Groups can be customized for easy management. Currently, two types are supported: `shared group` and `regular group`. ![web_admin_gr](docs/web_admin_gr.png) 5. You can open the web client directly for convenience: ![web_webclient](docs/admin_webclient.png) 6. OAuth support: Currently, only `GitHub` is supported. You need to create an `OAuth App` and configure it in the admin panel. ![web_admin_oauth](docs/web_admin_oauth.png) - Create a `GitHub OAuth App` at `Settings` -> `Developer settings` -> `OAuth Apps` -> `New OAuth App` [here](https://github.com/settings/developers). - Set the `Authorization callback URL` to `http:///api/oauth/callback`, e.g., `http://127.0.0.1:21114/api/oauth/callback`. ### **Web Client**: 1. If you're already logged into the admin panel, the web client will log in automatically. 2. If you're not logged in, simply click the login button at the top right corner, and the API server will be pre-configured. ![webclient_conf](docs/webclient_conf.png) 3. After logging in, the ID server and key will be automatically synced. 4. The address book will also be automatically saved to the web client for convenient use. ### **Automated Documentation** : API documentation is generated using Swag, making it easier for developers to understand and use the API. 1. Admin panel docs: `/admin/swagger/index.html` 2. PC client docs: `/swagger/index.html` ![api_swag](docs/api_swag.png) ## Installation and Setup ### Configuration * Modify the configuration in `conf/config.yaml`. If `gorm.type` is set to `sqlite`, MySQL-related configurations are not required. ```yaml gin: api-addr: "0.0.0.0:21114" mode: "release" resources-path: 'resources' trust-proxy: "" gorm: type: "sqlite" max-idle-conns: 10 max-open-conns: 100 mysql: username: "root" password: "111111" addr: "192.168.1.66:3308" dbname: "rustdesk" rustdesk: id-server: "192.168.1.66:21116" relay-server: "192.168.1.66:21117" api-server: "http://192.168.1.66:21114" key: "123456789" ``` * Environment variables, with the prefix `RUSTDESK_API`, will override the settings in the configuration file if present. | Variable Name | Description | Example | |------------------------------------|-----------------------------------------------------------|--------------------------------| | ----- GIN Configuration ----- | --------------------------------------- | ------------------------------ | | RUSTDESK_API_GIN_TRUST_PROXY | Trusted proxy IPs, separated by commas. | 192.168.1.2,192.168.1.3 | | ----- GORM Configuration ----- | --------------------------------------- | ------------------------------ | | RUSTDESK_API_GORM_TYPE | Database type (`sqlite` or `mysql`). Default is `sqlite`. | sqlite | | RUSTDESK_API_GORM_MAX_IDLE_CONNS | Maximum idle connections | 10 | | RUSTDESK_API_GORM_MAX_OPEN_CONNS | Maximum open connections | 100 | | ----- MYSQL Configuration ----- | --------------------------------------- | ------------------------------ | | RUSTDESK_API_MYSQL_USERNAME | MySQL username | root | | RUSTDESK_API_MYSQL_PASSWORD | MySQL password | 111111 | | RUSTDESK_API_MYSQL_ADDR | MySQL address | 192.168.1.66:3306 | | RUSTDESK_API_MYSQL_DBNAME | MySQL database name | rustdesk | | ----- RUSTDESK Configuration ----- | --------------------------------------- | ------------------------------ | | RUSTDESK_API_RUSTDESK_ID_SERVER | Rustdesk ID server address | 192.168.1.66:21116 | | RUSTDESK_API_RUSTDESK_RELAY_SERVER | Rustdesk relay server address | 192.168.1.66:21117 | | RUSTDESK_API_RUSTDESK_API_SERVER | Rustdesk API server address | http://192.168.1.66:21114 | | RUSTDESK_API_RUSTDESK_KEY | Rustdesk key | 123456789 | ### Installation Steps #### Running via Docker 1. Run directly with Docker. Configuration can be modified by mounting the config file `/app/conf/config.yaml`, or by using environment variables to override settings. ```bash docker run -d --name rustdesk-api -p 21114:21114 \ -v /data/rustdesk/api:/app/data \ -e RUSTDESK_API_RUSTDESK_ID_SERVER=192.168.1.66:21116 \ -e RUSTDESK_API_RUSTDESK_RELAY_SERVER=192.168.1.66:21117 \ -e RUSTDESK_API_RUSTDESK_API_SERVER=http://192.168.1.66:21114 \ -e RUSTDESK_API_RUSTDESK_KEY=123456789 \ lejianwen/rustdesk-api ``` 2. Using `docker-compose` - Simple example: ```docker-compose services: rustdesk-api: container_name: rustdesk-api environment: - RUSTDESK_API_RUSTDESK_ID_SERVER=192.168.1.66:21116 - RUSTDESK_API_RUSTDESK_RELAY_SERVER=192.168.1.66:21117 - RUSTDESK_API_RUSTDESK_API_SERVER=http://192.168.1.66:21114 - RUSTDESK_API_RUSTDESK_KEY=123456789 ports: - 21114:21114 image: lejianwen/rustdesk-api volumes: - /data/rustdesk/api:/app/data # Mount the database for easy backup networks: - rustdesk-net restart: unless-stopped ``` - Example with RustDesk's official Docker Compose file, adding your `rustdesk-api` service: ```docker-compose networks: rustdesk-net: external: false services: hbbs: container_name: hbbs ports: - 21115:21115 - 21116:21116 # 自定义 hbbs 映射端口 - 21116:21116/udp # 自定义 hbbs 映射端口 - 21118:21118 # web client 需要 image: rustdesk/rustdesk-server command: hbbs -r -k 123456789 # 填入个人域名或 IP + hbbr 暴露端口 volumes: - /data/rustdesk/hbbs:/root # 自定义挂载目录 networks: - rustdesk-net depends_on: - hbbr restart: unless-stopped deploy: resources: limits: memory: 64M hbbr: container_name: hbbr ports: - 21117:21117 # 自定义 hbbr 映射端口 image: rustdesk/rustdesk-server command: hbbr -k 123456789 #command: hbbr volumes: - /data/rustdesk/hbbr:/root # 自定义挂载目录 networks: - rustdesk-net restart: unless-stopped deploy: resources: limits: memory: 64M rustdesk-api: container_name: rustdesk-api environment: - RUSTDESK_API_RUSTDESK_ID_SERVER=192.168.1.66:21116 - RUSTDESK_API_RUSTDESK_RELAY_SERVER=192.168.1.66:21117 - RUSTDESK_API_RUSTDESK_API_SERVER=http://192.168.1.66:21114 - RUSTDESK_API_RUSTDESK_KEY=123456789 ports: - 21114:21114 image: lejianwen/rustdesk-api volumes: - /data/rustdesk/api:/app/data #将数据库挂载出来方便备份 networks: - rustdesk-net restart: unless-stopped ``` #### Running from Release Download the release from [release](https://github.com/lejianwen/rustdesk-api/releases). #### Source Installation 1. Clone the repository: ```bash git clone https://github.com/lejianwen/rustdesk-api.git cd rustdesk-api ``` 2. Install dependencies: ```bash go mod tidy # Install Swag if you need to generate documentation; otherwise, you can skip this step go install github.com/swaggo/swag/cmd/swag@latest ``` 3. Build the admin front-end (the front-end code is in [rustdesk-api-web](https://github.com/lejianwen/rustdesk-api-web)): ```bash cd resources mkdir -p admin git clone https://github.com/lejianwen/rustdesk-api-web cd rustdesk-api-web npm install npm run build cp -ar dist/* ../admin/ ``` 4. Run: ```bash # Run directly go run cmd/apimain.go # Or generate and run the API using generate_api.go go generate generate_api.go ``` 5. To compile, change to the project root directory. For Windows, run `build.bat`, and for Linux, run `build.sh`. After compiling, the corresponding executables will be generated in the `release` directory. Run the compiled executables directly. 6. Open your browser and visit `http://:21114/_admin/`, with default credentials `admin admin`. Please change the password promptly. ## Miscellaneous - [Change client ID](https://github.com/abdullah-erturk/RustDesk-ID-Changer) - [webclient](https://hub.docker.com/r/keyurbhole/flutter_web_desk)