gnaudio/jabra-xpress-frontend

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桌面系统（部署指南：https://docs.docker.com/install%EF%BC%89%E3%80%82
• 内存要求：16GB RAM。

完整Jabra Xpress设置

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

• https://hub.docker.com/r/gnaudio/fds.api
• https://hub.docker.com/r/gnaudio/jabra-xpress-analytics
• https://hub.docker.com/r/gnaudio/jabra-xpress-assets
• https://hub.docker.com/r/gnaudio/jabra-xpress-analytics-cron
• https://hub.docker.com/r/gnaudio/jabra-xpress-api
• https://hub.docker.com/r/gnaudio/jabra-xpress-frontend

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

• MongoDB
• SQL数据库

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

可选服务

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

• https://hub.docker.com/r/gnaudio/jabra-xpress-cron-compliancereporter

资源依赖

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

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

最新版本的Jabra Xpress前端

v5.7.02901

2025年2月11日

性能和稳定性改进

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

服务设置

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

运行镜像

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

yaml
  frontend:
    image: docker.xuanyuan.run/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" docker.xuanyuan.run/gnaudio/jabra-xpress-frontend:v5.7.02901

---

完整Xpress设置

---

注意事项

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

发布说明

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

SQL数据库

除以下步骤外，可访问https://hub.docker.com/r/gnaudio/jabra-xpress-databaseconsoletool%E8%8E%B7%E5%8F%96%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%E3%80%82

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

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

创建数据库架构

访问https://hub.docker.com/r/gnaudio/jabra-xpress-databaseconsoletool%E5%B9%B6%E8%BF%90%E8%A1%8C%E8%AF%A5%E9%95%9C%E5%83%8F%E3%80%82%E8%BF%90%E8%A1%8C%E6%97%B6%E4%BD%BF%E7%94%A8%E7%A9%BASQL%E6%95%B0%E6%8D%AE%E5%BA%93%E7%9A%84%E8%BF%9E%E6%8E%A5%E5%AD%97%E7%AC%A6%E4%B8%B2%E3%80%82

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

使用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 "http://¤HOST-NAME¤:80/";
            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 "http://¤HOST-NAME¤:85/";
            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 "http://¤HOST-NAME¤:82/";
            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 "http://¤HOST-NAME¤:88/";
            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: docker.xuanyuan.run/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: docker.xuanyuan.run/mongo:latest

  assets:
    image: docker.xuanyuan.run/gnaudio/jabra-xpress-assets:v¤CONTAINER-VERSION¤

  frontend:
    image: docker.xuanyuan.run/gnaudio/jabra-xpress-frontend:v¤CONTAINER-VERSION¤
    environment:
    - "ENDPOINT=https://¤HOST-NAME¤/api"
    ports:
    - "80:80"

  backend:
    image: docker.xuanyuan.run/gnaudio/jabra-xpress-api:v¤CONTAINER-VERSION¤
    environment:
    - "ConnectionStrings:XpressDatabaseSqlServer=¤CONNECTION-STRING¤"
    - "ConnectionStrings:MongoDb=mongodb://mongodb/raw"
    - "DefaultAnalyticsEndpoint=https://¤HOST-NAME¤/analytics/api/v1/Analytics"
    - "JDODownload=http://assets/"
    - "NetworkEndpoint=https://¤HOST-NAME¤/api"
    - "SDK:fwURL_base=http://¤HOST-NAME¤:82"
    - "SDK:fsURL_base=http://¤HOST-NAME¤:82"
    - "Security:PackageTokens:IssuerKey=¤SET_CUSTOM_VALUE¤"
    - "Security:ClientTokens:IssuerKey=¤SET_CUSTOM_VALUE¤"
    - "Security:TokenProtection:Key=¤SET_CUSTOM_VALUE¤"
    - "ASPNETCORE_URLS=http://+:8080"
    ports:
    - "85:8080"
    depends_on:
    - mongodb
    - assets
    - sdkbackend
    restart: on-failure

  sdkbackend:
    image: docker.xuanyuan.run/gnaudio/fds.api:¤CONTAINER-VERSION¤
    environment:
    - "Storage:SDKCopyUrl=https://¤HOST-NAME¤/fds"
    ports:
    - "82:80"

  analytics:
    image: docker.xuanyuan.run/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: docker.xuanyuan.run/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: docker.xuanyuan.run/mongo:latest

  assets:
    image: docker.xuanyuan.run/gnaudio/jabra-xpress-assets:v¤CONTAINER-VERSION¤

  frontend:
    image: docker.xuanyuan.run/gnaudio/jabra-xpress-frontend:v¤CONTAINER-VERSION¤
    environment:
    - "ENDPOINT=http://¤HOST-NAME¤:85"
    ports:
    - "80:80"

  backend:
    image: docker.xuanyuan.run/gnaudio/jabra-xpress-api:v¤CONTAINER-VERSION¤
    environment:
    - "ConnectionStrings:XpressDatabaseSqlServer=¤CONNECTION-STRING¤"
    - "ConnectionStrings:MongoDb=mongodb://mongodb/raw"
    - "DefaultAnalyticsEndpoint=http://¤HOST-NAME¤:88/api/v1/Analytics"
    - "JDODownload=http://assets/"
    - "NetworkEndpoint=http://¤HOST-NAME¤:85"
    - "SDK:fwURL_base=http://¤HOST-NAME¤:82"
    - "SDK:fsURL_base=http://¤HOST-NAME¤:82"
    - "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: docker.xuanyuan.run/gnaudio/fds.api:¤CONTAINER-VERSION¤
    environment:
    - "Storage:SDKCopyUrl=http://¤HOST-NAME¤:82"
    ports:
    - "82:80"

  analytics:
    image: docker.xuanyuan.run/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: docker.xuanyuan.run/gnaudio/jabra-xpress-analytics-cron:v¤CONTAINER-VERSION¤
    environment:
    - "MONGODBCONNECTIONSTRING=mongodb://mongodb/raw"
    depends_on:
    - mongodb

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

现在可通过http://¤HOST-NAME¤/访问Jabra Xpress。

历史版本

版本v5.5.26802

版本v5.4.24001

版本v5.3.09401

版本v5.1.***

版本v4.20.05402

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

版本v4.17.54803

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