Pushpin 镜像文档

镜像概述

Pushpin 是一款用 C++ 编写的反向代理服务器，专注于简化实时 Web 服务的实现过程。它原生支持 WebSocket、HTTP 流和 HTTP 长轮询等实时通信协议，特别针对 API 创建者的需求设计，具有客户端透明性和 API 栈集成便利性的核心优势。

核心功能与特性

• 多协议支持：全面支持 WebSocket、HTTP 流和 HTTP 长轮询三种实时通信模式
• API 导向设计：深度契合 API 开发者需求，降低实时服务构建门槛
• 客户端透明：客户端无需特殊配置即可接入，实现无感知集成
• 无缝集成能力：可轻松融入现有 API 技术架构，最小化系统改造成本

使用场景与适用范围

• 构建需要实时数据推送的 Web API 服务
• 开发实时通知、实时监控面板等即时交互应用
• 为传统 HTTP 服务添加长连接通信能力
• API 开发者需要快速实现实时功能的场景

使用方法与配置说明

基础部署命令

bash
docker run -d -p 7999:7999 -p 8080:8080 fanout/pushpin

端口说明：7999 为客户端连接端口，8080 为与后端服务通信端口

自定义配置部署

通过挂载配置文件实现个性化配置：

bash
docker run -d \
  -p 7999:7999 \
  -p 8080:8080 \
  -v /host/path/to/pushpin.conf:/etc/pushpin/pushpin.conf \
  fanout/pushpin

Docker Compose 配置示例

yaml
version: '3'
services:
  pushpin:
    image: fanout/pushpin
    ports:
      - "7999:7999"  # 客户端连接端口
      - "8080:8080"  # 后端服务通信端口
    volumes:
      - ./pushpin.conf:/etc/pushpin/pushpin.conf  # 自定义配置文件挂载
    restart: unless-stopped

注意事项

• 确保后端服务正确配置以接收来自 Pushpin 的代理请求
• 生产环境中建议通过配置文件自定义超时设置和连接限制
• 根据实际业务需求调整资源分配，避免连接数过载