OpenIM is a service platform specifically designed for integrating chat, audio-video calls, notifications, and AI chatbots into applications. It provides a range of powerful APIs and Webhooks, enabling developers to easily incorporate these interactive features into their applications. OpenIM is not a standalone chat application, but rather serves as a platform to support other applications in achieving rich communication functionalities. The following diagram illustrates the interaction between AppServer, AppClient, OpenIMServer, and OpenIMSDK to explain in detail.
Unlike standalone chat applications such as Telegram, Signal, and Rocket.Chat, OpenIM offers an open-source instant messaging solution designed specifically for developers rather than as a directly installable standalone chat app. Comprising OpenIM SDK and OpenIM Server, it provides developers with a complete set of tools and services to integrate instant messaging functions into their applications, including message sending and receiving, user management, and group management. Overall, OpenIM aims to provide developers with the necessary tools and framework to implement efficient instant messaging solutions in their applications.
**OpenIMSDK** is an IM SDK designed for **OpenIMServer**, created specifically for embedding in client applications. Its main features and modules are as follows:
**OpenIMSDK**, designed for **OpenIMServer**, is an IM SDK created specifically for integration into client applications. It supports various functionalities and modules:
+ 🌟 Main Features:
+ 🌟 Main Features:
- 📦 Local Storage
- 📦 Local storage
- 🔔 Listener Callbacks
- 🔔 Listener callbacks
- 🛡️ API Wrapping
- 🛡️ API wrapping
- 🌐 Connection Management
- 🌐 Connection management
+ 📚 Main Modules:
+ 📚 Main Modules:
1. 🚀 Initialization and Login
1. 🚀 Initialization and Login
2. 👤 User Management
2. 👤 User Management
3. 👫 Friend Management
3. 👫 Friends Management
4. 🤖 Group Functions
4. 🤖 Group Functions
5. 💬 Conversation Handling
5. 💬 Session Handling
It is built using Golang and supports cross-platform deployment, ensuring a consistent access experience across all platforms.
👉 **[Explore GO SDK](https://github.com/openimsdk/openim-sdk-core)**
## 🌐 About OpenIMServer
+ **OpenIMServer** has the following characteristics:
Built with Golang and supports cross-platform deployment to ensure a consistent integration experience across all platforms.
- 🌐 Microservice architecture: Supports cluster mode, including a gateway and multiple rpc services.
- 🚀 Diverse deployment methods: Supports deployment via source code, Kubernetes, or Docker.
- Support for massive user base: Super large groups with hundreds of thousands of users, tens of millions of users, and billions of messages.
### Enhanced Business Functionality:
👉 **[Explore the GO SDK](https://github.com/openimsdk/openim-sdk-core)**
+ **REST API**: OpenIMServer offers REST APIs for business systems, aimed at empowering businesses with more functionalities, such as creating groups and sending push messages through backend interfaces.
## 🌐 Introduction to OpenIMServer
+ **Webhooks**: OpenIMServer provides callback capabilities to extend more business forms. A callback means that OpenIMServer sends a request to the business server before or after a certain event, like callbacks before or after sending a message.
- 🌐 Microservices Architecture: Supports cluster mode, including a gateway and multiple rpc services.
- 🚀 Diverse Deployment Options: Supports source code, Kubernetes, or Docker deployment.
- Massive User Support: Supports large-scale groups with hundreds of thousands, millions of users, and billions of messages.
## :building_construction: Overall Architecture
### Enhanced Business Functions:
Delve into the heart of Open-IM-Server's functionality with our architecture diagram.
+ **REST API**: Provides a REST API for business systems to enhance functionality, such as group creation and message pushing through backend interfaces.
[](https://vscode.dev/github/openimsdk/open-im-server)
[](https://codespaces.new/openimsdk/open-im-server)
OpenIM Our goal is to build a top-level open source community. We have a set of standards, in the [Community repository](https://github.com/OpenIMSDK/community).
If you'd like to contribute to this Open-IM-Server repository, please read our [contributor documentation](https://github.com/openimsdk/open-im-server/blob/main/CONTRIBUTING.md).
## System Support
Before you start, please make sure your changes are in demand. The best for that is to create a [new discussion](https://github.com/openimsdk/open-im-server/discussions/new/choose) OR [Slack Communication](https://join.slack.com/t/openimsdk/shared_invite/zt-22720d66b-o_FvKxMTGXtcnnnHiMqe9Q), or if you find an issue, [report it](https://github.com/openimsdk/open-im-server/issues/new/choose) first.
Supports Linux, Windows, Mac systems, and ARM and AMD CPU architectures.
- [OpenIM API Reference](https://github.com/openimsdk/open-im-server/tree/main/docs/contrib/api.md)
We want anyone to get involved in our community and contributing code, we offer gifts and rewards, and we welcome you to join us every Thursday night.
## :writing_hand: How to Contribute
Our conference is in the [OpenIM Slack](https://join.slack.com/t/openimsdk/shared_invite/zt-22720d66b-o_FvKxMTGXtcnnnHiMqe9Q) 🎯, then you can search the Open-IM-Server pipeline to join
We welcome contributions of any kind! Please make sure to read our [Contributor Documentation](https://github.com/openimsdk/open-im-server/blob/main/CONTRIBUTING.md) before submitting a Pull Request.
We take notes of each [biweekly meeting](https://github.com/orgs/OpenIMSDK/discussions/categories/meeting) in [GitHub discussions](https://github.com/openimsdk/open-im-server/discussions/categories/meeting), Our historical meeting notes, as well as replays of the meetings are available at [Google Docs :bookmark_tabs:](https://docs.google.com/document/d/1nx8MDpuG74NASx081JcCpxPgDITNTpIIos0DS6Vr9GU/edit?usp=sharing).
+ **[Report a Bug](https://github.com/openimsdk/open-im-server/issues/new?assignees=&labels=bug&template=bug_report.md&title=)**
+ **[Suggest a Feature](https://github.com/openimsdk/open-im-server/issues/new?assignees=&labels=enhancement&template=feature_request.md&title=)**
+ **[Submit a Pull Request](https://github.com/openimsdk/open-im-server/pulls)**
## :eyes: Who Are Using OpenIM
Thank you for contributing to building a powerful instant messaging solution!
Check out our [user case studies](https://github.com/OpenIMSDK/community/blob/main/ADOPTERS.md) page for a list of the project users. Don't hesitate to leave a [📝comment](https://github.com/openimsdk/open-im-server/issues/379) and share your use case.
## :closed_book: License
## :page_facing_up: License
OpenIMSDK is available under the Apache License 2.0. See the [LICENSE file](https://github.com/openimsdk/open-im-server/blob/main/LICENSE) for more information.
OpenIM is licensed under the Apache 2.0 license. See [LICENSE](https://github.com/openimsdk/open-im-server/tree/main/LICENSE) for the full license text.
The OpenIM logo, including its variations and animated versions, displayed in this repository [OpenIM](https://github.com/openimsdk/open-im-server) under the [assets/logo](./assets/logo) and [assets/logo-gif](assets/logo-gif) directories, are protected by copyright laws.
# The IP address where this RPC service registers itself; if left blank, it defaults to the internal network IP
registerIP:''
registerIP:''
# List of ports that the RPC service listens on; configuring multiple ports will launch multiple instances. These must match the number of configured prometheus ports
ports:[10140]
ports:[10140]
prometheus:
prometheus:
# Enable or disable Prometheus monitoring
enable:true
enable:true
# List of ports that Prometheus listens on; these must match the number of rpc.ports to ensure correct monitoring setup
ports:[20112]
ports:[20112]
# IP address that the RPC/WebSocket service listens on; setting to 0.0.0.0 listens on both internal and external IPs. If left blank, it automatically uses the internal network IP
listenIP:0.0.0.0
listenIP:0.0.0.0
longConnSvr:
longConnSvr:
# WebSocket listening ports, must match the number of rpc.ports
ports:[10001]
ports:[10001]
# Maximum number of WebSocket connections
websocketMaxConnNum:100000
websocketMaxConnNum:100000
# Maximum length of the entire WebSocket message packet
websocketMaxMsgLen:4096
websocketMaxMsgLen:4096
# WebSocket connection handshake timeout in seconds
websocketTimeout:10
websocketTimeout:10
# 1: For Android, iOS, Windows, Mac, and web platforms, only one instance can be online at a time
# The IP address where this RPC service registers itself; if left blank, it defaults to the internal network IP
registerIP:''
registerIP:''
# IP address that the RPC service listens on; setting to 0.0.0.0 listens on both internal and external IPs. If left blank, it automatically uses the internal network IP
listenIP:0.0.0.0
listenIP:0.0.0.0
# List of ports that the RPC service listens on; configuring multiple ports will launch multiple instances. These must match the number of configured prometheus ports
ports:[10170]
ports:[10170]
prometheus:
prometheus:
# Enable or disable Prometheus monitoring
enable:true
enable:true
# List of ports that Prometheus listens on; these must match the number of rpc.ports to ensure correct monitoring setup
ports:[20107]
ports:[20107]
maxConcurrentWorkers:3
maxConcurrentWorkers:3
enable:getui
#"Use geTui for offline push notifications, or choose fcm or jpns; corresponding configuration settings must be specified."
# The IP address where this RPC service registers itself; if left blank, it defaults to the internal network IP
registerIP:''
registerIP:''
# IP address that the RPC service listens on; setting to 0.0.0.0 listens on both internal and external IPs. If left blank, it automatically uses the internal network IP
listenIP:0.0.0.0
listenIP:0.0.0.0
# List of ports that the RPC service listens on; configuring multiple ports will launch multiple instances. These must match the number of configured prometheus ports
ports:[10160]
ports:[10160]
prometheus:
prometheus:
# Enable or disable Prometheus monitoring
enable:true
enable:true
# List of ports that Prometheus listens on; these must match the number of rpc.ports to ensure correct monitoring setup
# The IP address where this RPC service registers itself; if left blank, it defaults to the internal network IP
registerIP:''
registerIP:''
# IP address that the RPC service listens on; setting to 0.0.0.0 listens on both internal and external IPs. If left blank, it automatically uses the internal network IP
listenIP:0.0.0.0
listenIP:0.0.0.0
# List of ports that the RPC service listens on; configuring multiple ports will launch multiple instances. These must match the number of configured prometheus ports
ports:[10180]
ports:[10180]
prometheus:
prometheus:
# Enable or disable Prometheus monitoring
enable:true
enable:true
# List of ports that Prometheus listens on; these must match the number of rpc.ports to ensure correct monitoring setup
# The IP address where this RPC service registers itself; if left blank, it defaults to the internal network IP
registerIP:''
registerIP:''
# IP address that the RPC service listens on; setting to 0.0.0.0 listens on both internal and external IPs. If left blank, it automatically uses the internal network IP
listenIP:0.0.0.0
listenIP:0.0.0.0
# List of ports that the RPC service listens on; configuring multiple ports will launch multiple instances. These must match the number of configured prometheus ports
ports:[10120]
ports:[10120]
prometheus:
prometheus:
# Enable or disable Prometheus monitoring
enable:true
enable:true
# List of ports that Prometheus listens on; these must match the number of rpc.ports to ensure correct monitoring setup
# The IP address where this RPC service registers itself; if left blank, it defaults to the internal network IP
registerIP:''
registerIP:''
# IP address that the RPC service listens on; setting to 0.0.0.0 listens on both internal and external IPs. If left blank, it automatically uses the internal network IP
listenIP:0.0.0.0
listenIP:0.0.0.0
# List of ports that the RPC service listens on; configuring multiple ports will launch multiple instances. These must match the number of configured prometheus ports
ports:[10150]
ports:[10150]
prometheus:
prometheus:
# Enable or disable Prometheus monitoring
enable:true
enable:true
# List of ports that Prometheus listens on; these must match the number of rpc.ports to ensure correct monitoring setup
# The IP address where this RPC service registers itself; if left blank, it defaults to the internal network IP
registerIP:''
registerIP:''
# IP address that the RPC service listens on; setting to 0.0.0.0 listens on both internal and external IPs. If left blank, it automatically uses the internal network IP
listenIP:0.0.0.0
listenIP:0.0.0.0
# List of ports that the RPC service listens on; configuring multiple ports will launch multiple instances. These must match the number of configured prometheus ports
ports:[10130]
ports:[10130]
prometheus:
prometheus:
# Enable or disable Prometheus monitoring
enable:true
enable:true
# List of ports that Prometheus listens on; these must match the number of rpc.ports to ensure correct monitoring setup
ports:[20102]
ports:[20102]
#发消息是否需要好友验证
# Does sending messages require friend verification
# The IP address where this RPC service registers itself; if left blank, it defaults to the internal network IP
registerIP:''
registerIP:''
# IP address that the RPC service listens on; setting to 0.0.0.0 listens on both internal and external IPs. If left blank, it automatically uses the internal network IP
listenIP:0.0.0.0
listenIP:0.0.0.0
# List of ports that the RPC service listens on; configuring multiple ports will launch multiple instances. These must match the number of configured prometheus ports
ports:[10190]
ports:[10190]
prometheus:
prometheus:
# Enable or disable Prometheus monitoring
enable:true
enable:true
# List of ports that Prometheus listens on; these must match the number of rpc.ports to ensure correct monitoring setup
ports:[20101]
ports:[20101]
object:
object:
# Use MinIO as object storage, or set to "cos", "oss", "kodo", "aws", while also configuring the corresponding settings
withchao
7 months ago