Jabra Xpress 前端镜像

什么是Jabra Xpress

Jabra Xpress是专为IT专业人员设计的软件解决方案，通过一系列智能工具远程管理Jabra产品。更多信息请访问[]
Jabra Xpress可作为云服务使用（访问并注册Jabra托管实例[] 管理员版。

注意：v5.4.24001后的重大变更
必须使用SSL/安全连接，且需要第一方Cookie。此变更为安全增强措施，所有凭据均需通过证书验证的连接与后端容器通信。此后，本地存储不再保存凭据。此变更要求配置受信任的SSL证书。更多配置信息请参见SSL配置部分。

免责声明

Docker可用性和许可声明：

• 企业和客户需自行确认Docker是否适用于其特定系统。
• 有关许可的任何问题，请直接联系Docker支持。
• Jabra支持无法为本地IT系统提供指导，且对非先决条件中指定的解决方案的支持将受限。

Nginx证书支持：

• docker-compose.yml示例仅提及.pem格式，但Nginx支持的所有证书格式均适用。有关证书相关支持，请查阅Nginx***文档。

系统要求

完整的Jabra Xpress设置需要SQL数据库来存储Xpress用户账户和配置。以下提供的Docker示例不包含此设置，需单独使用首选方式部署。

先决条件：

• 已准备好使用SQL Server身份验证的空Microsoft SQL Server数据库。支持Microsoft SQL Server 2017或更高版本（任何SKU）或Azure SQL数据库。典型数据库大小小于20GB。
• Linux Docker宿主环境。测试环境可使用运行Docker CE的Windows/Linux桌面系统（部署指南：[***]
• 内存要求：16GB RAM。

完整Jabra Xpress设置

完整的Jabra Xpress设置包含以下镜像：

• FDS
• Analytics
• Assets
• Analytics Cron
• Backend
• [***]

此外，设置还需两个数据库：

• MongoDB
• SQL数据库

使用相同版本的镜像可获得最佳效果。混合使用不同版本的镜像可能导致解决方案无法正常工作。例外情况：fds.api和jabra-xpress-assets有独立的版本控制。

可选服务

部分功能需要额外部署以下镜像。不部署此镜像将导致对应功能禁用：

• [***]

资源依赖

(*) 请始终在镜像页面查看最新可用标签。此处提及的版本已确认可用于本设置，但如需特定资源，可使用更新版本。

(**) 使用latest标签时，需确认部署中镜像已正确更新。在某些环境中，latest标签可能无法正常工作，导致Docker容器无法自动更新。

最新版本的Jabra Xpress前端

v5.7.02901

2025年2月11日

性能和稳定性改进

更多发布说明，请参见[***]

服务设置

服务运行所需的设置如下：

运行镜像

若Jabra Xpress已通过docker-compose部署，可将以下服务添加到docker-compose文件中，并替换相关值：

yaml
  frontend:
    image: gnaudio/jabra-xpress-frontend:v5.7.02901
    environment:
    - "ENDPOINT=http://localhost:85"
    ports:
    - "80:80"

若使用docker run部署，命令如下：

bash
docker run -p 80:80 -d --env ENDPOINT="http://localhost:85" gnaudio/jabra-xpress-frontend:v5.7.02901

---

完整Xpress设置

---

注意事项

• Jabra Xpress实例由多个镜像组成，可部署在多台机器或单台机器上。
• 部分镜像依赖其他镜像才能正常运行。
• 保持所需镜像版本一致。例如，混合使用不同版本的前端和后端可能导致无法正常工作。
• gnaudio/jabra-xpress-analytics-cron仅需运行1个实例，多实例可能导致数据被覆盖。

发布说明

• [***]
• [***]

SQL数据库

除以下步骤外，可访问[***]

在部署Docker镜像的机器上，为用户添加SQL连接字符串：

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

创建数据库架构

访问[***]

按照迁移步骤操作。若操作完成且无错误输出，可继续下一步。

使用docker-compose设置Xpress

单台机器部署Jabra Xpress可通过以下docker-compose配置实现。此配置包含完整的服务设置，所有所需服务均以Docker容器形式提供。

SSL配置

免责声明： 以下配置仅为指导。具体设置高度依赖基础设施。若无本地配置专业知识，建议使用云版Xpress。

自v5.4.24001起，SSL为必填项。docker-compose需更新以包含Nginx（或其他网关服务器）作为API网关。

Nginx网关配置文件：

conf
events {
    worker_connections  4096;  ## 默认：1024
}
http {
    server { 
        listen                  443 ssl;
        listen                  [::]:443 ssl;
        server_name             localhost;
        ssl_certificate         /etc/nginx/server.pem;
        ssl_certificate_key     /etc/nginx/server.key;

        location / {
            proxy_pass "[***]";
            proxy_http_version 1.1;
            proxy_set_header Upgrade $http_upgrade;
            proxy_set_header Connection "upgrade";
            proxy_set_header Host $host;
        }

        location /api/ {
            proxy_pass "[***]";
            proxy_http_version 1.1;
            proxy_set_header Upgrade $http_upgrade;
            proxy_set_header Connection "upgrade";
            proxy_set_header Host $host;
        }

        location /fds/ {
            proxy_pass "[***]";
            proxy_http_version 1.1;
            proxy_set_header Upgrade $http_upgrade;
            proxy_set_header Connection "upgrade";
            proxy_set_header Host $host;
        }

        location /analytics/ {
            proxy_pass "[***]";
            proxy_http_version 1.1;
            proxy_set_header Upgrade $http_upgrade;
            proxy_set_header Connection "upgrade";
            proxy_set_header Host $host;
        }

        error_page   500 502 503 504  /50x.html;

    }
}

SSL配置的docker-compose.yml

yaml
services:
  nginx:
    image: nginx:latest
    volumes:
      - ¤FILE-PATH¤/nginx.conf:/etc/nginx/nginx.conf
      - ¤CERTIFICATE-PATH¤/¤CERTIFICATE-FILE¤.pem:/etc/nginx/server.pem
      - ¤CERTIFICATE-PATH¤/¤CERTIFICATE-FILE¤.key:/etc/nginx/server.key
    command: [nginx-debug, "-g", "daemon off;"]
    ports:
      - "443:443"

  mongodb:
    image: mongo:latest

  assets:
    image: gnaudio/jabra-xpress-assets:v¤CONTAINER-VERSION¤

  frontend:
    image: gnaudio/jabra-xpress-frontend:v¤CONTAINER-VERSION¤
    environment:
    - "ENDPOINT=[***]"
    ports:
    - "80:80"

  backend:
    image: gnaudio/jabra-xpress-api:v¤CONTAINER-VERSION¤
    environment:
    - "ConnectionStrings:XpressDatabaseSqlServer=¤CONNECTION-STRING¤"
    - "ConnectionStrings:MongoDb=mongodb://mongodb/raw"
    - "DefaultAnalyticsEndpoint=[***]"
    - "JDODownload=[***]"
    - "NetworkEndpoint=[***]"
    - "SDK:fwURL_base=[***]"
    - "SDK:fsURL_base=[***]"
    - "Security:PackageTokens:IssuerKey=¤SET_CUSTOM_VALUE¤"
    - "Security:ClientTokens:IssuerKey=¤SET_CUSTOM_VALUE¤"
    - "Security:TokenProtection:Key=¤SET_CUSTOM_VALUE¤"
    - "ASPNETCORE_URLS=[***]"
    ports:
    - "85:8080"
    depends_on:
    - mongodb
    - assets
    - sdkbackend
    restart: on-failure

  sdkbackend:
    image: gnaudio/fds.api:¤CONTAINER-VERSION¤
    environment:
    - "Storage:SDKCopyUrl=[***]"
    ports:
    - "82:80"

  analytics:
    image: gnaudio/jabra-xpress-analytics:v¤CONTAINER-VERSION¤
    environment:
    - "ConnectionStrings:MongodbServer=mongodb://mongodb/raw"
    - "Security:PackageTokens:IssuerKey=¤SET_CUSTOM_VALUE¤"
    - "Security:ClientTokens:IssuerKey=¤SET_CUSTOM_VALUE¤"
    - "Security:TokenProtection:Key=¤SET_CUSTOM_VALUE¤"
    ports:
    - "88:8080"
    depends_on:
    - mongodb

  analytics-cron:
    image: gnaudio/jabra-xpress-analytics-cron:v¤CONTAINER-VERSION¤
    environment:
    - "MONGODBCONNECTIONSTRING=mongodb://mongodb/raw"
    depends_on:
    - mongodb

v5.4.24001之前的无SSL配置docker-compose.yml

yaml
version: '3.8'

services:

  mongodb:
    image: mongo:latest

  assets:
    image: gnaudio/jabra-xpress-assets:v¤CONTAINER-VERSION¤

  frontend:
    image: gnaudio/jabra-xpress-frontend:v¤CONTAINER-VERSION¤
    environment:
    - "ENDPOINT=[***]"
    ports:
    - "80:80"

  backend:
    image: gnaudio/jabra-xpress-api:v¤CONTAINER-VERSION¤
    environment:
    - "ConnectionStrings:XpressDatabaseSqlServer=¤CONNECTION-STRING¤"
    - "ConnectionStrings:MongoDb=mongodb://mongodb/raw"
    - "DefaultAnalyticsEndpoint=[***]"
    - "JDODownload=[***]"
    - "NetworkEndpoint=[***]"
    - "SDK:fwURL_base=[***]"
    - "SDK:fsURL_base=[***]"
    - "Security:PackageTokens:IssuerKey=¤SET_CUSTOM_VALUE¤"
    - "Security:ClientTokens:IssuerKey=¤SET_CUSTOM_VALUE¤"
    - "Security:TokenProtection:Key=¤SET_CUSTOM_VALUE¤"
    ports:
    - "85:8080"
    depends_on:
    - mongodb
    - assets
    - sdkbackend
    restart: on-failure

  sdkbackend:
    image: gnaudio/fds.api:¤CONTAINER-VERSION¤
    environment:
    - "Storage:SDKCopyUrl=[***]"
    ports:
    - "82:80"

  analytics:
    image: gnaudio/jabra-xpress-analytics:v¤CONTAINER-VERSION¤
    environment:
    - "ConnectionStrings:MongodbServer=mongodb://mongodb/raw"
    - "Security:PackageTokens:IssuerKey=¤SET_CUSTOM_VALUE¤"
    - "Security:ClientTokens:IssuerKey=¤SET_CUSTOM_VALUE¤"
    - "Security:TokenProtection:Key=¤SET_CUSTOM_VALUE¤"
    ports:
    - "88:8080"
    depends_on:
    - mongodb

  analytics-cron:
    image: gnaudio/jabra-xpress-analytics-cron:v¤CONTAINER-VERSION¤
    environment:
    - "MONGODBCONNECTIONSTRING=mongodb://mongodb/raw"
    depends_on:
    - mongodb

启动Xpress设置的命令
$ docker-compose up

现在可通过[***]访问Jabra Xpress。

历史版本

版本v5.5.26802

版本v5.4.24001

版本v5.3.09401

版本v5.1.***

版本v4.20.05402

完整Xpress设置所需的其他镜像

版本v4.17.54803

完整Xpress设置所需的其他镜像