Spaces:
Sleeping
Sleeping
|
Download README.md from WACATW/cloud-camera: direct link, hf CLI and curl.
- Browser
- Download file 4.96 kB
-
https://huggingface.co/spaces/WACATW/cloud-camera/resolve/main/README.md
- Command line
-
hf download hf://spaces/WACATW/cloud-camera/README.md
-
curl -L -o README.md https://huggingface.co/spaces/WACATW/cloud-camera/resolve/main/README.md
4.96 kB
A newer version of the Gradio SDK is available: 6.32.0
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 分钟)
- 打开 github.com/new,新建一个公开仓库,比如
cloud-camera - 上传
index.html到仓库根目录(仓库页面 → Add file → Upload files) - 仓库 Settings → Pages:Source 选
Deploy from a branch,分支选main,目录/ (root),Save - 等 1-2 分钟,GitHub 会给你一个
https://<用户名>.github.io/cloud-camera/地址,手机浏览器打开即用 - (可选)之后自己绑定域名: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文件(浏览器需联网)。