wardy784/erugo

Erugo

!GitHub Repo stars !GitHub Issues or Pull Requests !GitHub Issues or Pull Requests !GitHub commits since latest release

![*** Banner 2]([***]

Erugo是一款功能强大的自托管文件共享平台，采用PHP和Laravel构建后端，Vue.js构建前端。它通过优雅的用户界面提供安全、可定制的文件传输功能，让你完全控制自己的数据，同时为发送者和接收者提供无缝体验。

支持Erugo开发

如果你想支持Erugo的开发，欢迎考虑为项目***。你的支持将帮助我维护和改进软件。

![]([]

快速开始

你可以使用下面的示例docker-compose.yaml在容器中运行Erugo。

yaml
services:
  app:
    image: wardy784/erugo:latest
    restart: unless-stopped
    volumes:
      - ./erugo-storage:/var/www/html/storage # 使用专用文件夹
    ports:
      - "9998:80"

上述docker-compose.yml提供了一个基本配置起点，将使用默认的sqlite数据库启动Erugo。

sh
docker compose up -d

界面截图

!https://github.com/ErugoOSS/Erugo/raw/main/.github/images/screenshots/main-screen-with-files.png

简洁现代的上传界面，支持文件和文件夹

!https://github.com/ErugoOSS/Erugo/raw/main/.github/images/screenshots/main-screen-with-password-form.png

可选择为分享设置密码保护

!https://github.com/ErugoOSS/Erugo/raw/main/.github/images/screenshots/main-screen-with-reverse-share-req.png

通过一次性反向分享令牌邀请访客上传文件到你的账户

!https://github.com/ErugoOSS/Erugo/raw/main/.github/images/screenshots/login-screen-with-external-providers.png

支持外部认证提供商的登录界面

演示

你可以在演示站点查看示例分享：demo.erugo.app/shares/tight-silence-sweet-sea。演示站点禁用了上传功能，但你可以体验接收者视图并下载示例文件。

由BoxToPlay赞助

BoxToPlay提供价格具有竞争力的优质VPS和游戏服务器。他们慷慨地提供了服务器资源支持Erugo的基础设施，对此我深表感谢。访问boxtoplay.com了解他们的服务。

相关视频

• "Erugo - 自托管文件共享平台" by DB Tech
• "告别WeTransfer！使用Docker自托管Erugo实现安全文件共享" by KeepItTechie

社区内容

• 使用Docker安装Erugo（法语）
• 如何在服务器上安装Erugo：安全文件共享的分步指南

核心功能

• 轻松部署：通过提供的docker-compose文件轻松在Docker上部署
• 零配置：开箱即有合理默认设置，可通过Web界面轻松自定义
• 人性化分享链接：易读的URL格式，如you.com/shares/quiet-cloud-shrill-thunder
• 维护文件夹结构：上传文件夹时，文件夹结构在分享链接和后续下载中保持不变
• 反向分享：用户可通过一次性反向分享令牌邀请访客上传文件到自己的账户
• 安全访问控制：仅授权用户可创建分享，分享可公开访问或设置密码保护
• 控制过期时间：上传时可配置分享过期时间，管理员可设置分享的最大过期时间
• 灵活配置：内置主题和品牌选项，可通过Web界面安装自定义主题，轻松白标化Erugo，设置最大上传大小、最大过期时间等
• 自动清理：分享在配置时间后自动删除
• 邮件支持：完整的邮件支持，用于通知、密码重置等
• 用户管理：通过Web界面邀请、编辑和移除用户
• 交互式设置：首次加载Web界面时的用户友好初始配置
• 现代界面：简洁直观的Web用户界面
• 开源：MIT许可，支持白标化
• 多语言支持：完全可翻译，已支持多种语言

星级历史

给这个仓库点个星，以便跟踪发布和更新。星级也是激励我继续添加功能的动力！

![Star History Chart]([***]

使用Erugo

创建分享

1. 登录Web界面
2. 选择要上传的文件
3. 将生成的链接分享给接收者

下载文件

接收者只需：

1. 点击分享链接
2. 通过Web界面下载文件

管理你的分享

1. 登录Web界面
2. 点击右下角的齿轮图标
3. 点击"我的分享"选项卡

你可以延长分享过期时间、使分享过期、设置最大下载次数等。

自定义

作为开源项目，Erugo可根据你的需求定制：

• 自定义UI以匹配你的品牌
• 修改URL结构和认证方法
• 通过代码修改扩展功能

多语言支持

目前支持以下语言：

• 英语
• 法语（感谢https://github.com/zarevskaya%E5%92%8Chttps://github.com/thibdevan%EF%BC%89
• 德语
• 意大利语
• 荷兰语
• 葡萄牙语（感谢Distermaer）

Erugo完全可翻译。如果你想贡献翻译，请加入我们的***服务器并在通用频道留言。

开发

Erugo是一个Laravel应用，使用Laravel Sail运行开发环境。

运行以下命令启动服务器、运行迁移并以开发模式启动vite。

生成数据库

sh
touch database/database.sqlite
chmod 666 database/database.sqlite

安装Laravel依赖

sh
composer install
npm install
sail up -d

生成.env文件

sh
cp .env.example .env
chmod 666 .env
sail artisan key:generate
sail artisan jwt:secret

运行开发服务器

sh
sail artisan migrate
sail artisan db:seed
npm run dev

自行构建

要自行构建Docker镜像，运行以下命令。

sh
docker build -t erugo:local -f docker/alpine/Dockerfile .

如果你想将镜像推送到Docker Hub，运行以下命令。你需要有Docker Hub账户并已登录。

sh
DOCKER_HUB_USERNAME=<你的Docker Hub用户名> ./publish-docker-image.sh

贡献

我们欢迎社区贡献！你可以：

• 提交错误报告和功能请求
• 将Erugo翻译成你的语言
• 创建拉取请求
• 参与讨论

许可证

Erugo采用MIT许可证发布，确保个人和商业使用的最大灵活性。

---

🚀 准备开始了吗？下载Erugo，几分钟内即可开始安全地分享文件！

免责声明

预期用途

Erugo设计用于合法的文件共享目的，如在可信方之间传输工作资产、设计文件、媒体内容和其他非敏感数据。它不用于分享非法、有害或未授权内容。

管理员责任

作为自托管应用，部署Erugo的管理员需独自承担以下责任：

• 遵守所有适用的地方、国家和国际***
• 正确配置和保护其实例
• 监控和审核通过其实例共享的内容
• 为其用户实施适当的服务条款

无担保

ERUGO按"原样"提供，不提供任何明示或暗示的担保，包括但不限于适销性、特定用途适用性和非侵权担保。在任何情况下，作者或版权持有人不对因使用本软件或与本软件使用相关的任何索赔、损害或其他责任承担责任，无论是合同诉讼、侵权行为还是其他方式。

推荐做法

我们强烈建议管理员：

• 实施访问控制以限制谁可以创建分享
• 配置适当的文件大小限制
• 为分享设置合理的过期时间
• 定期查看系统日志
• 在生产环境部署时考虑实施额外监控

下载、安装或使用Erugo即表示你已阅读并理解本免责声明。