前提条件

在部署Control Hub前，需要准备以下条件：

1. 一台Windows 10 64-bit设备，可以是实体机、虚拟机或云服务器。
2. 参考Windows Docker安装指南， 在Windows上安装Docker和相关组件。了解Docker和相关组件。
3. 本教程使用Windows 10 家庭单语言版，操作系统内部版本19042.985，内存6.00 GB。
4. 安装部署前，需保证默认的TCP端口（80和1935）可用。如果端口已被占用，会导致服务启动失败无法访问。
5. 要保证服务所有功能都正常运行，需保证所有端口均可用。
6. 如果存在防火墙或者云上的安全策略，需要做相应的配置使得端口可以正常被访问。

注意事项

• 同一宿主机上，只能部署一个Control Hub实例。
• 建议您在部署前，检查Control Hub部署时使用的端口，是否已被其他服务占用。
• 部署了Control Hub的容器，不要修改容器名，否则会导致Control Hub无法正常升级。

步骤1：安装Docker

1. 下载并运行Docker Desktop for Windows。
2. 根据提示，安装对应组件。
   
3. 安装完成，根据提示，重启电脑。

步骤2：运行Docker

1. 根据提示，下载安装WSL 2组件。
2. 安装完成，根据提示，重启电脑。
3. 重启后，Docker开机自启动。点击Start，打开Docker。
   
4. 在电脑搜索框，输入cmd，打开命令提示符。
5. 运行hello-world镜像验证Docker安装正确。

   docker run hello-world

若出现以下信息则表明安装成功：

步骤3：安装Control Hub平台

1. 加载Control Hub镜像:

   docker image pull magewell/control-hub:2.1.93

   显示如下

2. 在Docker > Images中，查看加载结果。
   
3. 启动Control Hub容器，并指定数据存放路径和各协议端口。为了数据安全，建议存放在D盘或其他区。如果有端口被占用，请修改端口范围。

   data和log目录需要放在ntfs格式的分区，否则会导致部分服务无法启动。

   本例中，data数据存放在d:\data；log日志存放在d:\log；HTTP端口为80；rtmp监听端口号为1935；HTTPS端口号为443；udp端口（如SRT服务）使用7900-8000。
   在命令提示符中，输入docker run。

   docker run --name control-hub -it -v d:\data:/data -v  d:\log:/log -p 80:80 -p 1935:1935 -p 443:443 -p 554:554 -p 7777:7777 -p 7900-8000:7900-8000/udp -v //var/run/docker.sock:/var/run/docker.sock --restart unless-stopped -d magewell/control-hub:2.1.93

在Docker > Containers中，查看容器。

步骤4：（可选）升级Control Hub版本

升级Control Hub时，Docker必须处于运行状态，且已经部署了Control Hub。

• 若当前版本为2.1.49及以上版本，Control Hub支持在线升级。您可在“设置 > 升级 > 在线升级”中更新至当前检测到的最新版本。
• 若当前版本为2.1.49以下版本，请按照以下步骤升级。

  1. 在Control Hub的/data/script文件夹下，查找update_control_hub.bat文件。

     如果本地没有update_control_hub.bat文件，请联系我们。

  2. 在电脑搜索框，输入cmd，打开命令提示符。

  3. 将update_control_hub.bat文件拖拽到cmd命令窗口。此时，将自动下载固件。

     如需升级到指定版本，需提前获取目标版本号。在命令提示符窗口中依次操作如下：

     1. 拖拽添加update_control_hub.bat文件。
     2. 输入空格。
     3. 输入目标版本号。
     命令提示符窗口显示如下：

     升级后，登录Control Hub，在页面左上角查看目标版本是否正确。

后续操作

1. 访问Control Hub WebGUI。

   打开网页浏览器，输入Windows服务器IP地址，格式为http://IP address。

   地址正确时，您将看到如下登录页面。
   默认管理员用户名和密码均为Admin，区分大小写。 为提高账户安全性，初次登录后，强烈建议您修改密码。

2. 在Control Hub上添加设备。