绿联UGOS Pro中的安装方法

前置知识:关于Docker的一些重要概念

如果没有安装Docker,请先打开【应用中心】安装 Docker

1、创建文件夹

由于容器内无法保存文件,因此需要为容器添加目录映射来保存文件;

下面,我们先创建2个需要映射给容器的文件夹;

1.1、创建 /config 文件夹

打开【文件管理】,在 共享文件夹/docker 下创建 mt_photos文件夹 ;

mt_photos文件夹用来存储数据库和缩略图的文件;

这个文件夹会映射给容器的/config目录,路径可以点击复制按钮

注意:目录的拥有者应该为当前登录的管理员

创建应用程序

1.2、创建 /upload 文件夹

在另外的文件夹(比如 共享文件夹/photos)下创建 mt_photos_upload 文件夹;

mt_photos_upload文件夹用来保存App备份的照片;

这个文件夹会映射给容器的/upload目录

创建文件夹

2、创建应用程序

打开【Docker】,在项目中点击【创建】

创建文件夹

应用程序名称,填写 mt_photos

YAML模板

version: "3"

services:
  mtphotos:
    image: registry.cn-hangzhou.aliyuncs.com/mtphotos/mt-photos:latest
    container_name: mt-photos
    restart: always
    ports:
      - 8063:8063
    volumes:
      - /volume1/docker/mt_photos:/config
      - /volume1/photos/mt_photos_upload:/upload
      - /volume1/photos/family_photo:/family_photo #提示:这一行是其他需要映射给容器的文件夹,如果没有可以删除这一行; 如果还有其他目录要映射,可以再加一行;
    environment:
      - TZ=Asia/Shanghai
      - PUID=1000 #根据界面提示的 PUID=1000 PGID=10 填写
      - PGID=10

查看PUID、PGID的值

创建应用程序

如何填写volumes中的路径

比如下面的 /volume1/docker/mt_photos 这个路径是如何获取到的

    volumes:
      - /volume1/docker/mt_photos:/config

在【文件管理】中,右键文件夹来打开属性,然后在位置右侧点击【复制链接】按钮

创建应用程序

yaml语法三大规则

重要提示: 宿主机的目录,不要重复映射到容器内

重要提示: 宿主机的目录,不要重复映射到容器内

重要提示: 宿主机的目录,不要重复映射到容器内 点击查看

填写完成后,点击【立即部署】;

立即部署

等待拉取镜像, 当显示 Container mt-photos Created 后,点击完成

完成

3、访问MT Photos

等待容器启动成功后,使用浏览器打开地址:http://192.168.1.107:8063/ 访问安装向导,开始初始化配置。

192.168.1.107为NAS的IP,8063为映射的端口号,请根据实际情况替换

添加智能识别+人脸识别API

如果需要和智能识别+人脸识别API一起部署,可以使用下面的模板文件

查看什么是智能识别API?

version: "3"

services:
  mtphotos:
    image: registry.cn-hangzhou.aliyuncs.com/mtphotos/mt-photos:latest
    container_name: mt-photos
    restart: always
    ports:
      - 8063:8063
    volumes:
      - /volume1/docker/mt_photos:/config
      - /volume1/photos/mt_photos_upload:/upload
      - /volume1/photos/family_photo:/family_photo #提示:这一行是其他需要映射给容器的文件夹,如果没有可以删除这一行
    environment:
      - TZ=Asia/Shanghai
      - PUID=1000
      - PGID=10
      - LANG=C.UTF-8
    dns:
      - 114.114.114.114
    depends_on:
      - mtphotos_ai
      - mtphotos_face_api
  mtphotos_ai: # 智能识别api
    image: registry.cn-hangzhou.aliyuncs.com/mtphotos/mt-photos-ai:onnx-latest
    container_name: mtphotos_ai
    restart: always
    ports:
      - 8060:8060
    environment:
      - API_AUTH_KEY=mt_photos_ai_extra
  mtphotos_face_api: # 人脸识别api
    image: crpi-gcuyquw9co62xzjn.cn-guangzhou.personal.cr.aliyuncs.com/devfox101/mt-photos-insightface-unofficial:latest
    container_name: mtphotos_face_api
    restart: always
    ports:
      - 8066:8066
    environment:
      - API_AUTH_KEY=mt_photos_ai_extra

提示: 如果使用上面的模板部署 智能识别+人脸识别API

在MT Photos后台添加智能识别API时, 接口地址可以填写 http://mtphotos_ai:8060

在MT Photos后台添加人脸识别API时, 接口地址可以填写 http://mtphotos_face_api:8066

api_key 填写 mt_photos_ai_extra (这是默认值,如果上一步有修改过,用修改过的值)

Copyright © 2025 杭州相册家科技有限公司 All Rights Reserved

隐私协议软件许可及服务协议

浙公网安备 33019202000625号浙ICP备2022014580号