2.7 KiB
2.7 KiB
title, type, tags, date
| title | type | tags | date | ||||
|---|---|---|---|---|---|---|---|
| Zipline | entity |
|
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
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
zipline:
image: ghcr.io/diced/zipline:latest
depends_on:
minio:
condition: service_healthy
postgres:
condition: service_healthy
# 健康检查确保依赖服务就绪后才启动
n8n Integration
Zipline 提供完整的 REST API 供 n8n 调用：
# 上传图片（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
- 前端图片上传 Web UI
- API Token 认证
- S3 兼容存储后端
- n8n 工作流集成
- 图片 URL 直接访问（Public Bucket）
- 上传规则配置
- 返回 URL 配置
Connections
- MinIO ← stores files ← Zipline
- PostgreSQL ← stores metadata ← Zipline
- n8n ← calls ← Zipline API
- 群晖 NAS ← hosts ← Zipline
- Docker堆栈 ← part of ← Zipline