---
id: Zipline
title: "Zipline"
type: entity
tags: [image-hosting, self-hosted, docker, api]
sources: []
last_updated: 2026-04-15
---

## Overview
Zipline 是一个自托管的图片托管服务，提供前端上传 UI 和 REST API，可与 n8n 等工作流工具集成，实现图片自动化上传和管理。在 Synology NAS 上与 MinIO 配合使用。

## Key Characteristics
- 提供图片上传 Dashboard（默认端口 3333）和 REST API
- 支持多种存储引擎（S3/MinIO/Cloudflare R2/Backblaze B2）
- 通过 CORE_SECRET 环境变量配置加密密钥
- 支持生成 API Token 供外部工具调用
- 可设置上传规则和返回 URL 配置

## Architecture
- Zipline → MinIO（S3 存储）→ NAS 持久化存储
- 元数据（PostgreSQL）独立于文件实体（MinIO），备份方案必须保持两者时间点一致
- 与 n8n 集成：通过 API Token 调用 Zipline 上传接口

## Related Concepts
- [[MinIO]]：Zipline 的 S3 存储后端
- [[n8n]]：通过 Zipline API 集成到自动化工作流
- [[PostgreSQL]]：Zipline 元数据存储