Startalk Web

简介

• Startalk Web是IM网页版聊天工具。
• Startalk Web依赖后端服务，否则无法正常使用该工具。
• 涉及技术：node、koa、react、websocket、webpack等。
• 主要功能：单聊、群聊、好友、组织架构、个人名片等，消息支持：文本、表情、图片、文件等。
• 如果Startalk Web对您有所帮助或启发的话，还望给个star鼓励，我们团队会尽全力提供优化和支持，力求做出最优秀的企业级IM。
• 此外，为有效、流畅体验Startalk Web，还请仔细阅读安装说明，如若遇到问题，欢迎进群咨询[QQ群：852987381]。

安装

环境要求

• node@ >= 8.6.0
• pm2 @>= 2.0.0

服务器环境安装(root用户)

• 登录服务器后，进入下载目录，安装node：

    cd /startalk/download
    wget https://npm.taobao.org/mirrors/node/v8.6.0/node-v8.6.0-linux-x64.tar.xz
    tar -xvf  node-v8.6.0-linux-x64.tar.xz
    cd  node-v8.6.0-linux-x64/bin

• 执行以下命令，若显示 v8.6.0 ，则表明安装成功

    ./node -v

• 配置软连接，便于全局使用 node npm命令

    ln -s /startalk/download/node-v8.6.0-linux-x64/bin/node /usr/local/bin/node
    ln -s /startalk/download/node-v8.6.0-linux-x64/bin/npm /usr/local/bin/npm

• 分别执行以下命令，若返回版本号，则表示配置成功

    node -v
    npm -v

• 安装pm2，并配置软连接，便于全局使用 pm2命令

    npm install -g pm2
    ln -s /startalk/download/node-v8.6.0-linux-x64/bin/pm2 /usr/local/bin/pm2

• 执行以下命令，若返回版本号，则表示配置成功

    pm2 -v

下载代码到服务器

• 在 /startalk/download 目录下下载源码,然后将项目 /dist 目录下文件copy到 /startalk/startalk_web 目录下。

    cd /startalk/download
    git clone https://github.com/startalkIM/startalk_web.git
    cp -rf startalk_web/dist /startalk/startalk_web

修改配置

• 进入项目目录，配置 startalk.env 文件，将 BASEURL=http://IP:8080 的IP改成服务器IP,NAVIGATION=/ 改为后台导航
• 其他配置：端口、公共路径可根据实际情况选择性配置
• 建议采用淘宝镜像: npm config set registry https://registry.npm.taobao.org

    cd /startalk/startalk_web
    npm install -production
    vim profiles/production/startalk.env

• 编辑完成后，保存退出vim编辑

    按下 esc键
    输入 :wq
    回车

项目启动与预览

• 使用pm2启动项目

    pm2 start /startalk/startalk_web/app.js --watch

• 执行以下命令，查看是否启动成功，若该项目对应的status为online，则表明启动成功

    pm2 list

• 注意：本次部署是以后台服务和前端服务部署在同一台机器上为背景，如需部署多台机器，则需通过nginx配置转发，以解决接口的跨域问题。
• 项目预览：
  • 项目启动成功后，在电脑浏览器中输入 [本机IP:8080/web],回车键访问，输入测试账号登录，（测试账号admin，密码testpassword）
  • 至此，您便可享用web版及时通信聊天工具。

常见问题

A: 登录页面点击登录按钮后一直处于loading状态?

Q: 如果使用了旧版本的 im_http_service, 可能会出现此问题。 (建议升级im_http_service)

解决方案： 修改 /startalk/tomcat/im_http_service/webapps/im_http_service/WEB-INF/classes/nav.json 文件, 在 baseaddess 字段下增加 "socketurl": "ws://[your ip]:5280/websocket" 字段

注意

注意事项

• 前端服务默认端口为5000，默认公共路径为根路径（startalk.env 文件配置）
• 如果需要修改端口或者公共路径，需要同步修改ng转发配置，确保后端接口正常调用
• .env 文件默认为生产环境 NODE_ENV=production
• 如若需要修改源代码，则需要重新打包生成dist目录
  • 先fork项目到自己的GitHub
  • 参考本项目下的developement.md文件，进行本地开发调试
  • 本地启动成功后便可将最新的dist文件上传至服务器启动
• 接口位于entry.js
  • 获取直属领导，员工编号和查询用户电话功能已写好,接口需使用者实现

其他辅助命令（部署成功后不需要执行）

• sudo netstat -anlp| grep 5000 查看5000 端口的进程
• sudo kill -9 [进程code] 结束进程
• df -h 查看不同分区的大小
• rm -rf *** 删除文件夹
• pm2 start [启动文件]
• pm2 log 查看pm2日志
• pm2 list 查看pm2启动项目清单及状态
• pm2 delete [id] 删除pm2进程
• pm2 show [id] 查看项目启动详情