axeloz/filesharing

文件共享 (Files Sharing)

FILES SHARING 版本 2 已发布

概述

这是一个基于Laravel 10.9的PHP应用，功能类似Wetransfer，可部署在您自己的服务器上。它无需任何数据库系统，通过存储文件夹中的JSON文件实现数据存储。应用支持多语言，目前已包含英语、法语和韩语翻译，欢迎参与翻译工作。

每个文件包提供两个链接：

• 文件包预览链接：发送给接收者，对方可查看文件包内容。例如：[***]。接收者可查看所有文件并将文件包下载为ZIP压缩包。
• 文件包下载链接：发送给接收者，对方可直接下载所有文件（无预览）。例如：[***]。

每个链接均包含授权码，预览和下载链接使用相同的授权码。应用还内置Laravel Artisan命令作为后台任务，可定期（每5分钟）物理删除存储盘中的过期文件包。

核心功能

• 上传者访问权限：基于IP或用户名/密码控制
• 文件包设置：标题、描述、过期日期、最大下载次数、密码保护等
• 支持拖放或浏览文件系统上传一个或多个文件
• 支持日后继续向文件包添加文件
• 带文件包内容预览的共享链接
• 下载速率限制
• 支持将整个文件包下载为ZIP压缩包（需密码时受密码保护）
• 直接下载链接（无需预览文件包内容）
• 后台自动清理过期文件包的垃圾回收器
• 多语言支持（英语、韩语、法语）
• 安装简单，无需数据库
• 通过令牌、授权码和非公开访问文件确保安全

使用场景

适用于个人或企业在自有服务器上搭建安全可控的文件共享服务，用于临时或长期文件传输，尤其适合需要控制数据存储位置、限制访问权限或避免第三方服务依赖的场景。

环境要求

基础依赖与Laravel一致：

• PHP >= 8.1
• Ctype PHP扩展
• OpenSSL PHP扩展
• PDO PHP扩展
• Mbstring PHP扩展
• Tokenizer PHP扩展
• XML PHP扩展

额外依赖：

• JSON PHP扩展（PHP 5.2+已包含）
• ZipArchive PHP扩展（PHP 5.3+已包含）
• SQLite

前端技术栈：

• [***]
• [***]
• https://tailwindcss.com/
• [***]
• [***]
• [***]

安装方法

Docker部署

可通过Docker安装FileSharing，镜像地址：https://hub.docker.com/r/axeloz/filesharing

docker run命令示例：

bash
docker run -d \
-p 8080:80 \
-v <本地路径>:/app/storage/content \
--name filesharing \
-e APP_NAME="FileSharing" \
-e APP_URL="<您的URL>" \
-e ASSET_URL="<您的资源URL>" \
-e UPLOAD_MAX_FILESIZE="1G" \
-e APP_TIMEZONE="Europe/Paris" \
-e UPLOAD_PREVENT_DUPLICATES=true \
-e HASH_MAX_FILESIZE="1G" \
-e UPLOAD_MAX_FILES=100 \
-e LIMIT_DOWNLOAD_RATE="100K" \
docker.xuanyuan.run/axeloz/filesharing:latest

• -v：将本地路径挂载到容器内，用于持久化存储文件
• -p：端口映射，将容器80端口映射到本地8080端口
• -e：设置环境变量，配置应用参数

Nginx反向代理配置示例：

nginx
server {
    server_name filesharing.box.webinno.fr;
    charset utf-8;

    location / {
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_pass http://localhost:8080;
    }

    listen [::]:443 ssl http2;
    listen 443 ssl http2;
    ssl_certificate [...]
    ssl_certificate_key [...]
}

docker-compose配置示例：

yaml
version: '3'
services:
  app:
    image: docker.xuanyuan.run/axeloz/filesharing:latest
    environment:
      UPLOAD_MAX_FILESIZE: "1G"
      UPLOAD_MAX_FILES: "100"
      UPLOAD_LIMIT_IPS: "127.0.0.1"
      UPLOAD_PREVENT_DUPLICATES: true
      HASH_MAX_FILESIZE: "1G"
      LIMIT_DOWNLOAD_RATE: "1M"
    volumes:
      - files_v:/app/storage/content
    ports:
      - 8080:80

volumes:
  files_v:
    driver: local

独立部署（Standalone）

1. 配置域名（如files.yourdomain.com）
2. 将源码克隆或下载到web根目录
3. 配置Web服务器，将域名指向./public文件夹
4. 运行composer install
5. 运行yarn --production（或npm install --production）
6. 运行yarn build（或npm run build）
7. 确保PHP进程对./storage文件夹有写权限
8. 生成Laravel密钥：php artisan key:generate
9. 复制环境变量模板：cp .env.example .env并编辑.env文件
10. （可选）创建用户：php artisan fs:user:create
11. 启动Laravel调度器（用于删除过期文件包），添加 cron 任务：* * * * * /usr/bin/php /项目路径/artisan schedule:run >> /dev/null 2>&1
12. （可选）手动清理过期文件包：php artisan fs:bundle:purge

完成后，通过浏览器访问域名即可使用。

配置说明

复制.env.example为.env文件，编辑以下配置项：

访问控制

可通过以下方式限制上传功能访问：

• 指定允许上传的IP列表
• 创建用户名/密码凭证
• 两种方式可混合使用

警告：若UPLOAD_LIMIT_IPS为空且未创建用户，上传功能将对公众开放

已知问题

使用Nginx时，可能需要额外配置以增加上传文件大小限制，具体参考Nginx文档中的client_max_body_size配置项。

许可证

GPLv3

详细许可证信息：https://choosealicense.com/licenses/gpl-3.0/