本文基于 mtphotos/mt-photos:latest 镜像，群晖DS920plus实测（访问端口8063）

手机相册、Synology Photos、硬盘散落文件夹……照片越攒越乱，翻一张要翻半天？MT Photos是面向 NAS 用户的照片管理系统——支持导入已有照片/视频、App 备份手机相册、人脸识别与地图浏览，适合在自有 NAS 上私有化部署。

本文带你用Docker 单容器在群晖上跑通 MT Photos：轩辕镜像加速拉取、docker run一键启动、挂载已有Photos目录，再跟做Web 安装向导——全程 DS920plus 实测，附11 张截图与完整命令；文末 FAQ 收录群晖权限踩坑修复。

一、MT Photos 是什么？

MT Photos是一款为NAS 用户准备的照片管理系统，基于 Docker 运行，主要用于帮助用户高效存储、整理和管理各类照片资源。

典型使用场景：群晖 / 威联通等 NAS集中管理散落照片；替代或补充 Synology Photos；家庭私有化相册不经过第三方云。

部署要点：单容器即可跑通基础功能；内置PostgreSQL数据库，数据写在/config/pgsql，群晖上启动时需设置PUID/PGID（见第五节）。若遇权限报错，见第十节 FAQ。OCR / 人脸识别等 AI 功能需额外部署配套容器，不在本文范围。

架构示意：

浏览器 ──HTTP:8063──▶ MT Photos 容器 宿主机 /volume1/docker/mt_photos/config ──▶ /config（数据库、缩略图缓存） 宿主机 /volume1/docker/mt_photos/upload ──▶ /upload（App 备份） 宿主机 /volume1/homes/你的用户名/Photos ──▶ /photos（已有照片，可选）

二、环境要求

验证 Docker（SSH 终端）：

docker--version

群晖 NAS 镜像加速配置见 群晖 NAS Docker 镜像源配置教程。

三、拉取镜像

SSH 登录群晖（或直接在终端操作），拉取 MT Photos 镜像：

dockerpull docker.xuanyuan.run/mtphotos/mt-photos:latest

成功时终端类似输出：

latest: Pulling from mtphotos/mt-photos ... Status: Downloaded newer image for docker.xuanyuan.run/mtphotos/mt-photos:latest

四、创建数据目录

MT Photos 要求持久化两个必挂目录，删除容器后数据不丢失：

mkdir-p/volume1/docker/mt_photos/configmkdir-p/volume1/docker/mt_photos/upload

4.1 确认已有照片路径

可将群晖你的用户名对应个人 Photos 目录映射进容器。部署前先确认目录存在（将你的用户名替换为 DSM 中的实际用户名）：

ls/volume1/homes/你的用户名/Photos/

路径说明：

• /volume1/photo— 群晖共享文件夹路径（只有建了名为photo的共享目录时才有）
• /volume1/homes/你的用户名/Photos/— DSM 为该用户创建的个人照片目录（Synology Photos / 手机备份常用位置）

Web 初始化添加图库时填容器内路径/photos。

五、启动容器（docker run）

群晖上建议启动前设置目录属主，并为容器指定PUID/PGID，避免内置 PostgreSQL 在/config/pgsql初始化时遇到权限问题。

5.1 获取 NAS 用户 uid/gid

id你的用户名

示例输出（数值因用户而异）：

uid=1026(你的用户名) gid=100(users) groups=100(users),101(administrators)

记下uid与gid，下文PUID/PGID及chown均以此为准。

5.2 修正目录属主

chown-R你的用户名:users /volume1/docker/mt_photos/configchown-R你的用户名:users /volume1/docker/mt_photos/upload

5.3 启动容器

dockerrun-d\--namemt-photos\--restartunless-stopped\-p8063:8063\-v/volume1/docker/mt_photos/config:/config\-v/volume1/docker/mt_photos/upload:/upload\-v/volume1/homes/你的用户名/Photos:/photos\-eTZ=Asia/Shanghai\-ePUID=1026\-ePGID=100\docker.xuanyuan.run/mtphotos/mt-photos:latest

各参数说明：

注意：PUID/PGID不能为 0（不能是 root）。上例1026/100仅为示例，请替换为id 你的用户名的实际输出。

5.4 验证启动成功

dockerlogs mt-photos--tail30

DS920plus 实测日志：

===== initDb ===== waiting for server to start.... done server started 2026-07-08T12:55:13: PM2 log: Launching in no daemon mode 2026-07-08T12:55:13: PM2 log: App [launcher:0] starting in -fork mode- 2026-07-08T12:55:13: PM2 log: App [launcher:0] online [MT Photos] : Server started, http port:8063 ___ ________ ______ _ _ | \/ |_ _| | ___ \ | | | | . . | | | | |_/ / |__ ___ | |_ ___ ___ | |\/| | | | | __/| '_ \ / _ \| __/ _ \/ __| | | | | | | | | | | | | (_) | || (_) \__ \ \_| |_/ \_/ \_| |_| |_|\___/ \__\___/|___/ CREATE INDEX idx_file_clip_vec start CREATE INDEX idx_file_clip_vec success CREATE INDEX IDX_people_descriptor_v2_vec start CREATE INDEX idx_people_descriptor_v2_vec success

关键判据：

• 出现Server started, http port:8063— 服务已就绪
• 不再出现Permission denied或服务端启动异常

在Container Manager → 容器中也能看到mt-photos状态为绿色运行中：

六、Web 安装向导

浏览器打开：

http://你的群晖IP:8063

6.1 选择语言

安装向导首页，选择简体中文，点击下一步。

6.2 创建管理员账户

填写管理员用户名与密码。管理员账号用于管理 MT Photos 的所有资源和用户，请妥善保管。

6.3 设置图库

点击添加图库，在弹出的文件夹选择器中选择容器内路径/photos（对应宿主机/volume1/homes/你的用户名/Photos）。

为图库命名（实测创建「太湖」图库），确认后可在列表中看到已添加的图库卡片，点击完成结束向导。

七、登录与主界面

向导完成后进入登录页，使用刚创建的管理员账号登录。

登录后进入照片主界面。系统会按日期分组展示图库中的照片，首次加载时缩略图可能显示为加载中，等待后台索引完成即可。

点击任意照片可进入大图预览，支持旋转、分享、收藏、查看元数据等操作。

八、图库扫描与管理

进入左侧管理 → 图库管理，可查看已添加的图库、触发扫描。实测「太湖」图库显示「更新上传文件信息中」，表示正在索引/photos下的照片。

管理工具页面提供重复文件检查、文件夹整理、人脸识别整理、系统维护任务等高级功能。

索引完成后，探索页面会按人物、地点、场景等维度聚合照片（需照片含 GPS / 人脸等元数据，或部署 AI 配套容器）。

九、Container Manager 图形界面部署（可选）

若偏好 DSM 可视化管理，可用Container Manager → 项目创建 Compose 项目。路径建议：/volume1/docker/mt-photos-project。

docker-compose.yml：

version:"3"services:mtphotos:image:docker.xuanyuan.run/mtphotos/mt-photos:latestcontainer_name:mt-photosrestart:unless-stoppedports:-"8063:8063"volumes:-/volume1/docker/mt_photos/config:/config-/volume1/docker/mt_photos/upload:/upload# 群晖用户个人 Photos 目录（将 你的用户名 替换为实际用户名，部署前 ls 确认）-/volume1/homes/你的用户名/Photos:/photosenvironment:-TZ=Asia/Shanghai-PUID=1026-PGID=100

注意：若已用docker run创建同名容器，需先docker stop mt-photos && docker rm mt-photos，避免 8063 端口与容器名冲突。PUID/PGID请替换为你 NAS 用户的实际值。

十、常见问题 FAQ

Q1：首次启动报Permission denied/config/pgsql/data怎么办？（群晖高发）

若未按第五节设置PUID/PGID，或config目录属主不对，日志可能出现：

===== initDb ===== execFile stderr: sh /usr/src/app/initDb.sh initdb: error: could not access directory "/config/pgsql/data": Permission denied pg_ctl: could not access directory "/config/pgsql/data": Permission denied ... Debug: id postgres uid=103(postgres) gid=105(postgres) groups=105(postgres),103(ssl-cert) ... =========== 服务端启动异常 ============= 修复方法： https://mtmt.tech/docs/advanced/ifix

原因：MT Photos 内置 PostgreSQL 要求/config/pgsql目录属主为容器内postgres（uid=103, gid=105），权限为700。群晖宿主机/volume1/docker/mt_photos/config默认属root，容器无法在映射目录内初始化数据库。

修复步骤：

# 1. 停止并删除失败容器dockerstop mt-photos&&dockerrmmt-photos# 2. 查看 NAS 用户 uid/gidid你的用户名# 3. 清理不完整的数据库目录rm-rf/volume1/docker/mt_photos/config/pgsql# 4. 修正 config 目录属主chown-R你的用户名:users /volume1/docker/mt_photos/config# 5. 带 PUID/PGID 重建容器（uid/gid 替换为 id 命令输出）dockerrun-d\--namemt-photos\--restartunless-stopped\-p8063:8063\-v/volume1/docker/mt_photos/config:/config\-v/volume1/docker/mt_photos/upload:/upload\-v/volume1/homes/你的用户名/Photos:/photos\-eTZ=Asia/Shanghai\-ePUID=1026\-ePGID=100\docker.xuanyuan.run/mtphotos/mt-photos:latest# 6. 验证（应出现 Server started, http port:8063）dockerlogs mt-photos--tail30

若仍失败，在File Station中右键/volume1/docker/mt_photos/config→ 属性 → 权限，确认 NAS 用户有完全控制，且Everyone 有读取。不要用 SMB/NFS 远程挂载目录作为/config。官方文档：常见错误及解决方法。

Q2：8063端口被占用怎么办？

改端口映射，例如-p 18063:8063，浏览器访问http://群晖IP:18063。

Q3：图库里看不到已有照片？

1. 确认docker run时已挂载照片目录（如-v /volume1/homes/你的用户名/Photos:/photos）
2. Web 初始化添加图库时选择容器内路径/photos，不是宿主机路径
3. 进入图库管理 → 扫描所有图库触发索引

Q4：PUID/PGID 填什么？

SSH 执行id 你的用户名，将输出的uid填PUID、gid填PGID（例如1026/100，以实际输出为准）。第五节启动时已应配置。

Q5：需要人脸识别 / OCR 怎么办？

基础单容器不含 AI 服务。按 群晖 7.2+ 官方 Compose 示例 追加mt-photos-ai（端口 8060）和人脸识别 API 容器（端口 8066）。建议先跑通单容器再扩展。

Q6：CloudSync 无法感知容器内文件变化？

群晖不会监听 Docker 容器内对文件的改动。若需触发 CloudSync 同步，官方建议通过 CIFS 挂载 SMB 共享路径，详见 群晖安装方法。

Q7：如何停止与卸载？

# 停止并删除容器（保留 config / upload / 照片数据）dockerstop mt-photos&&dockerrmmt-photos# 删除全部数据（慎用）rm-rf/volume1/docker/mt_photos

十一、命令速查

十二、延伸阅读

总结：MT Photos =NAS 私有化照片管理，单容器即可跑通。群晖部署要点：拉镜像 → 建目录 → 设 PUID/PGID → docker run → 浏览器完成安装向导 → 挂载/photos导入已有图库。若遇Permission denied，见第十节 FAQ。长期运行注意备份/volume1/docker/mt_photos/config，按需扩展 AI 配套容器。