首次初始化与登录
程序启动后在 /setup 完成平台数据库与管理员账号初始化,并说明登录、锁定、找回与应急重置密码的做法。
概述
Sight Report 与 Sight Wall 首次启动时,平台还没有数据库和管理员。此时访问程序地址会进入初始化向导(路径 /setup),依次完成「数据库配置」「管理员账号」「完成」三步。每个产品程序各自初始化一次。
功能入口
浏览器访问 http://<服务器IP>:<端口>/setup:Sight Report 默认端口 9091,Sight Wall 默认端口 9090。启动程序的方法见 快速开始。
操作步骤
1. 选择平台数据库
向导第一步提供两种选择:
| 选项 | 页面提示 | 适用 |
|---|---|---|
| 内置数据库 | 推荐试用;平台数据存储在 H2 中,可直接使用 | 试用或少量用户 |
| 外接数据库 | 推荐生产;性能与稳定性更好 | 企业正式使用 |
选择「内置数据库」会跳过配置,直接进入第二步;数据文件位于程序目录下的 data/work/db。
选择「外接数据库」时:
- 先在数据库中建好库和用户。页面右上角的「如何配置?」给出了各数据库的建库示例,示例中库名与用户名统一使用
sight_report。 - 在「数据库类型」下拉框中选择类型。可选类型见下表。
- 填写「主机」「端口」「用户名」「密码」「数据库名称」。选择类型后端口、主机等会自动带出默认值,
JDBC URL由这些字段自动生成,也可以手动修改。 - PostgreSQL 系数据库还需要填写「模式名称」。填好用户名和密码后展开下拉框,可以从数据库中已有的模式里选择。
- 点击「测试连接」,通过后点击「下一步」。
| 分组 | 可选的数据库类型(默认端口) |
|---|---|
| 常用关系型数据库 | 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 分钟;默认锁定对象为账号 |
| 忘记密码 | 系统配置了邮件渠道时可走邮件自助找回;未配置时提示联系管理员 |
以上是默认值,管理员可在「系统 > 系统设置」的「登录」页签中调整(含登录锁定、密码强度等),被锁定的账号可在「登录解锁」页签解除。
忘记管理员密码:应急重置
管理员忘记密码且没有邮件找回渠道时,可在能登录服务器的前提下使用应急重置通道:
- 登录页点击「忘记密码?」,在提示框中点击「管理员应急重置」,或直接访问
/admin/reset。 - 在服务器上进入产品所在目录(程序 jar 所在目录),创建文件
reset-admin.txt,写入一串不少于 16 位的随机字符。 - 回到页面点击「重新检测文件」,确认页面提示已检测到文件。
- 填写「管理员账号」、文件中的「校验串」,再输入两次新密码并提交。
- 校验通过后密码被重置,该账号的登录锁定解除,全部在线会话被踢下线,服务器上的
reset-admin.txt被自动删除。
注意:该文件自创建起默认 60 分钟内有效,过期需重新创建。管理员可通过配置项
app.admin-reset.enabled=false关闭整个通道,关闭后/admin/reset页面会提示“应急重置通道未开启”。
注意事项
注意:系统初始化只能进行一次。已初始化的系统再次提交初始化会被拒绝,提示“系统已初始化,请勿重复初始化”。
注意:选择内置数据库(H2)适合试用和少量用户。需要集群部署或正式使用时,请在初始化时选择外接数据库。
提示:初始化时连不上数据库,通常是地址、端口、账号密码或模式名称有误。「测试连接」通过后再点击「下一步」,可以提前发现问题。