README
¶
Lufy 🎮
企业级分布式游戏服务器框架
专为卡牌和策略类游戏设计，基于 Actor 模型构建
🚀 高并发 • 🔒 安全性 • 📊 监控 • 🔥 热更新 • 🌍 国际化
Lufy 基于 Actor 模型构建，提供高并发、安全性、监控和热更新能力，支持百万级并发连接。
✨ 核心特性
| 特性 | 描述 | 技术栈 |
|---|---|---|
| 🏗️ 分布式架构 | Actor模型 + 微服务，支持横向扩展 | Go + ETCD + RPC |
| 🚀 高性能网络 | 百万级并发连接，TCP + Protobuf | TCP/Protobuf/连接池 |
| 💾 数据存储 | Redis集群 + MongoDB副本集 | Redis(6节点) + MongoDB(3节点) |
| 🔥 热更新 | 配置/逻辑/插件动态更新 | Go Plugin + 版本控制 |
| 📊 监控分析 | 实时指标 + 性能分析 | Prometheus + Grafana + pprof |
| 🔐 安全防护 | JWT认证 + 反作弊 + 限流 | JWT + AES-GCM + 行为分析 |
| 🌍 国际化 | 多语言 + 本地化格式 | i18n + 动态切换 |
| 🎮 游戏框架 | 卡牌系统 + 房间管理 + AI | 模块化设计 |
📋 系统要求
| 组件 | 版本 | 用途 | 必需 |
|---|---|---|---|
| Go | 1.21+ | 运行时环境 | ✅ |
| Redis | 6.0+ | 缓存存储 | ✅ |
| MongoDB | 4.4+ | 数据持久化 | ✅ |
| ETCD | 3.5+ | 服务发现 | ✅ |
| NSQ | 1.2+ | 消息队列 | ✅ |
| Docker | Latest | 容器化部署 | 🔶 |
🏗️ 系统架构
graph TB
subgraph "客户端层"
C1[Web客户端]
C2[移动客户端]
C3[PC客户端]
end
subgraph "网关层"
GW1[Gateway-1<br/>负载均衡/路由]
GW2[Gateway-2<br/>负载均衡/路由]
end
subgraph "业务服务层"
LOGIN[Login Service<br/>认证/会话管理]
LOBBY[Lobby Service<br/>大厅/匹配]
GAME1[Game Service-1<br/>游戏逻辑]
GAME2[Game Service-2<br/>游戏逻辑]
FRIEND[Friend Service<br/>社交系统]
CHAT[Chat Service<br/>聊天系统]
MAIL[Mail Service<br/>邮件系统]
end
subgraph "管理服务层"
CENTER[Center Service<br/>集群管理]
GM[GM Service<br/>运营工具]
end
subgraph "基础设施层"
REDIS[(Redis<br/>缓存)]
MONGO[(MongoDB<br/>持久化)]
NSQ[NSQ<br/>消息队列]
ETCD[ETCD<br/>服务发现]
end
subgraph "监控层"
PROM[Prometheus<br/>指标收集]
GRAF[Grafana<br/>可视化]
PPROF[pprof<br/>性能分析]
end
C1 --> GW1
C2 --> GW2
C3 --> GW1
GW1 --> LOGIN
GW1 --> LOBBY
GW2 --> LOGIN
GW2 --> LOBBY
LOBBY --> GAME1
LOBBY --> GAME2
GAME1 --> FRIEND
GAME1 --> CHAT
GAME1 --> MAIL
LOGIN --> REDIS
GAME1 --> REDIS
GAME1 --> MONGO
CHAT --> NSQ
MAIL --> NSQ
CENTER --> ETCD
GM --> CENTER
PROM --> GW1
PROM --> LOGIN
PROM --> GAME1
GRAF --> PROM
PPROF --> GAME1
技术栈: Go + Redis + MongoDB + ETCD + NSQ + Prometheus + Grafana + Docker
🎯 服务节点
| 服务 | RPC端口 | 监控端口 | 核心功能 |
|---|---|---|---|
| Gateway | 9001-9002 | 7001-7002 | 客户端接入、负载均衡 |
| Login | 9020 | 7020 | 用户认证、会话管理 |
| Lobby | 9030 | 7030 | 房间管理、匹配系统 |
| Game | 9100-9102 | 7100-7102 | 游戏逻辑、AI系统 |
| Friend | 9040 | 7040 | 好友系统、社交功能 |
| Chat | 9050 | 7050 | 聊天系统、消息广播 |
| 9060 | 7060 | 邮件系统、奖励发放 | |
| GM | 9200 | 7200 | 运营管理、热更新 |
| Center | 9010 | 7010 | 集群管理、监控统计 |
🚀 快速开始
1. 克隆项目
git clone https://github.com/phuhao00/lufy.git
cd lufy
2. 部署方式
| 方式 | 命令 | 适用场景 |
|---|---|---|
| Docker单机 | docker-compose up -d |
开发测试 |
| 集群部署 | ./scripts/start_cluster.sh |
生产环境 |
| 本地开发 | go mod tidy && make build && ./scripts/start.sh |
本地调试 |
3. 验证部署
# 检查服务状态
./scripts/status.sh
# 测试客户端连接
go run examples/client/main.go
4. 监控面板
| 服务 | 地址 | 用途 |
|---|---|---|
| 主监控 | http://localhost:7001 | 服务状态 |
| Grafana | http://localhost:3000 | 可视化监控 |
| Prometheus | http://localhost:9090 | 指标查询 |
⚙️ 配置说明
主配置文件：config/config.yaml
server:
name: "lufy-game-server"
debug: true
network:
tcp_port: 8001
rpc_port: 9001
http_port: 7001
database:
redis:
addr: "127.0.0.1:6379"
mongodb:
uri: "mongodb://127.0.0.1:27017"
database: "lufy_game"
🔥 热更新
支持配置、逻辑、数据的动态更新，无需重启服务。
# 重载配置
./scripts/hot_reload.sh config
# 重载游戏逻辑
./scripts/hot_reload.sh logic game
# 查看状态
./scripts/hot_reload.sh status
📊 监控与分析
监控指标: 在线用户数、QPS、响应时间、错误率、内存使用、Goroutine数量
性能分析:
# CPU/内存/协程分析
go tool pprof http://localhost:8080/debug/pprof/profile
go tool pprof http://localhost:8080/debug/pprof/heap
1. 性能问题诊断
问题现象：响应延迟高、CPU/内存使用率异常
诊断工具：
# 实时性能监控
go run tools/performance_analyzer.go watch
# CPU热点分析
go tool pprof http://localhost:8001/debug/pprof/profile?seconds=30
# 内存分析
go tool pprof http://localhost:8001/debug/pprof/heap
# Goroutine泄漏检测
go tool pprof http://localhost:8001/debug/pprof/goroutine
# 在pprof交互模式中：
(pprof) top 20 # 查看CPU热点
(pprof) list funcName # 查看函数详情
(pprof) traces # 查看调用栈
(pprof) web # 生成可视化图表
2. 内存泄漏排查
# 1. 持续监控堆内存
watch -n 5 "go tool pprof -top http://localhost:8001/debug/pprof/heap"
# 2. 生成内存快照对比
go tool pprof -base heap1.pb.gz heap2.pb.gz
# 3. 查看对象池统计
curl http://localhost:7001/api/pool/stats
# 4. 检查Goroutine泄漏
go tool pprof http://localhost:8001/debug/pprof/goroutine
(pprof) top
(pprof) traces
🚀 部署案例
小型游戏部署（1-1万用户）
# 推荐配置
services:
gateway: 1个实例 (2核4GB)
login: 1个实例 (1核2GB)
game: 2个实例 (4核8GB)
其他服务: 各1个实例 (1核2GB)
总资源需求: 16核32GB内存
中型游戏部署（1-10万用户）
# 推荐配置
services:
gateway: 3个实例 (4核8GB)
login: 2个实例 (2核4GB)
game: 5个实例 (8核16GB)
friend/chat/mail: 各2个实例 (2核4GB)
总资源需求: 64核128GB内存
大型游戏部署（10万+用户）
# 推荐配置
gateway:
instances: 5+
resources: 8核16GB
game:
instances: 10+
resources: 16核32GB
数据库:
redis_cluster: 6节点
mongodb_replica: 3节点
监控:
prometheus: 专用服务器
grafana: 高可用部署
🛡️ 安全建议
生产环境安全检查清单
- 更改默认密码和密钥
- 启用HTTPS/TLS加密
- 配置防火墙规则
- 启用访问日志记录
- 定期更新依赖包
- 配置自动备份
- 启用监控告警
- 进行渗透测试
- 制定应急响应计划
安全配置模板
# config/security.yaml
security:
tls:
enabled: true
cert_file: "/certs/server.crt"
key_file: "/certs/server.key"
cors:
allowed_origins: ["https://yourgame.com"]
allowed_methods: ["GET", "POST"]
allowed_headers: ["Authorization", "Content-Type"]
rate_limiting:
enabled: true
global_limit: 10000
per_ip_limit: 100
burst_size: 10
session:
secure: true
http_only: true
same_site: "strict"
max_age: 86400
git clone https://github.com/phuhao00/lufy.git
cd lufy
./scripts/start_enhanced.sh --with-monitoring
# 🎉 你的游戏服务器已经运行在 http://localhost:7001
⭐ 如果你觉得 Lufy 对你有帮助，请给我们一个 Star！ ⭐
Made with ❤️ by the Lufy Team
Directories
Click to show internal directories.
Click to hide internal directories.