绿联部署S3（minio）

在绿联 NAS 上搭建兼容 S3 的对象存储
方案一 使用 MinIO 搭建私有 S3（推荐）

• 准备
  
  • 在绿联 NAS 的应用中心安装并打开 Docker（UGOS 或 UGOS Pro 均可）。
  • 规划数据目录（如：/volume1/docker/minio/data）用于持久化对象数据。
    
• 部署 MinIO（Docker Compose 示例）
  
  • 在 Docker 的“项目/Compose”中新建项目，粘贴以下配置，按需修改端口与路径：
    
    1. version: "3.8"
       
    2. services:
       
    3.   minio:
       
    4.     image: minio/minio:latest
       
    5.     container_name: minio
       
    6.     ports:
       
    7.       - "9000:9000"   # S3 API
       
    8.       - "9090:9090"   # 控制台
       
    9.     volumes:
       
    10.       - /volume1/docker/minio/data:/data
        
    11.     environment:
        
    12.       MINIO_ROOT_USER: 用户名
        
    13.       MINIO_ROOT_PASSWORD: 您的密码
        
    14.     command: server /data --console-address ":9090"
        
    15.     restart: unless-stopped
        

    复制代码
    
    
  • 启动后在浏览器访问 ** http://NAS_IP:9090** ，使用上一步设置的账号登录控制台。
    
• 
  
  创建密钥与存储桶
  
  • 在控制台创建 Access Key/Secret Key，并新建 Bucket（注意：Bucket 名称需全局唯一）。
    
• 客户端验证（mc）
  
  • 安装 mc（MinIO 客户端）并添加别名：
    
    1. mc alias set myminio http://NAS_IP:9000 <AccessKey> <SecretKey>
       
    2. mc ls myminio
       
    3. mc mb myminio/mybucket
       
    4. mc cp localfile.txt myminio/mybucket/
       

    复制代码
    
    
• 说明
  
  • MinIO 提供与 AWS S3 API 兼容的对象存储，适合在 NAS 上自建私有对象存储服务，用于图片、视频、备份等场景。
    

在绿联 NAS 上安装 mc（MinIO Client）的实用做法
方法一 在绿联 NAS 上直接安装 mc 二进制（建议用此方法）

适用前提：你的绿联 NAS（如 UGOS Pro）提供 Debian 12 的终端环境（可通过 SSH 登录）。
操作步骤：

通过 SSH 登录 NAS（使用管理员账户）。
下载 mc（Linux amd64）并赋予可执行权限：
curl -O https://dl.min.io/client/mc/release/linux-amd64/mc
chmod +x mc
移动到系统路径（二选一）：
sudo mv mc /usr/local/bin/
或
sudo mv mc /usr/bin/
验证安装：
mc --version
配置别名并测试连接（将 your-minio:9000 替换为你的 MinIO API 地址，AK/SK 替换为实际密钥）：
mc alias set myminio http://your-minio:9000 AK SK
mc ls myminio
说明：上述下载、赋权、移动与配置命令为 MinIO 官方客户端的标准用法，适用于 Linux 环境；绿联 UGOS Pro 基于 Debian 12，可直接执行这些命令。

方法二 在 Docker 容器中运行 mc（不依赖 NAS 系统）

适用前提：NAS 已安装 Docker（绿联应用中心可安装 Docker）。
操作步骤：

在任意目录下创建临时 compose 文件（如 docker-compose-mc.yml）：
version: "3.8"
services:
mc:
image: minio/mc:latest
container_name: mc
stdin_open: true
tty: true
command: tail -f /dev/null
启动容器：
docker compose -f docker-compose-mc.yml up -d
进入容器并配置别名（注意把 your-minio:9000 与 AK/SK 替换为实际值）：
docker exec -it mc mc alias set myminio http://your-minio:9000 AK SK
测试：
docker exec -it mc mc ls myminio
说明：该方法通过官方 minio/mc 镜像运行一个长期存活的容器，在容器内使用 mc；适合无法在宿主系统直接安装二进制或希望与 Docker 环境隔离的场景。

常用 mc 命令与下一步

常用命令（配置完成后可直接使用）：
mc ls myminio                    # 列出存储桶
mc mb myminio/mybucket          # 创建存储桶
mc cp local.txt myminio/mybucket/ # 上传文件
mc mirror /local/dir myminio/bucket  # 目录同步
mc admin info myminio           # 查看 MinIO 服务状态
下一步建议：用 mc 为应用创建最小权限的 服务账号（而非长期使用 root），例如先创建用户并附加策略，再生成 Access Key/Secret Key，在思源笔记或其他应用中使用这些密钥进行 S3 对接。

排错要点

若出现 “command not found: mc”，请确认已将 mc 放入 /usr/local/bin 或 /usr/bin，或使用方法二在容器内执行。
连接失败请核对 MinIO 的 API 地址（端口 9000）、AK/SK、以及网络连通性（容器内外网络模式、防火墙/安全组）。
若你在 NAS 上用 Docker 自建了 MinIO，常用端口为 9000（API）/9001（控制台），请确保端口映射正确并可访问