Skip to Content
工作文档测试手册测试手册索引中心服务平台安装包Master 版本v1.0.202504161818

v1.0.202504161818

修改日志

  • WEB 客户端：

    • BUG 修复：
      • 根据纬度方向调整 GPS 的纬度值, 并根据经度方向调整经度值。
      • 修复了在多屏直播模式下隐藏设备列表时右侧播放界面出现的闪烁问题。
    • 用户体验改进：
      • 在多地图模式下, 系统将根据用户的语言设置自动加载默认地图。如果用户选择中文, 则默认使用百度地图；否则, 默认使用 Google 地图。地图选择列表的顺序已调整为：Google、Open Street Map、百度、高德、腾讯。

  • 安装程序：

    • Docker 配置调整：
      • 将所有服务的 docker-compose.yml 文件中的 restart: on-failure:9 更改为 restart: no。
      • 在所有服务的 docker-compose.yml 文件中添加了 restart_policy 设置, 以实现延时重启, 避免因连续重启导致 CPU 资源耗尽。
    • 默认数据目录变更：
      • 默认数据目录已从 /opt/es-center-server-data 更改为 /var/lib/es-center-server-data, 以更好地遵循 Linux 目录规范。
    • cli upgrade-server 子命令逻辑调整：
      • 新增了处理 docker-compose.yml 及相关配置文件升级的逻辑, 以应对可能需要升级的情况。
    • cli install-server-coturn-service 子命令调整：
      • 添加了 --internal-eth-name 参数, 用于指定 Coturn 服务的内部网卡名称。
    • 集成 docker:cli 容器：
      • 集成了 docker:cli 容器, 以便在开机自启后按指定顺序延时启动其他 Docker 容器。这样做的原因是, 开机时多个容器同时启动会对低配服务器造成巨大压力, 可能导致 CPU 超过 100%, 从而使某些服务无法正常启动。

测试说明

本部分详细阐述在 Ubuntu Server 22.04 LTS 系统上执行安装程序测试的具体步骤。

测试步骤

下载安装包并安装

# 安装 smbclient 工具, 用于从共享目录下载文件
sudo apt install -y smbclient
 
# 使用 smbclient 连接共享目录, 将指定的安装包下载至当前目录
smbclient //192.168.1.204/home1 -U 15675192166%es666666 << EOF
get yht/es-center-server-install-app-package/es-center-server-install-app-master-1.0.202504161818.tar.gz ./es-center-server-install-app-master-1.0.202504161818.tar.gz
quit
EOF
 
# 备选下载方法
# 如果需要, 也可以使用scp从内网服务器上下载安装包。
scp root@192.168.0.111:/es/tmp/es-center-server-install-app-master-1.0.202504161818.tar.gz .
 
# 创建安装目录, 路径可根据实际需求灵活调整
sudo mkdir -p /tmp/es-center-server-install-app
 
# 将下载的安装包解压到指定的安装目录
sudo tar -xzvf es-center-server-install-app-master-1.0.202504161818.tar.gz -C /tmp/es-center-server-install-app
 
# 查看解压后安装目录下各文件和文件夹的大小
sudo du -sh /tmp/es-center-server-install-app/*
 
# 安装前可选择修改配置文件。命令行输入的参数会覆盖配置文件中的设置,
# 但若命令行参数数量少于配置文件中的参数, 可根据特殊需求手动调整配置文件。
sudo nano /tmp/es-center-server-install-app/es-center-server-service/.env
 
# 根据实际情况指定服务安装目录、数据存储目录、内网 IP、公网 IP 以及域名。
# 进入安装目录并执行安装脚本完成安装。
# 特别注意, `data-root-dir` 对应的目录至关重要, 用于存储服务器运行过程中产生的数据（如日志文件、数据库内容等）。
# 因此, 务必将其设置为具有充足存储空间且安全可靠的目录。
# 推荐将此目录设置为磁盘阵列中的某个目录, 以确保数据的安全性与可靠性。
# `internal-eth-name` 是内网网卡名称（如 eth0）, 涉及 janus 服务的配置需根据实际情况调整。
cd /tmp/es-center-server-install-app
sudo ./cli install-server \
--service-root-dir /opt/es-center-server-service \
--data-root-dir /var/lib/es-center-server-data \
--internal-eth-name eth0 \
--internal-ip 172.16.8.178 \
--external-ip 120.26.124.232 \
--domain-name zxs-cs.netbodycamera.com

配置文件说明

安装前, 配置文件位于安装程序目录的相对路径：./es-center-server-service/.env 安装后, 配置文件位于 service-root-dir 对应的目录下, 文件名为：.env

# ####################################
# ### es-center-server Basic Configuration
# ####################################
# Root directory for the es-center-server service
ES_CENTER_SERVER_SERVICE_ROOT_DIR=/opt/es-center-server-service
# Data root directory for the es-center-server
ES_CENTER_SERVER_DATA_ROOT_DIR=/var/lib/es-center-server-data
# Internal IP address of the es-center-server
ES_CENTER_SERVER_INTERNAL_IP=192.168.0.1
# External IP address of the es-center-server
ES_CENTER_SERVER_EXTERNAL_IP=192.168.0.1
# Domain name of the es-center-server
ES_CENTER_SERVER_DOMAIN_NAME=example.com
 
# ####################################
# ### es-center-server-coturn WebRTC Traversal Service Configuration
# ####################################
# Docker image tag for the COTURN service
ES_CENTER_SERVER_COTURN_DOCKER_IMAGE_TAG=latest
# Domain name for the COTURN service
ES_CENTER_SERVER_COTURN_DOMAIN_NAME=example.com
# Internal Ethernet interface name for the COTURN service
ES_CENTER_SERVER_COTURN_INTERNAL_ETH_NAME=eth0
# Internal IP address of the COTURN service
ES_CENTER_SERVER_COTURN_INTERNAL_IP=192.168.0.1
# External IP address of the COTURN service
ES_CENTER_SERVER_COTURN_EXTERNAL_IP=192.168.0.1
# Specifies the main listening port for the COTURN service.
# This is the port on which the COTURN server listens for incoming connections.
ES_CENTER_SERVER_COTURN_LISTENING_PORT=3478
# Defines the minimum port number within the range used by the COTURN service.
# COTURN may allocate ports starting from this value for certain operations.
ES_CENTER_SERVER_COTURN_MIN_PORT=20000
# Defines the maximum port number within the range used by the COTURN service.
# COTURN will not allocate ports beyond this value for relevant operations.
ES_CENTER_SERVER_COTURN_MAX_PORT=39999
# TURN username for the COTURN service
ES_CENTER_SERVER_COTURN_TURN_USERNAME=webrtc-1
# TURN credential for the COTURN service
ES_CENTER_SERVER_COTURN_TURN_CREDENTIAL=A7mKp2L9xQ4Zn3T8
 
# ####################################
# ### es-center-server-janus WebRTC Gateway Configuration
# ####################################
# Docker image tag for the Janus service
ES_CENTER_SERVER_JANUS_DOCKER_IMAGE_TAG=0.0.3
# Identifier for the Janus instance
ES_CENTER_SERVER_JANUS_NO=janus-1
# Internal Ethernet interface name for the Janus service
ES_CENTER_SERVER_JANUS_INTERNAL_ETH_NAME=eth0
# Internal IP address of the Janus service
ES_CENTER_SERVER_JANUS_INTERNAL_IP=192.168.0.1
# External IP address of the Janus service
ES_CENTER_SERVER_JANUS_EXTERNAL_IP=192.168.0.1
# Defines the range of ports that the Janus service will use for Real - Time Transport Protocol (RTP) traffic.
# RTP is responsible for the actual transmission of audio and video data.
# The Janus service will allocate ports from 40000 to 59999 for handling RTP streams during media communication.
ES_CENTER_SERVER_JANUS_RTP_PORT_RANGE=40000-59999
 
# ####################################
# ### es-center-server-activemq-artemis Message Queue Configuration
# ####################################
# Docker image tag for the ActiveMQ Artemis service
ES_CENTER_SERVER_ACTIVEMQ_ARTEMIS_DOCKER_IMAGE_TAG=latest
# Username for the ActiveMQ Artemis service
ES_CENTER_SERVER_ACTIVEMQ_ARTEMIS_USER=artemis
# Password for the ActiveMQ Artemis service
ES_CENTER_SERVER_ACTIVEMQ_ARTEMIS_PASSWORD=abcd1234abcd
# TCP port for the ActiveMQ Artemis service
ES_CENTER_SERVER_ACTIVEMQ_ARTEMIS_TCP_PORT=61616
# HTTP port for the ActiveMQ Artemis service
ES_CENTER_SERVER_ACTIVEMQ_ARTEMIS_HTTP_PORT=8161
 
# ####################################
# ### es-center-server-emqx MQTT Message Broker Configuration
# ####################################
# Docker image tag for the EMQX service
ES_CENTER_SERVER_EMQX_DOCKER_IMAGE_TAG=5
# HTTP port for the EMQX service
ES_CENTER_SERVER_EMQX_HTTP_PORT=18083
# HTTPS port for the EMQX service
ES_CENTER_SERVER_EMQX_HTTPS_PORT=8883
# TCP port for the EMQX service
ES_CENTER_SERVER_EMQX_TCP_PORT=1883
# WebSocket port for the EMQX service
ES_CENTER_SERVER_EMQX_WS_PORT=8083
# Secure WebSocket port for the EMQX service
ES_CENTER_SERVER_EMQX_WSS_PORT=8084
# IP address of the EMQX service
ES_CENTER_SERVER_EMQX_IP=192.168.0.1
 
# ####################################
# ### es-center-server-nginx Reverse Proxy Configuration
# ####################################
# Docker image tag for the Nginx service
ES_CENTER_SERVER_NGINX_DOCKER_IMAGE_TAG=stable-alpine
# HTTP port for the Nginx service
ES_CENTER_SERVER_NGINX_HTTP_PORT=80
# HTTPS port for the Nginx service
ES_CENTER_SERVER_NGINX_HTTPS_PORT=443
 
# ####################################
# ### es-center-server-pg Database Cluster Configuration
# ####################################
# Docker image tag for PostgreSQL instance 0
ES_CENTER_SERVER_PG_0_DOCKER_IMAGE_TAG=16.3.0
# Docker image tag for PostgreSQL instance 1
ES_CENTER_SERVER_PG_1_DOCKER_IMAGE_TAG=16.3.0
# Docker image tag for Pgpool service
ES_CENTER_SERVER_PG_PGPOOL_DOCKER_IMAGE_TAG=4.5.2
# Username for Repmgr in PostgreSQL
ES_CENTER_SERVER_PG_REPMGR_USERNAME=repmgr
# Password for Repmgr in PostgreSQL
ES_CENTER_SERVER_PG_REPMGR_PASSWORD=abcd1234abcd
# Password for the 'postgres' user in PostgreSQL
ES_CENTER_SERVER_PG_POSTGRESQL_POSTGRES_PASSWORD=abcd1234abcd
# Username for the application in PostgreSQL
ES_CENTER_SERVER_PG_POSTGRESQL_USERNAME=es
# Password for the application in PostgreSQL
ES_CENTER_SERVER_PG_POSTGRESQL_PASSWORD=abcd1234abcd
# Username for SR check in Pgpool
ES_CENTER_SERVER_PG_PGPOOL_SR_CHECK_USER=repmgr
# Password for SR check in Pgpool
ES_CENTER_SERVER_PG_PGPOOL_SR_CHECK_PASSWORD=abcd1234abcd
# Username for the 'postgres' user in Pgpool
ES_CENTER_SERVER_PG_PGPOOL_POSTGRES_USERNAME=postgres
# Password for the 'postgres' user in Pgpool
ES_CENTER_SERVER_PG_PGPOOL_POSTGRES_PASSWORD=abcd1234abcd
# Admin username for Pgpool
ES_CENTER_SERVER_PG_PGPOOL_ADMIN_USERNAME=admin
# Admin password for Pgpool
ES_CENTER_SERVER_PG_PGPOOL_ADMIN_PASSWORD=abcd1234abcd
# Custom usernames for PostgreSQL in Pgpool
ES_CENTER_SERVER_PG_PGPOOL_POSTGRES_CUSTOM_USERS=es
# Custom passwords for PostgreSQL in Pgpool
ES_CENTER_SERVER_PG_PGPOOL_POSTGRES_CUSTOM_PASSWORDS=abcd1234abcd
# Port for the PostgreSQL service
ES_CENTER_SERVER_PG_PORT=5433
 
# ####################################
# ### es-center-server-redis Cache Service Configuration
# ####################################
# Docker image tag for the Redis service
ES_CENTER_SERVER_REDIS_DOCKER_IMAGE_TAG=7.2.5
# Port for the Redis service
ES_CENTER_SERVER_REDIS_PORT=6379
# Password for the Redis service
ES_CENTER_SERVER_REDIS_PASSWORD=abcd1234abcd
# Maximum memory limit for the Redis service
ES_CENTER_SERVER_REDIS_MAXMEMORY=100mb
# Memory eviction policy for the Redis service, using LRU
ES_CENTER_SERVER_REDIS_MAXMEMORY_POLICY=allkeys-lru
 
# ####################################
# ### es-center-server-main-service Main Service Configuration
# ####################################
# Docker image tag for the main service
ES_CENTER_SERVER_MAIN_SERVICE_DOCKER_IMAGE_TAG=1.20250416
# Java options for the main service, setting memory limits
ES_CENTER_SERVER_MAIN_SERVICE_JAVA_OPTS=-Xmx1024m -Xms512m -Xmn256m -XX:MaxDirectMemorySize=128m -XX:+UseG1GC -XX:MaxGCPauseMillis=200
# Commented-out alternative Java options for the main service with different memory limits
# ES_CENTER_SERVER_MAIN_SERVICE_JAVA_OPTS=-Xmx2048m -Xms1024m -Xmn512m -XX:MaxDirectMemorySize=256m -XX:+UseG1GC -XX:MaxGCPauseMillis=150
# HTTP port for the main service
ES_CENTER_SERVER_MAIN_SERVICE_HTTP_PORT=84
 
# ####################################
# ### es-center-server-device-service Device Service Configuration
# ####################################
# Docker image tag for the device service
ES_CENTER_SERVER_DEVICE_SERVICE_DOCKER_IMAGE_TAG=1.20250416
# Java options for the device service, setting memory limits
ES_CENTER_SERVER_DEVICE_SERVICE_JAVA_OPTS=-Xmx1024m -Xms512m -Xmn256m -XX:MaxDirectMemorySize=128m -XX:+UseG1GC -XX:MaxGCPauseMillis=200
# Commented-out alternative Java options for the device service with different memory limits
# ES_CENTER_SERVER_DEVICE_SERVICE_JAVA_OPTS=-Xmx2048m -Xms1024m -Xmn512m -XX:MaxDirectMemorySize=256m -XX:+UseG1GC -XX:MaxGCPauseMillis=150
# HTTP port for the device service
ES_CENTER_SERVER_DEVICE_SERVICE_HTTP_PORT=86
 
# ####################################
# ### es-center-server-web-app Web Application Configuration
# ####################################
# Docker image tag for the web application
ES_CENTER_SERVER_WEB_APP_DOCKER_IMAGE_TAG=1.20250416
# HTTP port for the web application
ES_CENTER_SERVER_WEB_APP_HTTP_PORT=89

验证安装结果

为确认安装是否成功, 可执行以下操作：

# 系统初次启动需进行数据初始化, 等待 4 分钟后可通过浏览器访问指定 IP 验证安装情况。
# admin 账号的登录密码将在首次登录时生成。
# 示例访问地址：https://192.168.1.33
 
# 检查是否成功导入 Docker 镜像
sudo docker images
 
# 查看是否有 Docker 容器成功运行
sudo docker ps
 
# 检查配置文件是否已复制到目标目录
sudo ls -la /opt/es-center-server-service/
 
# 检查数据目录是否已成功创建
sudo ls -la /var/lib/es-center-server-data/
 
# 查看配置文件内容
sudo cat /opt/es-center-server-service/.env
 
# 查看配置文件内容, 确认占位符是否已被替换为正确的值
sudo cat /opt/es-center-server-service/es-center-server-coturn/etc/coturn/turnserver.conf
# listening-ip=ES_CENTER_SERVER_COTURN_INTERNAL_IP
# relay-ip=ES_CENTER_SERVER_COTURN_INTERNAL_IP
# external-ip=ES_CENTER_SERVER_COTURN_EXTERNAL_IP/ES_CENTER_SERVER_COTURN_INTERNAL_IP
# server-name=ES_CENTER_SERVER_COTURN_DOMAIN_NAME
# realm=ES_CENTER_SERVER_COTURN_DOMAIN_NAME
 
# 查看各个服务的状态
 
sudo docker ps --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}"
 
# 查看各个服务的日志, 确保服务正常运行
 
# es-center-server-coturn WebRTC Traversal Service
sudo docker compose -f /opt/es-center-server-service/es-center-server-coturn/docker-compose.yml logs -f
 
# es-center-server-janus WebRTC Gateway
sudo docker compose -f /opt/es-center-server-service/es-center-server-janus/docker-compose.yml logs -f
 
# es-center-server-activemq-artemis Message Queue
sudo docker compose -f /opt/es-center-server-service/es-center-server-activemq-artemis/docker-compose.yml logs -f
 
# es-center-server-emqx MQTT Message Broker
sudo docker compose -f /opt/es-center-server-service/es-center-server-emqx/docker-compose.yml logs -f
 
# es-center-server-nginx Reverse Proxy
sudo docker compose -f /opt/es-center-server-service/es-center-server-nginx/docker-compose.yml logs -f
 
# es-center-server-pg Database Cluster
sudo docker compose -f /opt/es-center-server-service/es-center-server-pg/docker-compose.yml logs -f
 
# es-center-server-redis Cache Service
sudo docker compose -f /opt/es-center-server-service/es-center-server-redis/docker-compose.yml logs -f
 
# es-center-server-main-service Main Service
sudo docker compose -f /opt/es-center-server-service/es-center-server-main-service/docker-compose.yml logs -f
 
# es-center-server-device-service Device Service
sudo docker compose -f /opt/es-center-server-service/es-center-server-device-service/docker-compose.yml logs -f
 
# es-center-server-web-app Web Application
sudo docker compose -f /opt/es-center-server-service/es-center-server-web-app/docker-compose.yml logs -f

安装后配置更新或升级

修改配置文件

安装成功后, 可通过修改配置文件更新配置, 具体步骤如下：

# 使用 vim 或 nano 编辑器修改配置文件中 `# custom` 部分的内容, 其余部分保持不变
sudo vi /opt/es-center-server-service/.env
sudo nano /opt/es-center-server-service/.env
 
# 完成修改后, 进入服务目录并执行更新脚本
cd /opt/es-center-server-service
sudo ./cli update-server
 
# 验证各个服务中的配置是否已更新
sudo cat /opt/es-center-server-service/es-center-server-coturn/etc/coturn/turnserver.conf
sudo cat /opt/es-center-server-service/es-center-server-janus/opt/janus/etc/janus/janus.transport.mqtt.jcfg
sudo cat /opt/es-center-server-service/es-center-server-nginx/etc/nginx/conf.d/default.conf
sudo cat /opt/es-center-server-service/es-center-server-web-app/etc/nginx/conf.d/default.conf

更新或申请 SSL 证书

要更新或申请服务器的 SSL 证书, 请按照以下步骤操作：

  1. 确保配置文件中已正确配置域名。
  2. 执行以下命令调用 certbot 来生成新的 SSL 证书, 并将其应用于服务器。
# 更新并生成 SSL 证书
cd /opt/es-center-server-service
sudo ./cli update-server-ssl
 
# 在命令行界面打印以下信息时, 请按一下回车键：
#
# Account registered.
# Requesting a certificate for zxs-cs.netbodycamera.com

升级服务

# 创建升级目录, 此目录路径可依据实际情况灵活设定
sudo mkdir -p /tmp/es-center-server-upgrade-app
 
# 把下载的升级包解压至指定的升级目录
sudo tar -xzvf es-center-server-upgrade-app-master-1.0.202504161818.tar.gz -C /tmp/es-center-server-upgrade-app
 
# 查看解压后升级目录里各文件和文件夹的大小
sudo du -sh /tmp/es-center-server-upgrade-app/*
 
# 进入升级目录并执行升级脚本以完成升级。
# 必须指定已安装的服务根目录 `service-root-dir`, 若该目录不存在或者目录下没有 .env 文件, 升级将停止
cd /tmp/es-center-server-upgrade-app
sudo ./cli upgrade-server \
--service-root-dir /opt/es-center-server-service

独立部署 Coturn 服务

# 通过分布式部署 Coturn 服务, 分担直播转发的流量压力。
# 创建 Coturn 服务的安装目录
sudo mkdir -p /tmp/es-center-server-coturn-service-install-app
 
# 将安装包解压到指定目录
sudo tar -xzvf es-center-server-coturn-service-install-app-master-1.0.202504161818.tar.gz -C /tmp/es-center-server-coturn-service-install-app
 
# 进入安装目录
cd /tmp/es-center-server-coturn-service-install-app
 
# 执行安装脚本完成 Coturn 服务的安装
sudo ./cli install-server-coturn-service \
--service-root-dir /opt/es-center-server-coturn-service \
--internal-eth-name eth0 \
--internal-ip 172.16.8.178 \
--external-ip 120.26.124.232 \
--domain-name zxs-cs-coturn.netbodycamera.com
 
# 安装后的常用检查方式
# 查看服务的日志, 确保服务正常运行
sudo docker compose -f /opt/es-center-server-coturn-service/es-center-server-coturn/docker-compose.yml logs -f
 
# 根据实际情况, 修改配置文件并更新服务
cd /opt/es-center-server-coturn-service
sudo nano .env
sudo ./cli update-server

独立部署 Janus 服务

# 通过分布式部署 Janus 服务, 分担 WEBRTC SFU 的流量压力。
# 创建 Janus 服务的安装目录
sudo mkdir -p /tmp/es-center-server-janus-service-install-app
 
# 将安装包解压到指定目录
sudo tar -xzvf es-center-server-janus-service-install-app-master-1.0.202504161818.tar.gz -C /tmp/es-center-server-janus-service-install-app
 
# 进入安装目录
cd /tmp/es-center-server-janus-service-install-app
 
# 执行安装脚本完成 Janus 服务的安装
sudo ./cli install-server-janus-service \
--service-root-dir /opt/es-center-server-janus-service \
--internal-eth-name eth0 \
--internal-ip 172.16.8.178 \
--external-ip 120.26.124.232 \
--janus-server-no janus-1 \
--emqx-ip 172.16.8.178 \
--emqx-tcp-port 1883 \
--coturn-external-ip 120.26.124.233
 
# 安装后的常用检查方式
# 查看服务的日志, 确保服务正常运行
sudo docker compose -f /opt/es-center-server-janus-service/es-center-server-janus/docker-compose.yml logs -f
 
# 根据实际情况, 修改配置文件并更新服务
cd /opt/es-center-server-janus-service
sudo nano .env
sudo ./cli update-server
Last updated on
v1.0.202504151416v1.1.0-202507151703