2019-07-29 23:42:16 +08:00
|
|
|
|
|
2019-11-26 10:57:14 +08:00
|
|
|
|
[WindChat-风信](https://gitee.com/wind-chat/wind-im/blob/master/README.md)
|
2019-07-29 23:42:16 +08:00
|
|
|
|
====
|
|
|
|
|
|
|
|
|
|
[![License](https://img.shields.io/badge/license-apache2-blue.svg)](LICENSE)
|
|
|
|
|
|
|
|
|
|
**源码仓库**
|
|
|
|
|
|
|
|
|
|
> * **Github**: https://github.com/akaxincom/openzaly
|
2019-11-26 10:49:27 +08:00
|
|
|
|
> * `国内快` Gitee: https://gitee.com/wind-chat/wind-im.git
|
2019-07-29 23:42:16 +08:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
简介
|
|
|
|
|
----
|
|
|
|
|
|
2019-11-26 10:49:27 +08:00
|
|
|
|
WindChat 是一款开源免费私有IM聊天软件,原身是Akaxin即时通讯开源软件,由原开发者SAM2O2O个人维护,主要面向企业定制IM。
|
2019-07-29 23:42:16 +08:00
|
|
|
|
|
|
|
|
|
特性:
|
|
|
|
|
|
|
|
|
|
* 单聊、群聊(含文字、图片、语音等)
|
|
|
|
|
* 端到端的加密消息(服务端不可解密,服务器可通过配置关闭此特性)
|
|
|
|
|
* 匿名注册、实名注册,以及注册邀请码机制(只允许特定用户注册)
|
|
|
|
|
* 扩展机制
|
|
|
|
|
* 等
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<p align="center">
|
2019-11-26 10:49:27 +08:00
|
|
|
|
<img align="center" src="https://images.gitee.com/uploads/images/2019/1126/104318_e96d4636_1566564.jpeg" width="200" /> <img align="center" src="https://images.gitee.com/uploads/images/2019/1126/104318_3d9b5edb_1566564.jpeg" width="200" /> <img align="center" src="https://images.gitee.com/uploads/images/2019/1126/104318_3751606d_1566564.jpeg" width="200" />
|
2019-07-29 23:42:16 +08:00
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
一、快速体验
|
|
|
|
|
----
|
|
|
|
|
|
|
|
|
|
**1. 启动服务器**
|
|
|
|
|
|
2019-11-26 10:57:14 +08:00
|
|
|
|
* git clone https://gitee.com/wind-chat/wind-im.git
|
2019-07-29 23:42:16 +08:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
openzlay 0.10.6开始支持personal(个人版)与team版,默认状态下使用personal
|
|
|
|
|
|
|
|
|
|
支持的启动参数:`java -jar openzaly-server.jar -h`
|
|
|
|
|
|
|
|
|
|
openzaly Personal版本 命令:
|
|
|
|
|
|
|
|
|
|
* 版本升级:`java -jar openzaly-server.jar -upgrade` ,此命令在服务与sqlite数据库版本不一致时执行,正常情况无需执行
|
|
|
|
|
|
|
|
|
|
* 启动命令:`java -jar openzaly-server.jar`
|
|
|
|
|
|
|
|
|
|
openzaly Team版本 命令:
|
|
|
|
|
|
|
|
|
|
* 生成Team版本所需配置模版:`java -jar openzaly-server.jar -team`
|
|
|
|
|
|
|
|
|
|
* 修改配置文件: 上一步会生成 openzaly-server.config 使用mysql数据库需在openzaly-server.config配置文件中配置mysql参数:
|
|
|
|
|
主库(数据库编码需要设置utf8mb4):
|
|
|
|
|
openzaly.mysql.host=localhost //数据库的地址
|
|
|
|
|
openzaly.mysql.port=3306 //数据库端口
|
|
|
|
|
openzaly.mysql.database=openzaly //数据库名称
|
|
|
|
|
openzaly.mysql.username=root //mysql数据库访问用户
|
|
|
|
|
openzaly.mysql.password=1234567890 //mysql数据库密码
|
|
|
|
|
|
|
|
|
|
从库(如果需要使用主从模式,配置这里,不需要从库则不需要配置)数据库编码需要设置utf8mb4:
|
|
|
|
|
openzaly.mysql.slave.host=localhost
|
|
|
|
|
openzaly.mysql.slave.port=3306
|
|
|
|
|
openzaly.mysql.slave.database=openzaly
|
|
|
|
|
openzaly.mysql.slave.username=root
|
|
|
|
|
openzaly.mysql.slave.password=1234567890
|
|
|
|
|
|
|
|
|
|
其他mysql参数为使用mysql连接池的配置参数,如若涉及性能优化可开启配置项。
|
|
|
|
|
|
|
|
|
|
* 迁移数据库命令:openzaly支持使用者把Personal版本的sqlite中的数据迁移到Team版本的mysql数据库
|
|
|
|
|
如果执行这一步需要在openzaly-server.config配置文件中配置:
|
|
|
|
|
`openzaly.sqlite.url=openzalyDB.sqlite3` 这里指定sqlite数据库文件的位置
|
|
|
|
|
|
|
|
|
|
继续执行迁移命令:
|
|
|
|
|
`java -jar openzaly-server.jar -migrate`
|
|
|
|
|
|
|
|
|
|
* 启动命令:`java -jar openzaly-server.jar`
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
**2. 下载客户端**
|
|
|
|
|
|
|
|
|
|
> * [iOS](https://itunes.apple.com/cn/app/%E9%98%BF%E5%8D%A1%E4%BF%A1/id1346971087?mt=8)
|
|
|
|
|
> * [Android](https://www.akaxin.com)
|
|
|
|
|
|
|
|
|
|
**3. 访问站点**
|
|
|
|
|
|
|
|
|
|
> * 生成账号(手机账号与匿名均可)
|
|
|
|
|
> * 输入站点服务器
|
|
|
|
|
> * 首次登陆为管理员,邀请码:000000
|
|
|
|
|
> * 别的用户登陆后可以互加好友,开始聊天。
|
|
|
|
|
|
|
|
|
|
* 匿名账号,账号保存在设备本地,用户不会填写手机信息,任何地方都获取不到。
|
|
|
|
|
|
|
|
|
|
> **站点注册方式默认为匿名,进入站点后,请根据情况第一时间修改为 实名 或者 开启邀请码,防止恶意用户进入**
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
二、源码编译安装
|
|
|
|
|
----
|
|
|
|
|
|
2019-11-26 10:57:14 +08:00
|
|
|
|
- 本地安装Java1.8+
|
|
|
|
|
- 需要本地有mvn,直接使用mvn编译即可。
|
|
|
|
|
|
2019-07-29 23:42:16 +08:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
三、扩展开发
|
|
|
|
|
----
|
|
|
|
|
|
2019-11-26 10:57:14 +08:00
|
|
|
|
WindChat 具有灵活、强大的扩展机制 `(“管理平台” 就是一个扩展)`。通过嵌入WEB页面,与后端的扩展API进行交互, 可以很轻松的构建丰富的业务功能,如:
|
2019-07-29 23:42:16 +08:00
|
|
|
|
|
|
|
|
|
* 附近交友
|
|
|
|
|
* 店铺点评
|
|
|
|
|
* 在线游戏
|
|
|
|
|
* 等等等等
|
|
|
|
|
|
|
|
|
|
你的聊天服务器,将摇身一变,成为一个强大的社交软件平台。
|
|
|
|
|
|
|
|
|
|
> 扩展机制处于技术预览阶段,如果你希望在自己的业务中开发自己的扩展,可以联系我们( mail: hi@akaxin.xyz ),我们将免费提供文档与技术答疑。
|
|
|
|
|
|
|
|
|
|
以下是我们开发的一个 “校园社交” 的扩展,截图如下:
|
|
|
|
|
|
|
|
|
|
<p align="center">
|
|
|
|
|
<img align="center" src="https://raw.githubusercontent.com/akaxincom/faq/master/app_pic/plugin.1.jpeg" width="200" /> <img align="center" src="https://raw.githubusercontent.com/akaxincom/faq/master/app_pic/plugin.2.jpeg" width="200" /> <img align="center" src="https://raw.githubusercontent.com/akaxincom/faq/master/app_pic/plugin.3.jpeg" width="200" />
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
> 大家可以去 demo.akaxin.com 体验。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
四、技术贡献者
|
|
|
|
|
----
|
|
|
|
|
|
|
|
|
|
> 以加入时间排序
|
|
|
|
|
|
2019-11-26 10:57:14 +08:00
|
|
|
|
* sisishiliu(Akaxin/DuckChat创始人)
|
2019-07-29 23:42:16 +08:00
|
|
|
|
* SAM2O2O
|
|
|
|
|
* childeYin
|
|
|
|
|
* yi.chao
|
|
|
|
|
* lei.yu
|
|
|
|
|
* cuikun
|
|
|
|
|
* alexfanchina
|
|
|
|
|
* Mino0885
|
2019-11-26 10:50:02 +08:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
**向我们提问**
|
|
|
|
|
|
|
|
|
|
> 扫码加微信群:
|
|
|
|
|
![输入图片说明](https://images.gitee.com/uploads/images/2019/1126/104323_210ea786_1566564.png "屏幕截图.png")
|