icecave/honeycomb

Honeycomb镜像文档

镜像概述

Honeycomb是一款针对Docker Swarm环境的反向代理工具，其核心功能是基于TLS握手过程中的服务器名称指示（SNI），将传入的HTTPS请求路由至相应的Docker服务。该镜像旨在简化Docker Swarm集群中多服务的HTTPS访问管理，提供灵活的请求分发能力。

核心功能和特性

• 基于SNI的路由：通过解析TLS握手阶段的服务器名称（如域名），将请求精准路由至对应的Docker服务
• HTTPS支持：原生处理HTTPS请求，确保数据传输的安全性
• WebSocket兼容：完整支持WebSocket协议，适用于实时通信场景
• Docker Swarm集成：专为Docker Swarm环境设计，可与Swarm服务发现机制无缝协作

使用场景和适用范围

• 多服务共享入口：在Docker Swarm集群中，通过单一HTTPS端口暴露多个服务，基于域名区分不同服务
• 微服务架构：为微服务提供统一的HTTPS接入点，简化外部访问配置
• 实时应用：支持WebSocket的特性使其适用于需要实时数据传输的应用（如聊天系统、实时监控）
• 多租户环境：通过不同域名路由至不同租户服务，实现隔离访问

使用方法和配置说明

基本部署（docker run）

bash
docker run -d \
  --name honeycomb \
  --publish 443:443 \
  --volume /path/to/tls/certs:/etc/honeycomb/certs \
  --network swarm-network \
  --restart always \
  honeycomb

Docker Compose配置示例

yaml
version: '3.8'
services:
  honeycomb:
    image: honeycomb
    ports:
      - "443:443"
    volumes:
      - ./tls/certs:/etc/honeycomb/certs
    networks:
      - swarm-network
    restart: always
    deploy:
      placement:
        constraints: [node.role == manager]

networks:
  swarm-network:
    external: true

核心配置参数

注意事项

1. TLS证书需提前准备，且证书中的域名需与SNI中使用的服务器名称一致
2. 确保Honeycomb容器所在网络能与后端Docker服务通信
3. 在Docker Swarm环境中，建议将Honeycomb部署在管理节点以确保服务发现功能正常