教程2:快速部署Control Hub(Windows)

本教程描述如何将Control Hub安装在Windows 10系统的Docker上。

前提条件

在部署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. 如果存在防火墙或者云上的安全策略,需要做相应的配置使得端口可以正常被访问。

步骤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
  6. 若出现以下信息则表明安装成功:

步骤3:安装Control Hub平台

  1. 加载Control Hub镜像:
    docker image pull magewell/control-hub:2.1.81

    显示如下

  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.81
  4. 在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上添加设备