diced/zipline

Zipline：功能丰富的自建文件上传服务器

镜像概述

Zipline 是一个基于 Next.js 和 React 构建的 ShareX/文件上传服务器，旨在提供简单易用、功能全面且部署便捷的文件分享解决方案。它支持多种文件类型上传、URL 缩短、权限管理、第三方认证等功能，适合个人、团队或小型组织搭建私有文件上传与分享服务。

Docker 标签

• trunk：每次代码提交后更新
• latest：每次标签/版本发布时更新

核心功能与特性

• 高度可配置：支持自定义多种上传规则和系统行为
• 性能高效：优化的上传和访问速度
• 技术栈先进：基于 Next.js 和 React 构建，前端体验流畅
• 安全上传：支持令牌保护上传、密码保护上传和双因素认证（TOTP）
• 多媒体支持：图片上传与压缩、自动视频缩略图生成、多种文件格式预览
• 多样化上传类型：支持图片、文本、URL 缩短，以及代码高亮显示
• 灵活的 URL 格式：支持 UUID、日期、随机字母数字、原始文件名、零宽空格、Gfycat 风格（动物+形容词组合）等格式
• 社交集成：*** 嵌入（OG 元数据）、自定义 *** Webhook 通知
• 用户管理：OAuth2 注册（*** 和 GitHub）、用户邀请功能
• 高级文件控制：文件分块上传（支持大文件）、按查看次数自动删除文件
• 便捷部署：支持 Docker 一键部署，配置简单

使用场景

• 个人私有文件分享与备份
• 团队内部文件协作与传输
• 配合 ShareX（Windows）或 Flameshot（Linux/macOS）实现截图一键上传
• 搭建私有 URL 缩短服务
• 代码片段分享（支持语法高亮）

部署与使用指南

前提条件

• Docker 与 docker compose（推荐 Docker 部署方式）
• 或 Node.js（v14+）与 Yarn（从源码构建时需要）

Docker 安装与运行

此步骤需要 https://docs.docker.com/get-docker/ 和 https://docs.docker.com/compose/install/%E3%80%82

shell
# 克隆仓库
git clone https://github.com/diced/zipline
cd zipline

# 启动服务（后台运行）
docker compose up -d

部署后配置

部署完成后，请编辑 docker-compose.yml 文件，找到 SECRET=changethis 行，将 changethis 替换为随机字符串。可通过密码管理器生成或手动创建高强度随机字符串。

从源码构建与运行

此步骤需要 https://nodejs.org 和 https://yarnpkg.com/%EF%BC%88%E4%B8%8D%E6%8E%A8%E8%8D%90%E4%BD%BF%E7%94%A8 npm，可能导致构建问题）。

构建前需配置环境变量，至少需设置 CORE_SECRET（随机字符串）和 CORE_DATABASE_URL（数据库连接 URL）。

shell
# 克隆仓库
git clone https://github.com/diced/zipline
cd zipline

# 安装依赖
yarn install

# 构建项目
yarn build

# 启动服务
yarn start

NGINX 反向代理配置

如需通过域名访问，可配置 NGINX 反向代理（需安装 https://nginx.org/%EF%BC%89%EF%BC%9A

nginx
server {
  listen 80 default_server;
  client_max_body_size 100M;  # 根据需求调整最大上传大小
  server_name <你的域名（可选）>;
  
  location / {
    proxy_pass http://localhost:3000;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
  }
}

客户端配置

ShareX（Windows）

1. 访问 Zipline 网站，点击右上角用户名，选择“管理账户”
2. 滚动至“ShareX 配置”，选择所需配置并下载 .sxcu 文件
3. 导入该文件到 ShareX 即可使用

详细说明见 https://zipl.vercel.app/docs/guides/uploaders/sharex%E3%80%82

Flameshot（Linux/macOS）

需安装 Flameshot、https://stedolan.github.io/jq/ 和剪贴板工具（Linux：xsel 或 wl-clipboard；macOS：系统自带 pbcopy）。

基础脚本（替换 $TOKEN 和 $HOST 为实际值）

shell
# 捕获截图并保存（Linux示例）
DATE=$(date '+%h_%Y_%d_%I_%m_%S.png');
flameshot gui -r > ~/Pictures/$DATE;

# 上传并复制链接到剪贴板
curl -H "Content-Type: multipart/form-data" -H "authorization: $TOKEN" -F file=@$DATE $HOST/api/upload | jq -r '.files[0]' | xsel -ib

特殊配置

• Wayland 用户：需安装 wl-clipboard，并将脚本中的 xsel -ib 替换为 wl-copy，可在脚本开头添加 export XDG_CURRENT_DESKTOP=sway（适用于 wlroots compositor）。
• macOS 用户：将 xsel -ib 替换为 pbcopy。

文档与支持

• 完整文档：https://zipl.vercel.app
• 文档源码：https://github.com/diced/zipline-docs
• 社区支持：*** 服务器