--- 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//<文件名>"]`,再把该临时路径传给 `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` 文件(浏览器需联网)。