零基础小白手把手教程：用Docker和MinIO打造专属私有图床，并完美搭配PicGo

这是一份真正从零开始、手把手、极其详细的教程。请放心，你不需要任何编程基础，只需要会点击鼠标和打字就行。

我们将分为几个大步骤：

1. 安装必要的软件 (Docker Desktop)
2. 部署 MinIO 服务 (就像安装一个“图片仓库”的后台系统)
3. 配置 MinIO (给这个“仓库”设置规矩和钥匙)
4. 安装和配置 PicGo (一个帮你把图片轻松送到“仓库”的工具)
5. 测试使用 (试试看效果！)

---

第一步：安装 Docker Desktop

Docker 是一个用来快速安装和运行各种软件（比如我们的 MinIO）的工具，我们用它的桌面版，非常简单。

1. 打开浏览器，访问 Docker 官网的下载页面：https://www.docker.com/products/docker-desktop/
2. 点击下载 Docker Desktop for Windows（如果你是 Windows 系统的话。Mac 用户就选 for Mac）。
3. 下载完成后，双击打开安装文件，一路点击 “Next” 或 “OK” 即可，所有选项都保持默认，直到安装完成。
4. 安装完成后，它可能会要求你重启电脑。请重启电脑。
5. 电脑重启后，在开始菜单找到并打开 Docker Desktop。第一次启动可能需要稍等一会儿，直到看到右下角系统托盘里的小鲸鱼图标不再晃动，说明它已经准备好了。

---

第二步：部署 MinIO 服务

现在，我们要用 Docker 来安装和运行 MinIO。

1. 在电脑的任意位置（比如桌面），新建一个文件夹，命名为 minio。这个文件夹将用来存放所有相关文件。

2. 进入刚创建的 minio 文件夹，在里面再新建一个文本文档。

3. 右键点击这个文本文档，选择 “重命名” 。将文件名从 新建文本文档.txt 改为 docker-compose.yml。注意： 一定要把后面的 .txt 也删掉。系统可能会问你“如果改变文件扩展名，可能会导致文件不可用”，点击 “是” 。

4. 右键点击这个 docker-compose.yml 文件，选择用 “记事本” 打开。

5. 将你提供的文章里的那段代码完全复制，然后粘贴到记事本中。

   version: '3'
   services:
     minio:
       image: minio/minio:RELEASE.2024-11-07T00-52-20Z
       hostname: "minio"
       ports:
         - "9000:9000" # api 端口
         - "9001:9001" # 控制台端口
       environment:
         MINIO_ACCESS_KEY: admin    # 管理后台用户名
         MINIO_SECRET_KEY: tyw123456   # 管理后台密码，最小8个字符
       volumes:
         - ./data:/data               # 映射当前目录下的data目录至容器内/data目录
         - ./config:/root/.minio/     # 映射配置目录
       command: server --console-address ':9001' /data  #指定容器中的目录 /data
       privileged: true
       restart: "no"
   

6. 点击记事本菜单栏的 “文件” -> “保存” ，然后关闭记事本。

7. 现在，在这个 docker-compose.yml 文件所在的文件夹里，按住键盘上的 ​Shift​ 键不放，然后点击鼠标右键。在弹出的菜单中，选择 “在此处打开 PowerShell 窗口” 或 “在此处打开命令窗口” 。

8. 会弹出一个黑底的窗口（叫做命令行窗口）。复制下面这行命令，然后在窗口里点击鼠标右键（点击右键就是粘贴），最后按一下 回车键。

   docker compose up -d
   

   ​

9. 然后它会自动开始下载和安装 MinIO。等待几分钟，直到命令行不再疯狂滚动文字，并且出现类似 Done 或 Started 的字样，就完成了。你可以关闭这个黑色窗口了。

现在，你的 MinIO 服务已经在后台运行了！

---

第三步：配置 MinIO（在网页上操作）

现在我们要通过浏览器来管理这个刚刚建好的“图片仓库”。

1. 打开你的浏览器（Chrome, Edge 等），在地址栏输入：​http://127.0.0.1:9001​，然后按回车。

2. 会看到一个登录界面。

   • 用户名：输入 admin​
   • 密码：输入 tyw123456​
   • 点击 Login。

3. 创建存储桶 (Bucket)

   • 登录后，点击左边菜单栏的 ​Buckets​。
   • 点击右下角的 ​Create Bucket +​ 按钮。
   • 在 Bucket Name 里，随便起个名字，比如 my-pictures，其他都不用改。
   • 点击 ​Create Bucket​ 按钮。

4. 修改权限（非常重要！）

   • 点击你刚创建的 my-pictures 这个桶的名字。
   • 点击顶部的 ​Summary​ 选项卡。
   • 找到 ​Access Policy​，点击右边的编辑按钮（小铅笔图标）。
   • 在下拉菜单中，选择 ​public​。
   • 点击 ​Save​ 按钮。
   • 这一步是为了让你的图片链接可以被任何人看到，否则图床无法使用。

5. 创建访问密钥（给 PicGo 用）

   • 点击左边菜单栏的 ​Access Keys​（可能在 Identity 栏目下）。
   • 点击右上角的 ​Create Access Key +​ 按钮。
   • 点击 ​Create​ 按钮。它会为你生成一对新的密钥。
   • 非常重要： 立刻把这个页面上的 ​Access Key​ 和 ​Secret Key​ 复制到一个记事本里保存好！这个页面一旦关闭就再也看不到 Secret Key 了！

6. 配置 Region（非常重要！）

   • 点击左边菜单栏的 ​Settings​ -> ​Region​。
   • 在 Region 输入框里，随便填写一个区域代码，比如 ​us-east-1​ (这是默认的)。
   • 点击 ​Save​ 按钮。

---

第四步：安装和配置 PicGo

PicGo 是一个桌面软件，用来方便地上传图片到你配置好的图床。

1. 打开浏览器，访问 PicGo 的 GitHub 发布页面：https://github.com/Molunerfinn/PicGo/releases
2. 找到最新的版本（通常在最上面），下载文件名字里带有 ​.exe​ 结尾的文件（如果你是 Windows 系统）。比如 PicGo-Setup-2.3.0-x64.exe。
3. 下载完成后，双击安装，一路 “下一步” 即可。
4. 安装完成后打开 PicGo。

配置 PicGo：

1. 在 PicGo 左边，找到并点击 ​图床设置​。

2. 找到并点击 ​MinIO​ (或者 S3, 它们兼容)。右边会出现一堆设置选项。

3. 按照下面的说明填写，所有内容都来自你之前的操作：

   • ​​AccessKeyID​: 填写你刚才在 MinIO 里保存的那一串 Access Key。
   • ​​SecretAccessKey​: 填写你保存的那一串 Secret Key。
   • ​​Bucket​: 填写你创建的存储桶名字，比如 my-pictures。
   • ​​Area​: 填写你在 MinIO 里设置的 Region，比如 us-east-1。
   • ​​Path​: 可以填写 images/，这样图片会上传到桶里的 images 文件夹下（不填也行）。
   • ​​EndPoint​: 填写 ​http://127.0.0.1:9000​ (注意是 9000 端口，不是 9001！)。
   • 其他选项保持默认不动。

4. 填写完成后，点击 ​确定​。

5. 回到 PicGo 主界面，在 ​默认图床​ 那里，选择你刚刚配置的 ​MinIO​。

---

第五步：测试使用！

恭喜你！所有配置都完成了！现在来试试效果。

1. 你可以随便找一张电脑上的图片，比如一张截图。
2. 打开 PicGo 软件，直接把你电脑上的图片拖拽到 PicGo 的窗口里。
3. 如果上传成功，图片会出现在下面的列表里，并且 ​链接​ 那一栏会自动复制到你的剪贴板。
4. 打开浏览器，把复制好的链接粘贴到地址栏里按回车。如果能看到你的图片，说明大功告成！

以后你在写笔记或文章时，只需要把图片拖到 PicGo 里，然后在编辑器中直接粘贴 (Ctrl+V)，出来的就是你的私有图床链接了！

常见问题：

• 如果上传失败：请返回第四步，逐字检查 PicGo 里的配置是否和 MinIO 里的完全一致，特别是 AccessKey， SecretKey， Bucket， EndPoint 和 Area (Region)。
• 如果图片链接打不开：请返回第三步，确认存储桶的 Access Policy 是否已经设置为 ​public​。

Enjoy！你现在已经拥有一个完全由自己掌控的私有图床了！

‍