在日本服务器部署MinIO对象存储,如何配置磁盘与访问权限?

发布人:A5数据发布时间:2026-10-13 09:11阅读量:182

在日本服务器上部署 MinIO,磁盘和权限需要分开配置:磁盘层面,应把独立数据盘挂载到固定目录,只允许 MinIO 服务账户写入,并防止挂载失败后误写系统盘;访问层面,应通过 HTTPS 提供 S3 接口,为业务创建独立凭据,再按存储桶和对象前缀授予必要权限,不能把管理员密钥直接交给应用。

下面以 Ubuntu 22.04/24.04 LTS、systemd、单节点单数据盘为实施环境,完成“独立磁盘挂载 → MinIO 服务启动 → Nginx HTTPS 接入 → 业务权限验证”的部署。该方案适合开发测试、内部工具,以及能够接受单机停机风险的业务;它不提供节点或磁盘冗余,生产数据仍需独立备份。服务器位于日本不会改变 MinIO 的权限模型,但公网访问还需要考虑机房安全组、跨境链路延迟和带宽限制。

一、准备环境,明确磁盘与访问边界

上线前需要准备什么

本文使用以下示例,执行前替换域名、磁盘名称和服务器地址。

项目示例配置核对重点
操作系统Ubuntu 22.04/24.04 LTS使用 systemd 管理服务
CPU 架构x86_64对应 Linux amd64 软件包
数据盘/dev/vdb必须确认不是系统盘,也没有待保留数据
挂载点/srv/minio使用 UUID 挂载
对象目录/srv/minio/data仅供 MinIO 使用
S3 域名s3.example.netDNS 指向服务器,证书匹配域名
API 监听127.0.0.1:9000仅由本机 Nginx 转发
控制台监听127.0.0.1:9001通过 SSH 本地端口转发访问
业务存储桶assets默认保持私有
业务对象前缀project-a/应用仅访问此范围

先核对系统和磁盘:

cat /etc/os-release
uname -m
lsblk -o NAME,SIZE,TYPE,FSTYPE,MOUNTPOINTS,UUID
df -hT
timedatectl status

uname -m 返回 x86_64 时选择 amd64 构建;返回 aarch64 时选择 arm64 构建,不要混用。时间同步应正常,因为 S3 请求签名依赖客户端与服务端时间,偏差过大可能造成认证失败。

以 sudo 权限安装依赖:

sudo apt update
sudo apt install -y xfsprogs ca-certificates curl openssl nginx

MinIO 服务端与客户端 mc 应来自可信的软件发布渠道或内部制品库,固定到已经验证的版本,并记录版本号和校验值。不要在上线脚本中直接下载“最新版”,否则后续重建可能得到不同的软件行为。不同版本的发布渠道和控制台功能可能变化,应以所选构建实际提供的功能为准。

容量和可靠性边界

单数据盘没有副本或纠删码提供的磁盘冗余。磁盘故障、实例删除和误操作,都可能导致对象不可用。

容量规划应同时计算对象、未完成的分片上传、历史版本和增长空间。例如,500 GiB 数据盘按约 75% 的日常使用目标规划,对象及相关数据预算约为 375 GiB,其余作为运维余量;这是容量规划示例,不是 MinIO 的固定阈值。

日本机房的公网带宽也不能直接视为对象上传速度。实际吞吐受到客户端位置、往返延迟、并发数、TLS、磁盘性能和服务器出口限制共同影响。上线验收应从真实业务所在网络测试,而不只在服务器本机测试。

围绕日本机房的 MinIO 对象存储部署,A5数据提供涵盖 Xeon Gold、AMD EPYC 平台的日本物理服务器,热销系列配有 NVMe 存储,CTG 系列包含多块 SSD、大容量 HDD 等方案,为业务文件读写、备份与归档提供计算和存储基础。日本产品还提供 CN2、GIA、SoftBank 等不同线路选择,可承接面向日本本地及跨境应用的 S3 接口访问需求。

二、配置数据盘,避免挂载失败后写入系统盘

1. 确认磁盘,再决定是否格式化

下面的格式化命令仅适用于已经确认可以清空的新数据盘。格式化会破坏原有文件系统,无法通过撤销命令恢复;已有数据必须先备份,或者改用新的空盘。

sudo lsblk -f /dev/vdb
sudo wipefs -n /dev/vdb
sudo findmnt -S /dev/vdb

wipefs -n 只查看签名,不执行清除。若发现已有文件系统、分区或挂载关系,先停止操作并确认用途。

下面采用整盘 XFS 文件系统,不建立分区表:

sudo mkfs.xfs /dev/vdb
sudo mkdir -p /srv/minio
sudo blkid /dev/vdb

没有使用强制格式化参数。如果命令提示磁盘已有文件系统,不应为了继续教程而强行覆盖。

2. 使用 UUID 配置永久挂载

修改前备份:

sudo cp -a /etc/fstab "/etc/fstab.before-minio.$(date +%Y%m%d-%H%M%S)"
sudoedit /etc/fstab

将 blkid 返回的真实 UUID 写入文件:

UUID=替换为实际UUID /srv/minio xfs defaults,nodev,nosuid,nofail 0 0

这里的 nofail 允许数据盘不可用时系统继续启动,便于远程修复;后续 systemd 配置会单独限制 MinIO,避免服务在未挂载的数据目录上启动。不要重复添加同一个挂载点。

验证配置并挂载:

sudo findmnt --verify --verbose
sudo mount /srv/minio
findmnt -T /srv/minio
df -hT /srv/minio

正确结果应显示 /srv/minio 位于目标数据盘上,文件系统为 XFS。以下仅为示例输出:

TARGET      SOURCE   FSTYPE OPTIONS
/srv/minio  /dev/vdb  xfs    rw,nosuid,nodev,relatime,...

若显示的是系统盘上的 /,不要继续创建对象目录。

3. 创建服务账户和目录权限

以下账户只用于运行 MinIO,不允许交互登录:

sudo useradd --system --user-group \
  --home-dir /nonexistent \
  --shell /usr/sbin/nologin minio

sudo install -d -o minio -g minio -m 0750 /srv/minio/data
sudo -u minio test -w /srv/minio/data
namei -l /srv/minio/data

如果 minio 用户已存在,应先用 id minio 核对,而不是重复创建。

test -w 成功时不会输出内容,退出码为 0。目录使用 0750,服务账户可读写,其他无关账户不能进入。

文件系统权限和 S3 权限是两套独立机制。 Linux 目录权限决定 MinIO 进程能否访问磁盘;S3 策略决定业务身份能否读写对象。不能用 chmod 777 修复 S3 的 AccessDenied,也不能直接进入数据目录修改或删除对象文件,包括 .minio.sys 等内部数据。

三、安装 MinIO 并用 systemd 管理服务

1. 校验并安装固定版本

以下约定已经将可信来源的 minio、mc 和校验清单放在 /tmp/minio-release。校验清单中的摘要应通过独立可信渠道核对,不能仅凭同一下载位置的文件判断可信。

cd /tmp/minio-release
sha256sum -c SHA256SUMS

sudo install -o root -g root -m 0755 minio /usr/local/bin/minio
sudo install -o root -g root -m 0755 mc /usr/local/bin/mc

minio --version
mc --version
minio server --help

校验应全部返回 OK。本文使用的构建需要支持 server、--address 和 --console-address;如果帮助信息不同,先核对版本,不要猜测替代参数。

若这是替换既有安装,应先停止服务并备份原二进制、配置及数据恢复点,再覆盖文件。

2. 生成管理员凭据

管理员凭据仅用于初始化和运维,不交给业务应用。下面使用 root 子进程生成随机值,不在终端直接打印密码:

sudo install -d -o root -g root -m 0700 /etc/minio

sudo bash -c '
set -eu
umask 077
test ! -e /etc/minio/minio.env
ROOT_USER="admin-$(openssl rand -hex 6)"
ROOT_PASSWORD="$(openssl rand -hex 32)"
printf "MINIO_ROOT_USER=%s\nMINIO_ROOT_PASSWORD=%s\n" \
  "$ROOT_USER" "$ROOT_PASSWORD" > /etc/minio/minio.env
chmod 0600 /etc/minio/minio.env
'

test ! -e 用于防止重复执行时覆盖已有凭据。若文件已经存在,应先确认这是重装还是维护操作,并将凭据保存在受控密码库中,不要提交到代码仓库。

3. 创建服务文件

新建 /etc/systemd/system/minio.service:

[Unit]
Description=MinIO Object Storage
Wants=network-online.target
After=network-online.target
RequiresMountsFor=/srv/minio
ConditionPathIsMountPoint=/srv/minio

[Service]
User=minio
Group=minio
EnvironmentFile=/etc/minio/minio.env
ExecStart=/usr/local/bin/minio server /srv/minio/data --address 127.0.0.1:9000 --console-address 127.0.0.1:9001
Restart=on-failure
RestartSec=5
LimitNOFILE=65536
TimeoutStopSec=120
NoNewPrivileges=true
ProtectSystem=full
ProtectHome=true

[Install]
WantedBy=multi-user.target

RequiresMountsFor 建立挂载依赖,ConditionPathIsMountPoint 再检查目录是否确实是挂载点。这两项配合使用,可以降低磁盘未挂载时误写系统盘的风险。

从系统启动进入挂载依赖和挂载点检查,分出正常写入目标数据盘与未满足条件时阻止服务启动两条路径;失败路径包含修复挂载、核对原盘和显式启动

检查并启动:

sudo systemd-analyze verify /etc/systemd/system/minio.service
sudo systemctl daemon-reload
sudo systemctl enable --now minio
sudo systemctl status minio --no-pager
sudo journalctl -u minio -n 50 --no-pager

curl -fsS -o /dev/null -w '%{http_code}\n' \
  http://127.0.0.1:9000/minio/health/live

sudo ss -lntp | grep -E ':9000|:9001'

预期服务为 active (running),健康接口返回 200,两个端口都只监听 127.0.0.1。如果发现监听在 0.0.0.0,应先检查实际启动参数,不要立即开放公网端口。

四、通过 HTTPS 提供 S3 接口,控制公网入口

1. 配置 Nginx

上线前准备与 s3.example.net 匹配的可信证书,示例路径为:

  • 证书链:/etc/nginx/tls/s3.example.net/fullchain.pem
  • 私钥:/etc/nginx/tls/s3.example.net/privkey.pem

私钥应由 root 管理,通常使用 0600 权限。证书签发和续期需要提前安排,不能把临时自签名证书作为对外上线的默认方案。

新建 /etc/nginx/sites-available/minio-s3:

server {
    listen 443 ssl;
    server_name s3.example.net;

    ssl_certificate /etc/nginx/tls/s3.example.net/fullchain.pem;
    ssl_certificate_key /etc/nginx/tls/s3.example.net/privkey.pem;
    ssl_protocols TLSv1.2 TLSv1.3;

    client_max_body_size 0;
    ignore_invalid_headers off;

    location / {
        proxy_pass http://127.0.0.1:9000;
        proxy_http_version 1.1;

        proxy_set_header Host $http_host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header Connection "";

        proxy_request_buffering off;
        proxy_buffering off;
        proxy_connect_timeout 10s;
        proxy_read_timeout 300s;
        proxy_send_timeout 300s;
    }
}

这里保留原始 Host,不重写对象路径,也不把 MinIO 放在 /minio/ 之类的子路径下,避免破坏 S3 签名。

client_max_body_size 0 取消 Nginx 的请求体大小限制,适合对象上传,但意味着不能依靠这一项限制业务上传量。公网服务仍应控制身份、容量和请求规模。

启用配置前,备份既有 Nginx 配置;同名文件或链接已存在时应先核对,不要覆盖:

sudo ln -s /etc/nginx/sites-available/minio-s3 \
  /etc/nginx/sites-enabled/minio-s3

sudo nginx -t
sudo systemctl reload nginx

在本机验证证书和转发:

curl --resolve s3.example.net:443:127.0.0.1 \
  -fsS -o /dev/null -w '%{http_code}\n' \
  https://s3.example.net/minio/health/live

返回 200 表明证书验证和 API 转发成功。再从外部客户端执行不带 --resolve 的同一请求,验证 DNS、安全组和公网链路。不要用 curl -k 掩盖证书错误。

2. 配置防火墙和控制台入口

机房安全组与主机防火墙需要分别核对:

  • TCP 443:按业务需要开放;仅供固定来源使用时,限制来源地址。
  • SSH 端口:仅允许管理来源,并确认当前连接可以继续使用。
  • TCP 9000、9001:不对公网开放。
  • TCP 80:只有证书验证或其他明确需求时才开放。

先查看 UFW 状态:

sudo ufw status numbered

若 UFW 已启用且 SSH 放行规则已经确认,可以为公网 S3 接口添加规则:

sudo ufw allow 443/tcp

执行前应记录原规则编号和安全组配置。若服务仅面向固定业务来源,应改为来源受限规则,不使用上述全来源开放方式。不要在远程会话中未经检查直接启用防火墙;规则错误时,应通过备用 SSH 会话或服务器控制台恢复。

需要查看 MinIO 控制台时,在管理员电脑执行:

ssh -N -L 19001:127.0.0.1:9001 admin@服务器地址

随后访问 http://127.0.0.1:19001。HTTP 流量在 SSH 加密连接内传输,控制台端口无需暴露到公网。

上路为业务客户端经安全组和主机防火墙访问 Nginx 443,再转发到服务器回环 API 9000;下路为管理员电脑本地浏览器经 SSH 转发访问服务器回环控制

五、创建业务身份,验证允许与拒绝的操作

1. 建立管理员连接和私有存储桶

以下命令在服务器的 root 管理会话中执行。mc alias set 会把凭据写入本地配置,因此配置目录也需要保护。

sudo -i
set -a
. /etc/minio/minio.env
set +a

mc alias set local http://127.0.0.1:9000 \
  "$MINIO_ROOT_USER" "$MINIO_ROOT_PASSWORD"

chmod 0700 /root/.mc
chmod 0600 /root/.mc/config.json

mc admin info local
mc mb local/assets
mc anonymous get local/assets

若桶已经存在,先检查现有数据和策略,不要将其当作空桶重新配置。

新建桶默认应为私有。如果发现已有匿名访问策略,只有在确认没有依赖公开访问的业务后,才执行:

mc anonymous set none local/assets

这会立即停止匿名访问,可能影响原有公开下载链接。变更前应记录旧策略及恢复方式。

2. 按对象前缀授予读写权限

示例业务只允许访问 assets 桶中的 project-a/,允许上传、读取和必要的分片操作,不允许删除对象或修改桶策略。

创建 /root/assets-project-a-rw.json:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "s3:GetBucketLocation"
      ],
      "Resource": [
        "arn:aws:s3:::assets"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "s3:ListBucket"
      ],
      "Resource": [
        "arn:aws:s3:::assets"
      ],
      "Condition": {
        "StringLike": {
          "s3:prefix": [
            "project-a/",
            "project-a/*"
          ]
        }
      }
    },
    {
      "Effect": "Allow",
      "Action": [
        "s3:GetObject",
        "s3:PutObject",
        "s3:AbortMultipartUpload",
        "s3:ListMultipartUploadParts"
      ],
      "Resource": [
        "arn:aws:s3:::assets/project-a/*"
      ]
    }
  ]
}

桶级资源和对象级资源不能混写:列举对象使用桶 ARN,读写对象使用包含前缀的对象 ARN。

该策略没有允许无前缀列举整个桶。因此,某些客户端在打开桶根目录时可能显示权限不足,这不代表配置失败。业务应从 project-a/ 开始访问;只有确认客户端必须列举根目录时,才重新评估授权范围。

以私有 assets 桶为核心对象,内部按对象键前缀分组展示 project-a/ 与 project-b/;外侧分别标注桶级查询和带条件列举,以及 proje

创建业务用户并绑定策略:

mc admin policy create local assets-project-a-rw \
  /root/assets-project-a-rw.json

APP_SECRET="$(openssl rand -hex 24)"
mc admin user add local app-rw "$APP_SECRET"
mc admin policy attach local assets-project-a-rw --user app-rw

umask 077
printf 'ACCESS_KEY=app-rw\nSECRET_KEY=%s\n' "$APP_SECRET" \
  > /root/minio-app.env

mc admin user info local app-rw

凭据文件应转存到受控密码库,再通过应用的密钥注入机制配置,不能写进前端代码、公开仓库或日志。

如果业务确实需要删除,只增加 s3:DeleteObject;如果只读,就移除写入及分片上传相关动作。不要为了方便直接授予全桶 s3:*。

3. 用业务凭据做正向与反向验证

通过外部 HTTPS 地址建立业务连接:

mc alias set app https://s3.example.net app-rw "$APP_SECRET"

printf 'minio permission test\n' > /root/minio-test.txt

mc cp /root/minio-test.txt app/assets/project-a/minio-test.txt
mc cat app/assets/project-a/minio-test.txt
mc ls app/assets/project-a/

上传应成功,读取应返回测试内容,列表应包含该对象。

再检查权限边界:

mc cp /root/minio-test.txt app/assets/project-b/denied-test.txt
mc rm app/assets/project-a/minio-test.txt

第二条命令仅针对刚创建、可丢弃的测试对象,用于验证删除权限。两项操作都应返回 AccessDenied。若删除意外成功,损失范围仅为测试对象,但说明权限边界没有生效,应立即检查该用户是否还绑定了其他宽泛策略。

匿名读取也应失败:

curl -sS -o /dev/null -w '%{http_code}\n' \
  https://s3.example.net/assets/project-a/minio-test.txt

对象仍存在且桶保持私有时,预期返回 403。验证结束后清理当前 shell 中的变量:

unset MINIO_ROOT_USER MINIO_ROOT_PASSWORD APP_SECRET
exit

应用侧需要配置 HTTPS endpoint、业务 Access Key 和 Secret Key。本文只配置一个 S3 域名,客户端宜使用 path-style 寻址;若改用虚拟主机式寻址,还需要匹配的通配 DNS、证书和 Nginx 主机名配置。

六、处理常见失败,完成验收与回滚准备

常见异常处理

先检查只读状态和日志,再修改配置,避免通过扩大权限掩盖问题。

异常优先检查处理边界
服务未启动或被跳过systemctl status minio、findmnt -T /srv/minio挂载点条件失败时先恢复数据盘,不要删除保护条件
日志出现 permission deniednamei -l /srv/minio/data、服务用户只修正专用目录权限,不对整个 /srv 递归改权限
Nginx 返回 502本机健康接口、9000 监听、服务日志上游未运行时,修改公网规则没有帮助
证书验证失败域名、证书有效期、完整证书链修复证书,不长期关闭客户端 TLS 校验
S3 返回 AccessDenied当前凭据、绑定策略、桶名和对象前缀判断失败操作是否本来就应被拒绝
S3 返回签名错误时间同步、Host、路径改写、客户端寻址方式保持签名字段一致,不放宽权限
小文件正常,大文件失败请求体限制、超时、磁盘空间、分片上传权限同时检查 Nginx、MinIO 和客户端日志

服务因挂载检查被跳过时,修复挂载后需要显式启动:

sudo mount /srv/minio
findmnt -T /srv/minio
sudo systemctl start minio

重启前必须确认挂载的是原数据盘。若只是权限问题,调整已有对象目录可能影响服务访问,应在确认目录用途、保存原权限后处理;不要直接对整块磁盘运行递归权限修改。

上线验收检查项

  • 数据盘按 UUID 挂载,/srv/minio 对应正确设备。
  • MinIO 使用专用账户运行,数据目录不是全员可写。
  • 9000、9001 仅监听回环地址,公网入口只有计划中的 HTTPS 和管理端口。
  • 本机健康检查、外部 TLS 检查均通过,证书续期已有安排。
  • 业务凭据可以访问 project-a/,不能写入其他前缀、删除对象或修改桶策略。
  • 匿名访问被拒绝,管理员凭据没有进入业务配置。
  • 从实际业务网络验证上传、下载及大文件分片上传,不能只依赖健康接口。
  • 在维护窗口重启服务器后,磁盘自动挂载、服务自动启动,并能读取原有测试对象。
  • 对象备份位于独立故障域,恢复流程经过验证;监控覆盖空间、服务状态、错误率和证书有效期。

回滚检查项与执行顺序

回滚应先撤销业务访问和配置,再处理存储,避免把“撤销部署”误做成“删除数据”。

  1. 撤销业务身份。 先停止应用写入,再禁用用户。确认需要恢复时可以重新启用:
   mc admin user disable local app-rw
   mc admin user enable local app-rw

这两条命令分别表示撤销和恢复,不应连续执行作为一次操作。

  1. 恢复访问策略。 若需解除授权,记录原绑定关系后执行:
   mc admin policy detach local assets-project-a-rw --user app-rw

回退该变更时重新执行对应的 policy attach。修改已有策略前也应保存旧 JSON,恢复后重新运行允许与拒绝测试。

  1. 恢复 Nginx。 移出本次新增的站点链接或恢复配置备份,先运行 nginx -t,成功后 reload。只恢复本次改动,不覆盖其他站点;同步撤销本次新增的安全组和防火墙规则。
  2. 停止 MinIO,保留数据。
   sudo systemctl disable --now minio

如果是版本升级回滚,应确认旧版本能读取现有数据格式。不能确认兼容性时,应恢复升级前的有效备份,而不是只替换二进制。

  1. 最后处理磁盘挂载。 确认服务停止、没有其他进程使用目录后,才考虑卸载磁盘并恢复 /etc/fstab。不要删除 /srv/minio/data,不要重新格式化数据盘,也不要将同一目录同时交给两个 MinIO 实例使用。

完成验收的标准不仅是服务启动和上传成功,还包括:数据始终写在目标磁盘上,应用身份只能执行被授权的操作,重启后配置可恢复,发生故障时有可执行的数据恢复路径。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/3410.html

相关推荐