Files
yovision/Sense/scripts/runtime/README-WINDOWS.md
T

1.6 KiB
Raw Blame History

Sense Windows 运行包

此目录同时包含 Sense 后端和已经构建好的前端静态页面。Brain、Bell 无需启动。

快速查看

在命令提示符中运行:

start-sense.bat demo

然后访问 http://127.0.0.1:18080。demo 使用内存数据,进程退出后数据会丢失,仅用于本机查看,不能用于生产。

生产启动

生产环境必须先安装并准备独立 PostgreSQL。把配置写入运行目录的 config\sense.env,或在 Windows 进程环境中提供;已存在的非空进程环境变量优先于文件:

  • SENSE_DATABASE_URL:PostgreSQL 连接地址。
  • SENSE_IDENTITY_SIGNING_KEY:至少 32 个字符的会话签名密钥。
  • SENSE_BOOTSTRAP_TOKEN:首次初始化使用的引导令牌。
  • SENSE_CREDENTIAL_KEY:Base64 编码的 32 字节摄像头凭据加密密钥。

按需要设置 SENSE_HTTP_ADDRESS、MediaMTX 和 ONVIF 参数后运行:

start-sense.bat

启动前可只检查配置,不连接数据库也不启动服务:

start-sense.bat check

完整变量名可参考 config\sense.env.example。复制为 config\sense.env 后填写真实值;该文件不会进入 ZIP 或 Git。本机在同一运行目录重新打包时会保留该文件,但交付 ZIP 始终不包含它。启动器只读取 SENSE_* 键,忽略空行与 # 注释,且不会打印配置值。生产环境仍建议使用 Windows 环境变量或外部秘密管理工具注入真实值。

健康检查为 GET /healthz 和 GET /readyz。MediaMTX 仍是独立程序,本运行包不会安装 PostgreSQL、MediaMTX 或 Windows 服务。