MinIO 常被拿来做本地或私有对象存储。用它做图片服务时，资料最好按客户端、桶权限、图片处理和访问链路拆开，不要把所有命令都堆到一页。
Java 客户端
第一类是 Java 客户端资料。
可以记录：
- 上传文件。
- 下载文件。
- 桶操作。
- 生成签名 URL。
- 设置 content type。
- 处理文件名。
- 异常转换。
Java 客户端代码要注意超时、错误处理和日志脱敏。真实 endpoint、accessKey、secretKey 不应该写进公开文章。
mc 客户端和桶权限
第二类是 mc 客户端和桶权限。
常见内容包括：
- 配置 alias。
- 查看 bucket。
- 上传下载。
- 匿名访问策略。
- 只读权限。
- 公私有桶边界。
桶权限要特别谨慎。图片公开访问和管理权限是两回事，不要为了访问方便把管理权限也放开。
图片服务器和处理工具
第三类是图片处理。
可以拆成：
- 图片压缩。
- 裁剪。
- 缩放。
- 格式转换。
- 图片 URL 规则。
- 替代图片服务。
- 媒体库迁移。
如果图片要给网站长期使用，还要记录原图、压缩图、缩略图之间的关系，避免后续清理时误删。
Nginx 访问链路
MinIO 图片服务常常会放在 Nginx 后面。
这时要关注：
- 域名。
- HTTPS。
- 缓存头。
- 图片 MIME。
- 上传大小限制。
- 反向代理超时。
- 真实客户端 IP。
图片打不开时，不要只看 MinIO，也要看 Nginx、域名解析、HTTPS 证书和浏览器缓存。
维护建议
MinIO 图片服务可以按这几页维护：
- Java 客户端工具。
- mc 客户端与桶权限。
- 图片服务器与处理工具。
- Nginx 和访问链路。
公开文档只保留方法和占位；真实账号、密钥、服务器地址和私有路径放本机私有配置。这样既方便复用，也不容易把敏感信息误发出去。
正文完
