davinci1976/docker-sni-proxy

docker-sni-proxy 镜像说明

镜像概述

docker-sni-proxy是一个轻量级反向代理工具，专注于Docker环境下的服务路由。它通过SNI（服务器名称指示）和HTTP Host头识别目标服务，将HTTP(80)和HTTPS(443)请求转发到对应的容器或服务，支持Docker Compose和Swarm模式，帮助开发者简化多服务部署的网络配置。

核心功能

• 支持HTTP(80)和HTTPS(443)协议的请求转发
• 基于SNI（HTTPS）和Host头（HTTP）智能识别目标服务
• 兼容Docker Compose和Swarm集群模式
• 提供手动/自动Docker网络分配能力
• 支持服务模式（service）和栈模式（stack）两种工作模式

使用场景

1. 单Compose/Swarm栈内部署

   • 采用MODE=service或MODE=stack模式
   • 将公共服务加入docker-sni-proxy网络
   • 参考示例：docker-compose.test.yml

2. 多栈外部公共网络（手动网络分配）

   • 推荐使用MODE=stack模式
   • 将所有公共服务链接到外部公共网络

3. 多栈外部公共网络（自动网络分配）

   • 推荐使用MODE=stack模式
   • 设置DOCKER_NETWORK=<公共网络名称>
   • 参考示例：docker-compose.yml

配置说明

CLI/环境变量选项

sh
./docker-sni-proxy使用参数：
  -docker-network string  
    	指定Docker公共网络  
  -host string  
    	监听接口（默认："0.0.0.0"）  
  -http-port int  
    	HTTP监听端口（默认：80）  
  -mode string  
    	工作模式：stack/service（默认："stack"）  
  -tls-port int  
    	HTTPS监听端口（默认：443）  

工作模式

服务模式（Service Mode）

• 在服务中集成docker-sni-proxy，设置MODE=service
• 调用服务<SERVICE>时使用<SERVICE>.<DOMAIN>格式，代理自动转发到目标服务

栈模式（Stack Mode）

• 在独立栈中部署docker-sni-proxy，设置MODE=stack
• 手动方式：确保所有公共服务链接到公共网络
• 自动方式：设置DOCKER_NETWORK=<公共网络名称>
• 调用栈<STACK>中的服务<SERVICE>时使用<SERVICE>.<STACK>.<DOMAIN>格式

部署示例

Docker Run命令

sh
docker run -d \
  --name docker-sni-proxy \
  --network=public \
  -p 80:80 \
  -p 443:443 \
  -e MODE=stack \
  -e DOCKER_NETWORK=public \
  docker.xuanyuan.run/davinci1976/docker-sni-proxy

Docker Compose示例

yaml
version: '3.8'
services:
  proxy:
    image: docker.xuanyuan.run/davinci1976/docker-sni-proxy
    ports:
      - "80:80"
      - "443:443"
    environment:
      MODE: stack
      DOCKER_NETWORK: public
    networks:
      - public
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock # 必要时挂载Docker套接字

networks:
  public:
    external: true

更新日志

• 0.3.1：修复GetSNBlock:93处缓冲区溢出panic（防伪造***）
• 0.3.0：新增Docker Swarm模式服务支持
• 0.2.0：添加Docker网络配置（docker-network参数、proxy=true标签、端口映射标签）
• 0.0.3：修复HTTP头Host解析问题
• 0.0.2：支持HTTP 80端口，新增service模式
• 0.0.1：基础SNI 443端口支持