Ice-chat概述

Ice-chat是一个基于spring boot的多端聊天系统。支持群聊与点对点聊天。当前包括uniapp客户端与Java服务器端。3分钟就可以整套系统跑起来。

项目官方网站

https://github.com/Thecosy/Ice-chat

功能与特点

功能列表

• 频道里群聊
• 与其他用户点对点聊天
• 聊天支持文字、表情、URL等
• 注册用户（不需要密码）
• 创建频道、加入频道
• 我的最近聊天、我的频道
• 聊天记录缓存（在服务器端）
• 客户端选择聊天服务器、添加聊天服务器

特点

• 简单到极致的 http 聊天服务器：一个 jar 包跑起来
• 轻量级客户端：聊天界面使用 Webview 的方式

快速开始

Docker部署方式(推荐,可用于快速上线或测试)

# 未安装docker的请先安装docker，已经安装的跳过此步
yum install docker-ce -y
#启动docker
systemctl start docker
# 配置国内源
# 创建docker目录
sudo mkdir -p /etc/docker
# 创建配置文件
sudo tee /etc/docker/daemon.json <<-'EOF'
{
"registry-mirrors": ["https://registry.docker-cn.com"]
}
EOF
# 加载新的配置文件
sudo systemctl daemon-reload
# 重启docker服务
sudo systemctl restart docker

1.运行redis容器
docker run -p 6379:6379 --name redis -d redis

2.运行Spring容器
docker run -d -p 9090:9090 \
--name icechat\
--link redis:redis\
thecosy/ice-chat:latest

聊天服务器

Ice-chat的服务器端使用 Java 语言编写，基于最简单实用的开源框架。

• http 服务器使用 websocket：轻量级的 Java Servlet 容器。
• 数据库使用 sqlite： 轻量级的 Java 内存/文件数据库。
• 页面模板使用 uniapp：轻量级的 Java 页面模板引擎。
• 打包时集成为一个整体 jar 包（包含所有的依赖包）

要运行Ice-chat服务器端，请在 github项目界面相关版本下载 dist/ 目录下的 .jar 文件。

要打包 server-java，请在项目该目录下执行 mvn package 命令。

使用如下命令运行服务器：

java -Dfile.encoding=UTF-8 -jar pushtalk-server-with-dependencies.jar

注：实际的文件名后边一般会加上一个版本号。

上述命令运行后：

• 一个 http server 启动了，监听端口为 10010
• 浏览器里输入 http://localhost:10010 则可以访问到界面
• 要正确地运行服务器，需要通过客户端访问

Ice-chat服务器默认使用 10010 端口。可以在上述命令后指定使用另外的端口。比如以下命令指定使用 10011 来启动Ice-chat聊天服务器：

java -Dfile.encoding=UTF-8 -jar pushtalk-server-with-dependencies.jar 10011

移动 客户端

客户端运行，请在 github 文件下载页 https://github.com/good-life/PushTalk/downloads/ 下载 Android apk 安装到 Android 手机即可。

你也可以自己编译 /client-android 项目之后安装到手机。

客户端默认内置官方聊天服务器地址。也可以直接在客户端添加新的服务器，选择新的聊天服务器。

如果你有服务器资源，可以长期运行，欢迎你架设Ice-chat聊天服务器，请添加到以下的页面。经过测试没有问题，会被选择预置到客户端代码里：

https://github.com/good-life/PushTalk/wiki/PushTalk-Third-Party-Servers

开发者支持

欢迎广大开发者加入本开源项目，大家一起来不断地丰满、完善Ice-chat。

本人是因为兴趣业余时间来开发Ice-chat，考虑到 IM 占用的时间太多，所以请谅解，不提供任何 IM 的沟通方式。希望大家以如下的方式交流：

• Email: 23339097@qq.com
• PushTalk频道：pushtalk, 报告bug, 新功能讨论 等

代码提交方式：请先提交Bug修复，把 diff 以文件方式发邮件给我。合作多次后，我可以把你加入到本项目贡献者里来，你就可以随时自由地提交代码了。

你也可以自由地 fork 本项目，自己去发布新的版本。

Ice-chat使用的开源协议：Apache License 2.0