Kaazing Gateway Docker 镜像文档

重要提示：镜像已废弃

此镜像已废弃，原因是长期未维护（最后更新于 2018 年 7 月；docker-library/official-images#4575）。

镜像概述和主要用途

Kaazing Gateway 是一个网络网关，旨在为实时 Web 协议提供单一接入点，支持负载均衡、集群和安全管理。其核心用途是在所有平台、浏览器和设备上，提供基于 Web 的可扩展、安全的双向事件驱动通信。

核心功能和特性

• 实时协议接入点：支持多种实时 Web 协议，提供统一的通信接入点
• 企业级特性：集成负载均衡、集群管理和安全控制功能
• 双向通信：实现基于事件的双向数据传输，适用于实时应用场景
• 跨平台支持：兼容各类浏览器、设备和操作系统
• 性能优化：支持高并发连接，提供可扩展的通信架构

使用场景和适用范围

• 需要实时双向通信的 Web 应用（如即时通讯、实时数据监控）
• 基于 WebSocket 协议的服务端实现（如 echo 服务、实时通知系统）
• 需要集中管理实时通信接入点的企业级系统
• 需通过负载均衡和安全策略保障实时通信稳定性的场景

快速参考

基本信息

• 维护者：Kaazing Docker 维护团队
• 支持标签及对应 Dockerfile：
  • 5.6.0, 5.6, 5, latest
• 获取帮助：Docker 社区论坛、Docker 社区 Slack 或 Stack Overflow
• 问题反馈地址：[***]

技术细节

• 支持架构：
  • amd64 (详情)
  • arm64v8 (详情)
• 镜像 artifact 详情：repo-info 仓库的 repos/kaazing-gateway/ 目录（包含元数据、传输大小等）
• 镜像更新：
  • official-images 仓库的 library/kaazing-gateway 标签
  • official-images 仓库的 library/kaazing-gateway 文件（历史记录）
• 文档来源：docs 仓库的 kaazing-gateway/ 目录（历史记录）

使用方法和配置说明

快速启动

默认情况下，网关运行一个 WebSocket echo 服务（类似 websocket.org）。启动容器时需指定 hostname，并通过环境变量 GATEWAY_OPTS 传递配置：

$ docker run --name some-kaazing-gateway -h somehostname -e GATEWAY_OPTS="-Dgateway.hostname=somehostname -Xmx512m -Djava.security.egd=file:/dev/urandom" -d -p 8000:8000 kaazing-gateway

参数说明：

• -h somehostname：指定容器 hostname，需确保客户端可解析
• -e GATEWAY_OPTS：传递 JVM 参数和网关配置：
  • -Dgateway.hostname=somehostname：设置网关 hostname
  • -Xmx512m：Java 堆内存上限 512MB
  • -Djava.security.egd=file:/dev/urandom：加速 VM 环境启动
• -p 8000:8000：映射网关默认端口（WebSocket 服务端口）

启动后，可通过 WebSocket echo 测试工具 连接 ws://somehostname:8000。若客户端无法解析 somehostname，需在本地 etc/hosts 中添加 dockerhost-ip somehostname 条目。

自定义配置

通过挂载自定义配置文件覆盖默认配置：

$ docker run --name some-kaazing-gateway -h somehostname -e GATEWAY_OPTS="-Dgateway.hostname=somehostname -Xmx512m -Djava.security.egd=file:/dev/urandom" -v /some/gateway-config.xml:/kaazing-gateway/conf/gateway-config.xml:ro -d kaazing-gateway

配置文件说明：

• 配置文件语法参考 官方文档（“管理员指南”章节）
• 若需修改默认配置，可先从运行中的容器复制默认配置：

  $ docker cp some-kaazing-gateway:/kaazing-gateway/conf/gateway-config-minimal.xml /some/gateway-config.xml
  

通过 Dockerfile 自定义配置：

FROM kaazing-gateway
COPY gateway-config.xml conf/gateway-config.xml

构建并运行：

$ docker build -t some-custom-kaazing-gateway .
$ docker run --name some-kaazing-gateway -d some-custom-kaazing-gateway

环境变量 GATEWAY_OPTS

用于传递 JVM 参数和网关配置，详细说明见 官方文档。常用参数包括：

• -Dgateway.hostname：网关 hostname
• -Xmx<size>：Java 堆内存上限
• -Djava.security.egd：随机数生成器配置（加速启动）

许可信息

软件许可信息参见 GitHub 仓库。镜像可能包含其他软件（如 Bash 等基础依赖），其许可需另行遵守。

镜像元数据及许可相关详情可参考 repo-info 仓库。使用前请确保遵守所有包含软件的许可条款。