OpenSource-Hub
Z

Zipline

3.1k stars·文件管理·已提供 SHA-256 校验码,下载后可自行核对文件完整性

新一代自托管文件上传服务器,替代 ShareX,支持 Docker 一键部署,功能全面且可定制。

智能下载

前往项目主页

该项目暂未提供安装包,请直接访问源代码仓库

自己搭一个比 ShareX 更好用的文件上传站,Docker 一把梭。

核心功能

  • 支持 Docker 快速部署,几分钟搞定
  • 文件、图片、视频、短链接一应俱全
  • 文件夹和标签管理,上传不再乱
  • OAuth2、2FA、通行密钥多重安全防护
  • 图片压缩和视频缩略图自动生成

避坑指南

  • Zipline 需要 CPU 支持 AVX 指令集,老旧 CPU 无法运行;2. 必须设置 CORE_SECRET 环境变量,否则服务无法启动;3. 默认使用 PostgreSQL,需提前准备数据库或通过 Docker 自动创建;4. 生产环境请配置反向代理和 HTTPS;5. 文件上传默认存储在本地,若需 S3 请额外配置认证信息。

适用场景

  • 个人搭建私有图床或文件分享站
  • 团队内部文件协作上传与管理
  • 替代 ShareX 服务端,完全掌控数据
  • 为 Discord 或网页嵌入提供稳定的上传后端

详细介绍

Zipline 是一款基于 Node.js 和 PostgreSQL 构建的现代自托管文件上传服务器,旨在成为 ShareX 的下一代替代品。它支持文件上传、文件夹管理、标签分类、URL 缩短、嵌入生成、Discord 和 HTTP Webhook、OAuth2 认证、两步验证、通行密钥、密码保护、图片压缩、视频缩略图、断点续传、邀请注册、存储配额、自定义主题以及完整的 API 接口。通过 Docker 可快速部署,支持本地存储或 S3 兼容对象存储,并内置从 v3 导入数据的功能。无论是个人分享还是团队协作,Zipline 都能提供安全可控的私有文件上传体验,完全摆脱对公共服务的依赖。

常见问题与排障 (2)

故障排除
为什么我的TOTP双因素认证码在登录Zipline时有时会被拒绝?

Zipline 4.6之前的版本具有严格的TOTP验证,无时间漂移容差。如果服务器时钟向前推进,在30秒窗口期临近结束时生成的验证码可能会被拒绝。升级至Zipline 4.6或更高版本后,增加了30秒(±30秒)的epochTolerance,允许接受前一个或后一个窗口期的验证码,从而解决了该问题。

来源 Issue #1081
故障排除
为什么文件名中包含空格会导致 Zipline 中出现 S3 NoSuchKey 错误以及缩略图/重命名失败?

此错误已在同时修复了问题#1069的补丁中得到解决。请将Zipline更新至高于4.5.3(受影响版本)的版本以解决此问题。该修复确保在S3兼容存储中进行分块上传、缩略图生成和重命名操作时,包含空格的文件名能被正确处理。

来源 Issue #1070

标签

file-uploadsharexself-hosteddockernodejsimage-hostingurl-shortener

快速上手

1

下载安装包

点击上方按钮下载对应系统的安装包

2

安装软件

双击下载的安装程序,按提示完成安装

3

步骤1:创建项目目录并编写 docker-compose.yml 文件(参考官方文档)

4

步骤2:使用 openssl 生成随机密码和 CORE_SECRET,写入 .env 文件

5

步骤3:运行 docker compose up -d 启动 PostgreSQL 和 Zipline 容器

安装指引
  1. 步骤1:创建项目目录并编写 docker-compose.yml 文件(参考官方文档)
  2. 步骤2:使用 openssl 生成随机密码和 CORE_SECRET,写入 .env 文件
  3. 步骤3:运行 docker compose up -d 启动 PostgreSQL 和 Zipline 容器
文件完整性

暂未获取到校验码

该项目暂未在 GitHub Release 页面提供 SHA-256 校验码

SHA256 校验码

暂无校验码

建议从 GitHub Releases 页面直接下载,并自行核对文件完整性

本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件,未做任何修改。你可以通过 GitHub Releases 页面自行验证。

运维指引

卸载说明

停止容器并删除卷:docker compose down -v,然后删除项目目录即可完全卸载。注意:uploads 目录中的文件也会被删除,请提前备份。

无额外依赖

下载后即可直接使用,无需安装其他运行环境

项目信息
开源协议MIT
最后更新2026-06-26 03:30:10
GitHub 仓库官方网站

遇到问题?查看下方 FAQ

2 FAQs

相似推荐