Turms快速入门指南：5分钟搭建企业级即时通讯服务

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 turms

2. 安装Docker插件（可选）

如果需要日志收集功能，安装Loki Docker驱动：

docker plugin install grafana/loki-docker-driver:latest --alias loki --grant-all-permissions

3. 启动完整服务集群

运行以下命令启动包含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状态。

核心服务端口说明

扩展部署选项

启用监控功能

如需监控系统运行状态，添加--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服务。

下一步操作

1. 客户端集成：使用Turms提供的多语言SDK接入您的应用

   • JavaScript客户端：turms-client-js
   • Kotlin客户端：turms-client-kotlin
   • Swift客户端：turms-client-swift

2. 配置自定义：修改docker-compose.standalone.yml调整服务参数

3. 深入学习：查阅官方文档了解高级功能和性能优化

   • 架构设计：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