跳到主要内容

Installer 初始化

当系统检测到实例尚未完成初始化时，前端会自动跳转到 /installer。

Installer 的作用​

Installer 页面用于完成首次实例初始化，包括：

  • 建立租户与管理员信息
  • 写入平台基础配置
  • 初始化权限与种子数据

初始化流程​

  1. 首次启动 IoTSharp。
  2. 浏览器访问系统地址。
  3. 如果实例未初始化，自动进入 Installer 页面。
  4. 填写实例与管理员信息。
  5. 提交后等待初始化完成。
  6. 跳转到登录页继续登录。

初始化前的准备​

  • 确认数据库连接可用。
  • 确认 ASPNETCORE_ENVIRONMENT 对应的配置文件存在。
  • 如果使用 Sqlite，确认程序工作目录可写。
  • 如果启用证书或 ACME，确认文件目录与权限可用。

常见问题​

页面反复跳回 Installer​

通常说明初始化状态没有成功写入，优先检查：

  • 数据库连通性
  • 后端日志
  • 当前环境配置文件

提交后提示接口失败​

优先确认：

  • 前端是否能连接后端
  • 反向代理是否正确转发 /api
  • 浏览器开发者工具里是否有 4xx / 5xx