Jabra Xpress 镜像文档

概述和主要用途

Jabra Xpress是专为IT专业人士设计的软件解决方案，用于通过一系列智能工具远程管理Jabra产品。该解决方案支持两种部署方式：云服务（通过访问[***] Xpress解决方案以Docker镜像形式提供，可在任何支持Docker的环境中部署。

核心功能和特性

• 远程设备管理：IT管理员可远程配置、监控和管理Jabra设备
• 多组件架构：由多个协同工作的Docker镜像组成，提供完整功能
• 灵活部署：支持云托管或本地Docker自托管
• 数据存储与分析：依赖MongoDB和SQL数据库存储配置与分析数据
• 版本兼容性：建议使用相同版本的镜像以确保功能正常，部分组件（如fds.api和jabra-xpress-assets）有独立版本控制

完整部署组件

必需组件

完整的Jabra Xpress部署包含以下Docker镜像：

• gnaudio/fds.api
• gnaudio/jabra-xpress-analytics
• gnaudio/jabra-xpress-assets
• gnaudio/jabra-xpress-analytics-cron
• gnaudio/jabra-xpress-api
• gnaudio/jabra-xpress-frontend

此外，部署还需要两个数据库：

• MongoDB
• SQL数据库（Microsoft SQL Server 2017+或Azure SQL Database）

注意：建议所有镜像使用相同版本。不同版本的镜像混合使用可能导致功能异常，但fds.api和jabra-xpress-assets除外，它们有独立的版本控制。

可选服务

部分功能需要额外镜像支持，未部署这些镜像将导致对应功能禁用：

• gnaudio/jabra-xpress-cron-compliancereporter（合规报告功能）

资源依赖

*：请始终检查镜像页面获取最新可用标签。此处版本已确认可正常工作，但如需特定资源可使用更新版本。
**：使用latest标签时，请确保部署已正确更新。在某些环境中，latest标签可能无法自动更新容器。

服务设置

必需环境变量

以下设置是服务运行所必需的：

可选环境变量

使用方法

使用Docker Compose运行

若使用docker-compose部署Jabra Xpress，可将以下服务添加到docker-compose文件（替换相关值）：

yaml
  backend:
    image: gnaudio/jabra-xpress-api:v5.7.02901
    environment:
    - "ConnectionStrings:XpressDatabaseSqlServer=SQL_CONNECTION-STRING_HERE"
    - "ConnectionStrings:MongoDb=MONGODB_CONNECTIONSTRING_HERE"
    - "DefaultAnalyticsEndpoint=http://localhost:88/api/v1/analytics"
    - "JDODownload=http://localhost:89/"
    - "NetworkEndpoint=http://localhost:85"
    - "SDK:fwURL_base=http://localhost:82"
    - "SDK:fsURL_base=http://localhost:82"
    - "Security:PackageTokens:IssuerKey=9716702363504e4aaf47fa5bb2ec5c42"
    - "Security:ClientTokens:IssuerKey=ea99bbe6471848848b138ecb99e52d1f"
    - "Security:TokenProtection:Key=qt59#1dlZgsw3Tjv8eWyoQm$ib4u*O7N_"
    - "ASPNETCORE_URLS=[***]"
    ports:
    - "85:8080"

使用Docker Run运行

若使用docker run命令部署：

bash
docker run -p 85:8080 -d \
  --env ConnectionStrings:XpressDatabaseSqlServer="SQL_CONNECTION-STRING_HERE" \
  --env ConnectionStrings:MongoDb="MONGODB_CONNECTIONSTRING_HERE" \
  --env DefaultAnalyticsEndpoint="http://localhost:88/api/v1/analytics" \
  --env JDODownload="http://localhost:89/" \
  --env NetworkEndpoint="http://localhost:85" \
  --env SDK:fwURL_base="http://localhost:82" \
  --env SDK:fsURL_base="http://localhost:82" \
  --env Security:PackageTokens:IssuerKey="9716702363504e4aaf47fa5bb2ec5c42" \
  --env Security:ClientTokens:IssuerKey="ea99bbe6471848848b138ecb99e52d1f" \
  --env Security:TokenProtection:Key="qt59#1dlZgsw3Tjv8eWyoQm$ib4u*O7N_" \
  --env ASPNETCORE_URLS=[***] \
  gnaudio/jabra-xpress-api:v5.7.02901

完整部署指南

系统要求

• SQL数据库：Microsoft SQL Server 2017或更高版本（任何SKU）或Azure SQL Database，初始数据库大小建议小于20GB
• Docker环境：Linux Docker托管环境（测试环境可使用Windows/Linux/macOS的Docker CE）
• 内存：16GB RAM

部署注意事项

• Jabra Xpress实例由多个镜像组成，可部署在单台或多台机器上
• 部分镜像存在依赖关系，需确保正确配置
• 保持所需镜像版本一致，混合不同版本的前端和后端可能导致功能异常
• gnaudio/jabra-xpress-analytics-cron仅需运行1个实例，多个实例可能导致数据覆盖

SQL数据库配置

1. 准备SQL连接字符串

示例连接字符串：

"Server=tcp:sqlserver,1433;Initial Catalog=xpress;User ID=USERID;Password=USER-PASSWORD;Connection Timeout=30;"

2. 创建数据库架构

使用数据库工具创建架构：gnaudio/jabra-xpress-databaseconsoletool

运行该镜像时指定SQL连接字符串，执行数据库迁移。无错误输出则表示架构创建成功。

使用Docker Compose完整部署

详情请参考前端镜像文档：gnaudio/jabra-xpress-frontend

版本信息

最新版本

v5.7.02901（2025年2月）

发布说明：[***]

历史版本

v5.5.26802

完整部署所需其他镜像：

v5.4.240011

完整部署所需其他镜像：

v5.3.09401

完整部署所需其他镜像：

v5.1.***

完整部署所需其他镜像：

v5.0.***

完整部署所需其他镜像：

重大变更：

• 服务设置变更，部署前需更新docker-compose或容器配置：

  设置	变更
  NetworkEndpoint	值格式变更：移除URL中的/api/Xpress/Network/部分
  Security:PackageTokens:IssuerKey	新增设置
  Security:ClientTokens:IssuerKey	新增设置
  Security:TokenProtection:Key	新增设置

v4.20.05402

完整部署所需其他镜像：

v4.17.54803

完整部署所需其他镜像：

发布说明

• Jabra Xpress发布说明：[***]
• Jabra Direct发布说明：[***]