Open Trade Gateway 是一套主要用于期货交易的中继服务器系统. 它可以接受客户端以 DIFF协议 (Differential Information Flow for Finance) 接入, 完成用户终端与期货柜台系统的数据交互.
本项目目前支持的期货交易柜台系统包括:
- CTP
- Femas 主席系统 (测试中)
- 恒生 UFX 系统 (测试中)
DIFF Collection 中列出了一些支持本系统的终端产品
本服务必须在Linux环境下安装运行。下面的安装步骤以 Debian 9 为例，其它 linux 发行版可能需要相应调整.
用apt命令安装 openssl 和 libcurl:
sudo apt install libcurl4-openssl-dev
2019-03-21前的版本需要安装 boost 1.68.0, 参见 https://www.boost.org/doc/libs/1_68_0/more/getting_started/unix-variants.html
2019-03-21后的版本需要安装 boost 1.70.0, 参见 https://www.boost.org/users/history/version_1_70_0.html
获取 open-trade-gateway 代码:
git clone https://github.com/shinnytech/open-trade-gateway.git
- 编译与安装::
- cd open-trade-gateway sudo make sudo make install
- 第一次安装后需要将如下两个路径加入/etc/ld.so.conf文件中::
- /usr/local/bin/ /usr/local/lib/ 然后执行命令:ldconfig
本系统运行需要两个配置文件:
/etc/open-trade-gateway/config.json 用于服务进程的一些配置项:
{
"host": "0.0.0.0", //提供服务的IP地址
"port": 7788, //提供服务的端口号
"auto_confirm_settlement": false, //是否自动确认结算单
"user_file_path": "/var/local/lib/open-trade-gateway" //存放用户文件的目录，必须事先创建好
}
/etc/open-trade-gateway/broker_list.json 中可以设置一组或多组期货公司前置机:
[
{
"name": "simnow",//一个系统中要保证唯一性
"type": "ctp",//交易系统类型,目前支持ctp(ctp非穿管版)、ctpse13(ctp穿管版6.3.13版)、ctpse(ctp穿管版6.3.15)、sim(快期模拟)四种
"is_fens":false,//前置地址是否是Fens地址,只对type=ctp,ctpse或者ctpse13时有效,type=sim时忽略
"broker_id": "9999",//broker_id,必须与交易系统中的设置一致
"product_info": "abcd",//如果type=ctp,这里填写从期货公司申请的产品UserProductInfo;如果type=ctpse、或者ctpse13,这里填写从期货公司审请的中继产品RelayAppID;type=sim时忽略
"auth_code":"VUZMGH==",//如果type=ctp,这里填写从期货公司申请的产品AuthCode(由对应的UserProductInfo生成);如果type=ctpse、或者ctpse13,这里填写从期货公司申请的中继产品AuthCode(由对应的RelayAppId生成);type=sim时忽略
"trading_fronts": [//如果is_fens=false，这里填写ctp的交易前置机地址,如果is_fens=true,则这里填写ctp的命名服务地址,type=sim时忽略
"tcp://218.202.237.33:10002"
]
}
]
/etc/open-trade-gateway/broker_list.json中的一组配置也可以用/etc/open-trade-gateway/broker_list/目录下的一个文件来代替，如可以用simnow.json文件代替上面的配置:
{
"name": "simnow",
"type": "ctp"，
"is_fens":false,
"broker_id": "9999",
"product_info": "abcd",
"auth_code":"VUZMGH==",
"trading_fronts": [
"tcp://218.202.237.33:10002"
]
}
在命令行下运行服务器主程序:
open_trade_gateway
系统运行日志将输出到文件 /var/log/open-trade-gateway/open-trade-gateway.log 中
主程序启动后，用任意websocket client 连接到服务端口，应该收到这样的信息:
{
"aid": "rtn_brokers",
"brokers": ["simnow"]
}
表示服务器主程序启动正常
1、首先按上述配置步骤在一台或者多台服务器上配置一个或者多个open_trade_gateway实例
- 2、按下面的配置文件(文件名config-ms.json,需要安装在/etc/open-trade-gateway/下)的说明配置负载均衡服务器
- {
"host":"0.0.0.0",//提供负载均衡服务的IP地址
"port":5566,//负载均衡服务的端口号
"slaveNodeList":[//在第1步中已经配好的open_trade_gateway实例列表
- {
"name":"135",//结点名称,不能重复
"host":"192.168.1.35",//open_trade_gateway实例的IP地址
"port":"7788", //open_trade_gateway实例的端口号(注意:这里是字符串)
"path":"/" //open_trade_gateway实例的路径,默认为"/"
},
- {
"name":"136",
"host":"192.168.1.36",
"port":"7788",
"path":"/"
},
- {
"name":"137",
"host":"192.168.1.37",
"port":"7788",
"path":"/",
}
]
}
3、上述多个open_trade_gateway实例的broker list的bid配置不可重复,如果重复,按步骤2中结点配置的顺序,先出现的有效,后出现的忽略
4、首先正确启动上述结点上的open_trade_gateway实例，最后启动负载均衡服务器open-trade-gateway-ms
5、采用DIFF协议的客户端应用连接open-trade-gateway-ms的服务端口(上例中的5566)发送请求,open-trade-gateway-ms会根据请求的bid自动将请求转发到不同的open-trade-gateway结点进行处理,实现负载均衡
1、执行open_trade_gateway后，未启动重新返回命令行
解决：基本出现在编译完成后的首次运行，请检查是否对broker_list.json 、config.json重命名并配置。出现该问题时，一般/var/log/open-trade-gateway//open-trade-gateway.log中的提示信息是找不到config.json文件