---
title: Zipline
type: entity
tags: [docker, image, zipline, n8n]
date: 2025-12-29
---

# Zipline

## Aliases
- Zipline
- Zipline Image Host
- diced/zipline

## Definition
Zipline 是一个开源的自托管图床应用，提供图片上传 UI 和 REST API，支持 S3 兼容存储后端。作为 [[n8n]] 工作流集成的前置条件，Zipline 充当自动化图片上传的中间层。

## Core Characteristics

| 特性 | 说明 |
|------|------|
| 类型 | 图片托管 / 图床服务 |
| 前端 | Web UI（Dashboard） |
| API | RESTful JSON API |
| 存储后端 | S3 兼容（MinIO/AWS S3/Cloudflare R2） |
| 数据库 | PostgreSQL / SQLite |
| 官方镜像 | `ghcr.io/diced/zipline:latest` |
| 暴露端口 | 3333（内部 3000） |
| 工作流集成 | n8n |

## Architecture

```
[n8n Workflow] --API--> [Zipline] --S3 API--> [MinIO]
     ^                    |
     |                    v
     |              [PostgreSQL]
     |               (metadata)
     |
[User Browser] --Web UI--> [Zipline Dashboard]
```

## Key Environment Variables

```yaml
environment:
  DATABASE_URL: postgres://zipline:***@postgres:5432/zipline
  CORE_SECRET: 22d5d3159d5ed51743bc8c8ef007f836
  ZPLINE_ADMIN_USERNAME: admin
  ZPLINE_ADMIN_PASSWORD: Abcd_1234
  STORAGE_ENGINE: s3
  S3_BUCKET: zipline-bucket
  S3_ENDPOINT: http://minio:9000
  S3_ACCESS_KEY: admin
  S3_SECRET_KEY: Abcd_1234
  S3_REGION: us-east-1
  S3_FORCE_PATH_STYLE: "true"
  PORT: 3000
```

## Access Points

| URL | 说明 |
|-----|------|
| http://192.168.3.17:3333 | Zipline Web UI |
| http://192.168.3.17:3333/dashboard | Dashboard（登录后） |
| http://192.168.3.17:9001 | MinIO Console |

## Docker Dependencies

```yaml
zipline:
  image: ghcr.io/diced/zipline:latest
  depends_on:
    minio:
      condition: service_healthy
    postgres:
      condition: service_healthy
  # 健康检查确保依赖服务就绪后才启动
```

## n8n Integration

Zipline 提供完整的 REST API 供 [[n8n]] 调用：

```bash
# 上传图片（n8n HTTP Request 节点）
POST http://192.168.3.17:3333/api/upload
Headers:
  Content-Type: multipart/form-data
  X-API-Key: <your-api-token>
```

## Features

- [x] 前端图片上传 Web UI
- [x] API Token 认证
- [x] S3 兼容存储后端
- [x] [[n8n]] 工作流集成
- [x] 图片 URL 直接访问（Public Bucket）
- [x] 上传规则配置
- [x] 返回 URL 配置

## Connections
- [[MinIO]] ← stores files ← [[Zipline]]
- [[PostgreSQL]] ← stores metadata ← [[Zipline]]
- [[n8n]] ← calls ← [[Zipline API]]
- [[群晖 NAS]] ← hosts ← [[Zipline]]
- [[Docker堆栈]] ← part of ← [[Zipline]]

## Related Concepts
- [[图床]]
- [[S3-兼容对象存储]]
- [[Docker堆栈]]
- [[逻辑备份]]
- [[数据一致性]]