一个部署在 Hugging Face Spaces 上的私人图床服务,图片直接存储在 Space 的文件系统中,使用 SQLite 数据库管理元数据。
- 📤 批量上传:支持一次上传多张图片
- 👁️ 预览控制:可显示/隐藏图片上传预览
- 🔗 一键复制URL:点击按钮即可复制图片URL到剪贴板
- 👀 图片查看:在列表中直接查看图片详情和预览
- 🗑️ 图片删除:安全删除不需要的图片
- 🌐 完整URL生成:配置HF信息后自动生成外部可访问的完整URL
- 🔐 密码保护:所有操作都需要密码验证
- 💾 本地存储:图片存储在服务器文件系统,SQLite 管理元数据
- 📦 数据导出:导出图片元数据(含完整URL)为 JSON 格式
- 访问 Hugging Face Spaces
- 点击右上角头像,再点击 "+ New Space"
- 填写信息:
- Space name: 选择一个名字,例如
my-imgur - License: MIT
- Select the SDK: 选择
Gradio,然后Gradio template为Blank - Space hardware: CPU basic (免费)
- Visibility:
- Public: 选择这个
- Space name: 选择一个名字,例如
- 在创建的 Space 页面,点击 "Files" 标签
- 点击 "+ Contribute" -> "Upload files"
- 上传以下文件:
app.pyrequirements.txt
-
在你的 Space 页面,点击 "Settings" 标签
-
找到 "Variables and secrets" 部分
-
点击 "New secret" 按钮,添加以下变量:
变量 1: 访问密码(必需)
- Name:
ACCESS_PASSWORD - Value: 设置一个强密码,用于访问图床服务
变量 2: HF用户名(可选,用于生成完整URL)
- Name:
HF_USERNAME - Value: 你的 Hugging Face 用户名
变量 3: Space名称(可选,用于生成完整URL)
- Name:
HF_SPACE_NAME - Value: 你的 Space 名称(例如:
private-image-hosting)
- Name:
-
点击 "Save" 保存每个变量
💡 提示:配置 HF_USERNAME 和 HF_SPACE_NAME 后,系统会自动生成完整的外部访问URL(格式:https://用户名-空间名.hf.space,图片URL格式为:https://用户名-空间名.hf.space/img/图片ID)
- Space 会自动构建和启动,大约需要 1-2 分钟
- 构建完成后,你的私人图床服务就可以使用了!
- 重启/关闭/上传新的东西/改变Secrets这些操作会导致重启,重启后数据将丢失(无法持久保存)
- 所以尽量避免以上操作,创建完了就一直开着就行了。本仓库代码不适合长期存放图片使用
- 如需长期存放图片,请自行更改代码连接远程数据库!
MIT License
欢迎提交 Issue 和 Pull Request!
如果这个项目对你有帮助,请给它一个 Star!
如有问题或建议,欢迎提交 Issue。


