基于MinIO搭建私有档案库，彻底解决存取不便

配置说明：

• [minio_archives]：这是远程存储的名称，可以自定义，后续挂载会用到。
• type = s3 和 provider = MinIO：指定协议类型为 S3 兼容，厂商为 MinIO。
• access_key_id / secret_access_key：必须与第一步 Docker 启动时设置的环境变量完全一致。
• endpoint：指向 MinIO 的 API 端口（9000），注意是 http 而不是 https。

第五步：挂载存储桶为本地目录

配置完成后，即可执行挂载命令。我们将 MinIO 中的 digital-archives 桶挂载到本地的 /mnt/archives 目录。

1. 创建本地挂载点：

sudo mkdir -p /mnt/archives

2. 执行挂载命令：

sudo rclone mount minio_archives:digital-archives /mnt/archives \
--allow-other \
--umask 000 \
--daemon

参数解释：

• minio_archives:digital-archives：表示挂载配置文件中定义的 minio_archives 远程下的 digital-archives 桶。
• --allow-other：允许系统其他用户访问该挂载目录。
• --umask 000：赋予所有文件读写权限，防止权限问题导致无法写入。
• --daemon：让挂载程序在后台运行。

3. 验证挂载结果：

执行 df -h 命令，你应该能看到类似 rclone 的文件系统类型挂载在 /mnt/archives 上。

现在，你可以尝试使用 cp 命令将本地文件复制到 /mnt/archives 中：

cp /root/test.pdf /mnt/archives/

如果文件复制成功且无报错，说明存取通道已经打通。以后所有存入 /mnt/archives 的文件，都会自动同步上传到 MinIO 档案库中，实现了“本地化”的便捷操作。

第六步：编写 Python 脚本实现批量上传

对于需要归档大量历史档案的场景，手动复制效率较低。我们可以利用 Python 编写一个简单的脚本，结合 MinIO 的 SDK 实现自动化批量上传。这比单纯使用 cp 命令更具备断点续传和并发控制能力。

1. 安装 MinIO Python SDK：

pip3 install minio

2. 编写上传脚本：

创建文件 batch_upload.py，写入以下完整代码：

from minio import Minio
from minio.error import S3Error
import os
import pathlib
配置信息
MINIO_ENDPOINT = "你的服务器IP:9000"
ACCESS_KEY = "admin"
SECRET_KEY = "StrongPassword123!"
BUCKET_NAME = "digital-archives"
本地需要上传的文件夹路径
SOURCE_DIR = "/data/local_files_to_upload"
def main():
初始化客户端，注意 secure=False 表示使用 HTTP 而非 HTTPS
client = Minio(
MINIO_ENDPOINT,
access_key=ACCESS_KEY,
secret_key=SECRET_KEY,
secure=False
)
检查桶是否存在，不存在则创建
found = client.bucket_exists(BUCKET_NAME)
if not found:
print(f"Bucket '{BUCKET_NAME}' does not exist, creating now...")
client.make_bucket(BUCKET_NAME)
print(f"Bucket '{BUCKET_NAME}' created successfully.")
else:
print(f"Bucket '{BUCKET_NAME}' already exists.")
遍历本地文件夹并上传
for root, dirs, files in os.walk(SOURCE_DIR):
for file in files:
local_path = os.path.join(root, file)
计算在服务器的相对路径，保持目录结构
object_name = str(pathlib.Path(local_path).relative_to(SOURCE_DIR))
print(f"Uploading {local_path} to {object_name}...")
try:
client.fput_object(
BUCKET_NAME,
object_name,
local_path
)
print(f"Success: {object_name}")
except S3Error as exc:
print(f"Error: {exc[0]}")
if __name__ == "__main__":
main()

3. 运行脚本：

确保你已经创建了 /data/local_files_to_upload 目录并在里面放入了一些测试文件，然后执行：

python3 batch_upload.py

该脚本会自动遍历目录，保持原有的文件夹结构上传至 MinIO。通过这种方式，无论是几千个 PDF 还是图片，都可以一键完成数字化托管，彻底解决了传统方式下存取繁琐、连接不稳定的问题。