同步操作将从 balloonwj/flamingo 强制同步,此操作会覆盖自 Fork 仓库以来所做的任何修改,且无法恢复!!!
确定后同步将在后台操作,完成时将刷新页面,请耐心等待。
我为 Flamingo 专门录制了两部高清技术讲解视频以方便读者学习,视频中介绍了Flamingo的编译和部署方法、整体架构、各个模块的技术实现细节以及如何学习Flamingo的方法,需要视频教程的读者可以扫描[高性能服务器开发]公众号二维码,关注后并在后台回复关键字“flamingo”即可得到下载链接。
Flamingo IM 是一款高性能、轻量级的开源即时通讯软件,目前包括服务器端、pc 端、安卓端,微信版本和 IOS 版本目前正在开发中。
目前已经实现了如下功能(这里只列举网络相关的功能,其他客户端已经实现的功能不统计在列,请自行发现):
作系统是 Linux,推荐的版本是 CentOS 7.0 以上。服务器代码使用纯C++11开发,所以您的gcc/g++版本必须至少在4.7以上,推荐的版本是4.8.5。另外,使用cmake和makefile工具进行项目管理和编译,因此您需要安装cmake和makefile工具。
安装 mysql。
使用的数据库是mysql,如果您使用的是CentOS 7.0及以上系统,需要安装 mariadb-server、mariadb-client 和 mariadb-devel。如果您使用的是其他版本的linux系统,请安装 mysql-server、mysql-client 和 mysql-devel。
聊天服务 chatserver 会使用到 mysql,mysql 的库名(默认库名叫 flamingo)、登陆用户名和密码配置在 flamingoserver/etc/chatserver.conf
文件中。
首次启动聊天服务chatserver时,程序会自动检测是否存在flamingo这样的库,如果不存在则创建之,并检测相应的数据表是否存在,如果不存在则创建它们。所以,无需手动创建对应的库和表。当然,不排除由于不同的mysql版本对应的SQL语法有细微差别,可能建表会失败,这个时候你可能需要手动建表,建表语句在flamingoserver/table.sql中。flamingo目前使用的四个表分别是:
表名 | 用途说明 |
---|---|
t_user | 用户信息表 |
t_user_relationship | 好友关系及群成员信息表 |
t_chatmsg | 聊天记录表 |
进入 flamingoserver
目录,执行:
cmake .
如果没有错误,会产生一个 Makefile 文件。
执行如下命令生成可执行文件:chatserver、fileserver、imgserver。
make
各个服务的作用如下:
服务名称 | 用途说明 |
---|---|
chatserver | 聊天服务,用于基本的用户注册、登陆、聊天功能。 |
fileserver | 文件服务,用于聊天窗口中的离线文件的发送和客户端自动升级包的下载。 |
imgserver | 图片服务,用于聊天中图片文件的发送与用户自定义头像的上传与下载。 |
chatserver、fileserver、imgserver 这三个服务是相互独立的,可以直接在 Linux 中单独启动,也可以以守护进程的形式启动,守护进程形式启动命令:
./chatserver -d
./fileserver -d
./imgserver -d
可以使用一下 lsof
命令查看端口是否处于正常侦听状态:
[zhangyl@localhost flamingoserver]$ lsof -i -Pn
COMMAND PID USER FD TYPE DEVICE SIZE/OFF NODE NAME
chatserve 18540 zhangyl 19u IPv4 1129031 0t0 TCP *:20000 (LISTEN)
chatserve 18540 zhangyl 27u IPv4 1129032 0t0 TCP *:8888 (LISTEN)
chatserve 18540 zhangyl 35u IPv4 1129033 0t0 TCP *:12345 (LISTEN)
fileserve 18552 zhangyl 25u IPv4 1130523 0t0 TCP *:20001 (LISTEN)
imgserver 18562 zhangyl 25u IPv4 1131971 0t0 TCP *:20002 (LISTEN)
端口号 | 所属服务 | 用途说明 |
---|---|---|
20000 | chatserver | 聊天端口 |
8888 | chatserver | 聊天服务的监控端口,可以使用telnet或nc命令远程连接至聊天服务去查看服务器的一些实时状态信息 |
12345 | chatserver | 聊天服务的http端口,聊天服务不仅支持长连接,也支持http短连接。 |
20001 | fileserver | 文件服务端口 |
20002 | imgserver | 图片服务端口 |
上表中的8888端口可以使用nc命令,使用方式: nc -v ip port
去连接,其中port这里就是 8888,-v 选项是 nc 命令支持的选项,表示要求显示的信息丰富一点。示例:
[zhangyl@localhost flamingoserver]$ nc -v 127.0.0.1 8888
Ncat: Version 6.40 ( http://nmap.org/ncat )
Ncat: Connected to 127.0.0.1:8888.
1. help-show help info
2. ul-show online user list
3. su-show userinfo specified by userid: su [userid]
ul
No user online.
su
please specify userid.
help
1. help-show help info
2. ul-show online user list
3. su-show userinfo specified by userid: su [userid]
连接成功以后,你可以根据命令说明输入相应的命令来查看服务器的状态信息,目前只实现三个命令,即上面显示的 help、ul、su,您可以继续增加更多的命令。
**提醒一下:**服务器代码不仅是一款即时通讯软件的服务器代码,同时也是一款通用的 C++11 服务器框架。
使用Visual Studio 2019打开flamingoclient/目录下的Flamingo.sln即可编译。这个解决方案包括三个工程项目,说明如下:
项目名称 | 项目说明 |
---|---|
Flamingo.sln | flamingo pc版主程序 |
CatchScreen | flamingo聊天中用的抓屏程序,类似QQ截图。 |
iUpdateAuto | 用户pc端自动升级的zip解压工具。 |
生成后的程序位于目录flamingoclient\Bin目录下,其中客户端与服务器的连接配置信息位于flamingoclient\Bin\config\flamingo.ini文件中,直接打开Flamingo.exe即可启动flamingo pc端。
用Android Studio打开**flamingoAndroid/**目录下的安卓工程,编译产生相应的flamingo.apk文件,安装至安卓手机即可使用。与服务器的连接设置,在安卓版本的登陆界面的服务器设置中。
由于平常工作比较忙,不能固定周期地更新flamingo,但我保证我会一直维护下去。更新日志请参见:
https://github.com/baloonwj/flamingo/issues/1
如果您在使用的过程中发现任何bug,可以给我发邮件:balloonwj@qq.com,也可以去 bug 反馈页面进行反馈:
https://github.com/baloonwj/flamingo/issues/5。
凡是涉及到崩溃、死机等影响使用的重大 bug,我将在三个工作日内予以解决;其他不影响使用的功能性 bug,两个星期内解决。
如果您在使用这个项目的过程中遇到任何问题,或者您对我的项目有任何意见或者建议,再或者有不错的想法欢迎与我交流,可以加我微信 easy_coder,您也可以加入QQ技术群进行交流讨论:729995516。
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。