常见问题

MT Photos收费吗？

MT Photos 服务端收费，支持试用1个月；

试用结束后，服务端将停止扫描新增的文件，App也将停止备份新的照片、视频；

苹果、安卓App免费使用，下载地址请查看App下载；

服务端订阅可以换设备吗？

可以，在新的设备上安装好服务端后，重新绑定下激活码即可将订阅转到新设备上。

如需数据备份与迁移，请查看 如何备份MT Photos的数据、文件？

支持多用户使用吗？

支持，可以在【用户管理】中添加、管理用户；

支持哪些类型的图片、视频

支持图片的格式有：JPEG, HEIC, HEIF, HIF, PNG, GIF, BMP, TIFF, PSD, AVIF, JXL

支持RAW照片的格式有：3FR, ARW, CR2, CR3, CRW, DCR, DCRAW,DNG, ERF, IIQ, K25, KDC, MEF, MRW, NEF, NRW, ORF, PEF, RAF, RAW, RMF, RW2, SR2, SRF, X3F

如果一个文件夹下有同名的jpg+raw格式文件，会合并显示

支持视频的格式有：MOV, MP4, MPEG, 3GP, M4V, WEBM, MKV, WMV, AVI, RM, RMVB, FLV, OGG, M2T, M2TS, MTS, VOB （其中MOV和MP4文件App和网页支持播放，其他的格式需要生成转码文件或者调用外部播放器播放）

功能更新计划

• 图片归档、隐私相册
• 根据图片相似度清理重复文件
• 管理员增加整理人物相册，合并人物、设置默认名称、封面
• iOS App备份增加相册选择
• App备份增加自动同步相册
• 在相册内直接上传文件
• 按年月分文件夹整理已上传的文件
• 图片旋转功能
• 增加API key管理

已支持的功能

• 时间线模式查看照片
• 文件夹视图查看照片
• 使用影集、收藏夹来整理照片
• 基于人脸识别自动生成人物相册
• 基于照片、视频exif中的GPS信息自动生成地点相册
• 基于内容识别自动生成场景相册
• 基于照片类型自动生成分类相册(屏幕截图、自拍照、视频、动态照片、RAW图片)
• 照片、影集的分享功能
• 支持动态照片的备份、展示（苹果的LivePhoto及安卓的Motion Photo）
• App备份手机相册（支持选择备份位置、文件夹生成规则、按拍摄日期重命名等）
• 管理照片的标签、备注、评分
• 多用户管理
• 基于文件MD5的重复文件检查及清理
• App支持在后台备份照片
• App、网页增加对HTTP基本认证(Basic Authorization)的支持
• App、网页支持中文、英文2种语言的选择
• 登录增加二步验证
• 图片文字识别
• 基于OpenAI CLIP模型的以文搜图
• 浏览器端执行人脸识别、场景识别任务
• 管理员整理人物相册
• 网页批量下载照片
• 批量修改图片的GPS信息
• 批量或单个修改拍摄日期
• App隐私锁
• 影集支持按人物、标签、文件夹创建及自动更新
• TV端App
• 那年今日功能
• 幻灯片播放功能
• 搜索增加更丰富的查询条件

什么样的照片会被识别为动态照片?

当一个文件夹下有同名的图片和视频时, 比如 IMG_001.HEIC 和 IMG_001.MOV ，会合并显示为动态照片

图片可以是JPG、HEIC、HEIF格式，视频可以是MP4、MOV格式

Docker容器启动后，无法访问页面

请查看容器的日志，确认容器内/config或者/upload是否有写入权限；

更多内容查看 常见错误及解决方法

无法访问授权服务器

请检查容器内是否能访问外网，一般是DNS解析错误导致的；

解决方法查看 DNS解析错误

App开启备份后，不备份照片

请检查开启备份时，是否选了【仅备份新照片】

App备份是如何判断文件已存在的

当照片备份设置中，重名文件 为 跳过 的情况下；

App在备份时，会检查服务端对应的文件夹下有没有同名且MD5值相同的文件；

如果存在，则会使用服务端已存在的文件，不上传这个文件；

App备份时，文件上传到服务端哪个文件夹 由这些设置决定：

• 1、备份目的地
• 2、目录风格
• 3、按拍摄日期重命名

比如： 备份目的地为 /upload/mt/iPhone 15； 目录风格 为默认； 按拍摄日期重命名为关闭状态；

假设：有一张2025-01-20号拍摄的照片，文件名为IMG_001.HEIC

那么这张照片会上传到 /upload/mt/iPhone 15/DCIM/2025/01/IMG_001.HEIC

App在备份时，服务端会检查有没有/upload/mt/iPhone 15/DCIM/2025/01/IMG_001.HEIC这个文件，如果存在，则根据文件大小和MD5值判断文件是否需要上传；

导入照片后，日期不对

请检查照片的exif信息中是否有拍摄日期 ( DateTimeOriginal 或者 MediaCreateDate)

(查看方法：MT Photos网页端，打开照片然后点击右上角信息按钮，在照片信息中有【查看文件EXIF信息】按钮)；

当照片exif信息中没有拍摄日期，会尝试识别文件名称中是否包含日期；

如果以上2个日期都没有，那么最后会尝试识别照片路径中的日期及照片的最后修改日期；

文件路径支持以下这些格式：

• 文件路径日期格式1：2021/01/09
  • /photos/2021/01/09/a.jpg
• 文件路径日期格式2：2009-02-14
  • /photos/2009-02-14/a.jpg

文件名称支持以下这些格式：

• 文件名称日期格式1：xxx_20220810_171108
  • /photos/upload/IMG_20220810_171108.jpg
  • /photos/upload/IMG_2022-08-10 171108.jpg
  • /photos/upload/IMG_2022_08_10 171108.jpg
  • /photos/upload/IMG_2022.08.10 171108.jpg
  • /photos/upload/IMG_2022.08.10 17.11.08.jpg
  • /photos/upload/IMG_2022-08-10 17-11-08.jpg
  • /photos/upload/IMG_2022_08_10_17_11_08.jpg
• 文件名称日期格式2：xxx_1611713414335
  • /photos/upload/mmexport1611713414335.jpg
  • /photos/upload/IMG_1655521800000.jpg

或者可以用NewFileTime这样的工具，批量修改照片的修改日期，然后点击【扫描图库】来更新照片的日期；

总结：照片的日期优先级为：exif信息中的拍摄日期 > 文件名中的日期 > 路径中的日期 > 文件最后修改日期

导入照片后，没有位置信息

查看照片Exif信息中是否有GPSLatitude、GPSLongitude这2项信息

在网页中打开照片的信息，然后点击查看EXIF信息

如果有这2项信息，在系统设置中配置了GPS信息识别，等待GPS识别任务处理完成即可显示位置

如果没有GPSLatitude、GPSLongitude或者这2项值为空，则需要检查原始照片是否有位置信息

手机相册内照片有位置，但是备份的照片没有位置信息

检查手机相册是否有安全分享、发送时抹除隐私信息、隐私保护之类的设置

比如：

MIUI 或 HyperOS 在手机相册的设置中，找到安全分享，然后关闭 默认抹除照片位置 和 默认抹除照片拍摄信息

ColorOS 在手机相册的设置中，找到发送时抹除隐私信息，然后关闭 抹除位置信息 和 抹除拍摄数据

从xmp文件中读取信息

MT Photos支持从相同文件夹下，与文件同名的xmp文件中读取备注、评分、拍摄日期、标签、地图位置这些Exif信息；

比如：

IMG_20241002_192802.jpg
IMG_20241002_192802.jpg.xmp
IMG_20241002_192816.mp4
IMG_20241002_192816.mp4.xmp
IMG_20241002_192910.HEIC
IMG_20241002_192910.HEIC.xmp
IMG_20241002_193005.MOV
IMG_20241002_193005.MOV.xmp

当在MT Photos内编辑文件的备注、评分、拍摄日期、标签、地图位置这些时，会将数据写入到同名的.xmp文件中；

xmp文件支持需要升级MT Photos版本至1.34.1或更高版本

如果需要关闭xmp文件识别和写入，可以在图库管理顶部的图库设置中关闭

如何备份MT Photos的数据、文件？

MT Photos需要备份的数据、文件包含以下几类：

• 1、数据库文件，文件位置：/config/pgsql （Windows服务端为 %AppData%\mt-photos-server\pgsql 文件夹）
• 2、生成的缩略图等缓存文件，文件位置：/config/cache （Windows服务端为选择的缓存文件夹）
• 3、手机App、网页端端上传的照片，文件位置：/upload （Windows服务端为选择的照片备份文件夹）
• 4、通过目录映射导入的照片，位置文件：自定义

注意： 这些路径都是指在容器内的路径，对于在宿主机中所在的路径，请结合各自docker容器的目录映射关系来查找。

1、备份数据库：

建议在 系统设置 -> 数据库备份 中开启自动备份；

另外也可以点击【生成数据库备份】，来生成数据库备份文件

如果点击生成数据库备份出错，可以参考这里的命令来创建备份文件： 从数据库导出到文件中

2、备份缓存文件：

/config/cache文件夹中的缩略图等文件，可以直接备份整个文件夹；

也可以选择不备份，当文件丢失后，可以通过系统维护工具中的【修复无法显示的缩略图】来重新生成缩略图。

3、备份上传的照片：

/upload文件夹，可以直接备份整个文件夹；

4、目录映射导入的照片：

备份照片所在的文件夹

MT Photos会收集隐私数据吗？

服务端不会收集任何个人信息，除了联网验证订阅状态，与官方服务器不会有别的请求；

当配置的GPS API之后，服务端会请求高德或mapbox的接口来识别GPS对应的城市信息；

App端集成了高德地图SDK（用于地图模式查看照片），SDK会收集位置信息、传感器信息、设备标识信息、设备参数及系统信息；

App详细隐私政策请查看隐私政策 ；

服务端支持断网使用吗？

默认的激活方式服务端一周至少需要联网验证一次，不支持完全离线使用；

如需要在局域网内离线运行，可以使用离线激活

需要联网验证的原因：

基于docker容器运行，无法基于硬件生成固定的唯一ID；

因此也无法避免一个订阅在多台机器上使用的情况；

所以需要定时联网来验证订阅状态；

如果联网验证服务器关了，功能是不是都不能用了？

1. 只要还有用户在使用，联网验证服务器是不会关了的
2. 如果联网验证服务器要关，肯定会提前把联网验证机制关闭
3. 已有的功能肯定是可以继续使用的，因为功能都是由你部署的服务端提供的

会不会收集照片数据？

服务端不会收集任何照片数据，这也是MT Photos 存在的核心价值；

大家也是不想照片被各种云服务分析数据，才会考虑自建照片服务；

如果有这方面的顾虑，可以针对服务端、App的网络请求进行抓包分析；

离线激活

服务端更新到1.32.0以上版本，支持使用离线激活的方式来绑定订阅；

使用离线激活的方式后，订阅将绑定机器，无法再更换别的机器使用；

问题反馈

如果在使用过程中遇到问题，请发送邮件至 support@mtmt.tech

或者在MT Photos的小店中点击【客服】，发送消息