extern/doc.rustdesk.com
1
0
Fork 1
mirror of https://github.com/rustdesk/doc.rustdesk.com.git synced 2024-12-28 01:49:26 +01:00
Code Issues Packages Projects Releases Wiki Activity

Update _index.en.md

Browse Source
This commit is contained in:
Mr-Update 2024-05-21 21:56:48 +02:00 committed by GitHub
parent c588184bbe
commit baace1b8ce
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 51 additions and 38 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

89
content/self-host/rustdesk-server-oss/ubuntu-server/docker/_index.en.md
View File

@ -2,8 +2,10 @@
title: Ubuntu Server with Docker
weight: 20
---
Following tutoral will use Ubuntu Server **22.04 minimal** as example. And especially command line procedures, because lowest price spec of VPS can't handle desktop environment.
## Preparation
Following tutorial will use Ubuntu Server **22.04 minimal** as example. And especially command line procedures, because lowest price spec of VPS can't handle desktop environment.
### Preparation
> First, you need:
* [Visual Studio Code](https://code.visualstudio.com)
@ -15,22 +17,24 @@ Following tutoral will use Ubuntu Server **22.04 minimal** as example. And espec
* [Ubuntu Server ISO](https://ubuntu.com/download/server)
* Ability to setup port forwarding on your ISP modem or router, if you got these devices from your ISP and don't know how to enter the admin page, please ask your ISP
## VPS/VM specs choosing/setting
If you plan to run only RustDesk Server, lowest spec should be fine, except AWS Lightsail, because its lowest spec is 512MB RAM which may too low and crash, any spec with **1GB RAM** should fine.
### VPS/VM specs choosing/setting
For self-hosted VMs, **1GB RAM and 32GB** of disk will suit your need, and UEFI BIOS is preferred.
If you plan to run only RustDesk Server, lowest spec should be fine, except AWS Lightsail, because its lowest spec is 512 MB RAM which may too low and crash, any spec with **1 GB RAM** should fine.
For self-hosted VMs, **1 GB RAM and 32 GB** of disk will suit your need, and UEFI BIOS is preferred.
For any other hypervisor that runs on Windows or Linux with GUI, such as VirtualBox or VMware Workstation, please set your virtual network card to **bridged** mode.
## 1. Installing Ubuntu Server
#### [Skip](#2-setup-server) if you decide to rent a VPS.
### 1. Installing Ubuntu Server
##### Skip [2. Setup Server](#2-setup-server), if you decide to rent a VPS.
{{% notice note %}}
This tutorial assume you install your Ubuntu Server as a virtual machine. If you decide to install on a physical machine, doing wrong procedures, may cause **data loss**.
{{% /notice %}}
{{% notice note %}}
Use **Tab** to navigate different options, use **Space** to choose different options, use **Enter** when hitting Done.
Use **Tab** to navigate different options, use **Space** to choose different options, use **Enter** when hitting **Done**.
{{% /notice %}}
1. Choose language
@ -46,14 +50,13 @@ Use **Tab** to navigate different options, use **Space** to choose different opt
Now, you could go to your router's DHCP settings, find and add your VM's LAN IP address to DHCP reservation, if you want, you could also assign other IP address.
{{% /notice %}}
4. It should choose mirror automatically, if yes, next
![](images/installation/ubt-serv-install-mirror-config.png)
5. Choose minimized to reduce memory and disk usage
![](images/installation/ubt-serv-install-installation-type.png)
6. Use entire disk, next
6. Use entire disk
![](images/installation/ubt-serv-install-use-entire-disk.png)
7. Confirm your disk options
@ -64,41 +67,45 @@ Now, you could go to your router's DHCP settings, find and add your VM's LAN IP
9. Skip [Ubuntu Pro](https://ubuntu.com/pro) register, or you could do it right now
![](images/installation/ubt-serv-install-skip-pro.png)
10. We need to install OpenSSH
10. We need to install OpenSSH
![](images/installation/ubt-serv-install-add-ssh-serv.png)
11. Skip anyting at this page, because it is snap package
11. Skip anything at this page, because it is snap package
![](images/installation/ubt-serv-install-skip-snap.png)
12. After installed it may doing auto update, you could let it update, after it done, reboot.
## 2. Setup Server
### 2. Setup Server
1. Open VSCode, click button at left corner and select SSH
![](images/setup/open_vscode.png)
2. Enter `username@IP`
For example: `demouser@192.168.2.98`, and then enter
2. Enter `username@IP`, for example `demouser@192.168.2.98`, and then `Enter`
![](images/setup/connect_server_through_vscode.png)
3. Select your system, `Linux`
3. Select your system `Linux`
4. Confirm the fingerprint of the server
5. Enter the password of your user
6. Open your home folder
![](images/setup/vscode_open_folder.png)
7. Click, **Yes, I trust the authors**
7. Click `Yes, I trust the authors`
8. Open terminal
![](images/setup/vscode_open_terminal.png)
9. Install packages
```text
```
sudo apt install docker.io docker-compose python3-pip curl git vim nano zram-config -y
```
10. Disable disk swap
Check if swapfile exists
Check if swap file exists
```
sudo vim /etc/fstab
```
@ -107,17 +114,17 @@ If you find anything similar to:
```
/swap.img none swap sw 0 0
```
If not: Type `:qa!` then enter to exit. And go to Step. 12
If not: Type `:qa!` then `Enter` to exit. And go to step 12
If yes: Press `i` to activate edit mode, comment that line with `#` like this:
```
#/swap.img none swap sw 0 0
```
Press `Esc` and type `:wq` then enter to save the changes.
Press `Esc` and type `:wq` then `Enter` to save the changes.
11. Adjust ZRAM size
ZRAM means **"compress ram"**, it is more efficient and won't occupy disk space.
ZRAM means "compress ram", it is more efficient and won't occupy disk space.
```
sudo vim /usr/bin/init-zram-swapping
@ -141,6 +148,7 @@ Find your timezone at [Wikipedia](https://en.wikipedia.org/wiki/List_of_tz_datab
```
sudo timedatectl set-timezone "Asia/Taipei"
```
13. Reboot
```
sudo reboot
@ -151,12 +159,13 @@ After reboot, reconnect with your VSCode and open terminal.
(Skip if you don't have it.)
We've replaced swapfile with ZRAM, now we can delete `swap.img` now, replace `swap.img` with others if your name is different.
We've replaced swap file with ZRAM, now we can delete `swap.img` now, replace `swap.img` with others if your name is different.
```
sudo rm /swap.img
```
## 3. Setup RustDesk Server
### 3. Setup RustDesk Server
1. Run this command to create required folders once:
```
cd ~ && mkdir -p docker/rustdesk-server/data
@ -164,19 +173,21 @@ cd ~ && mkdir -p docker/rustdesk-server/data
2. Create `compose.yml`
Right click `rustdesk-server` folder, create new file named `compose.yml`
Right click `rustdesk-server` folder, create new file named `compose.yml`.
Paste this to `compose.yml`.
After you copied, you should replace `rustdesk.example.com` (Which point to your hbbr) to the domain that will point to your server.
After you copied, you should replace `rustdesk.example.com` (Which point to your `hbbr`) to the domain that will point to your server.
{{% notice note %}}
You could modify the line with `hbbs` to your server's LAN IP temporarily (If you're deploying in your LAN) to ensure it is working. After you verify your server is working, you **should** change back.
{{% /notice %}}
{{% notice note %}}
Having problem after you changed LAN IP to domain? You should check [this article](/docs/en/self-host/nat-loopback-issues/).
{{% /notice %}}
```yml
```yaml
services:
hbbs:
container_name: hbbs
@ -214,6 +225,7 @@ Check [here](/docs/en/client) to set up your client. Only `ID server` and `Key`
cd ~/docker/rustdesk-server
sudo docker-compose up -d
```
4. Check it is working
In your VSCode, you should see `id_ed25519`, `id_ed25519.pub` on your `docker/rustdesk-server/data` folder. You could click `id_ed25519.pub`, this is the public key that you need for your RustDesk client.
@ -221,7 +233,7 @@ In your VSCode, you should see `id_ed25519`, `id_ed25519.pub` on your `docker/ru
The public key will looks like this:
![](images/setup/vscode_see_public_key.png)
## 5. Set port forwarding on your router/VPS
### 4. Set port forwarding on your router/VPS
Go to your router's admin webpage, find anything related to `Port forwarding`, it should appear in `WAN` or `Firewall` settings.
@ -231,13 +243,14 @@ If you're using VPS, Google search `{VPS vendor name} + firewall port` to find t
Open these required ports:
* `21114` TCP for web console, only available in Pro version
* `21115` `TCP` For NAT type test
* `21116` `TCP` TCP hole punching
* `21116` `UDP` Heartbeat/ID server
* `21117` `TCP` Relay
* `21115` TCP for NAT type test
* `21116` TCP TCP hole punching
* `21116` UDP heartbeat/ID server
* `21117` TCP relay
* `21118/21119` TCP for web socket if you want to run web client
## 6. Some basics
### 5. Some basics
1. How to apply the settings after you modified `compose.yml`?
Run this again:
@ -263,7 +276,6 @@ Drag and drop them to VSCode Explorer if you want to upload it.
Use [Watchtower](https://containrrr.dev/watchtower/).
Create folder and put the `compose.yml` in it.
```
@ -274,7 +286,8 @@ Change your timezone with yours at `TZ`.
If you didn't specify any container name, it will update **all** of your containers.
At the following command, it will run everyday at 3 AM, for more details, check their [documentation](https://containrrr.dev/watchtower/arguments/#scheduling).
```yml
```yaml
version: "3"
services:
watchtower:
@ -291,4 +304,4 @@ services:
5. How to update Ubuntu system automatically?
By default, Ubuntu will installing security updates automatically, Google search: `ubuntu unattended-upgrades` or check the file at `/etc/apt/apt.conf.d/50unattended-upgrades` for more details.
By default, Ubuntu will installing security updates automatically, Google search: `ubuntu unattended-upgrades` or check the file at `/etc/apt/apt.conf.d/50unattended-upgrades` for more details.