gnzsnz/ib-gateway-docker

说明与用途

**项目简介**
gnzsnz/ib-gateway-docker 是一个基于 Docker 的镜像，预装了 Interactive Brokers 的 IB Gateway/TWS 与 IBC（IB Controller），旨在为量化研究与交易自动化提供即插即用的运行环境。

**价值**

• **快速搭建**：无需手动安装 IB Gateway/TWS，直接拉取镜像即可在本地或云端启动，极大缩短环境准备时间。
• **统一化部署**：Docker 化后可在 CI/CD 流水线、K8s 集群或普通服务器上统一管理，保证开发、回测、实盘环境的一致性。
• **可靠性**：镜像内已集成 IBC 自动登录、会话保持和日志轮转，降低因网络或会话失效导致的中断风险。

**典型接入方式**

1. **Docker Run**（最简方式）

   docker run -d --name ib-gateway \
       -p 7496:7496 -p 4002:4002 \
       -e IBC_USERNAME=your_user \
       -e IBC_PASSWORD=your_pass \
       gnzsnz/ib-gateway-docker

• 7496 为 TWS/IB Gateway API 端口，4002 为 IBC 控制端口。

1. **Docker‑Compose**（多服务协同）

   version: "3.8"
   services:
     ib-gateway:
       image: gnzsnz/ib-gateway-docker
       ports:
         - "7496:7496"
         - "4002:4002"
       environment:
         IBC_USERNAME: ${IB_USER}
         IBC_PASSWORD: ${IB_PASS}
       restart: unless-stopped

可与策略回测容器、数据库或消息队列一起编排，实现完整的交易工作流。

1. **Kubernetes**（大规模或高可用）

• 将镜像部署为 Deployment，配合 Service 暴露 API 端口；使用 livenessProbe 检查 IBC 状态，配合 HorizontalPodAutoscaler 实现弹性伸缩。

**生产可用性**

• **活跃度**：截至 2026‑06‑22，项目最近一次提交在当天，拥有 1 064 星、217 fork，社区活跃。
• **成熟度**：镜像已内置 IBC 自动登录、日志轮转、健康检查等生产级特性，适合作为正式交易系统的网关层。
• **风险**：目前未发现重大许可证或安全漏洞，但仍建议在投产前完成以下步骤：

1. **审计镜像**（使用 Trivy、Syft 等工具检查依赖漏洞）。
2. **确认许可证**（项目采用的开源许可证是否符合贵公司合规要求）。
3. **监控与告警**（对 ib-gateway 容器的 CPU、内存、网络以及 IBC 心跳进行监控）。

综上，gnzsnz/ib-gateway-docker 提供了即开即用、易于集成且在社区和更新频率上都具备生产级别的可靠性，是构建 IB 交易自动化系统的理想底层组件。

实际用途

gnzsnz/ib-gateway-docker helps research and automate market workflows.

• research trading systems
• backtest strategies
• monitor market workflows

限制与审查说明

High for an OSS candidate: recent activity, adoption, and ecosystem signals are strong enough for a serious pilot.