Linux服务器无头部署IB(盈透证券) API自动化交易要点

核心结论：不需要真实图形界面，但需要虚拟显示

IB 有两个客户端程序：

IB Gateway 仍然有一个最简 GUI 登录窗口（Java Swing），所以需要虚拟显示 Xvfb。配合 IBC（开源自动登录工具）可实现完全无人值守。

推荐方案：IB Gateway + IBC + Xvfb

安装步骤：

# 1. 安装依赖sudo apt-get install -y openjdk-11-jre xvfb x11-utils# 2. 从 IB 官网下载 Linux 版 IB Gateway# 地址：https://www.interactivebrokers.com/en/trading/ibgateway-stable.php# 下载 ibgateway-stable-standalone-linux-x64.shchmod +x ibgateway-stable-standalone-linux-x64.sh./ibgateway-stable-standalone-linux-x64.sh # 按提示安装，默认路径 ~/Jts/ibgateway/# 3. 下载 IBC（自动登录工具）wget https://github.com/IbcAlpha/IBC/releases/latest/download/IBCLinux-x.x.x.zipunzip IBCLinux-x.x.x.zip -d ~/ibc/chmod +x ~/ibc/*.sh

配置 IBC（~/ibc/config.ini）：

IbLoginId=你的IB用户名IbPassword=你的IB密码TradingMode=live # 或 paper（模拟账户）AcceptNonBrokerageAccountWarning=yes

启动脚本（~/start_ibgateway.sh）：

#!/bin/bash# 启动虚拟显示（:1 号显示）Xvfb :1 -screen 0 1024x768x24 &export DISPLAY=:1# 通过 IBC 启动 IB Gateway~/ibc/gatewaystart.sh \-ibcpath ~/ibc/ \-ibcini ~/ibc/config.ini \-javapath /usr/bin/java \-twsuserid 你的用户名 \-twspassword 你的密码 \-fixuserid "" \-fixpassword ""

Python 连接（推荐用 ib_insync）

pip install ib_insyncfrom ib_insync import IB, Stockib = IB()# IB Gateway 默认端口 4001（TWS 是 7497）ib.connect('127.0.0.1', 4001, clientId=1)# 获取美股实时价格示例contract = Stock('AAPL', 'SMART', 'USD')ib.qualifyContracts(contract)ticker = ib.reqMktData(contract)ib.sleep(2)print(ticker.last) # 最新成交价

注意事项

1. 端口：IB Gateway 默认 4001（live）/4002（paper），TWS 是 7497/7496
2. 每日重启：IB Gateway 会在每天美东时间凌晨强制断连重启，IBC 可配置自动重连
3. 订阅行情：你已付费订阅，连接后直接可用，但需确认是否订阅了 US Securities Snapshot and Futures Value Bundle
4. 防火墙：端口 4001 只监听 127.0.0.1，本机访问即可，无需对外开放
5. 二次验证（2FA）：IB 强制要求，推荐用 IB Key App + Trusted IP 白名单方式绕过服务器登录的手动验证

6. 为什么需要 Xvfb？

     IB Gateway 是用 Java 写的，启动时会弹出一个登录窗口（输入账号密码那种）。Java 的 GUI 框架要求系统有"显示器"，否则直接报错崩溃。Linux 服务器没有显示器，所以用 Xvfb（X virtual framebuffer） 虚拟一个假显示器，让 Java 以为有屏幕，实际上什么都看不见。IBC  再自动帮你填账号密码、点登录按钮。

7. IB 的价格推送机制

     建立连接后，是订阅推送模式，不是你主动去问。

     流程如下：

   

     (1). 你调用 reqMktData(contract) — 相当于告诉 IB "我要订阅这个标的" (

   2). 之后只要价格有变动，IB 服务器主动推过来，ticker.last 自动更新

     (3). 你的程序随时读 ticker.last 就是当前最新价

8.  用法，随时读取

   ib.connect('127.0.0.1', 4001, clientId=1)

     # 一次性订阅所有你需要的标的

     ticker_aapl = ib.reqMktData(Stock('AAPL', 'SMART', 'USD'))

     ticker_msft = ib.reqMktData(Stock('MSFT', 'SMART', 'USD'))

     # 主循环：每隔一段时间读一次

     while True:

         ib.sleep(5)          # 让 ib_insync 处理一下推送事件

         print(ticker_aapl.last, ticker_msft.last)

         # 这里写你的估值计算逻辑，写入数据库

9. 订阅一次，之后进主循环，每隔几秒 ib.sleep() 让连接保活，随时读 ticker.last 就行。  ib.sleep(N) 和 time.sleep(N) 的区别：ib.sleep 在等待期间会处理 IB 推过来的数据包time.sleep不处理，会导致ticker.last停止更新。用ib.sleep，不用time.sleep。