Skip to Content
工作文档周报2025年度总结2025年03月10日

2025年03月10日

上周工作回顾

中心服务平台

越南版本定制化

  • 目标：完成越南版安装程序的主体功能开发。
  • 当前进度：已完成 50%。

KH2248 项目

Web 定制开发

  • 目标：在 2025 年 3 月 12 日前完成核心功能的开发。
  • 当前进度：已完成 25%。

本周工作计划

KH2248 项目

Web 定制开发

  • 目标：在 2025 年 3 月 12 日前达成核心功能的开发目标。
  • 预期进度：完成 100%。

中心服务平台

越南版本定制化

  • 目标：持续推进越南版安装程序主体功能的开发工作。
  • 预期进度：完成 90%。

日常协作事宜

以下为当前需要协作完成的关键任务列表, 姚海涛作为主要协助人员, 将全力支持各位同事开展相关工作, 以保障项目的高效推进。

接口联调与文档优化

协助郭工进行应用接口的联调工作, 并对相关接口文档进行补充与优化, 确保文档内容准确、规范, 便于理解和使用。 协助对象：郭工

KH2248 项目技术支持

为韦工提供 KH2248 项目的技术支持, 协助解决设备中 WEB 前端的定制开发, 推动项目按计划顺利实施。 协助对象：韦工

WebRTC 服务交接支持

协助孙工完成 WebRTC 服务的开发交接工作, 并在后续提供必要的技术咨询与讨论支持, 确保服务平稳过渡并保持稳定运行。 协助对象：孙工

前后端联调工作

协助绍工完成中心服务平台后端接口与前端的联调工作, 确保系统功能完整、运行稳定, 为平台上线做好充分准备。 协助对象：绍工

平台使用咨询服务

协助王工为中心服务平台提供使用支持服务, 帮助用户解决在使用过程中遇到的问题, 提升用户体验和满意度。 协助对象：王工

本周工作进度

优先级：紧急但非重要

越南版本定制化（中心服务平台）

  • 时间范围：原计划从 2025 年 2 月 27 日至 2025 年 3 月 12 日, 现调整为 2025 年 2 月 27 日至 2025 年 3 月 25 日。自 2025 年 3 月 7 日起, 优先推进 KH2248 项目的开发工作, 实际进度将根据 KH2248 项目的进展情况以及协作事项进行动态调整。
  • 当前进度：已完成 60%。
  • 核心要求：
    • 采用单一配置文件对所有配置项进行集中管理。
    • 确保系统架构的简洁性。
已完成工作
  1. 基础环境搭建
    • 部署 ProxmoxVE 虚拟化平台, 作为基础设施的核心支撑。
    • 创建 Ubuntu Server 24.04.2 LTS 模板系统, 以确保环境的一致性和实现快速部署。
    • 制作 Docker 及 Docker Compose 离线安装包, 以满足离线场景下的容器化需求。
进行中任务
  1. 组件安装包开发
    • 构建转发服务独立离线安装包。
    • 构建 WebRTC SFU（Janus）独立离线安装包。
  2. 验证测试
    • 在 ProxmoxVE 虚拟化平台中, 通过 Ubuntu Server 24.04.2 LTS 模板系统克隆开发环境（为便于问题排查, 可根据实际需求进行多次克隆）。
    • 在 ProxmoxVE 虚拟化平台中, 通过 Ubuntu Server 24.04.2 LTS 模板系统克隆测试环境（为便于问题排查, 可根据实际需求进行多次克隆）。
    • 验证云环境安装（WebRTC 直播功能）。
  3. 文档编写
    • 编写防火墙配置指南（涵盖 Web/转发/SFU 服务）。
    • 编写安装手册。
越南版专项开发
后端改造
  • 实现越南语词条的本地化（数据库初始化脚本）。
  • 将配置参数迁移至数据库进行管理（包含管理界面）。
  • 优化数据库备份机制。
前端改造
  • 移除手机/邮箱相关功能模块。
  • 精简国际化支持, 仅保留英/越双语。
  • 将地图服务替换为 Google Maps。
  • 精简功能模块, 移除历史回放等非必要菜单。
  • 更新品牌标识, 集成 Sentinel 徽标及图标。
越南客户需求清单
  1. 本地化部署要求
    • 采用独立的越南服务器, 与中国区实现物理隔离。
    • 进行数据本地化存储, 禁止跨境传输。
  2. 功能定制
    • 移除中国区地图服务及 IP 相关功能。
  3. 品牌展示
    • 在系统启动界面添加 Sentinel 标识。
    • 在摄像头界面植入新型号标识。
    • 定制设备贴纸（Sentinel 版本）。

优先级：重要且紧急

KH2248 项目开发

  • 时间范围：2025 年 3 月 7 日至 2025 年 3 月 13 日。
  • 当前进度：已完成 100%。
  • 里程碑目标：在 2025 年 3 月 12 日前完成核心功能的开发。
任务跟踪
  • 完成 4G/WiFi 页面多语言支持：#61956 
  • 完成 WLAN AP 接口翻译：#61966 
  • 完成 WiFi 配置页面翻译：#62008 
  • 完成 IP 地址输入校验优化
  • 完成 WiFi 信号强度分级显示（≤25: 低 | 25-50: 正常 | 50-75: 中等 | >75: 高）
  • 完成 MQTT 配置同步提示：#62026 
  • 完成 恢复出厂设置格式化提示：#62158 
  • 完成 设备激活配置初始化：#62215 
  • 完成 WiFi 密码错误处理：#62209 

测试说明

以下是针对 Ubuntu Server 24.04.2 LTS 的测试安装程序的详细步骤。

测试步骤

1. 下载安装包

从共享目录下载安装包：

# 安装 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-1.0.20250314.tar.gz ./es-center-server-install-app-1.0.20250314.tar.gz
quit
EOF

2. 检查安装包完整性

确认下载的安装包是否完整：

du -sh ./es-center-server-install-app-*.gz

3. 解压安装包

将安装包解压到目标目录：

# 创建安装目录, 可根据实际情况修改安装目录
sudo mkdir -p /home/es/test/es-center-server-install-app
 
# 解压安装包
sudo tar -xzvf es-center-server-install-app-1.0.20250314.tar.gz -C /home/es/test/es-center-server-install-app
 
# 检查解压后的内容
sudo du -sh /home/es/test/es-center-server-install-app/*

4. 执行安装脚本

根据实际情况指定安装服务的目录、保存数据的目录、内网 IP、公网 IP、域名。进入安装目录并运行安装脚本：

cd /home/es/test/es-center-server-install-app
sudo ./cli install-server \
--service-root-dir /home/es/test/custom-service \
--data-root-dir /home/es/test/custom-data \
--internal-ip 192.168.1.217 \
--external-ip 192.168.1.217 \
--domain-name es-debug-217.good-tools.tech

5. 验证安装结果

验证安装是否成功：

# 等待 4 分钟后（系统初次启动需要初始化数据）, 可通过浏览器访问 http://192.168.1.217 或 https://外网 IP 或内网 IP, 例如：https://192.168.1.217
# admin 帐号的登录密码将通过第一次登录输入的登录密码生成
 
# 测试工具的帮助说明
sudo ./cli --help
sudo ./cli install-server --help
 
# 查看是否成功导入 Docker 镜像
sudo docker images
 
# 查看是否成功运行 Docker 实例
sudo docker ps
 
# 检查配置文件是否已复制到目标目录
sudo ls -la /home/es/test/custom-service/
 
# 检查已创建数据目录
sudo ls -la /home/es/test/custom-data/
 
# 查看配置文件内容
sudo cat /home/es/test/custom-service/.env
 
# 查看配置文件内容, 检查占位符是否被替换为正确的值
sudo cat /home/es/test/custom-service/es-center-server-coturn/etc/coturn/turnserver.conf
 
# listening-ip=INTERNAL_IP
# relay-ip=INTERNAL_IP
# external-ip=EXTERNAL_IP/INTERNAL_IP
# server-name=DOMAIN_NAME
# realm=DOMAIN_NAME
 
# 查看各服务的日志
sudo docker compose -f /home/es/test/custom-service/es-center-server-activemq-artemis/docker-compose.yml logs -f
sudo docker compose -f /home/es/test/custom-service/es-center-server-coturn/docker-compose.yml logs -f
sudo docker compose -f /home/es/test/custom-service/es-center-server-device-service/docker-compose.yml logs -f
sudo docker compose -f /home/es/test/custom-service/es-center-server-emqx/docker-compose.yml logs -f
sudo docker compose -f /home/es/test/custom-service/es-center-server-janus/docker-compose.yml logs -f
sudo docker compose -f /home/es/test/custom-service/es-center-server-main-service/docker-compose.yml logs -f
sudo docker compose -f /home/es/test/custom-service/es-center-server-nginx/docker-compose.yml logs -f
sudo docker compose -f /home/es/test/custom-service/es-center-server-pg/docker-compose.yml logs -f
sudo docker compose -f /home/es/test/custom-service/es-center-server-redis/docker-compose.yml logs -f
sudo docker compose -f /home/es/test/custom-service/es-center-server-web-app/docker-compose.yml logs -f

安装成功后, 通过修改配置文件的方式更新配置

# 使用 vim 或 nano 修改配置文件中 # custom 这部分的配置, 其他部分的配置保持不变
sudo vi /home/es/test/custom-service/.env
sudo nano /home/es/test/custom-service/.env
 
# 修改好之后
cd /home/es/test/custom-service
sudo ./cli update-server
 
# 验证各服务中的配置是否修改
sudo cat /home/es/test/custom-service/es-center-server-coturn/etc/coturn/turnserver.conf
sudo cat /home/es/test/custom-service/es-center-server-janus/opt/janus/etc/janus/janus.transport.mqtt.jcfg
sudo cat /home/es/test/custom-service/es-center-server-nginx/etc/nginx/conf.d/default.conf
sudo cat /home/es/test/custom-service/es-center-server-web-app/etc/nginx/conf.d/default.conf

配置 SSL 证书方式

申请好证书后操作

# 替换证书文件路径
sudo \cp xxx.key /home/es/test/custom-service/es-center-server-nginx/etc/nginx/cert/ssl_certificate.key
sudo \cp xxx.pem /home/es/test/custom-service/es-center-server-nginx/etc/nginx/cert/ssl_certificate.pem
 
# 根据证书供应商文档修改配置文件
sudo nano /home/es/test/custom-service/es-center-server-nginx/etc/nginx/conf.d/ssl_settings.conf
 
# 修改好之后, 重启 nginx 服务
sudo docker compose -f /home/es/test/custom-service/es-center-server-nginx/docker-compose.yml down
sudo docker compose -f /home/es/test/custom-service/es-center-server-nginx/docker-compose.yml up -d
 
# 查看日志, 判断是否成功
sudo docker compose -f /home/es/test/custom-service/es-center-server-nginx/docker-compose.yml logs -f

常见问题

1. 安装过程中提示权限不足？

确保以 sudo 权限运行安装脚本。若问题仍然存在, 请检查用户的权限设置。

2. Docker 镜像加载失败？

请检查 ./install-install-package 目录下是否存在有效的 .deb 文件或 Docker 镜像文件。若文件缺失, 请重新下载安装包。

如有任何疑问或问题, 请参考相关文档或联系技术支持人员。

Last updated on
2025年03月03日2025年03月17日