terrestris/projectsend

ProjectSend Docker镜像文档

镜像概述

本镜像用于创建ProjectSend的Docker容器。ProjectSend是一个开源的文件共享和管理平台，允许用户安全地上传、共享和管理文件。本镜像基于php:7-apache构建，使用ProjectSend r1295版本，受linuxserver/docker-projectsend项目启发。

核心功能与特性

• 基于稳定的php:7-apache基础镜像，确保运行环境兼容性
• 包含ProjectSend r1295版本，提供文件上传、用户管理、权限控制等核心功能
• 支持持久化存储配置和数据，通过卷挂载实现数据持久化
• 可与外部MySQL数据库集成，灵活适应现有数据库环境

使用场景

• 团队内部文件共享与协作
• 客户文件交付与管理
• 小型组织的文件存储与分发平台
• 需要简单部署和维护的文件共享解决方案

使用方法

Docker Compose部署

推荐使用提供的docker-compose.yml配置文件进行部署，包含Web服务和MySQL数据库服务：

yaml
version: "3.0"
services:
  web:
    restart: unless-stopped
    image: terrestris/projectsend:latest
    volumes:
      - /opt/projectsend/config:/config  # 配置文件持久化
      - /opt/projectsend/data:/data      # 数据文件持久化
    ports:
      - "8080:80"  # 映射容器80端口到主机8080端口
  mysql:
    restart: unless-stopped
    image: mariadb:10.5  # 使用MariaDB 10.5作为数据库
    volumes:
      - /opt/mariadb_data:/var/lib/mysql  # 数据库数据持久化
    environment:
      MYSQL_ROOT_PASSWORD: password       # MySQL root用户密码
      MYSQL_DATABASE: projectsend         # 创建ProjectSend专用数据库
      MYSQL_USER: projectsend             # ProjectSend数据库用户
      MYSQL_PASSWORD: projectsend         # ProjectSend数据库用户密码

外部数据库配置

如果已有MySQL数据库，可直接使用现有数据库服务，无需部署上述mysql服务。需确保Web服务能访问外部数据库，并在后续安装步骤中正确配置数据库连接信息。

启动与访问

1. 使用上述docker-compose.yml配置文件，执行以下命令启动服务：

   bash
   docker-compose up -d
   

2. 服务启动后，通过浏览器访问 http://localhost:8080

3. 首次访问将显示ProjectSend安装脚本，需输入以下数据库凭证（根据docker-compose.yml配置）：

   • 数据库主机：mysql（若使用内置数据库）或外部数据库主机地址
   • 数据库名称：projectsend
   • 数据库用户：projectsend
   • 数据库密码：projectsend

4. 完成安装步骤后，即可开始使用ProjectSend平台。

持久化存储

通过卷挂载实现以下目录的持久化：

• /config: 存储ProjectSend配置文件
• /data: 存储上传的文件数据
• 数据库数据（通过mariadb服务的/var/lib/mysql卷挂载）

确保这些目录在主机上具有适当的权限，以避免数据访问问题。