v1.0.2-202505221751

修改日志

janus 安装程序
- 修复自测时发现的问题：
  - 修复 coturn-external-ip 参数未生效的问题。
  - 修复 ES_CENTER_SERVER_COTURN_DOMAIN_NAME 内部替换配置变量未设置的问题。

补充说明

自测过程

服务器信息：
- 142.171.225.20 为石总购买的美国 racknerd 服务器, 已绑定域名 zxs-dev.netbodycamera.com, ext-doc.netbodycamera.com, int-doc.netbodycamera.com, weekly-report.netbodycamera.com, redmine.netbodycamera.com。
- 120.26.124.232 是阿里云国内服务器, 已绑定域名 zxs-cs.netbodycamera.com。
- 47.121.142.93 是阿里云国内服务器, 已绑定域名 zxs.netbodycamera.com。
服务部署调整：原部署在 142.171.225.20 上的整套中心服务平台已移除, 目前该服务器仅部署 coturn 和 janus 服务。
janus 服务配置：在 142.171.225.20 上部署 janus 服务, 并配置其 mqtt 连接至 120.26.124.232 用于使用 zxs-cs.netbodycamera.com 自测。为避免冲突, 将此 janus 服务编号设置为 janus-2, 因为在 120.26.124.232 上已有编号为 janus-1 的 janus 实例。
管理员登录 zxs-cs.netbodycamera.com 上添加或修改配置
- 进入 Configuration > Data dictionary 菜单, 添加或修改 webrtc-config 数据字典类型下的各项数据字典项：
  - Data dictionary type code：webrtc-config, Data dictionary code：janusNo, Value：janus-2
若后续需要支持 zxs.netbodycamera.com 的 SFU 房间模式转发, 需重新安装 janus 服务, 并将 MQTT 配置为连接至 47.121.142.93。具体操作是将安装参数 --emqx-ip 120.26.124.232 替换为 --emqx-ip 47.121.142.93。

测试说明

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

测试步骤

下载安装包并安装


# 通过 scp 获取
scp root@47.121.142.93:/home/tmp/es-center-server-*-app-1.0.2-202505221751.tar.gz .
 
# 创建安装目录, 路径可根据实际需求灵活调整
sudo mkdir -p /tmp/es-center-server-install-app
 
# 将下载的安装包解压到指定的安装目录
sudo tar -xzvf es-center-server-install-app-1.0.2-202505221751.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
 
# 显示 docker 实例信息
sudo docker ps --format "table {{.ID}}\t{{.Names}}\t{{.Image}}\t{{.Status}}"

安装成功后, 导入词条:

平台支持随时导入词条, 以便于新增或修改词条内容。

词条文件下载链接：

在中心服务平台成功安装后, 请使用管理员账号登录系统, 并导入中文词条文件。

导入完成后, 请等待大约3分钟, 然后刷新页面。随后, 您可以测试平台的中英文切换功能。

更新或申请 SSL 证书

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

确保配置文件中已正确配置域名。
执行以下命令调用 certbot 来生成新的 SSL 证书, 并将其应用于服务器。


# 更新并生成 SSL 证书
cd /opt/es-center-server-service
sudo ./cli update-server-ssl
 
# 在命令行界面打印以下信息时, 请按一下回车键：
#
# Account registered.
# Requesting a certificate for 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

升级服务


# 通过 wget 下载
wget https://zxs-dev.netbodycamera.com/download/es-center-server-upgrade-app-1.0.2-202505221751.tar.gz
 
# 创建升级目录, 此目录路径可依据实际情况灵活设定
sudo mkdir -p /tmp/es-center-server-upgrade-app
 
# 把下载的升级包解压至指定的升级目录
sudo tar -xzvf es-center-server-upgrade-app-1.0.2-202505221751.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 服务


# 通过 wget 下载
wget https://zxs-dev.netbodycamera.com/download/es-center-server-coturn-service-install-app-1.0.2-202505221751.tar.gz
 
# 通过分布式部署 Coturn 服务, 分担直播转发的流量压力。
# 创建 Coturn 服务的安装目录
sudo mkdir -p /tmp/es-center-server-coturn-service-install-app
 
# 将安装包解压到指定目录
# cd /var/lib/es-dev-server-data/es-dev-server-nginx/zxs-dev/download/
sudo tar -xzvf es-center-server-coturn-service-install-app-1.0.2-202505221751.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 142.171.225.20 \
--external-ip 142.171.225.20 \
--domain-name zxs-dev.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 服务


# 通过 wget 下载
wget https://zxs-dev.netbodycamera.com/download/es-center-server-janus-service-install-app-1.0.2-202505221751.tar.gz
 
# 通过分布式部署 Janus 服务, 分担 WEBRTC SFU 的流量压力。
# 创建 Janus 服务的安装目录
sudo mkdir -p /tmp/es-center-server-janus-service-install-app
 
# 将安装包解压到指定目录
# cd /var/lib/es-dev-server-data/es-dev-server-nginx/zxs-dev/download/
sudo tar -xzvf es-center-server-janus-service-install-app-1.0.2-202505221751.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 142.171.225.20 \
--external-ip 142.171.225.20 \
--janus-server-no janus-2 \
--emqx-ip 120.26.124.232 \
--emqx-tcp-port 1883 \
--coturn-external-ip 142.171.225.20
 
# 安装后的常用检查方式
# 查看服务的日志, 确保服务正常运行
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