Skip to content

qunarcorp/startalk_web

Repository files navigation

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/qunarcorp/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版及时通信聊天工具。

注意

注意事项

  • 前端服务默认端口为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] 查看项目启动详情

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published