一个基于 Next.js + Tailwind CSS + Supabase 的完整网页项目,提供注册、登录、退出登录、私有文件上传、文件列表展示、下载自己的文件、删除自己的文件,以及个人中心统计能力。
- Next.js App Router
- Tailwind CSS
- Supabase Auth
- Supabase Postgres
- Supabase Storage
- Capacitor Android Shell
- 用户注册
- 用户登录 / 退出登录
- 文件上传
- 文件列表展示
- 下载自己的文件
- 删除自己的文件
- 文件名、文件大小、上传时间展示
- 用户信息与文件统计展示
- 文件类型与大小限制
- 防止同名文件覆盖
- Android APK 壳应用封装
.
├─ android
├─ app
├─ capacitor-build
├─ components
├─ lib
├─ supabase
├─ .env.example
├─ capacitor.config.ts
├─ middleware.ts
├─ next.config.mjs
├─ package.json
└─ README.md
id uuid primary key
email text not null unique
full_name text
created_at timestamptz not nullid uuid primary key
user_id uuid not null
file_name text not null
file_path text not null
file_size bigint not null
mime_type text not null
created_at timestamptz not nullnpm install- 在 Supabase 控制台创建新项目。
- 打开 SQL Editor,执行
supabase/schema.sql。 - 获取项目的 URL 和 publishable key。
- 复制
.env.example为.env.local,填入你的 Supabase 环境变量。
如果你希望注册后立即登录,可以在 Supabase Auth 设置中关闭 Email Confirm。
npm run dev- 将代码推送到 Git 仓库。
- 在 Vercel 中导入该项目。
- 添加环境变量:
NEXT_PUBLIC_SUPABASE_URLNEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY
- 点击 Deploy。
- 确认
supabase/schema.sql已执行成功。 - 确认私有 Bucket
user-files已创建。 - 确认 RLS 与 Storage Policy 生效。
因为当前项目依赖 Next.js 服务端路由和 Supabase,会使用 Capacitor + 线上站点地址 的方式生成 Android 壳应用,而不是把整个 Next.js 服务端直接打包进 APK。
- 一个已经能公网访问的站点地址,例如你的自定义域名
- Android Studio
- Android SDK
- JDK 17 或更高版本
在 .env.local 中增加:
CAPACITOR_SERVER_URL=https://你的公网域名
CAPACITOR_APP_ID=com.personalfilecenter.app
CAPACITOR_APP_NAME=个人文件中心npm run apk:preparenpm run cap:open:android在 Android Studio 中:
BuildBuild Bundle(s) / APK(s)Build APK(s)
生成后可以在 Android Studio 提示里直接打开 APK 输出目录。
域名变更后重新执行:
npm run apk:prepare然后再重新构建 APK。
- 注册页使用用户名 + 密码的形式登录,底层映射到 Supabase Auth。
- 登录页支持用户名登录。
- 顶部导航支持退出登录。
- 中间件与服务端页面共同保护私有页面。
- 上传页面位于
components/files/upload-form.tsx - 已优化为浏览器直传 Supabase Storage,更适合移动端。
- 上传前校验登录状态、文件类型、文件大小。
- 存储路径使用
用户ID/UUID.扩展名,避免重名覆盖。 - 上传成功后通过接口写入
files表。
- 下载接口位于
app/api/files/[id]/download/route.ts - 先验证文件是否属于当前用户。
- 再生成短时效签名链接进行下载。
- 删除接口位于
app/api/files/[id]/route.ts - 先验证文件归属。
- 再删除 Storage 文件和数据库记录。
- 文件搜索 / 筛选
- 文件夹层级
- 回收站
- 分享链接
- 文件预览
- 用户头像与资料编辑
- APK 启动画面与图标替换