ChronoFrame
自托管的个人相册应用，支持多存储后端和智能EXIF解析，让摄影师完全掌控照片数据。
智能下载
前往项目主页
该项目暂未提供安装包，请直接访问源代码仓库
自建相册，替代Google Photos，支持地图浏览和EXIF自动提取。
核心功能
- 智能EXIF提取：自动识别拍摄时间、位置、相机参数
- 反向地理编码：根据经纬度自动查找拍摄地点名称
- 交互式地图：在地图上浏览所有照片的地理位置
- 多存储后端：支持本地存储、S3兼容存储和CDN加速
- 高效缩略图：使用ThumbHash技术快速生成预览
避坑指南
- •默认管理员密码弱（CF1234@!），务必在.env中修改。如使用本地存储，注意磁盘空间。地图功能需要MapTiler或Mapbox的Token（免费额度够用）。反向地理编码依赖Mapbox Token，不配置则无法显示地点名称。
适用场景
- 摄影师个人作品展示网站：用自己域名展示作品集
- 家庭照片存档：自建家庭相册，避免依赖云服务
- 旅行照片整理：自动提取拍照地点，在地图上回顾旅程
详细介绍
ChronoFrame 是一款专为摄影师和爱好者打造的现代自托管相册应用。基于 Nuxt 4 + TypeScript + TailwindCSS + Drizzle ORM 构建，它提供了一个流畅的网页界面，用于上传、浏览和管理照片。核心功能包括智能 EXIF 元数据提取（自动识别拍摄时间、地点、相机参数）、反向地理编码（自动标注拍摄位置）、交互式地图浏览以及多存储后端支持（本地文件系统或 S3 兼容存储）。它使用 ThumbHash 高效生成缩略图，并利用 WebGL 实现高质量图片渲染。通过 Docker 一键部署（预构建镜像在 GHCR 和 Docker Hub 上），管理员后台支持批量上传、拖拽上传和自动生成缩略图。还支持 CDN 加速图片分发。相比 Google Photos 或 Flickr 等云服务，ChronoFrame 让你完全掌控自己的照片数据，没有隐私泄露风险，且无需订阅费用。
标签
快速上手
安装软件
双击下载的安装程序，按提示完成安装
步骤1：在服务器上安装Docker和Docker Compose
步骤2：创建.env文件，配置管理员邮箱、密码和存储方式（本地或S3）
步骤3：运行docker compose up -d启动服务
- 步骤1：在服务器上安装Docker和Docker Compose
- 步骤2：创建.env文件，配置管理员邮箱、密码和存储方式（本地或S3）
- 步骤3：运行docker compose up -d启动服务
暂未获取到校验码
该项目暂未在 GitHub Release 页面提供 SHA-256 校验码
SHA256 校验码
暂无校验码
建议从 GitHub Releases 页面直接下载，并自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
停止容器：docker compose down；删除数据：rm -rf ./data 和 docker rmi ghcr.io/hoshinosuzumi/chronoframe
无额外依赖
下载后即可直接使用，无需安装其他运行环境