Home

SandAdmin 使用文档

SandAdmin 是基于 Webman 的 PostgreSQL 后台宿主，提供帐号、权限、系统配置、代码生成、任务调度和可选插件管理。它是独立维护的 SaiAdmin 6.x fork；业务插件各自维护源码、版本和安装说明。

当前安装指南面向已发布的 SandAdmin 0.2.1、Sand Core 0.2.2 与 SandPackage 0.2.2（2026-10-04核对）；实际验证范围见下方版本来源。PHP 要求至少8.2；当前指南推荐 Node.js 22（至少22.12.0），使用前端 packageManager 固定的 pnpm 11.19.0。pnpm9.15.9仅属于2026-09-30旧快照，不再作为当前安装命令。版本来源、工具链及验收范围见版本与验证范围。

版本更新

升级前先看 Core、Package 与 SandAI 版本更新，了解最近公开版本的功能变化、修复和升级影响。页面分别标明稳定版、预发布版及未发布源码候选。

• SandAdmin 宿主版本更新
• SandIAM 版本更新
• SandWorkflow 版本更新

第一次使用

1. 本地运行与首次安装：准备空 PostgreSQL 数据库，启动后端和前端，完成安装并登录。
2. 配置参考：核对数据库、端口、缓存与前端代理。
3. 从仓库安装插件：选择独立 Release，完成后端生命周期及管理端验证。
4. 部署与升级：保存配置和持久数据，构建并发布前端，在目标环境验收。

遇到问题先看排障。插件自身的配置、业务流程、数据保留和卸载影响以该版本包内 README 为准。

开发与维护

• Package 载荷与重接参考、SandAI 源码维护。
• 架构与插件边界及仓库治理：判断代码归属和公共契约。
• 插件开发、仓库分发、前端载荷契约：打包、兼容与前端生效边界。
• 宿主消费与同步：锁定版本并保护消费方数据。
• PostgreSQL 生命周期适配与旧失败升级恢复：维护者处理具体驱动和旧现场。
• 宿主版本更新、更名兼容、来源和许可证。

安装器会写入数据库并生成 .env；执行前应确认目标为空数据库且有初始化权限。实际验证范围见版本与验证范围。