---
title: "MinIO + Zipline 自托管图床应用安装教程"
type: source
tags: [minio, zipline, docker, synology, nas, image-hosting]
date: 2025-03-30
---

## Source File
- [[raw/Home Office/MinIO + Zipline 自托管图床应用安装教程.md]]

## Summary
- 核心主题：在 Synology NAS 上通过 Docker 部署 MinIO 对象存储 + Zipline 图片托管服务，替代第三方图床
- 问题域：自托管图片存储方案，确保数据主权、避免第三方图床限速或关停，结合 n8n 实现自动化工作流
- 方法/机制：docker-compose 编排 MinIO（存储引擎）+ PostgreSQL（元数据）+ Zipline（上传 UI 和 API），通过 mc 命令行设置公开 Bucket
- 结论/价值：完整自托管图床方案，存储性能仅受 NAS 硬盘/SSD 限制，可与 n8n 联动实现自动化图片处理

## Key Claims
- MinIO 存储性能仅受 NAS 硬盘/SSD 限制，Zipline 仅处理 metadata
- Zipline Bucket 必须设置为 public read 才能直接访问图片，使用 mc anonymous set public 命令
- Core_SECRET（随机字符串）和 MINIO_ROOT_PASSWORD 是必需的环境变量
- 数据库与 MinIO 数据必须保持时间点一致，pg_dump 热备份 + Hyper Backup 增量归档是推荐方案
- Synology DSM 必须安装 Container Manager（DSM 7.2+）或 Docker（DSM 7.1 及更早）
- Docker 网络默认网桥 IP 通常为 172.18.0.1，宿主机代理端口 10808 需对 Docker 网桥开放
- 容器内 SOCKS5 代理测试：curl --socks5 172.18.0.1:10808 https://ifconfig.me

## Key Concepts
- [[MinIO]]：兼容 S3 协议的对象存储引擎，部署在 NAS 提供高性价比私有云存储
- [[Zipline]]：自托管图片托管服务，提供上传 UI + REST API，n8n 可通过 API 集成
- [[S3协议]]：Amazon S3 兼容接口，MinIO 支持，S3_BUCKET/S3_ENDPOINT/S3_ACCESS_KEY/S3_SECRET_KEY 为四个核心配置
- [[Docker Compose]]：多容器编排，定义 minio/postgres/zipline 三个服务及其依赖关系
- [[PostgreSQL备份]]：pg_dump 逻辑热备份，备份目录 /volume1/docker/zipline-stack/backups
- [[Synology Hyper Backup]]：Synology 备份套件，可备份数据库 SQL 文件和 MinIO 数据目录

## Key Entities
- [[Synology NAS]]：硬件平台，IP 192.168.3.17，Container Manager 提供 Docker 能力
- [[shenwei]]：部署者
- [[n8n]]：通过 Zipline API 触发图片上传的自动化工作流编排工具

## Connections
- [[MinIO-Zipline自托管图床]] ← 存储层 → [[Synology NAS]]
- [[MinIO-Zipline自托管图床]] ← API集成 → [[n8n]]（Workflow 自动化上传图片）
- [[MinIO-Zipline自托管图床]] ← 元数据存储 → [[PostgreSQL]]

## Contradictions
- Docker Socket 挂载存在安全风险（容器可获宿主机 root 权限），但本方案通过 docker exec 操作而非 Socket 挂载规避

## Related Wiki Pages
- [[Synology NAS]]：NAS 平台本身，Docker 和 Container Manager 是 Synology 的核心能力
- [[n8n]]：n8n Workflow 自动化，可通过 Zipline API 触发图片上传
- [[家庭监控方案]]：同样基于 Synology Docker 栈部署，是另一个自托管服务案例