cloud-camera / README.md
WACATW's picture
Upload README.md
bc4af9e verified
|
Raw History Blame Contribute Delete
4.96 kB

A newer version of the Gradio SDK is available: 6.32.0

Upgrade
metadata
title: Cloud Camera
emoji: 📷
colorFrom: blue
colorTo: gray
sdk: gradio
app_file: app.py
pinned: false

📷 云端相机 Cloud Camera

手机浏览器打开的 H5 云端相机:拍照/选图 → 保存到本地或上传云端 → 随时随地打开网页查看自己的云端相册。

架构(方案 B)

  • 后端:Hugging Face Space(Gradio API),照片存 Space 挂载的持久存储桶(重启不丢)
  • 前端:单页 index.html,部署在你自己的 GitHub Pages(域名自理)

功能一览

模块 功能
🔐 登录 用户名 + PIN 码,首次输入自动创建专属相册;浏览器记住登录状态
📷 拍照 实时取景拍照、前后镜头切换;不支持实时预览时自动回退到系统相机
🖼 选图 从手机相册选照片上传
💾 保存 拍照后可选「存本地」或「传云端」(带进度条),设置里可开启「上传后自动再存一份本地」
🗂 云端相册 缩略图三列网格、滚动加载、大图查看、下载、删除、下拉刷新
⚙️ 设置 切换账号、退出登录、自动保存开关

目录结构

cloud-camera/
├── app.py            # HF Space 后端(Gradio API:登录/上传/列表/单图/删除)
├── storage.py        # 存储层:用户、PIN 加盐哈希、索引、图片访问签名
├── index.html        # 前端单页(部署到 GitHub Pages 的唯一文件)
├── main.py           # 旧 FastAPI 版后端(仅本地参考,Space 不再使用)
├── requirements.txt  # 后端依赖
└── README.md

后端(Hugging Face)— 已完成部署

当前线上后端:https://wacatw-cloud-camera.hf.space(用户名 WACATW,Space cloud-camera)

  • SDK:Gradio(ZeroGPU 免费额度,仅占用位函数,业务不消耗 GPU 配额)
  • 持久存储:挂载存储桶 WACATW/cloud-camera-storage 到 /data,Space 重启后照片不丢(已验证)
  • 业务接口:以 Gradio API 形式暴露(见下节)

后端 API 参考(Gradio Queue API)

调用流程:POST /gradio_api/call/{api} 提交参数 → 返回 event_id → GET /gradio_api/call/{api}/{event_id} 轮询 SSE 取结果。

接口 参数 data 返回
api_login ["用户名","PIN"] {"ok":true,"is_new":true/false}
api_upload ["用户名","PIN","临时路径"] {"ok":true,"photo":{...}}
api_photos ["用户名","PIN"] {"ok":true,"photos":[{...缩略图 base64...}]}
api_photo ["用户名","PIN","照片id"] {"ok":true,"b64":"data:image/jpeg;base64,..."}
api_delete ["用户名","PIN","照片id"] {"ok":true}

上传通道:POST /gradio_api/upload(multipart files=)→ 返回 ["/tmp/gradio/<hash>/<文件名>"],再把该临时路径传给 api_upload。

图片以 base64 data URL 传输(缩略图随列表返回、原图点开时单独拉取),绕开 Gradio file= 白名单限制,无需额外鉴权 header。

前端(GitHub Pages)— 你来部署

前端就是一个文件:index.html(CSS/JS 全内联)。后端地址已在文件开头配好:

var API_BASE = "https://wacatw-cloud-camera.hf.space";   // HF 后端(Gradio API)

部署步骤(约 3 分钟)

  1. 打开 github.com/new,新建一个公开仓库,比如 cloud-camera
  2. 上传 index.html 到仓库根目录(仓库页面 → Add file → Upload files)
  3. 仓库 Settings → Pages:Source 选 Deploy from a branch,分支选 main,目录 / (root),Save
  4. 等 1-2 分钟,GitHub 会给你一个 https://<用户名>.github.io/cloud-camera/ 地址,手机浏览器打开即用
  5. (可选)之后自己绑定域名:Settings → Pages → Custom domain

换绑到别的后端

如果后端地址变了,只需改 index.html 里的 API_BASE 一个常量;若整站同域部署,改成空字符串 "" 即可。

安全设计

  • PIN 码:加盐哈希存储 sha256(salt:pin),明文不落盘;错误 PIN 拒绝访问相册
  • 用户隔离:每个用户独立相册目录(/data/<用户名>/),接口强制校验用户名+PIN
  • 文件名:照片以随机 id 命名,中文/特殊字符用户名按规则清洗
  • 图片传输:相册列表仅返回缩略图,原图按需拉取,删除即从磁盘移除

本地调试

# 依赖
pip install gradio pillow

# 本地起服务(stub 掉 spaces.GPU)
DATA_DIR=/tmp/cc-data python3 -c "import sys,types;sp=types.ModuleType('spaces');sp.GPU=lambda fn:fn;sys.modules['spaces']=sp;import runpy;runpy.run_path('app.py',run_name='__main__')"
# 打开 http://127.0.0.1:7860 (Gradio API 端点)

本地 index.html 的 API_BASE 指向线上后端,纯前端测试可直接打开 index.html 文件(浏览器需联网)。