跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / Bash

Windows 本地部署 MinIO 对象存储服务实战

MinIO 是一款高性能开源对象存储,兼容 Amazon S3 接口。演示如何在 Windows 系统上完成 MinIO 的下载、目录规划及服务启动。提供命令行与批处理脚本两种运行方式,支持自定义管理员账号与端口配置,帮助开发者快速搭建本地测试环境。

筑梦师发布于 2026/3/30更新于 2026/9/955 浏览
Windows 本地部署 MinIO 对象存储服务实战

Windows 本地部署 MinIO 对象存储服务

MinIO 是一款基于 Apache License v2.0 开源协议的对象存储服务,兼容 Amazon S3 云存储接口。它非常适合用于存储海量非结构化数据,如图片、视频或日志文件。本教程将演示如何在 Windows 系统上搭建本地 MinIO 服务,适用于开发测试及小型项目部署场景。

下载与准备

获取安装包

访问 MinIO 官网下载对应版本:

  • MinIO 中文官网
  • MinIO 英文官网

根据操作系统选择 MinIO Server/AIStor Server 和 MinIO Client/AIStor Client。建议优先使用中文官网,下载速度通常更快。

注意:两版官网域名不同,但下载文件一致。Server 端是核心程序,Client 端(mc.exe)可选,仅在需要命令行管理时下载。

目录规划

在 D 盘创建 Minio 文件夹,并在其下建立三个子目录:

  • bin:存放可执行文件(minio.exe、mc.exe)
  • data:存储实际数据
  • logs:存放运行日志

将下载的 minio.exe 放入 D:\Minio\bin 目录下即可。

MinIO 目录结构示意

配置环境变量

启动前需设置管理员账号和密码。MinIO 要求密码长度至少 8 位。

方式一:临时生效(推荐调试用)

在当前终端会话中有效,关闭即失效:

set MINIO_ROOT_USER=minioadmin
set MINIO_ROOT_PASSWORD=minioadmin

方式二:永久生效

通过系统环境变量设置,重启后依然有效:

setx MINIO_ROOT_USER minioadmin
setx MINIO_ROOT_PASSWORD minioadmin

提示:若仅需临时修改,建议使用 set;若希望长期固定,使用 setx。注意 setx 命令需在管理员权限的 CMD 中运行以确保生效。

启动服务

方法一:命令行直接启动

切换到 bin 目录并执行启动命令:

cd /d D:\Minio\bin
minio.exe server D:\Minio\data --console-address "127.0.0.1:9001" --address "127.0.0.1:9000"

参数说明:

  • D:\Minio\data:数据持久化路径
  • --console-address:Web UI 控制台端口(默认 9001)
  • --address:API 服务端口(默认 9000)

启动后请勿关闭终端窗口,否则服务会中断。

MinIO 启动成功界面

方法二:批处理脚本一键启动

为了方便管理,可以创建一个 .bat 脚本。内容如下:

@echo off
set MINIO_ROOT_USER=minioadmin
set MINIO_ROOT_PASSWORD=minioadmin
minio.exe server D:\Minio\data --console-address ":9001" --address ":9000" > D:\Minio\logs\minio.log 2>&1

脚本逻辑解析:

  • @echo off:隐藏命令回显,让输出更简洁。
  • set ...:在脚本运行时临时设置环境变量,无需全局配置。
  • minio.exe server ...:启动核心服务。
  • > ... 2>&1:将标准输出和错误日志统一重定向到 minio.log 文件中,方便排查问题。

双击运行该脚本即可后台启动服务,日志会自动保存至 logs 目录。

访问 Web 控制台

服务启动成功后,打开浏览器访问:

  • 地址:http://localhost:9001
  • 用户名:minioadmin(或你设置的自定义值)
  • 密码:minioadmin(或你设置的自定义值)

首次登录后可进入主页面进行桶(Bucket)管理和用户配置。

MinIO 控制台首页

常见问题与建议

  1. 端口占用:如果 9000 或 9001 端口被占用,请修改 --address 和 --console-address 参数为其他可用端口。
  2. 防火墙:确保 Windows 防火墙允许相应端口的入站连接,否则外部无法访问。
  3. 日志查看:若启动异常,检查 D:\Minio\logs\minio.log 中的报错信息。

通过以上步骤,你就可以在 Windows 上快速拥有一个可用的 MinIO 对象存储服务了。后续结合 mc 客户端或代码 SDK,即可轻松实现文件上传下载功能。

目录

  1. Windows 本地部署 MinIO 对象存储服务
  2. 下载与准备
  3. 获取安装包
  4. 目录规划
  5. 配置环境变量
  6. 方式一:临时生效(推荐调试用)
  7. 方式二:永久生效
  8. 启动服务
  9. 方法一:命令行直接启动
  10. 方法二:批处理脚本一键启动
  11. 访问 Web 控制台
  12. 常见问题与建议

更多推荐文章

查看全部
  • unstructured:非结构化文档预处理与结构化转换实践
  • 支持 Nor Flash 读写的 SPI 主控制器设计、仿真和 FPGA 验证(含 XIP 模式)
  • Windows Python 安装与环境配置完整教程
  • 使用 Docker 部署 OpenClaw 实践
  • RabbitMQ 快速入门
  • 从 Chatbot 到 Agent:基于 Kotlin 实现 AI 智能体开发
  • 26 岁后转行程序员晚吗?毕业学员分享真实经验
  • OpenClaw 本地 AI 助手安装与使用指南
  • Spring 核心技术解析:Spring-Jcl 日志模块详解
  • 人工智能、机器学习与深度学习的核心概念解析
  • MCP 插件实战:Browser Tools 集成指南
  • BeyondMimic 人形机器人舞蹈训练与 rl_sar 部署实践
  • Venera 开源漫画阅读器使用指南与优化技巧
  • C++ 类和对象(中):默认成员函数与运算符重载
  • 英语学习笔记:认知方法、系统构成与风险管理
  • 国产 AI 副业通路全解析:12 条实用变现路径
  • ChatGLM-6B 使用、微调与训练指南
  • Vue3 前端最常用的 20 道面试题总结与代码解析
  • C++ STL 常用容器实战指南
  • 基于 7 系列 FPGA 实现万兆网通信

相关免费在线工具

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online

  • HTML转Markdown

    将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online

  • JSON 压缩

    通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online

  • JSON美化和格式化

    将JSON字符串修饰为友好的可读格式。 在线工具,JSON美化和格式化在线工具,online