linuxserver/projectsend 中文技术文档

镜像概述和主要用途

linuxserver/projectsend 是由 LinuxServer.io 团队开发的 Docker 镜像，用于部署 ProjectSend 应用。ProjectSend 是一款自托管的文件管理工具，允许用户上传文件并将其分配给自定义创建的客户端。该应用安全、私有且易于使用，避免了依赖外部服务或电子邮件发送文件的需求。

核心功能和特性

LinuxServer.io 镜像特性

• 定期应用更新：及时更新应用版本，确保功能和安全性
• 灵活的用户映射：通过 PUID/PGID 实现容器内用户与宿主机用户权限映射
• 自定义基础镜像：基于 s6 overlay 构建，提供可靠的进程管理
• 高效的层管理：每周更新基础 OS，跨镜像共享公共层，减少存储空间占用、 downtime 和带宽消耗
• 定期安全更新：持续修复安全漏洞，保障部署环境安全

ProjectSend 应用特性

• 自托管文件分发：无需依赖外部服务，私有部署文件共享系统
• 客户端管理：创建自定义客户端，将文件定向分配给特定用户
• 权限控制：精细管理文件访问权限，确保数据安全
• 多语言支持：通过翻译文件支持多种语言界面
• 灵活配置：可自定义 PHP 参数（如最大上传大小）和定时任务

使用场景和适用范围

• 企业内部文件共享：安全分发内部文档、安装包等资源
• 客户端文件交付：向客户交付设计稿、项目文件等，替代邮件附件
• 团队协作：团队成员间共享大文件，避免第三方存储依赖
• 自由职业者文件管理：集中管理与多个客户的文件交付记录
• 教育机构资源分发：教师向学生分发课程材料，确保资源可追溯

详细的使用方法和配置说明

支持的架构

该镜像通过 Docker manifest 支持多平台部署，默认拉取 lscr.io/linuxserver/projectsend:latest 会自动匹配宿主机架构。也可通过标签指定具体架构：

部署准备

• 数据库要求：需预先准备 MySQL 或 MariaDB 数据库及用户（需手动创建）
• 端口规划：默认使用 80 端口（HTTP），需确保宿主机端口未被占用
• 目录权限：宿主机挂载目录需确保指定的 PUID/PGID 用户有读写权限

Docker Compose 部署（推荐）

yaml
---
services:
  projectsend:
    image: lscr.io/linuxserver/projectsend:latest
    container_name: projectsend
    environment:
      - PUID=1000               # 用户ID，用于权限映射
      - PGID=1000               # 组ID，用于权限映射
      - TZ=Etc/UTC              # 时区，如 Asia/Shanghai
    volumes:
      - /path/to/projectsend/config:/config  # 配置文件存储目录
      - /path/to/data:/data                  # 文件存储目录
    ports:
      - 80:80                   # Web访问端口映射
    restart: unless-stopped     # 容器重启策略

Docker CLI 部署

bash
docker run -d \
  --name=projectsend \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -p 80:80 \
  -v /path/to/projectsend/config:/config \
  -v /path/to/data:/data \
  --restart unless-stopped \
  lscr.io/linuxserver/projectsend:latest

配置参数详解

环境变量

卷挂载

端口映射

应用设置

数据库配置

首次启动后，需通过 Web 界面完成数据库配置：

1. 访问 [***] 进入安装向导
2. 填写 MySQL/MariaDB 数据库信息（主机、端口、数据库名、用户名、密码）
3. 创建管理员账户并完成初始化

定时任务配置

如需启用定时任务（如文件清理、通知发送）：

1. 在宿主机 /path/to/projectsend/config/crontabs/ 目录下创建 abc 文件
2. 添加 crontab 任务（如 0 0 * * * /usr/bin/php /app/projectsend/cron.php）
3. 重启容器使配置生效

PHP 参数调整

修改 PHP 配置（如最大上传大小）：

1. 编辑宿主机 /path/to/projectsend/config/php/projectsend.ini 文件
2. 调整参数（如 upload_max_filesize = 100M、post_max_size = 100M）
3. 重启容器生效

多语言支持

1. 从 ProjectSend 翻译页面 下载语言文件
2. 将翻译文件放入宿主机 /path/to/projectsend/config/translations 目录
3. 在应用设置中选择对应语言

更新与维护

通过 Docker Compose 更新

bash
# 拉取最新镜像
docker-compose pull projectsend

# 重启容器
docker-compose up -d projectsend

# 清理旧镜像
docker image prune

通过 Docker CLI 更新

bash
# 拉取最新镜像
docker pull lscr.io/linuxserver/projectsend:latest

# 停止并删除旧容器
docker stop projectsend && docker rm projectsend

# 启动新容器（使用原参数）
docker run -d \
  --name=projectsend \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Asia/Shanghai \
  -p 80:80 \
  -v /path/to/config:/config \
  -v /path/to/data:/data \
  --restart unless-stopped \
  lscr.io/linuxserver/projectsend:latest

# 清理旧镜像
docker image prune

支持与故障排查

容器管理命令

bash
# 进入容器 shell
docker exec -it projectsend /bin/bash

# 实时查看日志
docker logs -f projectsend

# 查看容器版本
docker inspect -f '{{ index .Config.Labels "build_version" }}' projectsend

# 查看镜像版本
docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/projectsend:latest

Docker Mods 扩展

可通过 Docker Mods 扩展功能，支持自定义配置、额外依赖安装等，使用方法参考***文档。

版本历史

• 14.10.25: 基于 Alpine 3.22 重构
• 06.06.25: 添加定时任务处理功能
• 21.12.24: 基于 Alpine 3.21 重构，PHP 配置文件迁移至 /config/php
• 06.06.24: 基于 Alpine 3.20 重构
• 23.12.23: 基于 Alpine 3.19 重构，升级至 PHP 8.3
• 25.05.23: 基于 Alpine 3.18 重构，移除 armhf 架构支持
• 08.03.23: 基于 Alpine 3.17 重构，升级至 s6v3
• 23.08.22: 添加翻译支持
• 20.08.22: 基于 Alpine 3.15 重构，升级至 PHP 8，调整 Nginx 配置
• 24.06.21: 基于 Alpine 3.14 重构，切换至 Nginx
• 23.01.21: 基于 Alpine 3.13 重构
• 01.06.20: 基于 Alpine 3.12 重构
• 31.12.19: 基于 Alpine 3.11 重构，升级至 PHP 7
• 23.03.19: 切换至新基础镜像，使用 arm32v7 标签
• 11.02.19: 添加流水线逻辑和多架构支持
• 11.06.17: 从 GitHub 获取版本信息
• 09.12.17: 基于 Alpine 3.7 重构
• 13.06.17: 初始发布