1064 字
5 分钟
给你的照片一张地图通行证:我为 ChronoFrame 开发了一款配套小工具

给你的照片一张地图通行证:我为 ChronoFrame 开发了一款配套小工具#

1. 偶然的邂逅:发现 ChronoFrame#

最近在 GitHub 闲逛时,被一款名为 ChronoFrame 的开源项目吸引了。

它是一款视觉体验极其丝滑的照片管理应用,不仅支持大图渲染,最让我心动的是它的**“探索地图”**功能——可以在地图上直观地看到自己在世界各地留下的足迹。

快速部署体验#

它的部署非常简单,只需一个 docker-compose.yml.env 环境文件即可搞定。

第一步:创建 .env 配置文件

Terminal window
# 管理员邮箱(必须)
CFRAME_ADMIN_EMAIL=
# 管理员用户名
CFRAME_ADMIN_NAME=
# 管理员密码
CFRAME_ADMIN_PASSWORD=
# 站点信息(均可选)
NUXT_PUBLIC_APP_TITLE=
NUXT_PUBLIC_APP_SLOGAN=
NUXT_PUBLIC_APP_AUTHOR=
# 地图提供器 (maplibre)
NUXT_PUBLIC_MAP_PROVIDER=maplibre
# 使用 MapLibre 需要 MapTiler 申请链接 maptiler.com
NUXT_PUBLIC_MAP_MAPLIBRE_TOKEN=
# 存储提供者(local、s3 或 openlist)
NUXT_STORAGE_PROVIDER=local
NUXT_PROVIDER_LOCAL_PATH=/app/data/storage
# 会话密码(必须,32 位随机字符串)
NUXT_SESSION_PASSWORD=

第二步:创建 docker-compose.yml

version: '3.8'
services:
chronoframe:
image: ghcr.io/hoshinosuzumi/chronoframe:latest
container_name: chronoframe
restart: unless-stopped
ports:
- "3000:3000"
volumes:
- ./data:/app/data
env_file:
- .env

只需执行 docker compose up -d,一个漂亮的照片墙就搭好了。


2. 发现痛点:消失的 GPS 信息#

当我兴致勃勃地把刚从 Sony A6700Canon R5 Mark II 里导出的照片上传后,却发现“探索地图”里一片空白。

我才意识到,虽然这些是顶级微单,但由于机身不自带 GPS 模块,或者因为手机蓝牙同步极其不稳定,照片原始文件里根本没有坐标信息。

对于一个强迫症摄影师来说,没有地理位置的照片是不完整的。为了解决这个问题,我写了一个专门配合此类 Web 管理系统使用的“前置处理”小工具:Phoenix Photo Studio Pro

image


3. 解决方案:Phoenix Photo Studio Pro#

这是一款专门为摄影师设计的图像批处理工具,它不仅仅是用来加 GPS 坐标的,更是一个**“照片分发前的终点站”**。

它能为你解决什么?#

  1. 智能位置注入:你不需要去查经纬度。直接输入“南京 总统府”或者“西藏 纳木错”,程序会自动解析坐标并写入照片 EXIF 信息的 GPS 字段。
  2. 机身 EXIF 兼容性修复:Sony 等机型产生的原始元数据在 macOS 下经常会导致预览图出现黑线或无法读取。程序内置了底层自愈逻辑,自动修正这类报错。
  3. 隐私脱敏:在分享到网络前,一键抹除相机序列号、后期软件处理痕迹,只保留核心拍摄参数,保护你的设备安全。
  4. 智能缩放与压制:原片动辄 50MB,上传服务器太慢。工具内置 LANCZOS 高质量算法,可以一键将照片缩放至 2K/4K 级别并保持极佳画质。

4. 核心功能解析#

📍 语义化地理位置#

通过集成 Nominatim 引擎,支持中文语义搜索。配合我专门为 macOS 优化的 SSL 握手修复逻辑,无论在 Win 还是 Mac 上都能稳定查询。

🛠️ EXIF 隐私与自愈#

  • 隐私模式:抹除 SoftwareProcessingSoftware 等标签。
  • Sony 专项修复:针对标签 41728、41729 等类型冲突导致的显示 Bug 进行强制字节流修正。

🎨 工业级 UI 设计#

采用深色模式定制,绿色 Consolas 实时日志输出,支持文件夹递归扫描。


5. 推荐工作流#

现在的我,在把照片喂给 ChronoFrame 之前,会先经过 Phoenix Studio 的“洗礼”:

  1. 后期导出:从 Lightroom 或 Capture One 导出原大照片。
  2. 凤凰工作室处理
    • 输入拍摄地名(如“大理 古城”)。
    • 设置缩放至 2560px(节省服务器空间,提高加载速度)。
    • 选择“隐私脱敏”模式。
  3. 上传发布:将生成的 _pro 后缀照片上传到 ChronoFrame。

现在,我的地图终于亮起来了。


6. 如何获取#

如果你也遇到了大厂相机不带 GPS 的尴尬,或者想在上传照片前进行一键优化,可以尝试运行这个脚本。

下载链接 根据不同系统下载压缩包

Windows 下载 PhoenixPhotoStudio_win.zip

MacOS 下载 PhoenixPhotoStudio_MacOS.zip

给你的照片一张地图通行证:我为 ChronoFrame 开发了一款配套小工具
https://blog.wlens.top/posts/给你的照片一张地图通行证我为-chronoframe-开发了一款配套小工具/
作者
Lao Wang
发布于
2026-02-01
许可协议
CC BY-NC-SA 4.0