Home

SandAdmin 使用文档

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

本 Wiki 的当前操作指南以公开主线 276c89e188c5346df8535eb9b90608f189a3e572 为依据（2026-09-30 核对），不是把最新 Release 0.1.1 与主线视为同一工件。PHP 要求至少 8.2；当前指南选择 Node.js 22 系列（至少 22.12.0）和 pnpm 9.15.9，以满足实际锁文件及 Vite 的工具链要求。版本、工具链候选和验收限制集中见版本与验证范围。

第一次使用

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

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

开发与维护

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

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