library/kaazing-gateway

Kaazing Gateway Docker 镜像文档

重要提示：镜像已废弃

此镜像已废弃，原因是长期未维护（最后更新于 2018 年 7 月；https://github.com/docker-library/official-images/pull/4575%EF%BC%89%E3%80%82

镜像概述和主要用途

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

核心功能和特性

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

使用场景和适用范围

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

快速参考

基本信息

• 维护者：https://github.com/kaazing/gateway.docker
• 支持标签及对应 Dockerfile：
  • https://github.com/kaazing/gateway.docker/blob/a40c8da9d2c2925bdd78b9a6d1b6da3fe89322d1/Dockerfile
• 获取帮助：Docker 社区论坛、Docker 社区 Slack 或 Stack Overflow
• 问题反馈地址：https://github.com/kaazing/gateway.docker/issues

技术细节

• 支持架构：
  • amd64 (https://hub.docker.com/r/amd64/kaazing-gateway/)
  • arm64v8 (https://hub.docker.com/r/arm64v8/kaazing-gateway/)
• 镜像 artifact 详情：https://github.com/docker-library/repo-info/blob/master/repos/kaazing-gateway%EF%BC%88%E5%8C%85%E5%90%AB%E5%85%83%E6%95%B0%E6%8D%AE%E3%80%81%E4%BC%A0%E8%BE%93%E5%A4%A7%E5%B0%8F%E7%AD%89%EF%BC%89
• 镜像更新：
  • https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fkaazing-gateway
  • https://github.com/docker-library/official-images/blob/master/library/kaazing-gateway%EF%BC%88https://github.com/docker-library/official-images/commits/master/library/kaazing-gateway%EF%BC%89
• 文档来源：https://github.com/docker-library/docs/tree/master/kaazing-gateway%EF%BC%88https://github.com/docker-library/docs/commits/master/kaazing-gateway%EF%BC%89

使用方法和配置说明

快速启动

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

console
$ 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 条目。

自定义配置

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

console
$ 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

配置文件说明：

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

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

通过 Dockerfile 自定义配置：

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

构建并运行：

console
$ 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：随机数生成器配置（加速启动）

许可信息

软件许可信息参见 https://github.com/kaazing/gateway/blob/master/LICENSE.txt%E3%80%82%E9%95%9C%E5%83%8F%E5%8F%AF%E8%83%BD%E5%8C%85%E5%90%AB%E5%85%B6%E4%BB%96%E8%BD%AF%E4%BB%B6%EF%BC%88%E5%A6%82 Bash 等基础依赖），其许可需另行遵守。

镜像元数据及许可相关详情可参考 https://github.com/docker-library/repo-info/tree/master/repos/kaazing-gateway%E3%80%82%E4%BD%BF%E7%94%A8%E5%89%8D%E8%AF%B7%E7%A1%AE%E4%BF%9D%E9%81%B5%E5%AE%88%E6%89%80%E6%9C%89%E5%8C%85%E5%90%AB%E8%BD%AF%E4%BB%B6%E7%9A%84%E8%AE%B8%E5%8F%AF%E6%9D%A1%E6%AC%BE%E3%80%82