hascheksolutions/pictshare

官方PictShare Docker镜像（基于Alpine Linux和PHP 7）

快速部署PictShare图片托管服务的方式

![Docker部署演示]([***]

镜像概述

本镜像为PictShare的官方Docker实现，基于轻量级Alpine Linux和PHP 7构建，提供开源图片托管解决方案的快速部署能力。PictShare是一个功能全面的图片托管系统，支持图片上传、存储、处理及分享，适合个人或小型团队快速搭建私有图片托管服务。

核心功能与特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• 快速部署：一键启动，无需复杂配置
• 持久化存储：支持数据卷挂载，确保图片数据持久化
• 灵活配置：通过环境变量自定义上传大小、存储路径、访问控制等
• 自动更新：支持容器启动时自动升级功能
• 多存储支持：兼容本地存储、S3及FTP等多种存储方式

使用场景

• 个人博客或网站的图片存储服务
• 小型团队内部图片共享平台
• 需要自定义图片处理（压缩、格式转换）的场景
• 对数据隐私有要求，需自建图片托管服务的场景

使用方法

构建镜像

bash
docker build -t hascheksolutions/pictshare .

快速启动

bash
docker run -d -p 80:80 --name=pictshare hascheksolutions/pictshare

持久化数据配置

bash
# 创建本地数据目录并设置权限
mkdir /data/pictshareuploads
chown 1000 -R /data/pictshareuploads

# 启动容器并挂载数据卷
docker run -d -v /data/pictshareuploads:/usr/share/nginx/html/data -p 80:80 --name=pictshare hascheksolutions/pictshare

带自定义上传大小限制的持久化配置

bash
# 创建本地数据目录并设置权限
mkdir /data/pictshareuploads
chown 1000 -R /data/pictshareuploads

# 启动容器，设置最大上传大小为1024MB并挂载数据卷
docker run -d -e "MAX_UPLOAD_SIZE=1024" -v /data/pictshareuploads:/usr/share/nginx/html/data -p 80:80 --name=pictshare hascheksolutions/pictshare

环境变量配置

Docker镜像特有环境变量

• AUTO_UPDATE (true/false) - 容器是否在每次启动时自动升级，默认值：true
• MAX_UPLOAD_SIZE (int) - Nginx允许的最大上传大小（MB），默认值：50

通用配置环境变量

其他配置变量可参考https://github.com/HaschekSolutions/pictshare/blob/master/inc/example.config.inc.php%EF%BC%8C%E4%B8%BB%E8%A6%81%E5%8C%85%E6%8B%AC%EF%BC%9A

• TITLE (string) - 页面标题
• URL (string) - 新上传文件的基础链接URL
• PNG_COMPRESSION (int) - PNG压缩级别（0-9，不影响质量），默认值：6
• JPEG_COMPRESSION (int) - JPEG质量（0-100，值越高质量越好），默认值：90
• MASTER_DELETE_CODE (string) - 用于删除图片的验证码（添加到URL中使用）
• MASTER_DELETE_IP (string) - 允许删除任何图片的IP地址
• ALLOWED_SUBNET (CIDR IP范围，可逗号分隔) - 允许上传文件的IP子网
• ALLOW_BLOATING (true/false) - 是否允许将图片放大到高于原始分辨率
• UPLOAD_CODE (string) - 上传图片所需的验证码
• LOG_UPLOADER (true/false) - 是否记录上传者IP地址，默认值：false
• MAX_RESIZED_IMAGES (int) - 单个图片可生成的缩放版本数量（-1表示无限制）
• SHOW_ERRORS (true/false) - 是否显示上传/服务器错误信息，默认值：true

存储相关配置变量

• ALT_FOLDER (路径) - 哈希文件备份目录，用于NFS等异地备份
• S3_BUCKET (string) - S3存储桶名称
• S3_ACCESS_KEY (string) - S3访问密钥
• S3_SECRET_KEY (string) - S3密钥
• S3_ENDPOINT (url) - 自托管S3服务（如Minio）的URL
• ENCRYPTION_KEY (string) - 存储加密密钥，https://github.com/HaschekSolutions/pictshare/blob/master/rtfm/ENCRYPTION.md

FTP存储配置变量

• FTP_SERVER (string) - FTP服务器IP或主机名
• FTP_PORT (int) - FTP服务器端口（默认21）
• FTP_SSL (true/false) - 是否启用SSL-FTP（非sFTP）
• FTP_USER (string) - FTP用户名
• FTP_PASS (string) - FTP密码
• FTP_BASEDIR (string) - 文件存储基础路径（必须以/结尾，如/web/pictshare/）

内容控制器配置

• CONTENTCONTROLLERS (CSV字符串) - 内容控制器白名单，大写字母，逗号分隔。例如：仅允许图片IMAGE，允许图片和视频IMAGE,VIDEO