五分钟了解Docker基础
开始使用前，我们先了解下Docker相关的一些知识，以便于了解后面出现的一些名词；
Docker的详细介绍可以查看：Docker — 从入门到实践
什么是 Docker
Docker基于Linux内核的cgroup、namespace以及OverlayFS类的UnionFS等技术，对进程进行封装隔离，属于操作系统层面的虚拟化技术。
您可以简单地把Docker 容器当作一个效率很高的虚拟机，容器内部与宿主机隔离； （当然它不是真的虚拟机）
因此它需要端口映射 （用来访问容器内的网络服务），目录映射 （用来存储文件）
什么是 镜像
Docker 镜像 是一个特殊的文件系统，除了提供容器运行时所需的程序、库、资源、配置等文件外，还包含了一些为运行时准备的一些配置参数（如匿名卷、环境变量、用户等）。
镜像不包含任何动态数据，其内容在构建之后也不会被改变。
根据不同的使用场景或平台，镜像会有不同的标签，比如:
latest，arm-latest
mtphotos/mt-photos:latest
mtphotos/mt-photos:arm-latest
mtphotos/mt-photos:nodb-latest
什么是 容器
容器是镜像运行时的实体，容器可以被创建、启动、停止、删除、暂停等。
容器内部存储的生存周期和容器一样，容器删除时，容器内的存储也会删除。因此，任何保存于容器内部存储的文件都会随容器删除而丢失。
因此创建容器时需要使用数据卷（Volume）或者目录映射 来存储文件；
下面是一段使用docker run创建容器的命令：
提示：某些系统中(比如Windows)，不支持 \ 换行，需要将 \ 删了，合并为一行输入
什么是 目录映射
通过目录映射，可以将宿主机的目录挂载到容器内指定的目录；
这样容器内的文件，比如数据库、缩略图、备份的照片等可以存到宿主机中的目录下；
在docker run 命令中， -v /xxx/mt_photos/config:/config 就是一个目录映射；
注意：目录的路径只能是绝对路径，即 / 开头
:左侧 （/xxx/mt_photos/config）为宿主机目录路径，在创建容器前需要提前创建好
:右侧 （/config）为容器内的目录，通常不需要修改
对于MT Photos容器，只有 /config 和 /upload 是必须映射的，别的目录可以先不添加；
重要提示： 宿主机的目录，不要重复映射到容器内
重要提示： 宿主机的目录，不要重复映射到容器内
重要提示： 宿主机的目录，不要重复映射到容器内
比如下面的错误示范
错误示范1：
-v /mnt/docker/mt_photos/config:/config
-v /mnt/photos/mt_photos:/upload
-v /mnt/photos/mt_photos:/photos
存在的问题： /mnt/photos/mt_photos 文件夹下的文件，在容器内都会被识别为2个文件
比如 /mnt/photos/mt_photos/1.jpg 在容器内会识别为2个文件 /upload/1.jpg 和 /photos/1.jpg
/upload不和别的目录共用
/upload目录下会自动创建 .MT_UPLOAD_FOLDER 文件，用来表示这个备份用的目录；
当另外的目录下有.MT_UPLOAD_FOLDER文件时，扫描图库会跳过这个目录，比如上方的/photos目录；
错误示范2：
-v /mnt/docker/mt_photos/config:/config
-v /mnt/photos/mt_photos:/upload
-v /mnt/photos:/photos
存在的问题： /mnt/photos/mt_photos 文件夹下的文件，在容器内都会被识别为2个文件
比如 /mnt/photos/mt_photos/1.jpg 在容器内会识别为2个文件 /upload/1.jpg 和 /photos/upload/1.jpg
正确示范：
-v /mnt/docker/mt_photos/config:/config
-v /mnt/mt_photos:/upload
-v /mnt/photos/:/photos
什么是 端口映射
由于容器内部的网络和外部是隔离的，当外部需要访问容器内的服务时，就需要添加端口映射；
在docker run 命令中， -p 8163:8063 就是一个端口映射；
:左侧 8163为宿主机端口号，是外部用来访问的端口，比如 http://192.168.1.8:8163
:右侧 8063为容器内的端口号，通常不能修改，因为容器内服务绑定端口是固定的
这里的8163只是为了举例，实际使用中，一般2边会使用一样的端口号
-p 8063:8063如果遇到宿主机的8063端口已经被占用了，那么就需要调整宿主机端口号；
但是容器内的端口号不能修改，因为容器内服务只会使用默认固定的端口号；
什么是 环境变量
环境变量是容器内程序运行时，会读取的某些配置项；通过环境变量可以自定义容器内的某些功能；
在docker run 命令中， -e TZ="Asia/Shanghai" 就是一个环境变量；
TZ 就是环境变量的名称，TZ用来指定时区
"Asia/Shanghai" 就是环境变量的值，也就是时区的值
yaml模板
version: "3"
services:
mtphotos:
image: registry.cn-hangzhou.aliyuncs.com/mtphotos/mt-photos:latest
container_name: mtphotos
restart: always
ports:
- 8063:8063
volumes:
- /volume1/docker/mt_photos/config:/config
- /volume1/photos/mt_photos_upload:/upload
- /volume1/xxx/其他需要映射的目录:/photos
environment:
- TZ=Asia/Shanghai
- LANG=C.UTF-8
dns:
- 114.114.114.114
depends_on:
- mtphotos_ai
- mtphotos_face_api
mtphotos_ai:
image: registry.cn-hangzhou.aliyuncs.com/mtphotos/mt-photos-ai:onnx-latest
container_name: mtphotos_ai
restart: always
ports:
- 8060:8000
environment:
- API_AUTH_KEY=mt_photos_ai_extra
mtphotos_face_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
yaml语法三大规则
规则一：缩进
yaml使用一个固定的缩进风格表示数据层结构关系，需要每个缩进级别由两个空格组成，一定不能使用tab键
规则二：冒号
services: image: mtphotos/mt-photos:latest每个冒号后面一定要有一个空格（以冒号结尾不需要空格）
规则三：短横线
想要表示列表项，使用一个短横杠加一个空格。多个项使用同样的缩进级别作为同一个列表的一部分
environment: - TZ=Asia/Shanghai - LANG=C.UTF-8 - PUID=1000 - PGID=100
安装
如果您的NAS系统在以下列表中，可以点击下方链接查看单独的安装方法
Windows版本服务端的安装方法请查看: Windows服务端的安装方法
使用Portainer安装的方法请查看: Portainer使用方法
