五分钟了解Docker基础

开始使用前,我们先了解下Docker相关的一些知识,以便于了解后面出现的一些名词;

Docker的详细介绍可以查看:Docker — 从入门到实践

什么是 Docker

Docker基于Linux内核的cgroup、namespace以及OverlayFS类的UnionFS等技术,对进程进行封装隔离,属于操作系统层面的虚拟化技术。

您可以简单地把Docker 容器当作一个效率很高的虚拟机,容器内部与宿主机隔离; (当然它不是真的虚拟机)

因此它需要端口映射 (用来访问容器内的网络服务)目录映射 (用来存储文件)

什么是 镜像

Docker 镜像 是一个特殊的文件系统,除了提供容器运行时所需的程序、库、资源、配置等文件外,还包含了一些为运行时准备的一些配置参数(如匿名卷、环境变量、用户等)。

镜像不包含任何动态数据,其内容在构建之后也不会被改变。

根据不同的使用场景或平台,镜像会有不同的标签,比如: latestarm-latest

mtphotos/mt-photos:latest

mtphotos/mt-photos:arm-latest

mtphotos/mt-photos:nodb-latest

什么是 容器

容器是镜像运行时的实体,容器可以被创建、启动、停止、删除、暂停等。

容器内部存储的生存周期和容器一样,容器删除时,容器内的存储也会删除。因此,任何保存于容器内部存储的文件都会随容器删除而丢失

因此创建容器时需要使用数据卷(Volume)或者目录映射 来存储文件;

下面是一段使用docker run创建容器的命令: 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:8060
    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使用方法

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

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