mojo42/jirafeau

Jirafeau Docker镜像文档

镜像概述

Jirafeau是一个轻量级PHP应用，提供自托管的文件共享服务。其核心功能是实现"一键文件共享"，允许用户通过简单的Web界面上传文件，并自动生成唯一的访问链接，方便快速分享文件。该镜像基于官方Jirafeau项目构建，简化了部署流程，适合需要私有文件共享解决方案的场景。

核心功能和特性

• 简单易用：提供直观的Web界面，支持一键上传文件，无需复杂配置
• 轻量级设计：基于PHP开发，资源占用低，适合在各种服务器环境部署
• 唯一访问链接：每次文件上传自动生成唯一URL，确保分享的私密性和可控性
• 自托管特性：可部署在私有服务器，数据完全由用户掌控，保障数据安全和隐私
• 持久化存储：支持数据卷挂载，确保容器重启后文件和配置不会丢失

使用场景和适用范围

• 个人用户需要快速、简单地与他人共享文件
• 小团队内部临时文件交换和协作
• 对数据隐私有较高要求，希望避免使用公共文件共享服务的场景
• 需要在本地网络或私有服务器中搭建轻量级文件共享服务

使用方法和配置说明

基本部署（docker run）

通过以下命令快速启动Jirafeau容器：

bash
docker run -d \
  --name jirafeau \
  -p 8080:80 \
  -v /path/to/local/data:/data \
  jirafeau/jirafeau

参数说明：

• -d：后台运行容器
• --name jirafeau：指定容器名称为jirafeau
• -p 8080:80：将容器内80端口映射到主机的8080端口（可根据需要修改主机端口）
• -v /path/to/local/data:/data：将主机目录挂载到容器内/data目录，用于持久化存储上传的文件和配置

Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3'
services:
  jirafeau:
    image: jirafeau/jirafeau
    container_name: jirafeau
    ports:
      - "8080:80"  # 主机端口:容器端口
    volumes:
      - ./jirafeau_data:/data  # 当前目录下的jirafeau_data目录映射到容器/data
    restart: unless-stopped  # 容器退出时自动重启（除非手动停止）

启动服务：

bash
docker-compose up -d

访问和使用

1. 部署完成后，通过浏览器访问 http://<主机IP>:8080
2. 在Web界面中点击"选择文件"按钮上传需要分享的文件
3. 上传完成后，系统会生成唯一的访问链接
4. 将链接分享给需要访问文件的用户，对方通过链接即可下载文件

注意事项

• 数据卷挂载是推荐的做法，确保容器删除或更新后文件不会丢失
• 如需使用HTTPS，建议在容器前端配置反向代理（如Nginx、Traefik）并添加SSL证书
• 更多高级配置和自定义选项，请参考Jirafeau官方Docker文档