BilldDesk 中文文档 下载 App

Docker 私有化部署——把 BilldDesk 跑在自己的服务器上

什么是私有化部署

私有化部署指的是把 BilldDesk 的服务端组件(信令服务器、中继服务器、后台管理服务)部署在你自己的服务器 / 云服务器上,而不是使用 BilldDesk 官方的 SaaS 服务。

私有化部署的核心好处:

BilldDesk 的服务端架构

BilldDesk 客户端(桌面端、移动端、网页端)远程连接时,需要以下服务端组件配合:

服务作用技术栈
信令服务器交换远程连接协商信息(NAT 穿透候选、密钥、设备信息)Node.js + Koa2 + Redis
中继服务器NAT 穿透失败时转发远程会话流量基于 WebRTC TURN 协议
后台管理服务设备管理、分组、远程记录、黑名单等(Pro 版有)Node.js + 前端管理界面

这三个服务可以一起部署,也可以分散在不同服务器上。

Docker 一键部署

BilldDesk 官方提供了 Docker 镜像和 docker-compose.yml 配置文件,私有化部署非常简单:

# 1. 克隆项目仓库(开源版或购买源码后)
git clone https://github.com/galaxy-s10/billd-desk-server.git

# 2. 进入项目目录
cd billd-desk-server

# 3. 修改配置(数据库、端口、域名等)
# 编辑 config/production.json

# 4. 一键启动
docker-compose up -d

启动后,你自己的服务器上就跑着一套完整的 BilldDesk 服务端:

客户端配置自建服务器

服务端部署好后,需要在 BilldDesk 客户端中配置指向自建的服务器:

  1. BilldDesk 客户端 → 高级设置 → 网络设置
  2. 找到「自定义接口」配置区域
  3. 填入自建信令服务器的 WebSocket 地址(如 wss://your-server.com/socket)
  4. 填入自建中继服务器的地址
  5. 保存后客户端就会连接到你的自建服务端

自建后,客户端的所有远程连接都不会经过 BilldDesk 官方的服务器。

最低硬件要求

私有化部署 BilldDesk 服务端的最低硬件要求:

组件最低配置推荐配置
信令服务器1 核 1G 内存2 核 4G 内存
中继服务器1 核 2G 内存 + 足够带宽4 核 8G 内存 + 100Mbps+ 上行带宽
Redis跟信令同机即可独立实例

关键瓶颈是中继服务器的上行带宽:中继每转发一路远控画面需要消耗对应带宽(1080P + 60FPS ≈ 3-10Mbps)。如果有 5 路远程同时经过自建中继,中继服务器的上行带宽就要 ≥ 50Mbps。

与官方 SaaS 的对比

对比项私有化部署官方 SaaS
数据路径仅经过自建服务器经过官方服务器
稳定性自建保障依赖官方可用性
中继资源自己的服务器带宽官方中继集群
维护成本需要自己维护零维护
费用服务器成本 + Pro 源码购买VIP 订阅(低至 4.2 元/月)
定制能力源码购买后自由修改不可定制

私有化部署适合谁

用户类型推荐私有化?原因
个人用户(< 10 台设备)❌ 不推荐维护成本高于收益
小型工作室(< 50 台)⚠️ 可选如果对数据安全有要求可以考虑
中型企业(50-500 台)✅ 推荐数据安全、自定义需求 justify 成本
大型企业 / 政府 / 金融✅ 强烈推荐数据不出内网是硬性要求
云游戏 / 云手机运营商✅ 必须批量设备管理 + 低延迟需求

开源版 vs Pro 源码私有化部署

对比项开源版Pro 源码(¥19999 起)
服务端功能基础信令 + 中继完整信令 + 中继 + 后台管理
客户端功能基础远控全部高阶功能(隐私屏、屏幕墙、驱动级键鼠等)
二次开发可以可以
后台管理界面无有
文档与支持GitHub README源码内文档 + 作者支持