Skip to content

About

个人文件中心 · Next.js + Supabase + Tailwind 全栈文件管理:注册登录、私有文件上传/下载/删除、使用统计、Capacitor Android 壳。Self-hosted personal file center.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

个人文件中心

一个基于 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

数据结构

users

id uuid primary key
email text not null unique
full_name text
created_at timestamptz not null

files

id 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 null

本地运行方法

1. 安装依赖

npm install

2. 创建 Supabase 项目

  1. 在 Supabase 控制台创建新项目。
  2. 打开 SQL Editor,执行 supabase/schema.sql。
  3. 获取项目的 URL 和 publishable key。
  4. 复制 .env.example 为 .env.local,填入你的 Supabase 环境变量。

3. 可选:关闭邮箱验证

如果你希望注册后立即登录,可以在 Supabase Auth 设置中关闭 Email Confirm。

4. 启动开发环境

npm run dev

访问 http://localhost:3000

部署步骤

推荐:部署到 Vercel

  1. 将代码推送到 Git 仓库。
  2. 在 Vercel 中导入该项目。
  3. 添加环境变量:
    • NEXT_PUBLIC_SUPABASE_URL
    • NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY
  4. 点击 Deploy。

Supabase 配置检查

  • 确认 supabase/schema.sql 已执行成功。
  • 确认私有 Bucket user-files 已创建。
  • 确认 RLS 与 Storage Policy 生效。

Android APK 封装

说明

因为当前项目依赖 Next.js 服务端路由和 Supabase,会使用 Capacitor + 线上站点地址 的方式生成 Android 壳应用,而不是把整个 Next.js 服务端直接打包进 APK。

需要先准备

  • 一个已经能公网访问的站点地址,例如你的自定义域名
  • Android Studio
  • Android SDK
  • JDK 17 或更高版本

1. 配置 APK 对应的线上地址

在 .env.local 中增加:

CAPACITOR_SERVER_URL=https://你的公网域名
CAPACITOR_APP_ID=com.personalfilecenter.app
CAPACITOR_APP_NAME=个人文件中心

2. 同步 Android 工程

npm run apk:prepare

3. 用 Android Studio 打开工程

npm run cap:open:android

4. 导出 APK

在 Android Studio 中:

  • Build
  • Build Bundle(s) / APK(s)
  • Build APK(s)

生成后可以在 Android Studio 提示里直接打开 APK 输出目录。

5. 如果改了线上域名

域名变更后重新执行:

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 启动画面与图标替换

About

个人文件中心 · Next.js + Supabase + Tailwind 全栈文件管理:注册登录、私有文件上传/下载/删除、使用统计、Capacitor Android 壳。Self-hosted personal file center.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages