Turms快速入门指南:5分钟搭建企业级即时通讯服务
【免费下载链接】turms🕊️ The world's most advanced open source instant messaging engine for 100K~10M concurrent users https://turms-im.github.io/docs项目地址: https://gitcode.com/gh_mirrors/tu/turms
Turms是全球最先进的开源即时通讯引擎,专为支持10万至1000万并发用户设计。本指南将帮助您在5分钟内快速搭建一套完整的企业级即时通讯服务,无需复杂配置,只需简单几步即可启动。
准备工作:环境要求
在开始之前,请确保您的系统满足以下要求:
- Docker Engine (20.10+)
- Docker Compose (v2+)
- Git
- 至少2GB内存和2核CPU
一键部署步骤
1. 获取项目代码
首先克隆Turms仓库到本地:
git clone --depth 1 https://gitcode.com/gh_mirrors/tu/turms cd turms2. 安装Docker插件(可选)
如果需要日志收集功能,安装Loki Docker驱动:
docker plugin install grafana/loki-docker-driver:latest --alias loki --grant-all-permissions3. 启动完整服务集群
运行以下命令启动包含Turms核心服务和依赖组件的完整集群:
docker compose -f docker-compose.standalone.yml up --force-recreate这个命令会自动启动以下服务:
- turms-gateway:客户端接入网关,处理用户认证和消息路由
- turms-service:业务逻辑服务,实现IM核心功能
- turms-admin:Web管理界面,用于系统配置和监控
- MongoDB:分布式数据库,存储业务数据
- Redis:缓存服务,支持会话管理和分布式锁
验证部署结果
服务启动后(约1-2分钟),通过以下方式验证部署是否成功:
访问管理界面
打开浏览器访问Turms管理后台:
http://localhost:6510使用默认账号密码登录:turms/turms
检查服务状态
通过Docker命令检查所有容器是否正常运行:
docker ps --filter name=turms_您应该能看到turms-gateway、turms-service和turms-admin等容器处于Up状态。
核心服务端口说明
| 服务组件 | 端口 | 用途 |
|---|---|---|
| turms-admin | 6510 | Web管理界面 |
| turms-gateway | 10510 | WebSocket客户端连接 |
| turms-gateway | 11510 | TCP客户端连接 |
| turms-service | 8510 | 管理API接口 |
扩展部署选项
启用监控功能
如需监控系统运行状态,添加--profile monitoring参数启动Prometheus和Grafana:
docker compose -f docker-compose.standalone.yml --profile monitoring up --force-recreate监控界面访问地址:
- Grafana: http://localhost:3000(默认账号:turms/turms)
- Prometheus: http://localhost:9090
云环境部署
Turms提供Terraform模块支持阿里云等云服务快速部署。以阿里云为例:
cd turms/terraform/alicloud/playground export ALICLOUD_ACCESS_KEY=<您的AccessKey> export ALICLOUD_SECRET_KEY=<您的SecretKey> terraform init terraform apply等待3-15分钟后,通过云服务器公网IP访问Turms服务。
下一步操作
客户端集成:使用Turms提供的多语言SDK接入您的应用
- JavaScript客户端:turms-client-js
- Kotlin客户端:turms-client-kotlin
- Swift客户端:turms-client-swift
配置自定义:修改docker-compose.standalone.yml调整服务参数
深入学习:查阅官方文档了解高级功能和性能优化
- 架构设计:docs/design/architecture.md
- 功能特性:docs/feature/index.md
常见问题解决
服务启动失败
- 检查Docker资源是否充足:建议至少2GB内存
- 查看容器日志:
docker logs turms_turms-service_1 - 确保端口未被占用:特别是27017(MongoDB)、6379(Redis)
无法访问管理界面
- 检查容器状态:
docker inspect turms_turms-admin_1 - 验证端口映射:
netstat -tulpn | grep 6510
Turms凭借其高性能、可扩展性和丰富的功能,成为企业级即时通讯解决方案的理想选择。无论是社交应用、企业协作工具还是在线教育平台,Turms都能提供稳定可靠的通讯基础设施支持。立即开始您的即时通讯服务搭建之旅吧!
【免费下载链接】turms🕊️ The world's most advanced open source instant messaging engine for 100K~10M concurrent users https://turms-im.github.io/docs项目地址: https://gitcode.com/gh_mirrors/tu/turms
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考