stonith404/pingvin-share

Pingvin Share

概述

Pingvin Share 是一个自托管的文件共享平台，旨在作为 WeTransfer 的替代方案，提供安全、可控的文件共享服务。用户可通过自部署方式搭建，满足个人或组织对文件传输的私密性和自定义需求。

核心功能与特性

• 链接分享文件：通过生成唯一链接实现文件共享
• 无限制文件大小：仅受服务器磁盘空间限制
• 设置分享过期日期：自定义文件分享的有效期限
• 安全访问控制：支持设置访问次数限制和密码保护
• 邮件接收者通知：可直接通过邮件通知接收者
• 反向分享：允许接收者上传文件至分享链接
• 多种认证方式：支持 OIDC 和 LDAP 认证集成
• 安全扫描集成：与 ClamAV 联动进行文件安全扫描

使用场景与适用范围

• 个人用户：需要临时分享大文件且希望控制访问权限的场景
• 企业/团队：内部文件协作、客户间安全文件传输，避免依赖第三方服务
• 安全敏感场景：对文件访问有严格控制需求（如密码保护、访问次数限制）的组织
• 自托管环境：需完全掌控数据存储和传输过程，避免数据泄露风险的场景

安装与使用指南

推荐安装方式：Docker 部署

前提条件

• 已安装 Docker 和 Docker Compose
• 服务器具备足够磁盘空间（根据预期文件存储需求）

部署步骤

1. 获取 Docker Compose 配置文件
   从官方仓库下载 docker-compose.yml 文件：

   bash
   curl -O https://raw.githubusercontent.com/stonith404/pingvin-share/main/docker-compose.yml
   

2. 启动服务
   执行以下命令启动容器（后台运行）：

   bash
   docker compose up -d
   

3. 访问服务
   服务启动后，通过 http://localhost:3000 访问 Pingvin Share 平台。

部署方案示例

Docker Compose 配置示例

以下为基础 docker-compose.yml 配置（具体以官方最新版本为准）：

yaml
version: '3'
services:
  pingvin-share:
    image: stonith404/pingvin-share:latest
    container_name: pingvin-share
    ports:
      - "3000:3000"  # 宿主机端口:容器端口
    volumes:
      - ./data:/app/data  # 数据持久化目录
      - ./uploads:/app/uploads  # 文件上传目录
    environment:
      - NODE_ENV=production
      - TZ=Asia/Shanghai  # 设置时区
    restart: unless-stopped

Docker Run 命令示例

如需直接使用 docker run 启动（不推荐用于生产环境，建议使用 Docker Compose 管理）：

bash
docker run -d \
  --name pingvin-share \
  -p 3000:3000 \
  -v ./data:/app/data \
  -v ./uploads:/app/uploads \
  -e NODE_ENV=production \
  -e TZ=Asia/Shanghai \
  --restart unless-stopped \
  stonith404/pingvin-share:latest

高级配置与扩展

对于 OIDC/LDAP 认证配置、ClamAV 安全扫描集成、反向代理设置等高级功能，可参考官方完整文档：
https://stonith404.github.io/pingvin-share

资源与参考

• 官方演示：[***]
• 功能介绍视频：DB Tech 评测
• 贡献指南：支持代码贡献或翻译，详见 https://stonith404.github.io/pingvin-share/help-out/contribute