RustDesk API服务器终极部署指南：5分钟快速搭建远程桌面服务 🚀

【免费下载链接】rustdesk-api-server RustDesk Api Server 项目地址: https://gitcode.com/gh_mirrors/rus/rustdesk-api-server

RustDesk API服务器Go语言版本是开源远程协助领域的明星项目，专为需要自建远程控制服务的用户设计。无论是个人开发者还是企业团队，都能通过这个轻量级解决方案实现安全高效的设备管理。本指南将带你从零开始，用最简单的方式部署专属的远程桌面API服务。

🎯 为什么选择RustDesk API服务器？

RustDesk API服务器基于Go语言开发，支持MySQL和SQLite3双数据库，具有部署简单、性能优异、安全性高等特点。通过自建服务器，你可以完全掌控数据流转，避免第三方服务的隐私风险，同时享受更稳定的连接体验。

📦 环境准备与快速安装

首先确保你的系统已安装Golang环境和GCC编译器。推荐使用以下命令一键安装依赖：

# Ubuntu/Debian系统
sudo apt update && sudo apt install golang gcc -y

# CentOS/RHEL系统  
sudo yum install golang gcc -y

接下来克隆项目代码到本地：

git clone https://gitcode.com/gh_mirrors/rus/rustdesk-api-server
cd rustdesk-api-server

⚙️ 核心配置详解

配置文件位于conf/app.conf，这是服务器的控制中心。主要配置项包括：

• 数据库类型：支持mysql或sqlite3
• 数据库连接：主机地址、端口、数据库名、用户名和密码
• 安全密钥：授权密码和加密盐值，保障通信安全

数据库配置示例：

dbtype: mysql
mysql:
  host: '127.0.0.1'
  port: 3306
  database: 'rustdesk'
  username: 'root'
  password: 'your_password'
app:
  authkey: 'your_auth_key'
  cryptkey: 'encryption_salt'

🚀 三种部署方式任选

方案一：直接运行（推荐新手）

直接执行编译后的程序，系统会自动创建所需数据表：

go build -o rustdesk-api-server
./rustdesk-api-server

方案二：端口映射

映射21114端口，兼容移动端默认配置：

# 使用iptables进行端口映射
iptables -t nat -A PREROUTING -p tcp --dport 21114 -j REDIRECT --to-port 21114

方案三：Nginx反向代理

配置Nginx实现80端口访问，提升服务可用性：

server {
    listen 80;
    server_name your-domain.com;
    
    location / {
        proxy_pass http://127.0.0.1:21114;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

📱 客户端配置技巧

在RustDesk客户端中配置API服务器时，注意以下要点：

• 安卓端：不需要填写http://前缀，端口必须为21114
• PC端：完整URL格式为http://your-server.com:21114
• 多设备同步：登录后自动获取账号下所有在线设备

🔧 核心功能实战

用户账号管理

创建新用户账号：

http://your-server.com:21114/api/reg?username=test&password=test&auth_key=your_auth_key

修改用户密码：

http://your-server.com:21114/api/set-pwd?username=test&password=new_password&auth_key=your_auth_key

设备地址簿管理

系统自动同步同一账号下的设备列表，方便快速连接。特殊处理：当username为"----"时不会保存到地址簿。

🏗️ 项目架构解析

RustDesk API服务器采用清晰的MVC架构：

• 控制器层(app/controllers/)：处理HTTP请求和响应
• 服务层(app/services/)：实现业务逻辑核心
• 数据模型(app/models/)：定义数据库表结构
• 工具库(utils/)：提供加密、日志等辅助功能

这种设计保证了代码的可维护性和扩展性，方便二次开发。

💡 常见问题解决方案

Q: 端口21114无法访问？ A: 检查防火墙设置，确保端口已开放：

sudo ufw allow 21114/tcp

Q: 数据库连接失败？
A: 确认数据库服务正常运行，配置信息正确无误

Q: 客户端连接超时？ A: 检查网络环境，确保服务器有公网IP或正确配置了内网穿透

🚀 性能优化建议

1. 数据库优化：MySQL建议启用连接池，SQLite3适合轻量级应用
2. 缓存策略：对频繁访问的数据添加缓存机制
3. 负载均衡：高并发场景可使用Nginx做负载均衡
4. 安全加固：定期更换authkey和cryptkey，启用HTTPS加密

🌟 进阶功能扩展

基于RustDesk API服务器的开源特性，你可以轻松扩展以下功能：

• 添加设备分组管理
• 实现访问权限控制
• 集成第三方认证系统
• 添加操作日志审计
• 开发Web管理界面

通过本指南，你已经掌握了RustDesk API服务器的完整部署流程。无论是个人使用还是团队协作，这个强大的远程控制解决方案都能满足你的需求。现在就动手搭建属于自己的远程桌面服务吧！🎯

提示：部署过程中遇到问题，可以查看项目日志文件获取详细错误信息，日志默认输出到控制台，也可配置输出到文件便于排查。

【免费下载链接】rustdesk-api-server RustDesk Api Server 项目地址: https://gitcode.com/gh_mirrors/rus/rustdesk-api-server