Leaf-Server官方教程：Leaf安装搭建与模块运行 (二)

系统管理员 2022-10-05 00:39 140阅读 0赞

# Leaf 框架配置(windos os / mac os) #

## Go IDE: (windos / mac) ##

**windows os:**

**[Goland 下载地址与安装: ][Goland _]**

**[https://download.csdn.net/download/Kaitiren/19427755][https_download.csdn.net_download_Kaitiren_19427755]**

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0thaXRpcmVu_size_16_color_FFFFFF_t_70][]

**mac os:**

**[下载安装地址: ][Link 1]**

**[https://download.csdn.net/download/Kaitiren/19427964][Link 1]**

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0thaXRpcmVu_size_16_color_FFFFFF_t_70 1][]

## GO SDK下载连接: ##

建议下载最较新的稳定版本开发:

[https://studygolang.com/dl][https_studygolang.com_dl]

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0thaXRpcmVu_size_16_color_FFFFFF_t_70 2][]

## Leaf-Server FrameWork部署: ##

**[ leaf-server framework 下载地址: ][leaf-server framework _]**

**https://download.csdn.net/download/Kaitiren/19427697**

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0thaXRpcmVu_size_16_color_FFFFFF_t_70 3][]

**Leaf-Server FrameWork部署:**

**websocket: github.comgorillawebsocket.zip**

**leaf: leaf-master.zip**

**leafserver游戏服务器框架: leafserver-master.zip**

**mysql数据库: mysql-master.zip**

**go数据库操作库: sqlx-master.zip**

## Leaf 源码概览 ##

*  **leaf/chanrpc 提供了一套基于 channel 的 RPC 机制，用于游戏服务器模块间通讯**
 *  **leaf/db 数据库相关，目前支持 [MongoDB][]**
 *  **leaf/gate 网关模块，负责游戏客户端的接入**
 *  **leaf/go 用于创建能够被 Leaf 管理的 goroutine**
 *  **leaf/log 日志相关**
 *  **leaf/network 网络相关，使用 TCP 和 WebSocket 协议，可自定义消息格式，默认 Leaf 提供了基于 [protobuf][] 和 JSON 的消息格式**
 *  **leaf/recordfile 用于管理游戏数据**
 *  **leaf/timer 定时器相关**
 *  **leaf/util 辅助库**

## Leaf 的模块机制: ##

一个 Leaf 开发的游戏服务器由多个模块组成（例如 [LeafServer][]），模块有以下特点：

*  每个模块运行在一个单独的 goroutine 中
 *  模块间通过一套轻量的 RPC 机制通讯（[leaf/chanrpc][leaf_chanrpc]）Leaf 不建议在游戏服务器中设计过多的模块。

游戏服务器在启动时进行模块的注册：

leaf.Run(
    game.Module,
    gate.Module,
    login.Module,
    )

这里按顺序注册了 game、gate、login 三个模块。每个模块都需要实现接口：

type Module interface {
    OnInit()
    OnDestroy()
    Run(closeSig chan bool)
    }

Leaf 首先会在同一个 goroutine 中按模块注册顺序执行模块的 OnInit 方法，等到所有模块 OnInit 方法执行完成后则为每一个模块启动一个 goroutine 并执行模块的 Run 方法。最后，游戏服务器关闭时（Ctrl + C 关闭游戏服务器）将按模块注册相反顺序在同一个 goroutine 中执行模块的 OnDestroy 方法。

## 使用 Leaf 开发游戏服务器 ##

[LeafServer][] 是一个基于 Leaf 开发的游戏服务器，我们以 LeafServer 作为起点。

获取 LeafServer：

git clone https://github.com/name5566/leafserver

设置 leafserver 目录到 GOPATH 环境变量后获取 Leaf：

go get github.com/name5566/leaf

编译 LeafServer：

go install server

如果一切顺利，运行 server 你可以获得以下输出：

2021/06/07 15:05:58 [release] Leaf 1.1.3 starting up

敲击 Ctrl + C 关闭游戏服务器，服务器正常关闭输出：

2021/06/07 15:06:11 [release] Leaf closing down (signal: interrupt)

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0thaXRpcmVu_size_16_color_FFFFFF_t_70 4][]

=======================================================================================

Kaitiren博客全栈开发技术博客:

[https://kaitiren.blog.csdn.net/][https_kaitiren.blog.csdn.net]

Go 服务器开发(从零开始学习 基础篇):

[https://blog.csdn.net/kaitiren/category\_10696929.html][https_blog.csdn.net_kaitiren_category_10696929.html]

Go LeafServer 游戏服务器(完结篇):

[https://blog.csdn.net/kaitiren/category\_11098695.html][https_blog.csdn.net_kaitiren_category_11098695.html]

[Goland _]: https://download.csdn.net/download/Kaitiren/19427755%C2%A0
[https_download.csdn.net_download_Kaitiren_19427755]: https://download.csdn.net/download/Kaitiren/19427755
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0thaXRpcmVu_size_16_color_FFFFFF_t_70]: /images/20221005/2d79cd5be7aa4b84b1552d78a9ebad8d.png
[Link 1]: https://download.csdn.net/download/Kaitiren/19427964
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0thaXRpcmVu_size_16_color_FFFFFF_t_70 1]: /images/20221005/4567d1d136b84b01841dfaf489dab596.png
[https_studygolang.com_dl]: https://studygolang.com/dl
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0thaXRpcmVu_size_16_color_FFFFFF_t_70 2]: /images/20221005/897e7e655d7a4080a0aeea5784051166.png
[leaf-server framework _]: https://download.csdn.net/download/Kaitiren/19427697
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0thaXRpcmVu_size_16_color_FFFFFF_t_70 3]: /images/20221005/9506cc5bc4fd455db504f5d175008747.png
[MongoDB]: https://www.mongodb.org/
[protobuf]: https://developers.google.com/protocol-buffers
[LeafServer]: https://github.com/name5566/leafserver
[leaf_chanrpc]: https://github.com/name5566/leaf/tree/master/chanrpc
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0thaXRpcmVu_size_16_color_FFFFFF_t_70 4]: /images/20221005/46320b593a9645b7a1250d663580b745.png
[https_kaitiren.blog.csdn.net]: https://kaitiren.blog.csdn.net/
[https_blog.csdn.net_kaitiren_category_10696929.html]: https://blog.csdn.net/kaitiren/category_10696929.html
[https_blog.csdn.net_kaitiren_category_11098695.html]: https://blog.csdn.net/kaitiren/category_11098695.html