# TIM

**Repository Path**: Nl_1/tim

## Basic Information

- **Project Name**: TIM
- **Description**: No description available
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2025-06-02
- **Last Updated**: 2025-06-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 介绍

`TIM` 一款面向开发者的 `IM(即时通讯)`系统；同时提供了一些组件帮助开发者构建一款属于自己可水平扩展的 `IM` 。

借助 `TIM` 你可以实现以下需求：

- `IM` 即时通讯系统。
- 适用于 `APP` 的消息推送中间件。

## 系统架构

![](http://assets.processon.com/chart_image/611bb33a1efad412479f7157.png)

- `TIM` 中的各个组件均采用 `SpringBoot` 构建。
- 采用 `Netty` 构建底层通信。
- `Redis` 存放各个客户端的路由信息、账号信息、在线状态等。
- `Zookeeper` 用于 `IM-server` 服务的注册与发现。
- 认证这块逻辑只做了简单实现

### tim-server

`IM` 服务端；用于接收 `client` 连接、消息透传、消息推送等功能。

**支持集群部署。**

### tim-gateway

消息路由网关；用于处理消息路由、消息转发、用户登录、用户下线以及一些运营工具（获取在线用户数等）。

### tim-client

`IM` 客户端；给用户使用的消息终端，一个命令即可启动并向其他人发起通讯（群聊、私聊）。

## 流程图

![](http://assets.processon.com/chart_image/611bb33a1efad412479f7157.png)

- 客户端向 `gateway` 发起登录。
- 登录成功从 `Zookeeper` 中选择可用 `IM-server` 返回给客户端，并保存登录、路由信息到 `Redis`。
- 客户端向 `IM-server` 发起长连接，成功后保持心跳。
- 客户端下线时通过 `gateway` 清除状态信息。

## 快速启动

首先需要安装 `Zookeeper、Redis` 并保证网络通畅。

ZK存服务器的地址和端口

redis存客户端的账号-名字，账号-地址和端口，当前处于登录状态的用户账号

Jenkins拉取公共代码并install，拉取server和gateway代码部署到docker，拉取client代码打成jar包，将client的jar包拷贝到不同的服务器执行

### 1、部署网关服务器(tim-gateway)

本地的话直接运行GatewayApplication.java。线上通过Jenkins部署到docker
> tim-gateway 本身就是无状态，可以部署多台；使用 Nginx 代理即可。

### 2、部署 IM-server(tim-server)

本地的话直接运行TIMServerApplication.java。线上通过Jenkins部署到docker

#### 3、注册账号 用postman注册三个账号 wangwu wangwu2 ldj，去redis中查询是否注册成功

```shell
curl -X POST --header 'Content-Type: application/json' --header 'Accept: application/json' -d '{
  "reqNo": "13766668890",
  "timeStamp": 0,
  "userName": "wangwu"
}' 'http://路由服务器:8090/registerAccount'
```

```json
{
  "code": "9000",
  "message": "成功",
  "reqNo": null,
  "dataBody": {
    "userId": 1633614560039,
    "userName": "wangwu"
  }
}
```

从返回结果中获取 `userId`,写入客户端项目tim-client的配置文件里

也可以在启动jar包时指定,分别将client 的jar包拷贝到三台不同的服务器（或者同一台服务器启动时指定配置文件中不同的端口）

### 4、启动客户端(tim-client)

直接运行TIMClientApplication.java。线上通过Jenkins获取到jar包并mv到指定位置，然后执行jar包

mv /root/.m2/repository/com/ldj/netty/tim-client/1.0.0-SNAPSHOT/tim-client-1.0.0-SNAPSHOT.jar /opt/software

cd /opt/software

java -jar tim-client-1.0.0-SNAPSHOT.jar --tim.user.id=1652526381087 --tim.user.userName=wangwu

java -jar tim-client-1.0.0-SNAPSHOT.jar --tim.user.id=1652497656957 --tim.user.userName=wangwu2

java -jar tim-client-1.0.0-SNAPSHOT.jar --tim.user.id=1652526093588 --tim.user.userName=ldj1

java -jar tim-client-1.0.0-SNAPSHOT.jar --tim.user.id=1652526173060 --tim.user.userName=ldj

查看redis中login-status中已经登录的用户有哪些

### 5、客户端内置命令

| 命令 | 描述|
| ------ | ------ |
| `:q!` | 退出客户端|
| `:olu` | 获取所有在线用户信息 |
| `:all` | 获取所有命令 |
| `:q [option]` | 【:q 关键字】查询聊天记录 |
| `:ai` | 开启 AI 模式 |
| `:qai` | 关闭 AI 模式 |
| `:pu` | 模糊匹配用户 |
| `:info` | 获取客户端信息 |
| `进行聊天的方法` | 见下面几个段落 |

### 聊天记录查询

使用命令 `:q 关键字` 即可查询与个人相关的聊天记录。

> 客户端聊天记录默认存放在 `/opt/logs/tim/`，所以需要这个目录的写入权限。也可在启动命令中加入 `--tim.msg.logger.path = /自定义` 参数自定义目录。

### 前缀匹配用户名

使用命令 `:pu prefix` 可以按照前缀的方式搜索用户信息。

> 该功能主要用于在移动端中的输入框中搜索用户。

### 群聊/私聊

#### 群聊

群聊只需要在控制台里输入消息回车后即可发送，同时所有在线客户端都可收到消息。

#### 私聊

私聊首先需要知道对方的 `userID` 才能进行。

输入命令 `:olu` 可列出所有在线用户。

接着使用 `userId::消息内容` 的格式即可发送私聊消息。

同时另一个账号收不到消息。