tarsdocs
  • Readme.md
  • CLA
  • LICENSE
  • 基础介绍
    • 简介
    • 基础概念
    • 基础通信协议 Tars
    • 统一通信协议 Tup
    • 开发模式介绍
    • 模板配置
    • 服务市场
    • 服务扩展
    • 框架版本说明
  • 开源版框架介绍
    • 开源版本部署
      • 部署总体介绍
      • Docker环境安装
      • Mysql安装
      • 框架源码部署(Linux/Mac)
      • 框架源码部署(Windows)
      • 框架Docker部署
      • 框架节点部署
      • 业务服务容器化
      • 框架K8SDocker 部署
      • 框架K8STARS 部署
      • 框架K8SFramework 部署(强烈推荐)
      • 框架更新及扩容
      • 调用链升级注意事项
      • TarsWeb-v3.0.3升级说明
    • 开源版管理平台
      • TarsWeb说明
      • web用户体系
      • web管理平台 API
  • 企业版本介绍
    • 企业版说明
    • 框架集群化机制
    • 框架单节点机制
    • 使用二进制包部署
    • 使用容器部署
    • 业务服务一主多备机制
    • 命令行控制终端
    • IP-LIST级联缓存机制
    • 多数据中心管理
    • 多网络支持
    • 第三方服务管理
    • 数据产生和管理机制
    • 密码重置
    • TarsPython介绍
  • 框架关键特性
    • 业务配置
    • 服务监控
    • 无损发布/重启
    • 调用链
    • IDC分组
    • 鉴权功能
  • TarsCPP
    • 编译
    • 快速开发入门
    • 使用指南
    • 开发规范
    • 服务线程说明文档
    • protobuf 协议支持文档
    • 第三方协议支持
    • HTTP1 支持
    • HTTP2 支持
    • TLS 通信支持
    • Push 功能说明
    • PushCallback 功能说明
    • Cookie 支持
    • 队列模式
    • 手动绑定
    • 性能数据
    • 2.x 版本变化
    • 3.x 版本变化
    • 协程版本说明
    • 基础类库说明
    • [案例]
      • 框架快速入门
      • Http 服务示例
  • TarsJava
    • 快速开始
    • 快速开发入门
    • [使用指南]
      • Tars 服务开发与上线
      • HTTP 服务开发与上线
      • 生成接口调用文件
    • [性能测试]
      • tars java 压测代码
  • TarsGo
    • 基本介绍
    • 快速开始
    • 使用指南
    • cmake 管理代码
    • pb2tarsgo
    • 性能数据
    • 使用示例
  • TarsPHP
    • 搭建 php 环境
    • 快速开发入门
    • [快速起步]
      • 搭建 HttpServer
      • 搭建 TimerServer
      • 搭建 TcpServer
      • 搭建 WebSocketServer
      • 弹幕活动实战
    • [框架简介]
      • 简介
      • tars-server
      • tars-client
      • tars-config
      • tars-deploy
      • tars-extension
      • tars-log
      • tars-monitor
      • tars-registry
      • tars-report
      • tars-utils
      • tars2php
    • [高阶应用]
      • PHP 的 Swoole 框架如何接入 Tars
      • 与 thinkphp 结合使用
      • 与 Swoft 结合使用
      • 与 Laravel 结合使用
      • 与 Yii2 结合使用
      • 持续集成方案
    • [其他]
      • 常见问题
      • 如何 Debug
      • changelog
      • 其他外部文档
  • Tars.js
    • 基本介绍
    • 脚手架
    • 快速开发入门
    • @tars/stream
    • @tars/rpc
    • @tars/logs
    • @tars/config
    • @tars/monitor
    • @tars/notify
    • @tars/utils
    • @tars/dyeing
    • @tars/node-agent
    • @tars/winston-tars
    • tars2node
  • K8SFramework
    • [安装和使用说明]
      • 介绍
      • 特性
      • 安装
      • 升级
      • 云原生运维
      • 管理平台
      • 证书
    • [开发环境构建]
      • Dockerfile 说明
      • 服务发布流程说明
      • 制作基础编译镜像
      • 制作业务服务镜像
      • 制作 Helm 包
      • 发布业务镜像到 K8S 集群
      • 服务发布示例
      • 如何调试业务服务
  • 服务扩展
    • 云告警
    • 接口及压测工具
    • 网关服务
    • dcache缓存服务
    • 发送邮件服务
    • 一致性存储服务
    • 一致性存储web管理平台
    • 唯一计数服务
  • 常见问题
    • 安装常见问题
    • Issues
    • Issues-tarscpp
    • Issues-tarsjava
    • Issues-tarsgo
    • Issues-tarsphp
  • 开源合作
    • TarsFramework 项目 Git 合作规范
  • 直播视频
    • B 站 TARS 培训系列课程
  • 相关文章
    • TARS 技术文章
  • 其它资源分享
    • 下载
    • Tars 介绍.pptx
    • TarsPHP 解密.pdf
    • TarsJava 本地调试.pdf
    • 微服务在腾讯的业务实践.pptx
Powered by GitBook
On this page
  • 目录
  • 1 介绍
  • 2 模块说明
  • 3 权限说明
  • 4 模块调用
  • 5 检查问题
  • 6 Token管理
  • 7 密码遗忘处理
  • 8 web开发

Was this helpful?

  1. 开源版框架介绍
  2. 开源版管理平台

TarsWeb说明

Previous开源版管理平台Nextweb用户体系

Last updated 3 years ago

Was this helpful?

目录

1 介绍

tars web主要用于开发或运维人员管理Tars整体平台, 主要功能如下:

  • 服务的部署, 发布, 扩容和配置

  • 服务的监控, 统计信息查看

  • 节点在线扩容

  • 服务日志查看(点击服务名称)

  • 权限管理

2 模块说明

tars web < v2.4.7

tars web在v2.4.7之前由两个模块组成(nodejs实现的服务, 用koa框架实现):

  • tars-node-web: 核心功能界面, 默认绑定本机: 0.0.0.0:3000

  • tars-user-system: 用户权限系统, 默认绑定本机: 0.0.0.0:3001

系统安装好以后, 是被pm2来管理的, 可以查看:

pm2 list

可以查看到模块的状态.

常见命令:

  • 启动模块

pm2 start tars-node-web
pm2 start tars-user-system
  • 停止模块

pm2 stop tars-node-web
pm2 stop tars-user-system
  • 重启模块

pm2 start tars-node-web
pm2 start tars-user-system

tars web >= v2.4.7

tars web在v2.4.7之后, 将用户体系和逻辑模块合并到一起, 并内嵌了ldap, 未来会打开ldap, 通过ldap来完成和其他鉴权系统的对接

系统安装好以后, 是被pm2来管理的, 可以查看:

pm2 list

可以查看到模块的状态.

常见命令:

  • 启动模块

pm2 start tars-node-web
  • 停止模块

pm2 stop tars-node-web
  • 重启模块

pm2 start tars-node-web

其他说明

注意, 如果你发现没有pm2命令, 一般都是node环境遍历没有生效, 你可以执行:

source /etc/profile

node的环境变量是在安装Tars时自动安装的, 注意用户是root.

3 权限说明

用户权限分为三种:

  • admin: 管理员

  • operator: 运维人员

  • developer: 开发人员, 不能发布以及修改配置, 重启等写操作

权限的粒度可以到应用 或者 服务级别.

在web管理平台上, 点击右上角箭头, 进入用户中心, 就可以创建用户以及给用户赋值权限.

比如: 你想给运维用户test, app为Test, 服务为HelloServer的权限:

  • 在用户管理界面, 以operator创建用户test

  • 在权限管理界面, 新增权限, 注意标示为: Test.HelloServer

如果你想test用户, app为Test的所有服务权限, 则标示为: Test 即可

你可以在web管理平台, 点击具体服务->点击权限管理-> 在运维, 开发的输入框中输入用户名称, 多用户以;分隔

注意: 在v2.4.7之前的版本, 由tars-user-system负责维护tars web的权限, v2.4.7及之后的版本和逻辑服务合并到一起了

4 模块调用

tars web < v2.4.7

tars-node-web & tars-user-system默认是部署在同一台机器上, 并且都绑定了0.0.0.0 (即也绑定了127.0.0.1)

tars-node-web通过localhost(127.0.0.1)来访问tars-user-system, 如果未绑定127.0.0.1, 则无权限, 此时需要修改tars-user-system模块的配置(demo/config/loginConf.js), 修改ignoreIps, 开放白名单.

正常情况你可以通过机器的外网ip来访问, 例如:http://xxx.xxx.xxx.xxx:3000 web管理平台

如果web & demo前面挂了nginx代理, 反向代理到不同端口(一个3000, 一个3001)来访问, 则需要设置不同域名来访问, web & demo 的登录态通过cookie传递, 因此需要部署在同一个根域名下面.

比如: web的nginx的入口域名是: http://user.tars.com, demo的nginx域名是: http://auth.tars.com, (注意根域名都是tars.com), 那么需要在web服务器上设定环境变量:

export USER_CENTER_HOST=http://auth.tars.com
export COOKIE_DOMAIN=.tars.com

tars web >= v2.4.7

tars-node-web绑定了0.0.0.0 (即也绑定了127.0.0.1), 并且内部鉴权会访问自己的127.0.0.1 来实现.

正常情况你可以通过机器的外网ip来访问, 例如:http://xxx.xxx.xxx.xxx:3000 web管理平台

由于鉴权模块和web逻辑模块合并, 通过nginx反向代理来访问更加简单, 只需要反向道理到3000端口即可.

5 检查问题

tars web < v2.4.7

如果tars web运行异常, 比如:页面打不开, 可以通过以下方式检查:

  • 先把web模块停止

pm2 stop tars-node-web
  • 进入目录, 手工启动服务

cd /usr/local/app/web
npm run dev

npm run dev 会把错误输出在屏幕上, 根据错误判断如果修改, ctrl + c 退出 npm run dev

bug解决后, 重新用pm2 启动服务:

pm2 start tars-node-web
pm2 start tars-user-system

两个重要的web日志:

  • tars-node-web模块运行过程中的日志, 会输出在 /usr/local/app/web/log/ 目录下, 便于定位问题

  • tars-user-system模块运行过程中的日志, 会输出在 /usr/local/app/web/demo/log 目录下, 便于定位问题.

tars web >= v2.4.7

如果tars web运行异常, 比如:页面打不开, 可以通过以下方式检查:

  • 先把web模块停止

pm2 stop tars-node-web
  • 进入目录, 手工启动服务

cd /usr/local/app/web
npm run dev

npm run dev 会把错误输出在屏幕上, 根据错误判断如果修改, ctrl + c 退出 npm run dev

bug解决后, 重新用pm2 启动服务:

pm2 start tars-node-web

重要的web日志:

  • tars-node-web模块运行过程中的日志, 会输出在 /usr/local/app/web/log/ 目录下, 便于定位问题

6 Token管理

7 密码遗忘处理

如果admin的密码遗忘, 目前只能重置数据库中相关表的字段来解决:

  • 登录mysql

  • 查看db: db_user_system

  • 修改表: t_user_info

  • 重置admin用户记录, 将password重置为空

登录web时, 将会提示设置admin密码.

8 web开发

如果你是nodejs开发者, 你也可以参与到web的开发中, 目前采用: nodejs + koa实现, web开发方式如下:

目录:

  • app: 后台代码

  • bin: 入口

  • client: 前端页面代码, 页面代码用webpack组织, 发布前必须:npm run build

  • config: 配置文件

  • locale: 字符集目前支持(中文/英文)

  • app.js: koa 入口

tars web安装通常是跟随一键安装脚本, 或者docker容器中自动安装好的, 源码安装可参见

Web的用户模块, 提供了token管理功能, 即可以创建token, 并通过web api来调用和获取相关数据,

Tars源码安装
请参见
介绍
模块说明
权限说明
模块调用
检查问题
Token管理
密码遗忘处理
web开发