Supabase 初始化
数据库安装与维护
本目录提供万有AI 的数据库安装、升级和校验文件。新部署按下面的安装步骤操作;已有数据的实例使用升级指南。
新装
要求 PostgreSQL 17 或更高版本。在全新、未使用的 Supabase 项目中打开 SQL Editor,依次粘贴并完整执行:
supabase/install.sql
supabase/verify.sql
install.sql 执行成功后再运行 verify.sql。校验应返回检查结果,每一行的 passed 都必须为 true。如果校验返回空结果、出现 false 或 SQL 错误,停止部署,按失败项排查;不要通过反复运行安装文件来修复。
安装会建立数据库结构、访问权限和空白站点配置,不创建用户、站主或内容,也不开通支付和分身。站主认领、Auth 登录邮件和网站部署按部署指南继续操作。面向部署者的示例在站主认领后从 /admin/setup 载入,包含免费指南与收费方案页,可选择空站。demo.sql 是另一个维护测试用演示数据集,仅用于尚未使用的测试实例,不是网站初始化的必需步骤。
图片存储
图片桶需在 Storage 中单独配置,安装 SQL 不会创建桶。先按环境变量说明填好自己的项目 URL 和服务端密钥,再从仓库根目录运行:
npm run storage:setup # 只读检查图片桶
npm run storage:setup -- --apply # 创建桶或调整上传限制
公开图片桶默认 media,单文件上限 10 MiB,允许 PNG、JPEG、WebP、GIF;名称通过 SUPABASE_STORAGE_MEDIA_BUCKET 设置。工具同时配置固定名称 media-uploads 的私有暂存桶,同样 10 MiB 并允许 SVG。浏览器直传暂存桶,服务端校验并将 SVG 转为 PNG 后才进入公开桶。选图、旧图登记和暂存维护见素材库说明。
工具不上传或删除文件,也不改变已有桶的公开/私有属性;属性不符时会停止,需要先核对桶内容再处理。对象写入权限仍须按安全配置检查。verify.sql 只检查应用数据库,不检查 Storage、Auth 回调、SMTP 或外部服务凭据。
私有文件包桶是可选项,可用 --packages 一并配置,默认名 packages、上限 50 MiB。应用尚未提供文件包下载接口,创建该桶不会启用下载功能,基础部署无需配置它。
文件用途
| 文件或目录 | 用途 |
|---|---|
install.sql | 全新实例的一体化安装文件 |
verify.sql | 只读检查数据库结构、版本和访问权限 |
demo.sql | 可选演示内容;仅用于尚未使用的实例 |
migrations/ | 按版本顺序保存的数据库变更,是维护源 |
upgrades/ | 指定旧版本的升级脚本,使用前须核对前置版本 |