leapsight/bondy

Bondy - 分布式应用网络平台

!https://github.com/Leapsight/bondy/blob/develop/doc/assets/bondy_bg.png?raw=true

!Version
!Docker Pulls
!Docker Build (master)
!Docker Build (develop)
!Docker Build (latest-tag)
!Architectures

镜像概述与主要用途

Bondy是开源、高可扩展的分布式应用网络平台，旨在连接分布式应用的所有元素（Web/移动应用、IoT设备、后端微服务等），通过统一、安全的通信协议实现解耦和动态通信。它基于开放的Web应用消息协议（WAMP），融合服务网格与事件网格能力，支持集群部署和跨平台运行，确保分布式系统的可靠、低延迟通信。

核心功能与特性

支持的WAMP特性

认证机制

• WAMP标准认证：***认证、***sign、Ticket、WAMP-CRA（WAMP-SCRAM和Cookie认证开发中）
• 扩展认证：HTTP OAuth2、HTTP Password、Same Sign-on（单一凭证登录多领域）、Single Sign-on（结合Ticket认证实现多领域登录）

高级RPC特性

• 调用取消、调用超时、调用信任级别、调用者标识
• 基于模式的注册、共享注册
  • 负载均衡：随机、轮询
  • 热备模式：First（优先第一个）、Last（优先最后一个）

高级Pub/Sub特性

• 事件保留、基于模式的订阅、发布信任级别
• 发布者排除、发布者标识、订阅者黑白名单

传输与序列化

• 传输协议：WebSockets、RawSockets（E2E加密开发中）
• 序列化格式：JSON、Msgpack、BERT、Erlang子集（JSON批量和Msgpack批量开发中）

分布式架构优势

• 分布式设计：原生支持集群，节点故障或网络中断时仍能持续运行，通过数据复制确保可靠性
• 无主节点集群：所有节点平等，基于去中心化P2P架构，支持透明路由（跨节点消息转发）
• 低延迟数据复制：采用因果跟踪、实时流行病广播（gossip）和定期主动反熵协议，确保集群状态一致
• 嵌入式能力：集成API网关（HTTP转WAMP）、身份管理、RBAC权限控制、Broker Bridge（如Kafka桥接）

使用场景

• 分布式微服务通信：连接跨语言/框架的微服务，实现松耦合的RPC和事件通知
• IoT设备网络：低资源设备通过WAMP协议高效接入，支持大规模设备管理和实时数据传输
• 实时Web/移动应用：为Web和移动应用提供低延迟双向通信，支持实时协作、通知等场景
• 跨平台应用集成：统一异构系统通信协议，简化多平台（Linux、macOS、ARM架构）应用集成

快速开始（Docker部署）

前提条件

• 安装Docker Engine（官方安装指南）

基本部署命令

通过Docker镜像快速启动单节点Bondy：

shell
docker run \
  --rm \  # 容器退出后自动删除
  -e BONDY_ERL_NODENAME=bondy1@127.0.0.1 \  # Erlang节点名称（集群标识）
  -e BONDY_ERL_DISTRIBUTED_COOKIE=bondy \  # 集群通信Cookie（所有节点需一致）
  -u 0:1000 \  # 运行用户ID:组ID
  -p 18080:18080 \  # HTTP API网关/WebSocket WAMP
  -p 18081:18081 \  # HTTP管理API
  -p 18082:18082 \  # TCP RawSocket WAMP
  -p 18083:18083 \  # 备用HTTP API网关
  -p 18084:18084 \  # HTTPS管理API
  -p 18085:18085 \  # TLS RawSocket WAMP
  -v "$(PWD)/examples/custom_config/etc:/bondy/etc" \  # 挂载自定义配置（本地路径需替换）
  -v "/tmp/data:/bondy/data" \  # 挂载数据目录（持久化存储）
  leapsight/bondy:master  # 镜像名称:标签（master为开发版，稳定版用具体版本标签如1.0.0-rc.30）

参数说明

• 环境变量：
  • BONDY_ERL_NODENAME：Erlang节点唯一标识（格式节点名@IP），集群部署时需确保可解析
  • BONDY_ERL_DISTRIBUTED_COOKIE：集群节点通信的安全Cookie，所有节点必须相同
• 端口映射：

• 卷挂载：
  • /bondy/etc：配置文件目录，挂载本地自定义配置（如领域设置、认证策略）
  • /bondy/data：数据持久化目录，存储集群状态、用户数据等

本地集群测试

启动节点1

shell
# 假设本地有examples/custom_config配置目录
docker run \
  --name bondy1 \
  -e BONDY_ERL_NODENAME=bondy1@127.0.0.1 \
  -e BONDY_ERL_DISTRIBUTED_COOKIE=bondy \
  -p 18080:18080 -p 18081:18081 -p 18082:18082 \
  -v "$(PWD)/examples/custom_config/etc:/bondy/etc" \
  -v "/tmp/bondy1_data:/bondy/data" \
  -d leapsight/bondy:master

创建测试领域

通过管理API创建WAMP通信领域：

curl
curl -X POST "http://localhost:18081/realms/" \
  -H "Content-Type: application/json" \
  -d '{"uri": "com.myrealm", "description": "测试领域"}'

禁用安全（测试用）

临时禁用领域安全验证，简化测试流程：

curl
curl -X DELETE "http://localhost:18081/realms/com.myrealm/security_enabled"

启动节点2（自动加入集群）

shell
docker run \
  --name bondy2 \
  -e BONDY_ERL_NODENAME=bondy2@127.0.0.1 \
  -e BONDY_ERL_DISTRIBUTED_COOKIE=bondy \
  -p 18180:18080 -p 18181:18081 -p 18182:18082 \  # 端口偏移避免冲突
  -v "$(PWD)/examples/custom_config/etc:/bondy/etc" \
  -v "/tmp/bondy2_data:/bondy/data" \
  -d leapsight/bondy:master

节点2启动后会自动发现节点1并加入集群，约1分钟后领域数据（如com.myrealm）会复制到节点2。

资源与文档

• 官方网站：bondy.io
• 开发文档：developer.bondy.io
• WAMP协议规范：wamp-proto.org
• 镜像地址：https://hub.docker.com/r/leapsight/bondy