文档首页 / 首次初始化与登录

首次初始化与登录

程序启动后在 /setup 完成平台数据库与管理员账号初始化,并说明登录、锁定、找回与应急重置密码的做法。

概述

Sight Report 与 Sight Wall 首次启动时,平台还没有数据库和管理员。此时访问程序地址会进入初始化向导(路径 /setup),依次完成「数据库配置」「管理员账号」「完成」三步。每个产品程序各自初始化一次。

功能入口

浏览器访问 http://<服务器IP>:<端口>/setup:Sight Report 默认端口 9091,Sight Wall 默认端口 9090。启动程序的方法见 快速开始。

操作步骤

1. 选择平台数据库

向导第一步提供两种选择:

选项 页面提示 适用
内置数据库 推荐试用;平台数据存储在 H2 中,可直接使用 试用或少量用户
外接数据库 推荐生产;性能与稳定性更好 企业正式使用

选择「内置数据库」会跳过配置,直接进入第二步;数据文件位于程序目录下的 data/work/db。

选择「外接数据库」时:

  1. 先在数据库中建好库和用户。页面右上角的「如何配置?」给出了各数据库的建库示例,示例中库名与用户名统一使用 sight_report。
  2. 在「数据库类型」下拉框中选择类型。可选类型见下表。
  3. 填写「主机」「端口」「用户名」「密码」「数据库名称」。选择类型后端口、主机等会自动带出默认值,JDBC URL 由这些字段自动生成,也可以手动修改。
  4. PostgreSQL 系数据库还需要填写「模式名称」。填好用户名和密码后展开下拉框,可以从数据库中已有的模式里选择。
  5. 点击「测试连接」,通过后点击「下一步」。
分组 可选的数据库类型(默认端口)
常用关系型数据库 MySQL(3306)、MariaDB(3306)、PostgreSQL(5432)、Oracle(1521)、SQL Server(1433)
国产信创数据库 达梦 DM(5236)、人大金仓 KingBase、华为 GaussDB / OpenGauss、海量 Vastbase G100、阿里云 PolarDB、OceanBase(MySQL 模式)
云 / 分布式数据库 TiDB(4000)、Greenplum(5432)

2. 设置管理员账号

字段 要求
用户名 必填,不少于 3 位
密码 必填,不少于 6 位,且必须同时包含字母、数字和特殊字符
确认密码 必须与密码一致
导入演示数据 复选框「导入演示数据(推荐首次使用时勾选)」,默认勾选

点击「确定」后系统建表并创建管理员,此账号是系统超级管理员。勾选演示数据时,会创建名为 demo 的数据连接,并导入示例表、数据集和报表模板(示例报表按分类目录组织)。

3. 完成

出现“设置完成!”后点击「进入系统」,跳转到登录页。

登录

登录页(/login)输入「用户账号」和「密码」后点击「登 录」。

项目 行为
滑块验证 在「系统 > 系统设置」的「登录」页签中开启「滑块验证」后,登录前需先完成滑块拼图验证;默认关闭
记住我 由后端配置决定是否显示;默认开启,有效期 7 天
会话超时 默认 1440 分钟(24 小时)
登录锁定 默认连续输错密码 5 次锁定,锁定 10 分钟;默认锁定对象为账号
忘记密码 系统配置了邮件渠道时可走邮件自助找回;未配置时提示联系管理员

以上是默认值,管理员可在「系统 > 系统设置」的「登录」页签中调整(含登录锁定、密码强度等),被锁定的账号可在「登录解锁」页签解除。

忘记管理员密码:应急重置

管理员忘记密码且没有邮件找回渠道时,可在能登录服务器的前提下使用应急重置通道:

  1. 登录页点击「忘记密码?」,在提示框中点击「管理员应急重置」,或直接访问 /admin/reset。
  2. 在服务器上进入产品所在目录(程序 jar 所在目录),创建文件 reset-admin.txt,写入一串不少于 16 位的随机字符。
  3. 回到页面点击「重新检测文件」,确认页面提示已检测到文件。
  4. 填写「管理员账号」、文件中的「校验串」,再输入两次新密码并提交。
  5. 校验通过后密码被重置,该账号的登录锁定解除,全部在线会话被踢下线,服务器上的 reset-admin.txt 被自动删除。

注意:该文件自创建起默认 60 分钟内有效,过期需重新创建。管理员可通过配置项 app.admin-reset.enabled=false 关闭整个通道,关闭后 /admin/reset 页面会提示“应急重置通道未开启”。

注意事项

注意:系统初始化只能进行一次。已初始化的系统再次提交初始化会被拒绝,提示“系统已初始化,请勿重复初始化”。

注意:选择内置数据库(H2)适合试用和少量用户。需要集群部署或正式使用时,请在初始化时选择外接数据库。

提示:初始化时连不上数据库,通常是地址、端口、账号密码或模式名称有误。「测试连接」通过后再点击「下一步」,可以提前发现问题。

相关文档

联系我们

请填写您的信息,我们将在 1 个工作日内与您联系。