ChronoFrame 是一款功能强大的自托管个人相册开源应用,让用户完全掌控自己的照片库,并提供一个美观、现代的浏览界面。由开发者 HoshinoSuzumi 创建,遵守MIT开源。核心定位是“动态的”个人画廊应用,支持在线照片上传、管理、相册创建与浏览,与那些需要预先静态生成页面的方案形成了鲜明对比。用户可以随时随地通过网页上传新照片,并立即在画廊中看到它们。

核心特性

ChronoFrame 的魅力在于其丰富而实用的功能集:

  • 全面的格式支持:不仅支持常见的 JPEG、PNG 格式,还原生支持 HEIC/HEIF 格式以及 Live Photo 和 Motion Photo(通过配对的 .mov 视频文件实现),非常适合展示用现代手机拍摄的照片。
  • 智能照片管理:应用会自动解析照片的 EXIF 信息,展示拍摄参数。更酷的是,它能识别照片中的地理位置数据,并在地图上可视化你的拍摄足迹,提供一种全新的“地图探索”浏览模式。
  • 现代化的技术栈与体验:项目采用 Nuxt 4、TypeScript、Tailwind CSS 和 Drizzle ORM 等现代前端技术构建,确保了应用的性能与开发质量。界面设计简洁美观,支持亮色/暗色主题切换,并且是响应式设计,在手机和电脑上都能获得良好的浏览体验。
  • 灵活的存储后端:目前主要支持 S3 兼容的对象存储(如 AWS S3、MinIO 等),方便扩展和备份。未来版本计划增加对本地存储等更多后端的支持。

适用场景

无论是摄影爱好者,希望有一个私密的空间来展示自己的作品;还是只想为家庭照片建立一个安全的数字相册,避免依赖第三方云服务,ChronoFrame 都是一个非常出色的选择。它平衡了功能的完备性与部署的简便性,在享受现代 Web 应用便利的同时,牢牢握住数据的所有权。

轻松部署

ChronoFrame 的部署非常友好,官方推荐使用 Docker 或 Docker Compose,这能极大地简化环境配置过程。基本步骤包括:拉取官方 Docker 镜像。通过环境变量配置关键信息,如管理员账号、Mapbox 地图服务的访问令牌(用于地图功能)以及 S3 存储的连接参数。使用 Docker Compose 一键启动。启动后,首次访问时会根据配置自动创建管理员账户,之后就可以通过网页端轻松上传和管理照片了。

源代码:https://github.com/HoshinoSuzumi/chronoframe