29 lines
1.0 KiB
Markdown
29 lines
1.0 KiB
Markdown
---
|
||
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 元数据存储
|