终极指南:5步快速部署RustDesk API自建服务器
终极指南:5步快速部署RustDesk API自建服务器
【免费下载链接】rustdesk-api-server RustDesk Api Server 项目地址: https://gitcode.com/gh_mirrors/rus/rustdesk-api-server
RustDesk API服务器是一个基于Go语言开发的专业远程桌面管理解决方案,支持SQLite3和MySQL数据库,为技术爱好者和系统管理员提供完整的自建服务器能力。通过部署RustDesk API自建服务器,您可以完全掌控远程连接管理,确保数据安全和隐私保护。
环境准备与依赖检查
在开始部署之前,请确保您的系统满足以下基本要求:
- Go语言环境:安装Go 1.16或更高版本,并正确配置GOPATH和GOROOT环境变量
- GCC编译器:用于编译项目依赖库,确保GCC已安装并配置到系统PATH中
- 数据库选择:准备SQLite3或MySQL数据库,推荐使用MySQL以获得更好的性能表现
验证环境准备就绪后,您可以通过以下命令检查Go语言环境:
go version
一键式Docker部署
RustDesk API服务器支持多种部署方式,其中Docker部署是最为简便的方法:
- 获取项目代码:
git clone https://gitcode.com/gh_mirrors/rus/rustdesk-api-server.git
cd rustdesk-api-server
- 构建Docker镜像: 项目提供了完整的Dockerfile支持,您可以使用buildDocker.sh脚本快速构建:
./buildDocker.sh
- 运行容器: 使用docker-compose或直接运行容器,映射21114端口到主机:
docker run -p 21114:21114 rustdesk-api-server
RustDesk客户端API服务器配置界面示例
API功能详解与使用
RustDesk API服务器提供丰富的接口功能,核心配置位于conf/app.conf和global/config.go中:
核心配置项说明
- 监听配置:服务器默认监听0.0.0.0:21114,可在
conf/app.conf中修改 - 数据库连接:支持MySQL和SQLite3,配置路径为项目根目录下的配置文件
- 安全设置:包含授权密钥和密码加密盐值,确保API访问安全
用户管理接口
创建新账号:
curl -X POST "http://服务器地址:21114/api/reg?username=用户名&password=密码&auth_key=授权密钥"
修改密码:
curl -X POST "http://服务器地址:21114/api/set-pwd?username=用户名&password=新密码&auth_key=授权密钥"
地址簿功能
系统会自动同步同账号下的所有在用主机,并以账号归属开头进行组织。特别注意:当username字段值为"----"时,系统不会保存该地址簿条目。
高级配置优化
数据库配置优化
在项目配置文件中,您可以详细设置数据库连接参数:
dbtype: mysql
mysql:
host: '127.0.0.1'
port: 3306
database: 'rustdesk'
username: 'root'
password: '您的密码'
app:
authkey: '您的授权密码'
cryptkey: '密码加密盐值'
Nginx反向代理配置
为提高生产环境稳定性和安全性,建议使用Nginx进行反向代理:
location / {
proxy_pass http://127.0.0.1:21114;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
日志管理
服务器日志默认输出到logs/app.log,您可以在conf/app.conf中调整日志级别和文件大小限制,确保系统运行状态可监控。
故障排除指南
常见问题解决
- 端口冲突:如果21114端口被占用,修改
conf/app.conf中的httpport配置项 - 数据库连接失败:检查数据库服务状态和连接参数是否正确
- 权限问题:确保运行用户对日志目录有写入权限
性能优化建议
- 对于高并发场景,建议使用MySQL并优化数据库连接池配置
- 调整Go语言的GOMAXPROCS参数以充分利用多核CPU性能
- 定期清理日志文件,避免磁盘空间不足
通过本指南,您应该能够顺利完成RustDesk API服务器的部署和配置。这个基于Go语言和Beego框架的解决方案为您提供了稳定可靠的远程桌面管理平台,让您完全掌控自己的远程连接环境。
【免费下载链接】rustdesk-api-server RustDesk Api Server 项目地址: https://gitcode.com/gh_mirrors/rus/rustdesk-api-server










