xingo golang游戏开发交流群:535378240 文档地址: http://www.runingman.net
xingo是免费、开源、可定制、可扩展、节点支持“热更新”的高性能分布式服务器开发框架,采用golang语言开发,天生携带 高并发场景的处理基因,继承了golang语言本身的各种优点,开发简单易上手并且功能强大。它主要实现了高性能的异步网络库, 分布式节点间的高性能rpc通信,日志管理,数据库支持(暂时只支持mongodb),goroutine安全的定时器,telnet在线服务器调试 工具等,可用的开发场景包括但不局限于IM即时通讯服务器,游戏服务器(已有多款公司级别的项目选择了xingo)等可以节省大量 游戏开发时间,让游戏开发人员可以将主要精力放到游戏玩法和游戏逻辑上。真正实现了修改配置文件就可以搭建自定义的分布式服 务器架构。 优势特点: 1) 开发效率高 2) 支持自定义的分布式架构,方便横向扩展节点,理论上只要有足够的物理机器,没有承载上限 3) 支持自定义通信协议 4) 分布式节点自动发现,自动重连 5) worker pool工作线程池 6) telnet在线服务调试工具(使用方便扩展简单) 7) 内置mongodb数据库支持 8)goroutine安全的定时器实现
示例配置:
{ "master":{"host": "192.168.2.225","rootport":9999}, "servers":{ "gate2":{"host": "192.168.2.225", "rootport":10000,"name":"gate2", "module": "gate", "log": "gate2.log"}, "gate1":{"host": "192.168.2.225", "rootport":10001,"name":"gate1", "module": "gate", "log": "gate1.log"}, "net1":{"host": "192.168.2.225", "netport":11009,"name":"net1","remotes":["gate2", "gate1"], "module": "net", "log": "net.log"}, "net2":{"host": "192.168.2.225", "netport":11010,"name":"net2","remotes":["gate2", "gate1"], "module": "net", "log": "net.log"}, "net3":{"host": "192.168.2.225", "netport":11011,"name":"net3","remotes":["gate2", "gate1"], "module": "net", "log": "net.log"}, "net4":{"host": "192.168.2.225", "netport":11012,"name":"net4","remotes":["gate2", "gate1"], "module": "net", "log": "net.log"}, "admin":{"host": "192.168.2.225", "remotes":["gate2", "gate1"], "name":"admin", "module": "admin", "http": [8888, "/static"]}, "game1":{"host": "192.168.2.225", "remotes":["gate2", "gate1"], "name":"game1", "module": "game"} } }
示例架构图:
默认通信协议如下(支持自定义协议处理部分代码,支持灵活的重载协议部分代码):
Len uint32 数据Data部分长度 MsgId uint32 消息号 Data []byte 数据 消息默认通过google 的protobuf进行序列化
服务器全局配置对象为GlobalObject,支持的配置选项及默认值如下: TcpPort: 8109,//服务器监听端口 MaxConn: 12000,//支持最大链接数 LogPath: “./log”,//日志文件路径 LogName: “server.log”,//日志文件名 MaxLogNum: 10,//最大日志数 MaxFileSize: 100,//per日志文件大小 LogFileUnit: logger.KB,//日志文件大小对应单位 LogLevel: logger.ERROR,//日志级别 SetToConsole: true,//是否输出到console LogFileType: 1,//日志切割方式1 按天切割 2按文件大小切割 PoolSize: 10,//api接口工作线程数量 MaxWorkerLen: 1024 * 2,//任务缓冲池大小 MaxSendChanLen: 1024,//发送队列从缓冲池 FrameSpeed: 30,//未使用 MaxPacketSize: 1024,//协议数据包最大包体大小 FrequencyControl: 100/s,// 100/h(每小时一百个包), 100/m(每分钟一百个包), 100/s(每秒一百个包) OnConnectioned: func(fconn iface.Iconnection) {},//链接建立事件回调 OnClosed: func(fconn iface.Iconnection) {},//链接断开事件回调 OnServerStop: func(), //服务器停服回调 Protoc: iface.IServerProtocol//socket数据pack和unpack的实现,可以通过设置该值重载服务器协议
如何使用? 只需要一步,添加消息路由: s := fserver.NewServer() //add api ---------------start FightingRouterObj := &api.FightingRouter{} s.AddRouter(FightingRouterObj) //add api ---------------end xingo会自动注册FightingRouter中的方法处理对应消息 例如:msgId =1 则会寻找FightingRouter中的Func_1的方法从进行处理 具体使用请参考项目: 帧同步服务器: https://github.com/viphxin/fighting mmo demo: https://git.oschina.net/viphxin/xingo_demo xingo_cluster demo: https://github.com/viphxin/xingo_cluster