
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可:
请先完整阅读并严格遵守以下文档中的全部规则与要求:
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前,不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
Jabra Xpress是专为IT专业人士设计的软件解决方案,用于通过一系列智能工具远程管理Jabra产品。该解决方案支持两种部署方式:云服务(通过访问[***] Xpress解决方案以Docker镜像形式提供,可在任何支持Docker的环境中部署。
完整的Jabra Xpress部署包含以下Docker镜像:
此外,部署还需要两个数据库:
注意:建议所有镜像使用相同版本。不同版本的镜像混合使用可能导致功能异常,但fds.api和jabra-xpress-assets除外,它们有独立的版本控制。
部分功能需要额外镜像支持,未部署这些镜像将导致对应功能禁用:
| Docker镜像 | 推荐标签 | 可选标签 |
|---|---|---|
| https://hub.docker.com/r/gnaudio/fds.api | 5.1.1035 * | latest ** |
| https://hub.docker.com/r/gnaudio/jabra-xpress-assets | v6.1.*** * | latest ** |
*:请始终检查镜像页面获取最新可用标签。此处版本已确认可正常工作,但如需特定资源可使用更新版本。
**:使用latest标签时,请确保部署已正确更新。在某些环境中,latest标签可能无法自动更新容器。
以下设置是服务运行所必需的:
| 设置名称 | 值描述 | 说明 |
|---|---|---|
| ConnectionStrings:XpressDatabaseSqlServer | SQL连接字符串 | 用于连接SQL数据库 |
| ConnectionStrings:MongoDb | MongoDB连接字符串 | 用于连接MongoDB数据库 |
| DefaultAnalyticsEndpoint | 分析服务URL 示例: http://localhost:88/api/v1/analytics | 指定分析服务端点 |
| JDODownload | 资产服务URL 示例: http://localhost:89/ 或 http://assets/ | 用于通过前端下载Jabra Direct客户端 |
| NetworkEndpoint | API服务URL 示例: http://localhost:85 | 指定当前API服务的URL,用于告知托管的Jabra Direct客户端 |
| SDK:fwURL_base | 固件端点URL 示例: http://localhost:82 | 指向FDS/sdkbackend服务的固件端点 |
| SDK:fsURL_base | 清单端点URL 示例: http://localhost:82 | 指向FDS/sdkbackend服务的清单端点 |
| Security:PackageTokens:IssuerKey | 令牌签发密钥 示例: 9716702363504e4aaf47fa5bb2ec5c42 | 重要:必须与xpress-analytics服务中设置的值相同。未设置时使用默认值,建议自定义。 |
| Security:ClientTokens:IssuerKey | 客户端令牌密钥 示例: ea99bbe6471848848b138ecb99e52d1f | 重要:必须与xpress-analytics服务中设置的值相同。未设置时使用默认值,建议自定义。 |
| Security:TokenProtection:Key | 令牌加密密钥 示例: qt59#1dlZgsw3Tjv8eWyoQm$ib4u*O7N_ | 重要:必须与xpress-analytics服务中设置的值相同。未设置时使用默认值,建议自定义。 |
| ASPNETCORE_URLS | [***] | 告知ASP.NET Core在8080端口监听HTTP请求 |
| 设置名称 | 值描述 | 说明 |
|---|---|---|
| XpressAutoMigration | true | false(默认) | 启动时自动迁移数据库。设置为true时,服务启动时会检查数据库变更并执行迁移,需确保SQL用户具有完全写入权限。如不希望使用高权限用户,可使用独立数据库工具:https://hub.docker.com/r/gnaudio/jabra-xpress-databaseconsoletool |
若使用docker-compose部署Jabra Xpress,可将以下服务添加到docker-compose文件(替换相关值):
yamlbackend: image: docker.xuanyuan.run/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=http://+:8080" ports: - "85:8080"
若使用docker run命令部署:
bashdocker 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=http://+:8080 \ docker.xuanyuan.run/gnaudio/jabra-xpress-api:v5.7.02901
1. 准备SQL连接字符串
示例连接字符串:
"Server=tcp:sqlserver,1433;Initial Catalog=xpress;User ID=USERID;Password=USER-PASSWORD;Connection Timeout=30;"
2. 创建数据库架构
使用数据库工具创建架构:https://hub.docker.com/r/gnaudio/jabra-xpress-databaseconsoletool
运行该镜像时指定SQL连接字符串,执行数据库迁移。无错误输出则表示架构创建成功。
详情请参考前端镜像文档:https://hub.docker.com/r/gnaudio/jabra-xpress-frontend
v5.7.02901(2025年2月)
发布说明:[***]
v5.5.26802
完整部署所需其他镜像:
| Docker镜像 | 推荐标签 |
|---|---|
| https://hub.docker.com/r/gnaudio/fds.api | 5.1.2436 |
| https://hub.docker.com/r/gnaudio/jabra-xpress-assets | v6.21.01701 |
v5.4.240011
完整部署所需其他镜像:
| Docker镜像 | 推荐标签 |
|---|---|
| https://hub.docker.com/r/gnaudio/fds.api | 5.1.1035 |
| https://hub.docker.com/r/gnaudio/jabra-xpress-assets | v5.3.09401 |
v5.3.09401
完整部署所需其他镜像:
| Docker镜像 | 推荐标签 |
|---|---|
| https://hub.docker.com/r/gnaudio/fds.api | 5.1.1035 |
| https://hub.docker.com/r/gnaudio/jabra-xpress-assets | v5.3.09401 |
v5.1.***
完整部署所需其他镜像:
| Docker镜像 | 推荐标签 |
|---|---|
| https://hub.docker.com/r/gnaudio/fds.api | 5.1.1035 |
| https://hub.docker.com/r/gnaudio/jabra-xpress-assets | v6.1.*** |
v5.0.***
完整部署所需其他镜像:
| Docker镜像 | 推荐标签 |
|---|---|
| https://hub.docker.com/r/gnaudio/fds.api | 5.1.964 |
| https://hub.docker.com/r/gnaudio/jabra-xpress-assets | v5.12.06601 |
重大变更:
服务设置变更,部署前需更新docker-compose或容器配置:
| 设置 | 变更 |
|---|---|
| NetworkEndpoint | 值格式变更:移除URL中的/api/Xpress/Network/部分 |
| Security:PackageTokens:IssuerKey | 新增设置 |
| Security:ClientTokens:IssuerKey | 新增设置 |
| Security:TokenProtection:Key | 新增设置 |
v4.20.05402
完整部署所需其他镜像:
| Docker镜像 | 推荐标签 |
|---|---|
| https://hub.docker.com/r/gnaudio/fds.api | 5.1.880 |
| https://hub.docker.com/r/gnaudio/jabra-xpress-assets | v5.12.06601 |
v4.17.54803
完整部署所需其他镜像:
| Docker镜像 | 推荐标签 |
|---|---|
| https://hub.docker.com/r/gnaudio/fds.api | 5.1.639 |
| https://hub.docker.com/r/gnaudio/jabra-xpress-assets | v5.9.56147 |
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
来自真实用户的反馈,见证轩辕镜像的优质服务