目錄

1. MinIO簡介

什么是MinIO？

為什么選擇Docker安裝？

2. 環境準備

檢查Docker狀態

檢查防火墻設置

創建存儲目錄

3. 快速啟動MinIO

基礎啟動命令

驗證啟動狀態

4. 配置持久化存儲

停止并刪除臨時容器

使用數據卷啟動MinIO

驗證數據持久化

5. 訪問MinIO控制臺

通過瀏覽器訪問

本地訪問（如果在本機安裝）

控制臺功能介紹

6. 高級配置

使用Docker Compose管理

配置SSL/HTTPS（可選）

環境變量配置

7. 管理和維護

常用Docker命令

數據備份

設置開機自啟動

8. 常見問題解決

問題1：無法訪問Web控制臺

問題2：權限不足錯誤

問題3：容器意外停止

問題4：忘記管理員密碼

問題5：升級MinIO版本

總結

---

1. MinIO簡介

什么是MinIO？

MinIO是一個高性能的對象存儲服務，兼容Amazon S3 API。簡單來說，它就像一個私有云盤，可以讓你：

• 存儲文件、圖片、視頻等任何數據
• 通過網頁界面管理文件
• 為應用程序提供文件存儲服務
• 支持分布式部署，數據安全可靠

為什么選擇Docker安裝？

• 簡單快捷：一條命令就能啟動
• 環境隔離：不會影響系統其他服務
• 易于管理：啟動、停止、刪除都很方便
• 版本控制：可以輕松切換不同版本

---

2. 環境準備

檢查Docker狀態

首先確認Docker已經安裝并正在運行：

# 檢查Docker版本
docker --version# 檢查Docker服務狀態
systemctl status docker# 如果Docker沒有啟動，執行以下命令
sudo systemctl start docker
sudo systemctl enable docker

檢查防火墻設置

MinIO默認使用9000和9001端口，需要確保這些端口可以訪問：

# 查看防火墻狀態
firewall-cmd --state# 如果防火墻開啟，需要開放端口
sudo firewall-cmd --zone=public --add-port=9000/tcp --permanent
sudo firewall-cmd --zone=public --add-port=9001/tcp --permanent
sudo firewall-cmd --reload# 驗證端口是否開放
firewall-cmd --zone=public --list-ports

創建存儲目錄

為MinIO數據創建專門的目錄：

# 創建MinIO數據目錄
sudo mkdir -p /opt/minio/data
sudo mkdir -p /opt/minio/config# 設置目錄權限（重要！）
sudo chmod 755 /opt/minio/data
sudo chmod 755 /opt/minio/config

---

3. 快速啟動MinIO

基礎啟動命令

使用以下命令快速啟動MinIO：

docker run -p 9000:9000 -p 9001:9001 \--name minio \-e "MINIO_ROOT_USER=admin" \-e "MINIO_ROOT_PASSWORD=password123" \quay.io/minio/minio server /data --console-address ":9001"

命令解釋：

• -p 9000:9000：映射API端口（用于程序訪問）
• -p 9001:9001：映射Web控制臺端口（用于網頁管理）
• --name minio：給容器命名為minio
• -e "MINIO_ROOT_USER=admin"：設置管理員用戶名為admin
• -e "MINIO_ROOT_PASSWORD=password123"：設置管理員密碼
• server /data：啟動服務器，數據存儲在/data目錄
• --console-address ":9001"：指定控制臺端口

驗證啟動狀態

# 查看容器運行狀態
docker ps# 查看MinIO日志
docker logs minio# 如果一切正常，你會看到類似輸出：
# MinIO Object Storage Server
# Copyright: 2015-2023 MinIO, Inc.
# API: http://172.17.0.2:9000  http://127.0.0.1:9000
# Console: http://172.17.0.2:9001 http://127.0.0.1:9001

---

4. 配置持久化存儲

上面的快速啟動方法有個問題：容器刪除后數據就丟失了。讓我們配置持久化存儲：

停止并刪除臨時容器

# 停止容器
docker stop minio# 刪除容器
docker rm minio

使用數據卷啟動MinIO

docker run -d \-p 9000:9000 \-p 9001:9001 \--name minio \-v /opt/minio/data:/data \-v /opt/minio/config:/root/.minio \-e "MINIO_ROOT_USER=admin" \-e "MINIO_ROOT_PASSW