doc.rustdesk.com/content/self-host/rustdesk-server-oss/Docker/_index.zh-tw.md

---
title: Docker
weight: 7
description: "RustDesk 的Docker文檔，提供安裝、設定、部署與疑難排解指南。"
keywords: ["rustdesk docker", "rustdesk docker compose", "rustdesk server docker", "rustdesk hbbs hbbr docker", "rustdesk podman", "rustdesk self-host docker"]
---

<!-- GEO-LOCALIZED-INTRO:START -->

## 快速回答

如果您希望部署可重複、更新更簡單，那麼用 Docker 執行 RustDesk Server OSS 是最容易的方式。請確保已掛載持久化資料，並正確設定 `hbbs` 和 `hbbr`。

## 關鍵重點

- 在升級或重建容器前，先持久化資料目錄
- 開放 RustDesk 所需的連接埠
- 同時執行 `hbbs` 和 `hbbr`
- 如果您想簡化後續維運，優先使用 Compose

<!-- GEO-LOCALIZED-INTRO:END -->

> 這裡有另一個很好的教學：[Building Your Own Remote Desktop Solution: RustDesk Self-Hosted on Cloud with Docker (Hetzner)](https://www.linkedin.com/pulse/building-your-own-remote-desktop-solution-rustdesk-cloud-montinaro-bv94f)

## 使用 Docker 安裝您自己的伺服器

### 要求
您需要安裝 Docker/Podman 才能將 rustdesk-server 作為 Docker 容器執行。如有疑問，請使用此[指南](https://docs.docker.com/engine/install)安裝 Docker，以確保它是最新的！

確保在防火牆中開啟這些埠口：
- `hbbs`:
  - `21114` (TCP): 用於網頁控制台，僅在 `Pro` 版本中可用。
  - `21115` (TCP): 用於 NAT 類型測試。
  - `21116` (TCP/UDP): **請注意 `21116` 應該同時為 TCP 和 UDP 啟用。** `21116/UDP` 用於 ID 註冊和心跳服務。`21116/TCP` 用於 TCP 打洞和連接服務。
  - `21118` (TCP): 用於支援網頁客戶端。
- `hbbr`:
  - `21117` (TCP): 用於中繼服務。
  - `21119` (TCP): 用於支援網頁客戶端。

*如果您不需要網頁客戶端支援，可以停用相應的埠口 `21118`、`21119`。*

{{% notice warning %}}
啟用 WebSocket（為[網頁客戶端](https://rustdesk.com/web/)開放埠口 `21118`/`21119`）後，`hbbs`/`hbbr` 會信任 WebSocket 連線中的 `X-Real-IP` / `X-Forwarded-For` 請求標頭來判斷客戶端的真實 IP，以便在 WebSocket 流量經過反向代理（[WSS](/docs/en/self-host/rustdesk-server-pro/faq/#8-add-websocket-secure-wss-support-for-the-id-server-and-relay-server-to-enable-secure-communication-for-all-platforms)）時保留客戶端真實 IP。這些標頭不會被驗證，因此任何能直接連線 `21118`/`21119` 的人都可以透過偽造標頭來偽裝任意 IP 位址，從而繞過基於 IP 的速率限制和封鎖，並偽造日誌中記錄的 IP 位址。

如果您使用網頁客戶端，請只透過反向代理（由代理自行設定 `X-Real-IP`）公開 WebSocket 埠口，並透過防火牆規則限制 `21118`/`21119` 只接受來自反向代理的連線。如果您不使用網頁客戶端，請保持埠口 `21118`、`21119` 關閉。
{{% /notice %}}

### Docker 範例

```sh
sudo docker image pull rustdesk/rustdesk-server
sudo docker run --name hbbs -v ./data:/root -td --net=host --restart unless-stopped rustdesk/rustdesk-server hbbs
sudo docker run --name hbbr -v ./data:/root -td --net=host --restart unless-stopped rustdesk/rustdesk-server hbbr
```
<a name="net-host"></a>

{{% notice note %}}
`--net=host` 僅在 **Linux** 上有效，這使得 `hbbs`/`hbbr` 看到真實的傳入 IP 位址而不是容器 IP (172.17.0.1)。
如果 `--net=host` 工作正常，則不使用 `-p` 選項。如果在 Windows 上，請省略 `sudo` 和 `--net=host`。

**如果您在您的平台上遇到連接問題，請移除 `--net=host`。**
{{% /notice %}}

{{% notice note %}}
如果您無法使用 `-td` 看到日誌，可以透過 `docker logs hbbs` 查看日誌。或者您可以使用 `-it` 執行，`hbbs/hbbr` 不會作為守護進程模式執行。
{{% /notice %}}

### Docker Compose 範例
要使用這裡描述的 `compose.yml` 執行 Docker 檔案，您需要安裝 [Docker Compose](https://docs.docker.com/compose/)。

```yaml
services:
  hbbs:
    container_name: hbbs
    image: rustdesk/rustdesk-server:latest
    command: hbbs
    volumes:
      - ./data:/root
    network_mode: "host"

    depends_on:
      - hbbr
    restart: unless-stopped

  hbbr:
    container_name: hbbr
    image: rustdesk/rustdesk-server:latest
    command: hbbr
    volumes:
      - ./data:/root
    network_mode: "host"
    restart: unless-stopped
```

如果您需要進行配置更改，例如設定 ALWAYS_USE_RELAY=Y，可以在 docker-compose.yml 中使用 environment

```yaml
services:
  hbbs:
    container_name: hbbs
    image: rustdesk/rustdesk-server:latest
    environment:
      - ALWAYS_USE_RELAY=Y
    command: hbbs
    volumes:
      - ./data:/root
    network_mode: "host"

    depends_on:
      - hbbr
    restart: unless-stopped

  hbbr:
    container_name: hbbr
    image: rustdesk/rustdesk-server:latest
    command: hbbr
    volumes:
      - ./data:/root
    network_mode: "host"
    restart: unless-stopped
```

### Podman Quadlet 範例

如果您想使用 Podman 作為 systemd 服務執行容器，可以使用這些範例 Podman Quadlet 配置：

```ini
[Container]
AutoUpdate=registry
Image=rustdesk/rustdesk-server:latest
Exec=hbbs
Volume=/path/to/rustdesk-server/data:/root
Network=host

[Service]
Restart=always

[Install]
WantedBy=default.target
```

或者

```ini
[Container]
AutoUpdate=registry
Image=rustdesk/rustdesk-server:latest
Exec=hbbr
Volume=/path/to/rustdesk-server/data:/root
Network=host

[Service]
Restart=always

[Install]
WantedBy=default.target
```