问题：如何在1Panel中正确配置RustDesk的端口映射与服务启动？

Question

在使用1Panel部署RustDesk时，常见的一个技术问题是：如何正确配置端口映射与启动RustDesk服务？用户常常遇到无法远程连接、端口冲突或服务启动失败等问题。此问题的核心在于理解RustDesk所需的端口（如21115、21116、21117等）及其作用，并在1Panel的应用管理中正确设置端口映射和服务依赖项。此外，还需确保防火墙规则允许对应端口通行，并正确配置反向代理（如有）。解决该问题需要结合1Panel的可视化界面和系统配置，合理分配宿主机与容器之间的端口绑定，以保障RustDesk各项功能正常运行。

Answer 1

一、理解 RustDesk 的端口需求

RustDesk 是一个开源的远程桌面工具，其服务端（RustDesk ID/Relay Server）由多个组件构成，包括 hbbs（信令服务器）、hbbr（中继服务器）等。每个组件都需要特定端口进行通信：

组件	默认端口	作用说明
hbbs	21115	用于客户端与服务器之间的握手和认证
hbbr	21116	作为中继服务器，转发数据流
hbbs Web API	21117	提供用户管理、设备注册等API接口

二、在1Panel中配置容器端口映射

1Panel 提供了可视化的容器部署界面，但在部署 RustDesk 容器时，必须手动设置端口映射以确保外部网络能够访问到容器内部的服务。

1. 进入“应用市场”或“自定义镜像”页面，选择 RustDesk 镜像。
2. 在“端口映射”部分添加如下配置：
   • 21115:21115 — TCP
   • 21116:21116 — TCP
   • 21117:21117 — TCP
3. 确认宿主机端口未被占用，避免端口冲突。

三、检查系统防火墙与安全组设置

即使容器端口已正确映射，如果系统防火墙或云平台的安全组未放行对应端口，也将导致无法连接。

# Ubuntu/Debian 系统开放端口示例
ufw allow 21115/tcp
ufw allow 21116/tcp
ufw allow 21117/tcp
ufw reload

四、配置反向代理（如使用HTTPS）

若希望通过域名并启用 HTTPS 访问 hbbs Web API 接口（端口21117），可使用 Nginx 或 Traefik 进行反向代理配置。

server {
    listen 443 ssl;
    server_name yourdomain.com;

    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass http://localhost:21117;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

五、验证服务是否正常运行

可通过以下方式检查 RustDesk 服务状态：

• 查看容器日志：docker logs [容器ID]
• 测试本地访问：curl http://localhost:21117
• 使用公网IP测试远程连接是否成功

六、常见问题排查流程图

graph TD
    A[启动失败] --> B{端口是否冲突?}
    B -- 是 --> C[修改宿主机端口]
    B -- 否 --> D{防火墙是否放行?}
    D -- 否 --> E[调整防火墙规则]
    D -- 是 --> F{反代配置正确?}
    F -- 否 --> G[修正Nginx/Traefik配置]
    F -- 是 --> H[RustDesk服务正常]