已以下实例为例:
version: '3.8'
services:
npm:
image: 'jc21/nginx-proxy-manager:latest'
restart: unless-stopped
environment:
PIP_INDEX_URL: https://mirrors.aliyun.com/pypi/simple/
PUID: 1000
PGID: 1000
ports:
- '9080:80'
- '9081:81'
- '9443:443'
volumes:
- /share/Container/nginx/data:/data
- /share/Container/nginx/letsencrypt:/etc/letsencrypt
1.restart 参数:
always
:表示容器总是运行,无论其是否正常退出或异常终止,都会自动重启。例如:
services:
webapp:
restart: always
on-failure[:max-retries]
:表示在容器非正常退出(即退出码不为 0)时重启容器。可选项max-retries
用于指定最大重试次数,默认为无限次。例如
services:
myservice:
restart: on-failure:5
上述配置表示容器在非正常退出时最多重启 5 次。
unless-stopped
:表示除非容器被手动停止(如使用docker-compose stop
命令),否则在其他情况下(如 Docker 守护进程重启或容器异常退出)都会自动重启容器。例如:
services:
webapp:
restart: unless-stopped
这些重启策略可以根据具体的需求进行设置,以确保容器在出现异常情况时能够自动恢复运行,或者在特定条件下进行重启。
2.ports 端口:
"宿主机端口:容器端口"
:将容器的端口映射到宿主机的指定端口。例如,"8080:80"
表示将容器的 80 端口映射到主机的 8080 端口上,这样你可以通过访问主机的 8080 端口来访问容器内运行在 80 端口的服务。"容器端口"
:只指定容器端口时,Docker 会在主机上自动分配一个未被占用的端口来映射容器端口。"端口范围:容器端口"
或"宿主机端口范围:容器端口"
:用于指定端口范围的映射。例如,"3000-3005:80"
表示将容器的 80 端口映射到主机的 3000 到 3005 范围内的端口。"宿主机 IP:宿主机端口:容器端口"
:可以绑定到特定的主机 IP 地址。例如,"127.0.0.1:8001:8001"
表示将容器的 8001 端口映射到主机的 127.0.0.1 这个 IP 地址的 8001 端口上。"端口:端口/协议"
:可以限制为指定的协议,如"6060:6060/udp"
表示将容器的 6060 端口(UDP 协议)映射到主机的 6060 端口。
services:
my_service:
image: my_image
ports:
- "8080:80"
- "9090-9091:8080-8081"
- "127.0.0.1:5000-5010:5000-5010"
- "6060:6060/udp"
疑点:通常情况部署docker时默认都会有固定的容器端口,但主机端口可以自己设置,只要不会和nas上的其他服务端口冲突随便设置都行(端口范围内)
3.volumes 卷:
在 Docker Compose 中,volumes
参数用于配置数据卷挂载。通过volumes
参数,可以将容器内的路径与主机上的目录或卷进行映射,实现数据的持久化和共享。
volumes
参数的值可以是一个或多个字符串,每个字符串表示一个数据卷的映射关系。其常见的格式如下:
volumes:
- <主机路径>:<容器内路径>
- <数据卷名称>:<容器内路径>
以下是对两种常见格式的解释:
<主机路径>:<容器内路径>
:直接使用宿主机的路径进行映射。例如,volumes: -./data:/app/data
表示将主机上的./data
目录挂载到容器的/app/data
路径上,容器内的应用就可以读写主机上./data
目录中的数据。这种方式比较直观,但需要管理好主机上的路径。<数据卷名称>:<容器内路径>
:使用数据卷名称进行映射。数据卷是由 Docker 管理的特殊卷,它的具体存储位置由 Docker 自动处理,用户不需要关心数据实际存储在主机的何处。例如,volumes: - my_volume:/app/data
,其中my_volume
是数据卷的名称。这种方式相对简洁,无需关心数据在主机上的具体位置。
要查看 Docker 的数据卷具体对应的真实地址,可以使用docker volume inspect <数据卷名称>
命令。
在 Docker Compose 中定义了数据卷后,当启动相关服务时,Docker 会自动创建或使用指定的数据卷,并进行目录的挂载映射。这样,即使容器被删除或重新创建,数据仍然可以保留在数据卷中,实现了数据的持久化存储。同时,多个容器也可以通过挂载相同的数据卷来共享数据。
例如,以下是一个 Docker Compose 文件的片段,展示了如何使用volumes
参数:
services:
my_service:
image: my_image
volumes:
- /host/path:/container/path
- data_volume:/another/container/path
在上述示例中,/host/path
是主机上的实际路径,它将被挂载到容器内的/container/path
路径;data_volume
是一个数据卷的名称,它将被挂载到容器内的/another/container/path
路径。这样,容器内的应用就可以通过/container/path
和/another/container/path
来访问主机目录或数据卷中的数据了。
疑点:
容器路径一般都是该docker预设或固定的
但主机路径则需要自己映射一下,但往往自己填写后下载或浏览会发现找不到文件,甚至会造成NAS ramdisk空间不足从而影响使用
这是因为qnap nas网页显示的共享文件夹,实际ssh命令里的绝对路路径为:
/share/CACHEDEV1_DATA/shared folder
因此我们在设置docker的路径时不能写成:/shared folders/subfolders,且有多个卷的话他的CACHEDEV1~X_DATA又各不相同,需要进ssh里面查看比较麻烦
有一个更简单的路径就直接写成:
/share/shared folders/subfolders
它对应的就是/share/CACHEDEV1_DATA/shared folders/subfolders,我们也不用去管它是CACHEDEV几_DATA
挂载共享文件夹后,才能正确保存docker的配置,以及可以找到下载的内容或docker能够访问到挂载的文件。
理解了这些参数,基本在qnap nas里创建大部分docker都能够信手拈来。
制作不易,感谢鼓励!