ChronoFrame

ChronoFrame 是一款自托管个人照片图库，面向想把日常照片和旅行影像集中整理、并自行选择存储位置的用户。它支持批量上传、编辑照片信息、筛选和排序；项目文档还介绍了地图地点、相册访问保护，以及 Live Photos 和 Motion Photos 的浏览能力。本文根据官方 v1.0.0 文档整理，未下载或实测部署。

ChronoFrame 的照片管理功能

可以在管理界面批量上传照片，编辑照片信息，再通过筛选和排序查找内容。项目提供相册分组与排列选项；官方介绍还列出对 Apple Live Photos 和 Motion Photos 的播放支持。实际格式兼容范围应以当前版本文档为准。

存储方式与适用条件

官方文档列出本地文件、S3 兼容存储和 OpenList 三类存储方式，并说明可在控制面板管理存储方案。使用地图地点需要配置相应地图服务令牌；没有令牌时，文档说明可以先完成本地部署和照片上传。服务器系统兼容矩阵未在本次资料中核实；平台字段仅反映其 Docker/Web 部署形态，不代表所有 Linux 发行版都经过测试。

Docker Compose 安装与启动

在已安装 Docker Engine 和 Docker Compose 的主机上，按项目文档创建 compose 配置并启动容器。官方示例映射主机 3000 端口到容器 3000，并挂载持久化数据目录；随后访问 http://localhost:3000，按照首次设置向导创建管理员并选择存储。若通过远程主机部署，应将 localhost 换成该主机可访问的地址，并按部署环境自行配置访问控制和 HTTPS；本页未对公网部署安全配置作测试或保证。

数据目录与版本更新

官方 README 提醒保留数据卷挂载：该目录包含数据库、设置、会话密钥，以及启用本地存储时的照片文件。更新容器前应先依据官方说明备份持久化数据，再将镜像版本固定到所需标签；不要把临时容器文件系统当作备份。此次核验的版本为 v1.0.0，具体更新内容以对应 release 页面为准。

常见问题（FAQ）

ChronoFrame 需要单独安装数据库吗？ 官方首页介绍 Docker 部署时无需另行安装数据库；具体资源需求和生产部署设置仍应参考项目部署文档。

没有地图令牌能否先上传照片？ 官方 README 表示可以先完成向导并开始上传，之后再添加地图令牌。地图相关功能在未配置前不可据此视为已启用。

照片存放在哪里？ 可选择本地文件、S3 兼容服务或 OpenList。使用本地存储时，官方 Docker 示例将数据目录挂载至容器内的存储路径；部署时请保留持久化挂载并自行确认备份策略。

项目是否收费？ 本次查阅的官网和 v1.0.0 仓库资料没有明确列出商业价格，因此不据 MIT 许可证推断托管服务或相关第三方服务的收费情况。

来源：项目官网 https://chronoframe.bh8.ga/；v1.0.0 README https://github.com/HoshinoSuzumi/chronoframe/blob/v1.0.0/README.md；v1.0.0 Release https://github.com/HoshinoSuzumi/chronoframe/releases/tag/v1.0.0；v1.0.0 LICENSE https://raw.githubusercontent.com/HoshinoSuzumi/chronoframe/v1.0.0/LICENSE。