Spaces:
Sleeping
Sleeping
File size: 4,963 Bytes
bc4af9e 4446216 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 | ---
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 全内联)。后端地址已在文件开头配好:
```js
var API_BASE = "https://wacatw-cloud-camera.hf.space"; // HF 后端(Gradio API)
```
### 部署步骤(约 3 分钟)
1. 打开 [github.com/new](https://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 命名,中文/特殊字符用户名按规则清洗
- **图片传输**:相册列表仅返回缩略图,原图按需拉取,删除即从磁盘移除
## 本地调试
```bash
# 依赖
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` 文件(浏览器需联网)。
|