docker部署minio对象存储并用rclone同步

本文首发于 ❄️慕雪的寒舍

1.什么是minio？

minio是一个开源的对象存储服务器，兼容S3协议。

官网：https://min.io/

官方在开源的基础上也提供云端S3服务，分为个人和企业，有不同的收费标准。

1.1 自建对象存储的好处？

当然，本文写下来肯定不是让你去买它的对象存储服务的，而是在我们自己的服务器/Nas上部署一个minio的docker，来拥有一个我们自己的对象存储服务器！

对象存储服务器可以用来做图床、静态资源缓存，亦或者是直接当作一个网盘来使用。

自建的对象存储的好处是所有源文件我们都能亲手管理，且无需为付费的对象存储的奇怪的计价文档感到手足无措，也不需要担心有人恶意刷流把你一套房子给套走。

缺点就是，自建的稳定性肯定不如已有厂家提供的服务，且自购的服务器/Nas上传带宽一般都很低，文件一多，访问速度就很慢了。

对于我个人而言，自建minio的唯一作用，就是备份七牛云/阿里云对象存储中的文件。考虑到2023下半年，各大厂接连boom云服务，国外的谷歌还出现了云盘里面用户的数据回滚到几月前的恶性问题，这可是可能导致用户数据丢失的大问题啊！

• 谷歌公布方案，修复 Drive 云盘文件丢失问题
• 谷歌承认云端硬盘Google Drive存在BUG，3月内用户文件可能丢失

所以，将数据在自己本地留一份总是安心一些。数据安全靠的是备份，不是云服务厂家给你提供的99.99999%可用性的一面之词。

如果你对数据备份这个话题感兴趣，可以看看我的另外一篇博客：谈谈如何进行有效数据备份，3+2+1

温馨提醒：如果你想在云服务器上安装minio来备份已有S3中的文件的话，最好是使用一个和已有S3不在同一个地域、非同一个服务商的云服务器，避免某些服务商云服务器和对象存储一起boom的情况……

2.docker安装minio

2.1 安装docker

docker安装的教程详见我的另外一篇博客

【Docker】deepin/centos安装docker | 慕雪的寒舍

2.2 安装minio

这里推荐使用由VMware维护的minio docker版本bitnami/minio，更新很频繁。

hub.docker.com/r/bitnami/minio

创建容器的命令如下，非常简单

docker run -it -d --name minio \
	-p 9000:9000 \
	-p 9001:9001 \
	--restart=always \
	-v /minio/data:/bitnami/minio/data \
	-e MINIO_ROOT_USER="minio_root" \
	-e MINIO_ROOT_PASSWORD="minio_123456" \
	-e TZ='Asia/Shanghai' \
	bitnami/minio:latest

该创建容器操作基于如下hash的docker镜像（更新于2023-12-12），创建容器的命令后续可能会有变动，请参考docker-hub中的官方文档

bitnami/minio  latest    552af9bd3d6d   2 days ago     212MB

对这个docker命令进行解释

• -it -d，it提供交互能力，d代表后台运行
• --restart=always，始终重启docker（docker服务重启后，镜像会自动启动）
• -p 9000:9000，将docker内的9000端口（右侧）映射给宿主机（左侧）的9000端口，端口9001的映射同理。
  • 容器内9000端口是minio的api端口（用于S3协议操作）
  • 容器内9001端口是minio的web管理界面端口
  • 根据你的需要，修改冒号左侧的宿主机端口即可。
• -v /minio/data:/bitnami/minio/data，将docker内/bitnami/minio/data路径映射给主机/minio/data路径，主机上的路径（左侧）请自行修改；这个路径是bucket和minio配置文件的存储路径。
• 两个-e设置的是环境变量，分别设置的是minio管理员的账户和管理员的密码。请注意，在这里配置了管理员用户名和密码后，进入minio管理系统的密码无法被修改。如果你的minio服务需要暴露在公网上，请一定要设置一个高强度的密码！
• -e TZ='Asia/Shanghai' 设置时区为东八区（后续定时备份需要有正确时区）
• 最后的bitnami/minio:latest代表我们需要创建bitnami/minio这个docker镜像的latest版本，如果本地没有这个镜像，则会自动去docker-hub拉取。
• 如果你卡在了pull镜像的步骤，请自行百度如何替换docker的镜像源。

如下是我在一个没有安装过minio的云服务上测试的结果，成功安装并启动minio

[root:~/docker]# docker run -it -d --name minio \
> -p 19000:9000 \
> -p 19001:9001 \
> --restart=always \
> -v /root/docker/minio:/bitnami/minio/data \
> -e MINIO_ROOT_USER="minio_root" \
> -e MINIO_ROOT_PASSWORD="minio_123456" \
> bitnami/minio:latest
Unable to find image 'bitnami/minio:latest' locally
latest: Pulling from bitnami/minio
ef5975039511: Pull complete 
Digest: sha256:3bb81d101dea57a5382a2d01eda6991e75ce69669d2d49c4646d82721b7c258e
Status: Downloaded newer image for bitnami/minio:latest
afefbb9514de0f4a1c02b7f4212b1e05eee5ef342ed4ce27e03de10071914060

容器正常启动，处于Running状态，STATUS正常！

CONTAINER ID   IMAGE                                  COMMAND                  CREATED         STATUS         PORTS                                                                                      NAMES
afefbb9514de   bitnami/minio:latest                   "/opt/bitnami/script…"   3 minutes ago   Up 3 minutes   0.0.0.0:19000->9000/tcp, :::19000->9000/tcp, 0.0.0.0:19001->9001/tcp, :::19001->9001/tcp   minio

这样还不够，请在后续创建了bucket并上传测试文件后，查看本地映射的路径中是否有对应文件夹和文件，避免路径映射失败！（如果路径没有成功映射到本地，那么你当前创建的minio被删除之后，文件就很难找回来了）

顺带一提，在我这边测试发现，如果你错误使用浏览器访问了9000这个api端口，会被自动重定向到9001 web管理页面端口（前提是映射的宿主机端口和docker内端口一致）

2.3 web管理

使用 http://IP:端口 打开minio的9001端口对应的宿主机端口，访问minio的web管理页面。输入刚刚创建容器时，在环境变量里面配置的用户名和密码进行登录，即可进入控制台。

minio的界面比较简单，基本要做的操作只有两个，创建bucket存储桶，和accesskey用于api调用。

更高阶的配置项和操作我没有尝试过，请自行参考minio的文档或者其他教程。

2.3.1 创建bucket

第一个界面就是大大的Object Browser，在这里我们可以创建存储桶

点击创建bucket，会进入如下配置项，除了bucket的名字，还有三个选项

• Versioning：版本控制，开启后，该bucket将处于多版本模式下，文件会保留修改的历史记录。
• Object Locking：避免文件被删除，需要支持保留和合法保留（这两个啥意思我不明白），该选项只能在bucket创建时打开。
• Quota：限制容器中文件大小（总容量）

对于我的备份需求来说，这三个额外选项都不需要，直接创建就行了

创建之后，在bucket页面可以看到刚刚创建的test存储桶，这里会统计存储容量和文件数量

2.3.2 创建accessKey

accessKey是用于操作api的token凭证。创建完毕后，他只会显示一次，后续将不会显示出来。

如果你不想创建太多个密钥，那就把这个密钥的文件下载下来，免得到时候不知道是什么了。点击右下角的import文件就可以下载，会下载一个json文件，内部包含密钥和其他一些相关信息

因为我这只是做个测试，一会就会把这个minio的docker删除，所以展示密钥无所谓。如果你是在生产环境下使用，请一定不要暴露你的密钥给任何人。

{
    "url": "http://公网IP:19001/api/v1/service-account-credentials",
    "accessKey": "aXpBxrUceV30Id6gOouG",
    "secretKey": "dIWl9IFL05UtaI08PZfPXE66zPGu2zWrGFfSTaUm",
    "api": "s3v4",
    "path": "auto"
}

密钥创建完毕，就能在列表看到它。

3.rclone备份

rclone是一个全平台的命令行工具，其可以用于多种云端/本地存储之间的数据拷贝、同步、加密同步等功能。详见rclone官网：rclone.org

因为我的目标就是我的七牛云bucket里面的图床文件备份到本地，rclone绝对是不二之选。

3.1 进入docker容器内终端

你可以选择在宿主机上安装rclone，也可以选择直接在minio的容器内安装rclone。

前排提醒：部分nas品牌的系统（比如群晖）已经提供了执行定时脚本的功能，这种情况下直接使用系统提供的定时任务来执行rclone sync即可，即直接在nas里面安装rclone和使用定时任务，不要在minio的docker里面安装rclone。

如你选择了在宿主机上安装rclone，则可以直接跳过本3.1步骤，阅读3.2及后续步骤

docker特权模式

注意，如果在minio的容器内安装rclone，那么minio容器被删除后，rclone和它的配置文件自然也不在了。

且如果需要用minio的容器进行crontab定时任务，则必须用特权模式安装minio的docker，在minio的docker创建命令里面加如下这条，设置特权模式（不需要定时任务可以不设置）。

--privileged

在绿联nas的docker管理界面，创建docker的时候给定所有权限，也是一样的效果。（因为我不太了解这里具体每个权限的作用，干脆全给了）

ssh连接宿主设备

不同nas机型进入ssh的方式不太一样，请参考你的nas或设备品牌搜索对应类型教程。

连接到宿主设备的ssh后，参考：以指定用户启动和进入docker容器 - langyong - 博客园 一文，使用如下docker命令进入minio的容器终端中。

docker exec -it -u 用户名 容器名 /bin/bash
# 示例如下
docker exec -it -u root minio /bin/bash

如果你使用的是绿联、极空间这类不太方便进入ssh的nas，可以在nas的docker管理页里面操作，如下图所示，选择/bin/bash后点击链接即可进入容器内终端。

3.2 下载安装rclone

进入终端后，默认所在路径是docker容器的工作路径/opt/bitnami/minio-client。

为了避免影响容器运行，我们不要在工作路径里面做操作，请使用如下命令，创建一个新的rclone文件夹，进入root用户的家目录进行操作。

如果你是在宿主机上操作，也是一样的道理，为rclone单独创建一个文件夹，来存放它的软件包、配置文件、执行日志。

mkdir /root/rclone
cd /root/rclone

如果是docker内操作，你可以在创建minio容器的时候，就把/root/rclone路径给映射到宿主机上，方便后续查看rclone备份的日志。

下载安装rclone的命令如下

curl -O https://downloads.rclone.org/rclone-current-linux-amd64.zip
unzip rclone-current-linux-amd64.zip
cd rclone-*-linux-amd64
 
sudo cp rclone /usr/bin/
sudo chown root:root /usr/bin/rclone
sudo chmod 755 /usr/bin/rclone

minio的docker内没有unzip命令，需要安装一下

apt-get update && apt-get install -y unzip

minio的docker内也没有sudo，将上述安装命令中的sudo去掉就可以了。

完成安装命令后，执行一下rclone，出现rclone命令的使用提示，那就是安装成功了！

root@878a0dd03ec4:/root/rclone/rclone-v1.65.0-linux-amd64# rclone
Usage:
  rclone [flags]
  rclone [command]
  ...

3.3 rclone对象存储配置

rclone的官网上有不同云端存储协议和不同S3服务商的配置教程，跟着官方的来就可以了。

执行rclone config命令，工具会自动在/.config/rclone/rclone.conf下创建一个config文件，你可以根据官方的向导，在此处添加新的remote;

root@878a0dd03ec4:/root/rclone/rclone-v1.65.0-linux-amd64# rclone config
2023/12/14 04:38:44 NOTICE: Config file "/.config/rclone/rclone.conf" not found - using defaults
No remotes found, make a new one?
n) New remote
s) Set configuration password
q) Quit config
n/s/q> q

下面给出minio和七牛云的配置文件，你可以直接修改这个配置文件中的内容为你的配置，然后写入/.config/rclone/rclone.conf即可。

• rclone.org/s3/#minio
• rclone.org/s3/#qiniu

其中minio的region在minio的控制台里面可以修改，如果你没有修改过，默认使用的是us-east-1。因为rclone是直接在minio的docker里面执行的，所以endpoint只需要写成127.0.0.1和minio的api端口9000就可以了。

如果你的minio在公网或者其他设备上，请修改对应的IP地址和端口。

七牛云的region和endpoint在七牛云bucket页面找到S3域名就可以看到。

请注意，七牛云/阿里云这类存储服务商，如果你有多个bucket，且他们的地域不一样，则需要新增对应地域的配置项。通过修改[]里面的配置名进行区分。

[minio]
type = s3
provider = Minio
env_auth = false
access_key_id = 控制台获取的key_id
secret_access_key = 控制台获取的secret_key
region = us-east-1
endpoint = http://127.0.0.1:9000
location_constraint =
server_side_encryption =

[qiniu]
type = s3
provider = Qiniu
access_key_id = 七牛云控制台获取key_id
secret_access_key = 七牛云控制台获取secret_key
region = cn-east-1
endpoint = s3-cn-east-1.qiniucs.com
location_constraint = cn-east-1
acl = private
storage_class = STANDARD

执行如下命令，安装nano编辑器，然后使用nano编辑器打开rclone配置文件进行编辑。

apt-get update && apt-get install -y nano
nano /.config/rclone/rclone.conf

linux下的粘贴命令是CTRL+SHIFT+V或CTRL+INSERT，你可以在本地修改了配置文件后，通过nano编辑器，直接粘贴到docker容器内。编辑完毕后，使用CTRL+X退出nano的编辑模式，并按Y确认保存，随后直接回车，即完成编辑。

这个配置文件建议备份一个，免得每次都得重新弄

3.4 rclone基本命令

copy

拷贝命令如下，配置名称是在config文件中[]里面的文字，桶名就是你的S3服务里面的对象存储桶，还可以在桶名后面用/来追加指定上传的路径。

 rclone copy 本地文件路径 配置名称:桶名
 rclone copy 本地文件路径 配置名称:桶名/桶内目录

这里我在docker内创建了一个test.txt文件，尝试将其拷贝到minio里面。

touch test.txt
rclone copy ./test.txt minio:1panel-bak

命令没有错误输出，即拷贝成功！

root@878a0dd03ec4:/root/rclone# touch test.txt
root@878a0dd03ec4:/root/rclone# rclone copy ./test.txt minio:1panel-bak
root@878a0dd03ec4:/root/rclone# 

尝试在拷贝的时候指定远端仓库内的路径

rclone copy ./test.txt minio:qiniu-muxue-sy/test

成功指定，文件被上传到了test文件夹里面。

sync

备份命令如下，可以在任意目的地（本地-远端，远端-本地，远端-远端）里面执行这个命令，左侧是源路径，右侧是目标。

rclone sync 本地源文件路径  目的地配置名称:桶名 
rclone sync 源配置名称:桶名 目的地配置名称:桶名
rclone sync 源配置名称:桶名 目的地的本地文件路径

rclone sync有两个常用的选项，刚开始使用的时候，建议带上 --dry-run 命令来确认自己的配置没有问题

• -P 显示详细同步进度条
• --dry-run 用作命令测试，不会真正的执行同步

指定-P命令后的进度输出如下，可以看到实时网速和文件数量/大小。

目前发现的问题是minio显示的文件总量和数据存储量会有一定滞后，刚开始我还以为是rclone没有跑完呢，sync完毕过了几分钟minio里面才刷出正确的文件数量来。

3.5 cron定时同步

前排提醒：部分nas品牌的系统（比如群晖）已经提供了执行定时脚本的功能，这种情况下直接使用系统提供的定时任务来执行rclone sync即可，无序安装其他服务。即直接在nas里面安装rclone和使用定时任务，不要在minio的docker里面安装rclone和cron。

• 群晖官网关于定时任务的说明： https://kb.synology.cn/zh-cn/DSM/help/DSM/AdminCenter/system_taskscheduler?version=6
• 绿联nas的环境中已有crontab，但我没有试过使用它。考虑到绿联这个nas的系统还是一点都不稳定，还是别动它的系统里面的东西了，不知道绿联官方有没有可能把定时任务加到控制页里面去吧（我估计是没戏，这个系统的限制太多了）。

如果你使用的是群晖、威联通等提供了执行定时任务的功能的nas，请在nas内配置好rclone后，自行百度执行定时任务相关教程。

minio docker内安装cron服务

下面介绍在minio的docker内cron服务的安装和使用。

在minio的docker里面直接安装crontab服务和nano文本编辑器

apt-get update
apt-get install -y cron nano

但这还不够，cron服务的运行还依赖于其他组件，需要一并安装。

apt-get install -y rsyslog  postfix
service rsyslog start

安装postfix的时候会提示让你选择配置文件，键入1选择无配置就够了。

postfix还需要额外配置，否则可能会遇到如下错误

Dec 16 01:07:01 878a0dd03ec4 postfix/sendmail[1859]: fatal: open /etc/postfix/main.cf: No such file or directory
Dec 16 01:12:02 878a0dd03ec4 postfix/postdrop[1912]: warning: unable to look up public/pickup: No such file or directory

配置命令如下

touch /etc/postfix/main.cf
mkfifo /var/spool/postfix/public/pickup

crontab配置定时任务测试

安装完毕后，使用crontab -e看看是否能打开crontab的配置编辑页面，如果可以打开如下配置界面，则代表cron安装成功。

这个配置文件需要写入的格式如下，一行对应一个配置。

五位cron表达式 需要执行的命令

cron表达式可以用在线工具crontab执行时间计算 - 在线工具

先用如下的配置来检测cron服务是否能正常运行，以及是否能成功输出日志

*/1 * * * * echo "$(date) This is a test command" >> /root/rclone/log.txt

该配置的含义是每分钟执行一次echo命令，打印当前时间和对应内容到/root/rclone/log.txt文件中。

修改了配置文件后，启动cron服务，测试我们的配置是否有效，cron服务是否能正常运行。

service cron start 

该命令执行效果如下

root@878a0dd03ec4:/root/rclone# service cron start
Starting periodic command scheduler: cron.

等待数分钟，看看cron命令是否成功输出内容到指定文件里面了，有内容则代表配置和运行成功！默认情况下，使用cron执行的echo命令内的date采用了UTC时间的输出，但这并不影响我们的使用，给小时加8就能得到东八区的时间了。

root@878a0dd03ec4:/root/rclone# cat /root/rclone/log.txt
Sat Dec 16 01:18:01 UTC 2023 This is a test command
Sat Dec 16 01:18:01 UTC 2023 This is a test command
Sat Dec 16 01:19:01 UTC 2023 This is a test command
Sat Dec 16 01:19:01 UTC 2023 This is a test command

在syslog里面也能看到cron的服务日志，该服务日志组件依赖于先前安装的rsyslog

cat /var/log/syslog

文件/var/log/syslog内部cron执行日志如下

Dec 16 01:25:01 878a0dd03ec4 CRON[2059]: (root) CMD (echo "$(date) This is a test command" >> /root/rclone/log.txt)
Dec 16 01:25:01 878a0dd03ec4 CRON[2058]: (root) CMD (echo "$(date) This is a test command" >> /root/rclone/log.txt)

请注意，默认情况下，minio的docker是没有时区配置的，请一定要在创建docker容器的时候，使用TZ环境变量来设置时区，否则crontab不会执行！
原因也很简单，cron表达式有一个指定时间，比如每周一执行、几点执行，如果没有配置时区，cron没有办法明确你的cron表达式到底应该什么时候跑，干脆就不跑了！

如果你的docker已经创建，不想重新创建，可以通过修改配置文件来设置时区，修改后重启docker容器即可。

nano /etc/environment
# 在文件末尾写入如下内容
TZ='Asia/Shanghai'

crontab配置定时rclone sync

确认cron服务可用，就可以来配置rclone sync的自动执行命令了。

对于rclone的sync备份而言，写入如下内容即可；

0 3 * * 1,5 rclone sync qiniu-e1:muxue-sy  minio:qiniu-muxue-sy >> /root/rclone/rclone.log 2>&1
0 2 * * 1,5 rclone sync qiniu-e2:muxue-img  minio:qiniu-muxue-img >> /root/rclone/rclone.log 2>&1

解析如下

• 0 3 * * 1,5 代表每周一和周五的凌晨3点执行一次
• 0 2 * * 1,5 代表每周一和周五的凌晨2点执行一次
• >> /root/rclone/rclone.log 2>&1 代表将rclone命令的输出结果写入到 /root/rclone/rclone.log 文件中。

因为我对备份的频次要求不高，一周备份两次就够了。

写入完毕后，CTRL+X关闭nano编辑模式，按Y和回车即完成nano编辑。编辑完成后会有如下输出。

root@878a0dd03ec4:/root/rclone# crontab -e
no crontab for root - using an empty one
crontab: installing new crontab

后续crontab执行的命令结果都会输入到/root/rclone/rclone.log日志文件中。rclone命令只有在出现ERROR的时候才会输出。如果这个文件里面什么都么有，就代表运行没有出错！

配置好了之后，使用如下命令重新启动cron服务

service cron restart

用如下命令查看cron服务状态

root@878a0dd03ec4:/root/rclone# service cron status
cron is running.

优化日志

为了让日志更加合理，可以在执行rclone命令之前，打印当前时间，这样可以知道crontab到底有没有正常执行定时任务。

打印时间的基本命令如下，echo命令会将当前时间和相关的说明信息写入test.txt文件中

echo "$(date) This is a test command" >> test.txt

执行效果如下，打印了时间和对应的日志信息

root@878a0dd03ec4:/root/rclone# echo "$(date) This is a test command" >> test.txt
root@878a0dd03ec4:/root/rclone# cat test.txt
Sat Dec 16 09:36:06 CST 2023 This is a test command

再次提醒，minio的docker内必须指定TZ环境变量，否则crontab不会执行！且date命令时区和东八区不符。

echo打印的时候，可以临时指定TZ环境变量来打印不同时区的date

echo "$(TZ='Asia/Shanghai' date) 这是东八区" >> test.txt

执行效果如下，因为我的docker内已经设置了TZ环境变量为东八区，所以不加这个TZ也是打印的东八区的时间。

root@878a0dd03ec4:/root/rclone# echo "$(TZ='Asia/Shanghai' date) 这是东八区" >> test.txt
root@878a0dd03ec4:/root/rclone# cat test.txt
Sat Dec 16 09:36:06 CST 2023 This is a test command
Sat Dec 16 09:37:39 CST 2023 这是东八区

但是需要注意的是，使用cron命令执行的时候，它依旧会打印UTC时间，前文已经提到过了。

将原本的crontab命令改成如下形式（crontab -e编辑配置文件），使用&&来链接echo和rclone命令，这样在每次执行rclone之前都会有一个当前时间和sync的是什么内容的的输出，能让我们知道crontab是否正常执行。

0 3 * * 1,5 echo "$(TZ='Asia/Shanghai' date) sync muxue-sy" >> /root/rclone/rclone.log && rclone sync qiniu-e1:muxue-sy  minio:qiniu-muxue-sy >> /root/rclone/rclone.log 2>&1

0 2 * * 1,5 echo "$(TZ='Asia/Shanghai' date) sync muxue-img" >> /root/rclone/rclone.log && rclone sync qiniu-e2:muxue-img  minio:qiniu-muxue-img >> /root/rclone/rclone.log 2>&1

你可以修改cron表达式为*/1 * * * *，让crontab表达式立即执行一次，确认一下输出是否正确，以及rclone命令是否正常执行。

*/1 * * * * echo "$(date) sync muxue-img" >> /root/rclone/rclone.log && rclone sync qiniu-e2:muxue-img  minio:qiniu-muxue-img >> /root/rclone/rclone.log 2>&1

我的测试结果如下，rclone sync成功被cron执行（这个ERROR是因为我的bucket里面有个无效的文件，正常情况下应该不会有ERROR）

Sat Dec 16 01:45:01 UTC 2023 sync muxue-img
2023/12/16 01:45:02 ERROR : : Entry doesn't belong in directory "" (same as directory) - ignoring

测试结束后，记得还原配置项。

每次修改配置文件后，都需要重启cron服务！

root@878a0dd03ec4:/root/rclone# service cron restart
Restarting periodic command scheduler: cronStopping periodic command scheduler: cron.
Starting periodic command scheduler: cron.

The end

本文的教程结束，有问题欢迎在评论区提出。

数据无价，多一份备份，多一份安心