部署后端服务
更新时间: 2024/11/28 17:19:26
Nemo 是网易 云信派对 App 的后端服务开源项目。项目提供了包括 1v1 娱乐社交、语聊房、一起听、游戏房、秀场直播(PK直播、PK 连麦)场景解决方案的实现。本文介绍如何下载 Nemo 后端服务到您的本地工程,自定义配置,直至初始化成功。
准备工作
根据本文操作前,请确保您已经在 网易云信控制台 上创建至少一个应用,并获取到应用密钥。详细步骤请参考 创建应用并获取 AppKey。
下载工程
- 访问 nemo.git。
- 克隆工程或下载到本地。
修改配置
-
使用您本地的 IDEA 软件,打开 Nemo 工程。
-
找到
application-local.yml
文件,修改文件中的${APPKEY}
、${APPSECRET}
、redis
、MySQL 数据库配置。YAML
spring: profiles: active: local datasource: driver-class-name: com.mysql.cj.jdbc.Driver hikari: connection-init-sql: SET NAMES utf8mb4 COLLATE utf8mb4_unicode_ci minimum-idle: 2 connection-test-query: SELECT 1 login-timeout: 30000 connection-timeout: 30000 validation-timeout: 5000 idle-timeout: 600000 maximum-pool-size: 100 max-lifetime: 900000 type: com.zaxxer.hikari.HikariDataSource url: jdbc:mysql://127.0.0.1:3306/nemo?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai username: 'root' password: '12345678' redis: database: 0 host: 127.0.0.1 port: 6379 #可不配,因为底层默认值为 6379 pool: max-active: 100 #连接池最大连接数(负值表示没有限制) max-wait: 3000 #连接池最大阻塞等待时间(负值表示没有限制) max-idle: 200 #连接池最大空闭连接数 min-idle: 50 #连接汉最小空闲连接数 timeout: 600 #连接超时时间(毫秒) yunxin: origin: appKey: ${APPKEY} # 网易云信 appkey,如果需要申请应用可联系商务 appSecret: ${APPSECRET} # 网易云信 appSecret nimHost: https://api.netease.im neRoomHost: https://roomkit.netease.im/ securityAuditHost: https://logic-dev.netease.im/ rtcHost: https://logic-dev.netease.im/ business: yunxinAssistAccid: yunxinassistaccid_1 #网易云信派对小助手 systemAccid: nimsystembot_1 #服务端系统 Nim 账号 1v1RtcRoomLiveTime: 10 # 单位(分钟) 1v1RTC 房间存活时间,demo 默认 10 分钟回收房间 voiceRoomConfigId: 569 # 语聊房模板 server: port: 9981
-
部署启动 Redis 或 MySQL 数据库,并执行 init.sql 脚本。
-
启动 RestApplication
main
函数。 -
调用接口初始化应用及生成测试账号。
-
修改
{APPKey}
、{AppSecret}
,以及data-raw
中的测试账号参数。cURL
curl --location --request POST 'http://127.0.0.1:9981/nemo/app/initAppAndUser' \ --header 'Appkey: {APPKey}' \ --header 'AppSecret: {AppSecret}' \ --header 'Content-Type: application/json' \ --data-raw '{"userName":"test","userUuid":"test","imToken":"test","icon":"test"}';
-
执行 cURL 命令,生成 Nemo 测试账号。
-
返回结果
code: 200
则表示本地启动成功。
-
配置抄送
如果您需要联调客户端代码,则需要将 Nemo 工程发布为外网可以访问的服务,同时在 网易云信控制台 配置抄送地址。详细步骤请参考 开通和配置消息抄送。
客户端 Demo | 配置类型 | 抄送地址 |
---|---|---|
1v1 娱乐社交 | 即时通讯(IM)服务抄送 | http://{您部署的Nemo服务域名}/nemo/socialChat/nim/notify |
语聊房 | 房间组建(NERoom)服务抄送 | http://{您部署的Nemo服务域名}/nemo/entertainmentLive/nim/notify |
此文档是否对你有帮助?