搭建指南:手把手部署 Raingad-IM 即时聊天项目

Raingad-IM 是一款基于 ThinkPHP6 和 Workerman 的开源即时通信系统,支持单聊、群聊、音视频通话,能快速构建企业内部通讯或社区聊天应用。下面是一份详细的部署指南。

服务器购买

这里服务器推荐雨云雨云服务器性价比特别高

雨云服务器:为你的数字世界,提供一片性能、易用与支持并存的“及时雨”

在数字化转型浪潮中,无论是个人开发者起步、中小企业上云,还是部署像 Raingad-IM 即时聊天系统 这类对实时性有要求的项目,一款稳定、易用且支持到位的云服务器已成为核心生产力工具。在众多选择中,雨云服务器正如其名,以其润物细无声的可靠、清晰明了的易用和细致周到的支持,为开发者和企业用户带来一片“及时雨”。

一、 卓越性能与稳定可靠:数字业务的坚实基座

服务器的核心价值在于其底层性能与稳定性,这是所有在线业务流畅运行的基石。

  • 强劲且灵活的配置:雨云提供从基础入门到高性能计算的多种配置方案。无论是需要部署上文提到的 ThinkPHP + Workerman 架构的即时通讯服务,还是运行高流量网站、数据库或进行大数据处理,用户都能根据需求精准选择CPU、内存、存储和带宽,避免资源浪费或瓶颈,实现成本与性能的最优平衡。

  • 高速稳定的网络体验:搭载优质BGP网络,保障全国乃至海外多地的快速接入与低延迟响应。对于即时聊天、在线协作等实时应用,网络质量直接决定用户体验,雨云致力于提供稳定、高速的连接通道。

  • 坚实的数据安全与保障:采用企业级硬件与分布式存储,默认提供数据快照、备份与恢复功能,建立完善的数据安全防线,让用户能够安心托管业务与数据。

场景贴合:例如,部署 Raingad-IM 这类项目时,稳定的WebSocket服务(依赖特定端口如8282)和持续的数据库连接对服务器持续运行能力要求很高。雨云的稳定架构能有效支撑此类长连接、实时交互的应用场景。

二、 极致简单与开发者友好:让技术专注归于创造

对于许多用户,特别是个人开发者或初创团队,服务器的易用性和管理便捷性至关重要。雨云深刻理解这一点,致力于降低云服务的使用门槛。

  • 直观清晰的控制面板:摒弃复杂晦涩的命令行操作(尽管也全面支持),提供直观的图形化控制台。服务器开机、关机、重启、重装系统、管理防火墙(如放行8282端口用于IM消息服务)、监控资源使用情况等日常操作,都能通过简单点击轻松完成。

  • 快捷的应用部署与环境搭建:针对常见开发栈和应用(如LAMP/LNMP、WordPress、各种PHP框架等),雨云往往提供了一键安装或便捷的部署指导。这能极大简化像部署Raingad-IM(需要配置Nginx、PHP、MySQL、Redis等)这类复杂初始环境的过程,让用户更快进入业务开发与调试阶段。

  • 灵活的计费与弹性伸缩:提供按需付费、包月包年等多种计费模式,用户可以根据业务周期灵活选择。结合便捷的升降级配置功能,业务增长时可快速扩容,需求减少时亦可及时调整,实现资源的弹性管理,优化成本支出。

三、 贴心支持与成长陪伴:不仅是服务,更是伙伴

选择云服务商,不仅是购买计算资源,更是选择一位长期的技术伙伴。雨云在用户支持与社区建设方面的投入,构成了其重要的差异化优势。

  • 专业及时的客户支持:当用户遇到部署难题(例如 Workerman 服务启动失败、环境配置报错)、网络波动或其他技术问题时,能够通过工单、在线客服等渠道获得专业团队的及时响应与有效解决方案,减少业务中断时间与排查成本。

  • 丰富的文档与教程:维护详尽、持续更新的知识库、安装教程和常见问题解答(FAQ)。无论是新手起步指南,还是针对特定软件(如优化PHP性能、配置SSL证书实现HTTPS)的进阶教程,都能帮助用户自助解决问题,加速学习曲线。

  • 活跃的开发者社区:积极构建用户交流社区,鼓励用户分享技术心得、部署经验和解决方案。在这里,用户不仅可以获得官方支持,还能与其他开发者交流互助,形成良好的技术生态,共同成长

购买使用

注册

打开雨云官网

注册 | 雨云

通过这个链接可以注册,雨云支持微信qq邮箱手机号注册

注册完以后我们登录即可

这里我们可以购买服务器

这里大家可以根据自己的要求购买。

🗂️ 项目与技术栈概览

项目类型:全栈即时通信 Demo(前后端分离)。

  • 主要用途:学习交流、快速构建企业内部或社区聊天系统。

  • 核心特点:支持文本、图片、文件、语音、视频及一对一音视频通话。

技术栈

  • 后端:ThinkPHP6 + Workerman + Redis

  • 前端(Web/管理后台):Vue2 + Lemon-IMUI + Element-UI

  • 移动端:Uniapp (Vue3)(完整功能需捐赠获取)

  • 桌面端:Electron(完整功能需捐赠获取)

重要提示:Gitee 上提供的开源版本中,移动端 H5 演示、桌面端/安卓端完整功能以及移动端源码需要付费(捐赠)获取。开源部分主要包含后端和 Web 前端。

点击下载

⚙️ 部署前准备

1. 服务器与环境要求

  • 服务器:最低配置 2核2G,推荐使用 Linux(如 CentOS 7.9)。

  • 推荐使用宝塔面板 简化环境安装与管理。

  • 必备软件及版本

环境 最低版本 推荐版本 特别说明
Nginx 1.17 最新版 不推荐 Apache
PHP 7.1 7.3 不支持 PHP 8.x
MySQL 5.7 5.7 必须 ≥ 5.7
Redis 5.0 7.0 用于缓存与消息

2. PHP 关键配置(非常重要)

在宝塔面板的 PHP 设置中完成以下两步:

  • 安装扩展:必须安装 redis 和 fileinfo 扩展。

  • 取消禁用函数:找到“禁用函数”列表,移除以下函数:
    shell_execchownexecputenvproc_openpcntl_execpcntl_alarmpcntl_forkpcntl_waitpidpcntl_waitpcntl_signalpcntl_signal_dispatch

🚀 详细部署步骤

步骤一:获取源码

建议从项目主页右侧的 “发行版” 下载最新稳定版本(如 v6.0.0),而非直接克隆开发分支,更稳定完整。

IM即时聊天-php: 即时通信聊天应用Raingad-IM后端代码,需要前后端配合使用,可以为企业快速构建内部聊天应用、团队私密聊天,也可以作为社区聊天。支持文本、文件、图片、语音、视频等消息格式,还支持点对点音视频聊天,支持web端、桌面端和uniapp,uniapp可以打包成小程序、h5、APP。

步骤二:部署与配置

  1. 上传与权限:将源码上传至服务器(如 /www/wwwroot/im),并将整个目录的所有者设为 www 用户,权限设置为 755

  2. 创建网站:在宝塔面板创建新站点,并将站点的运行目录指向项目下的 public 文件夹

  3. 配置伪静态与反向代理:在站点设置中,粘贴以下 Nginx 配置代码:

    nginx

    复制

    下载
    # 伪静态配置
    location ~* (runtime|application)/{
        return 403;
    }
    location / {
        if (!-e $request_filename){
            rewrite  ^(.*)$  /index.php?s=$1  last;   break;
        }
    }
    # WebSocket 反向代理配置(用于消息实时推送)
    location /wss
    {
        proxy_pass http://127.0.0.1:8282;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "Upgrade";
        proxy_set_header X-Real-IP $remote_addr;
    }
  4. 配置数据库:在宝塔面板创建 MySQL 数据库,记下数据库名、用户名和密码。

  5. (可选)SSL证书:如需使用音视频通话等功能,务必配置 HTTPS(可使用宝塔的 Let's Encrypt 免费证书)。

步骤三:安装向导

访问你的服务器 IP 或域名,应出现安装界面,按提示完成安装:

  • 填写上一步创建的数据库信息。

  • 系统会自动导入数据并完成配置。

  • 安装成功后,默认管理员账号为 administrator,密码为 123456。管理入口在聊天界面左下角。

步骤四:启动核心消息服务

安装后聊天无法实时收发的核心原因是 Workerman 服务未启动。有两种启动方式:

  1. 通过管理后台启动(推荐)

    • 用管理员账号登录,从聊天界面左下角进入管理后台。

    • 在后台首页找到“系统服务”或类似模块,点击“启动消息推送服务”。

  2. 通过命令行启动与调试

    • 如果后台启动失败,需 SSH 连接到服务器,进入项目根目录执行。

      下载
      cd /项目根目录路径
      php think worker:gateway start
    • 如果看到启动成功的提示,说明环境正常。可按 Ctrl+C 停止,然后回到后台启动。

🔧 常见问题排查

问题现象 可能原因 解决方案
访问安装页报错 PHP环境未配置好 检查PHP版本(需7.1-7.3)、扩展(redis,fileinfo)和禁用函数
能登录但无法收发消息 1. Workerman服务未启动
2. 端口未放行或代理未配
1. 按上文启动服务
2. 确保服务器防火墙和安全组放行 8282 端口,并检查Nginx反向代理配置
后台启动服务失败 1. 权限不足
2. 进程冲突
3. PHP命令行版本与网页版本不一致
1. 确认目录所有者为 www,权限755
2. 执行 killall -9 php 后重试
3. 在终端执行 php -v,确保与宝塔网站所用PHP版本一致
音视频通话不可用 未配置 HTTPS 为域名申请并部署 SSL 证书

💡 使用与进阶提示

  1. 首次体验:可使用提供的体验账号(如 13800000002,密码 123456)登录 Web 演示站先行体验功能。

  2. 模式切换:系统支持“企业模式”和“社区模式”,社区模式支持用户注册和添加好友,可在后台设置中切换。

  3. 获取完整功能:如需移动端(Uniapp)或桌面端(Electron)完整源码,需要联系作者捐赠获取。

  4. 寻求帮助:部署过程遇阻,可仔细阅读项目 README.md。如需付费部署服务(200元/次)或交流,可申请加入项目QQ群(需先为项目点Star)。

Logo

有“AI”的1024 = 2048,欢迎大家加入2048 AI社区

更多推荐