docker 布置 thumbor 服务器

下载镜象

docker pull apsl/thumbor

下载完后先临时启动

docker run -it --rm --name thumbor

开多一个ssh窗口，将配置文件和启动文件COPY出来

mkdir /opt/thumbor
docker cp thumbor:/docker-entrypoint.sh  /opt/thumbor/
docker cp thumbor:/usr/src/app /opt/thumbor/app

修改启动文件

#!/bin/sh

# To disable warning libdc1394 error: Failed to initialize libdc1394
ln -s /dev/null /dev/raw1394

#envtpl /usr/src/app/thumbor.conf.tpl  --allow-missing --keep-template

# If log level is defined we configure it, else use default log_level = info
if [ -n "$LOG_LEVEL" ]; then
    LOG_PARAMETER="-l $LOG_LEVEL"
fi

# Check if thumbor port is defined -> (default port 80)
if [ -z ${THUMBOR_PORT+x} ]; then
    THUMBOR_PORT=8000
fi

if [ "$1" = 'thumbor' ]; then
    exec thumbor --port=$THUMBOR_PORT --conf=/usr/src/app/thumbor.conf $LOG_PARAMETER
fi

exec "$@"

修改配置文件,一般需要修改到的，已标记中文

################################### 日志配置 ####################################

## Logging configuration as json
## Defaults to: None
THUMBOR_LOG_CONFIG = None

## Log Format to be used by thumbor when writing log messages.
## Defaults to: %(asctime)s %(name)s:%(levelname)s %(message)s
THUMBOR_LOG_FORMAT = '%(asctime)s %(name)s:%(levelname)s %(message)s'

## Date Format to be used by thumbor when writing log messages.
## Defaults to: %Y-%m-%d %H:%M:%S
THUMBOR_LOG_DATE_FORMAT = '%Y-%m-%d %H:%M:%S'

################################################################################


################################### Imaging ####################################

## 读取或者创建图片的最大宽度(PX),0为不限制
## Defaults to: 0
MAX_WIDTH = 1024

## 读取或者创建图片的最大高度(PX),0为不限制
## Defaults to: 0
MAX_HEIGHT = 0

## 读取的最大像素
## Defaults to: 75000000 pixels
MAX_PIXELS = 75000000

## 读取或者创建图片的最小宽度(PX)
## Defaults to: 1
MIN_WIDTH = 1

## 读取或者创建图片的最小高度(PX)
## Defaults to: 1
MIN_HEIGHT = 1

## 域名白名单，添加后别人不能引用
## expressions.
## Defaults to: []
ALLOWED_SOURCES =  []


## 生成JPEG的质量
## Defaults to: 80
QUALITY = 80

## 是否使用渐进式加载图片.
## Defaults to: True
PROGRESSIVE_JPEG = True

## Specify subsampling behavior for Pillow (see `subsampling`               in
## http://pillow.readthedocs.org/en/latest/handbook/image-file-
## formats.html#jpeg).Be careful to use int for 0,1,2 and string for "4:4:4"
## notation. Will ignore `quality`. Using `keep` will copy the original file's
## subsampling.
## Defaults to: None
PILLOW_JPEG_SUBSAMPLING = None

## Specify quantization tables for Pillow (see `qtables`               in
## http://pillow.readthedocs.org/en/latest/handbook/image-file-
## formats.html#jpeg). Will ignore `quality`. Using `keep` will copy the
## original file's qtables.
## Defaults to: None
PILLOW_JPEG_QTABLES = None

## Specify resampling filter for Pillow resize method.One of LANCZOS, NEAREST,
## BILINEAR, BICUBIC, HAMMING (Pillow>=3.4.0).
## Defaults to: 'LANCZOS'
PILLOW_RESAMPLING_FILTER = 'LANCZOS'

## Quality index used for generated WebP images. If not set (None) the same level
## of JPEG quality will be used.
## Defaults to: None
WEBP_QUALITY = None


## PNG 的压缩级别.
## Defaults to: 6
PNG_COMPRESSION_LEVEL = 6

## Specifies whether WebP format should be used automatically if the request
## accepts it (via Accept header)
## Defaults to: False
AUTO_WEBP = False

## Specify the ratio between 1in and 1px for SVG images. This is only used
## whenrasterizing SVG images having their size units in cm or inches.
## Defaults to: 150
SVG_DPI = 150

## Max AGE sent as a header for the image served by thumbor in seconds
## Defaults to: 86400
MAX_AGE = 86400

## Indicates the Max AGE header in seconds for temporary images (images with
## failed smart detection)
## Defaults to: 0
MAX_AGE_TEMP_IMAGE = 0

## Indicates whether thumbor should rotate images that have an Orientation EXIF
## header
## Defaults to: False
RESPECT_ORIENTATION = False

## 忽略错误并返回原图 (not
## saved in result storage and with MAX_AGE_TEMP_IMAGE age)
## Defaults to: False
IGNORE_SMART_ERRORS = False

## Sends If-Modified-Since & Last-Modified headers; requires support from result
## storage
## Defaults to: False
SEND_IF_MODIFIED_LAST_MODIFIED_HEADERS = False

## 保留 exif 信息（图片会变大）.
## Defaults to: False
PRESERVE_EXIF_INFO = False

## 启用动画支持.
## Defaults to: True
ALLOW_ANIMATED_GIFS = False

## Indicates whether thumbor should use gifsicle engine. Please note that smart
## cropping and filters are not supported for gifs using gifsicle (but won't
## give an error).
## Defaults to: False
USE_GIFSICLE_ENGINE = False

## 启用黑名单.
## Defaults to: False
USE_BLACKLIST = False

## 图像转换的线程池大小.  The default value is
## 0 (don't use a threadpoool. Increase this if you are seeing your IOLoop
## getting blocked (often indicated by your upstream HTTP requests timing out)
## Defaults to: 0
ENGINE_THREADPOOL_SIZE = 0



################################################################################


################################ Extensibility #################################

## The metrics backend thumbor should use to measure internal actions. This must
## be the full name of a python module (python must be able to import it)
## Defaults to: 'thumbor.metrics.logger_metrics'
METRICS = 'thumbor.metrics.logger_metrics'

## 图片加载方式
## thumbor.loaders.http_loader 网络加载
## thumbor.loaders.file_loader 本地加载
## full name of a python module (python must be able to import it)
## Defaults to: thumbor.loaders.http_loader
LOADER = 'thumbor.loaders.file_loader'

## The file storage thumbor should use to store original images. This must be the
## full name of a python module (python must be able to import it)
## Defaults to: thumbor.storages.file_storage
STORAGE = 'thumbor.storages.file_storage'
STORAGE_BUCKET = ''
RESULT_STORAGE_BUCKET = ''


## The result storage thumbor should use to store generated images. This must be
## the full name of a python module (python must be able to import it)
## Defaults to: None

RESULT_STORAGE = 'thumbor.result_storages.file_storage'


## The imaging engine thumbor should use to perform image operations. This must
## be the full name of a python module (python must be able to import it)
## Defaults to: thumbor.engines.pil
ENGINE = 'thumbor.engines.pil'

## The gif engine thumbor should use to perform image operations. This must be
## the full name of a python module (python must be able to import it)
## Defaults to: 'thumbor.engines.gif'
GIF_ENGINE = 'thumbor.engines.gif'

## The url signer thumbor should use to verify url signatures.This must be the
## full name of a python module (python must be able to import it)
## Defaults to: 'libthumbor.url_signers.base64_hmac_sha1'
URL_SIGNER = 'libthumbor.url_signers.base64_hmac_sha1'

################################################################################


################################### Security ###################################

## 使用密钥加密URL
## Defaults to: MY_SECURE_KEY
SECURITY_KEY = 'MY_SECURE_KEY'

## 设为 True 可支持非密钥（unsafe）访问
## Indicates if the /unsafe URL should be available
## Defaults to: True
ALLOW_UNSAFE_URL = True

## Indicates if encrypted (old style) URLs should be allowed
## Defaults to: True
ALLOW_OLD_URLS = True

## AWS 设置 
## AWS access keys - used in thumbor_aws storage
AWS_ACCESS_KEY = ''
AWS_SECRET_KEY = ''

################################################################################

##################################### HTTP #####################################

## Enables automatically generated etags
## Defaults to: True
ENABLE_ETAGS = True

################################################################################


################################### Storage ####################################

## 图片ID最大长度
## Defaults to: 32
MAX_ID_LENGTH = 32

################################################################################


################################### Metrics ####################################

## 主机监控
## Defaults to: None
STATSD_HOST = None

## 监控端口
## Defaults to: 8125
STATSD_PORT = 8125

## 前缀
## Defaults to: None
STATSD_PREFIX = None

################################################################################

################################# File Loader ##################################

## 加载图片路径
## Defaults to: /tmp
FILE_LOADER_ROOT_PATH = '/data/upload'

################################################################################


################################# HTTP Loader ##################################

## 超时(秒)
## loaded
## Defaults to: 5
HTTP_LOADER_CONNECT_TIMEOUT = 5

## 图片载超时(秒)
## Defaults to: 20
HTTP_LOADER_REQUEST_TIMEOUT = 20

## 开启重试
## Defaults to: True
HTTP_LOADER_FOLLOW_REDIRECTS = True

## 重试次数
## Defaults to: 5
HTTP_LOADER_MAX_REDIRECTS = 5

## 最大并发
## queuing
## Defaults to: 10
HTTP_LOADER_MAX_CLIENTS = 10

## 下面是代理设置

## Indicates whether thumbor should forward the user agent of the requesting user
## Defaults to: False
HTTP_LOADER_FORWARD_USER_AGENT = False

## Default user agent for thumbor http loader requests
## Defaults to: Thumbor/6.3.0
HTTP_LOADER_DEFAULT_USER_AGENT = 'Thumbor/6.3.0'

## The proxy host needed to load images through
## Defaults to: None
HTTP_LOADER_PROXY_HOST = None

## The proxy port for the proxy host
## Defaults to: None
HTTP_LOADER_PROXY_PORT = None

## The proxy username for the proxy host
## Defaults to: None
HTTP_LOADER_PROXY_USERNAME = None

## The proxy password for the proxy host
## Defaults to: None
HTTP_LOADER_PROXY_PASSWORD = None

## 下面是 HTTPS 设置
## The filename of CA certificates in PEM format
## Defaults to: None
HTTP_LOADER_CA_CERTS = None

## Validate the servers certificate for HTTPS requests
## Defaults to: True
HTTP_LOADER_VALIDATE_CERTS = True

## The filename for client SSL key
## Defaults to: None
HTTP_LOADER_CLIENT_KEY = None

## The filename for client SSL certificate
## Defaults to: None
HTTP_LOADER_CLIENT_CERT = None

## If the CurlAsyncHTTPClient should be used
## Defaults to: False
HTTP_LOADER_CURL_ASYNC_HTTP_CLIENT = False


################################################################################


################################# File Storage #################################

## 图像缓存到期时间，默认一个月,单位(秒)
## Defaults to: 2592000
STORAGE_EXPIRATION_SECONDS = 259200

## Indicates whether thumbor should store the signing key for each image in the
## file storage. This allows the key to be changed and old images to still be
## properly found
## Defaults to: False
STORES_CRYPTO_KEY_FOR_EACH_IMAGE = False

## 缓存路径
## Defaults to: /tmp/thumbor/storage
FILE_STORAGE_ROOT_PATH = '/data/storage'

################################################################################


#################################### Upload ####################################

## 是传的最大尺寸
## Aliases: MAX_SIZE
## Defaults to: 0
UPLOAD_MAX_SIZE = 0

## 是否启用文件上传
## Aliases: ENABLE_ORIGINAL_PHOTO_UPLOAD
## Defaults to: False
UPLOAD_ENABLED = False

## The type of storage to store uploaded images with
## Aliases: ORIGINAL_PHOTO_STORAGE
## Defaults to: thumbor.storages.file_storage
UPLOAD_PHOTO_STORAGE = 'thumbor.storages.file_storage'

## 是否可以删除图片
## Aliases: ALLOW_ORIGINAL_PHOTO_DELETION
## Defaults to: False
UPLOAD_DELETE_ALLOWED = False

## 是否可以覆盖图片
## Aliases: ALLOW_ORIGINAL_PHOTO_PUTTING
## Defaults to: False
UPLOAD_PUT_ALLOWED = False

## 默认文件名
## Defaults to: image
UPLOAD_DEFAULT_FILENAME = 'image'

################################################################################

## 下面是各种其它库的存储配置

############################### MongoDB Storage ################################

## MongoDB storage server host
## Defaults to: localhost
MONGO_STORAGE_SERVER_HOST = 'mongo'

## MongoDB storage server port
## Defaults to: 27017
MONGO_STORAGE_SERVER_PORT = 27017

## MongoDB storage server database name
## Defaults to: thumbor
MONGO_STORAGE_SERVER_DB = 'thumbor'

## MongoDB storage image collection
## Defaults to: images
MONGO_STORAGE_SERVER_COLLECTION = 'images'

################################################################################


################################ Redis Storage #################################

## Redis storage server host
## Defaults to: localhost
REDIS_STORAGE_SERVER_HOST = 'redis'

## Redis storage server port
## Defaults to: 6379
REDIS_STORAGE_SERVER_PORT = 6379

## Redis storage database index
## Defaults to: 0
REDIS_STORAGE_SERVER_DB = 0

## Redis storage server password
## Defaults to: None
REDIS_STORAGE_SERVER_PASSWORD = None

################################################################################


################################ Redis Result Storage #################################

## Redis storage server host
## Defaults to: localhost
REDIS_RESULT_STORAGE_SERVER_HOST = 'redis'

## Redis storage server port
## Defaults to: 6379
REDIS_RESULT_STORAGE_SERVER_PORT = 6379

## Redis storage database index
## Defaults to: 0
REDIS_RESULT_STORAGE_SERVER_DB = 0

## Redis storage server password
## Defaults to: None
REDIS_RESULT_STORAGE_SERVER_PASSWORD = None

################################################################################


############################### Memcache Storage ###############################

## List of Memcache storage server hosts
## Defaults to: ['localhost:11211']
MEMCACHE_STORAGE_SERVERS = ['localhost:11211']


################################################################################


################################ Mixed Storage #################################

## Mixed Storage file storage. This must be the full name of a python module
## (python must be able to import it)
## Defaults to: thumbor.storages.no_storage
MIXED_STORAGE_FILE_STORAGE = 'thumbor.storages.no_storage'

## Mixed Storage signing key storage. This must be the full name of a python
## module (python must be able to import it)
## Defaults to: thumbor.storages.no_storage
MIXED_STORAGE_CRYPTO_STORAGE = 'thumbor.storages.no_storage'

## Mixed Storage detector information storage. This must be the full name of a
## python module (python must be able to import it)
## Defaults to: thumbor.storages.no_storage
MIXED_STORAGE_DETECTOR_STORAGE = 'thumbor.storages.no_storage'

################################################################################


##################################### Meta #####################################

## The callback function name that should be used by the META route for JSONP
## access
## Defaults to: None
META_CALLBACK_NAME = None

################################################################################


################################## Detection ###################################

## 人脸识别

## List of detectors that thumbor should use to find faces and/or features. All
## of them must be full names of python modules (python must be able to import
## it)
## Defaults to: []
#DETECTORS =  [
#'thumbor.detectors.queued_detector.queued_complete_detector',
#'thumbor.detectors.queued_detector.queued_face_detector',
#'thumbor.detectors.queued_detector.queued_feature_detector',
#'thumbor.detectors.feature_detector',
#'thumbor.detectors.face_detector',
#]
DETECTORS = []

## The cascade file that opencv will use to detect faces
## Defaults to: haarcascade_frontalface_alt.xml
FACE_DETECTOR_CASCADE_FILE = 'haarcascade_frontalface_alt.xml'

## The cascade file that opencv will use to detect glasses.
## Defaults to: 'haarcascade_eye_tree_eyeglasses.xml'
GLASSES_DETECTOR_CASCADE_FILE = 'haarcascade_eye_tree_eyeglasses.xml'

## The cascade file that opencv will use to detect profile faces.
## Defaults to: 'haarcascade_profileface.xml'
PROFILE_DETECTOR_CASCADE_FILE = 'haarcascade_profileface.xml'

################################################################################


################################## Optimizers ##################################

## List of optimizers that thumbor will use to optimize images
## Defaults to: [] --> ['thumbor.optimizers.jpegtran',]
OPTIMIZERS = []


## Path for the jpegtran binary
## Defaults to: /usr/bin/jpegtran
JPEGTRAN_PATH = '/usr/bin/jpegtran'
PROGRESSIVE_JPEG = True
FFMPEG_PATH = '/usr/bin/ffmpeg' # Default path for the docker installation in debian

################################################################################


################################### Filters ####################################

## 图片过滤器

## List of filters that thumbor will allow to be used in generated images. All of
## them must be full names of python modules (python must be able to import
## it)
## Defaults to: ['thumbor.filters.brightness', 'thumbor.filters.contrast', 'thumbor.filters.rgb', 'thumbor.filters.round_corner', 'thumbor.filters.quality', 'thumbor.filters.noise', 'thumbor.filters.watermark', 'thumbor.filters.equalize', 'thumbor.filters.fill', 'thumbor.filters.sharpen', 'thumbor.filters.strip_icc', 'thumbor.filters.frame', 'thumbor.filters.grayscale', 'thumbor.filters.rotate', 'thumbor.filters.format', 'thumbor.filters.max_bytes', 'thumbor.filters.convolution', 'thumbor.filters.blur', 'thumbor.filters.extract_focal', 'thumbor.filters.no_upscale']
FILTERS = ['thumbor.filters.brightness', 'thumbor.filters.contrast', 'thumbor.filters.rgb', 'thumbor.filters.round_corner', 'thumbor.filters.quality', 'thumbor.filters.noise', 'thumbor.filters.watermark', 'thumbor.filters.equalize', 'thumbor.filters.fill', 'thumbor.filters.sharpen', 'thumbor.filters.strip_icc', 'thumbor.filters.frame', 'thumbor.filters.grayscale', 'thumbor.filters.rotate', 'thumbor.filters.format', 'thumbor.filters.max_bytes', 'thumbor.filters.convolution', 'thumbor.filters.blur', 'thumbor.filters.extract_focal', 'thumbor.filters.no_upscale']

################################################################################


################################ Result Storage ################################

## Expiration in seconds of generated images in the result storage
## Defaults to: 0
RESULT_STORAGE_EXPIRATION_SECONDS = 0

## Path where the Result storage will store generated images
## Defaults to: /tmp/thumbor/result_storage
RESULT_STORAGE_FILE_STORAGE_ROOT_PATH = '/data/result_storage'

## Indicates whether unsafe requests should also be stored in the Result Storage
## Defaults to: False
RESULT_STORAGE_STORES_UNSAFE = False

################################################################################


############################ Queued Redis Detector #############################

## Server host for the queued redis detector
## Defaults to: localhost
REDIS_QUEUE_SERVER_HOST = 'redis'

## Server port for the queued redis detector
## Defaults to: 6379
REDIS_QUEUE_SERVER_PORT = 6379

## Server database index for the queued redis detector
## Defaults to: 0
REDIS_QUEUE_SERVER_DB = 0

## Server password for the queued redis detector
## Defaults to: None
REDIS_QUEUE_SERVER_PASSWORD = None

################################################################################


############################# Queued SQS Detector ##############################

## AWS key id
## Defaults to: None
SQS_QUEUE_KEY_ID = None

## AWS key secret
## Defaults to: None
SQS_QUEUE_KEY_SECRET = None

## AWS SQS region
## Defaults to: us-east-1
SQS_QUEUE_REGION = 'us-east-1'

################################################################################


#################################### Errors ####################################

## This configuration indicates whether thumbor should use a custom error
## handler.
## Defaults to: False
USE_CUSTOM_ERROR_HANDLING = False

## Error reporting module. Needs to contain a class called ErrorHandler with a
## handle_error(context, handler, exception) method.
## Defaults to: thumbor.error_handlers.sentry
ERROR_HANDLER_MODULE = 'thumbor.error_handlers.sentry'

## File of error log as json
## Defaults to: None
ERROR_FILE_LOGGER = None

## File of error log name is parametrized with context attribute
## Defaults to: False
ERROR_FILE_NAME_USE_CONTEXT = False

################################################################################


############################### Errors - Sentry ################################

## Sentry thumbor project dsn. i.e.: http://5a63d58ae7b94f1dab3dee740b301d6a:73ee
## a45d3e8649239a973087e8f21f98@localhost:9000/2
## Defaults to:
SENTRY_DSN_URL = ''

################################################################################

################################### General ####################################

## Custom app class to override ThumborServiceApp. This config value is
## overridden by the -a command-line parameter.
## Defaults to: 'thumbor.app.ThumborServiceApp'
APP_CLASS = 'thumbor.app.ThumborServiceApp'

################################################################################

############################## TC_AWS ##########################################
TC_AWS_REGION = 'eu-west-1' # AWS Region

TC_AWS_ENDPOINT = None # Custom S3 endpoint URL (for GCP, Minio, etc.)

TC_AWS_STORAGE_BUCKET = '' # S3 bucket for Storage
TC_AWS_STORAGE_ROOT_PATH = '' # S3 path prefix for Storage bucket

TC_AWS_LOADER_BUCKET = '' #S3 bucket for loader
TC_AWS_LOADER_ROOT_PATH = '' # S3 path prefix for Loader bucket

TC_AWS_RESULT_STORAGE_BUCKET = '' # S3 bucket for result Storage
TC_AWS_RESULT_STORAGE_ROOT_PATH = '' # S3 path prefix for Result storage bucket

# put data into S3 using the Server Side Encryption functionality to
# encrypt data at rest in S3
# https://aws.amazon.com/about-aws/whats-new/2011/10/04/amazon-s3-announces-server-side-encryption-support/
TC_AWS_STORAGE_SSE = False

# put data into S3 with Reduced Redundancy
# https://aws.amazon.com/about-aws/whats-new/2010/05/19/announcing-amazon-s3-reduced-redundancy-storage/
TC_AWS_STORAGE_RRS = False


# Enable HTTP Loader as well?
# This would allow you to load watermarks in over your images dynamically through a URI
# E.g.
# http://your-thumbor.com/unsafe/filters:watermark(http://example.com/watermark.png,0,0,50)/s3_bucket/photo.jpg
TC_AWS_ENABLE_HTTP_LOADER = False

TC_AWS_ALLOWED_BUCKETS = False # List of allowed bucket to be requested
TC_AWS_STORE_METADATA = False # Store result with metadata (for instance content-type)
################################################################################

回到刚才的临时启动窗口，ctrl+c 关闭服务器

正式启动服务器

#  /home/upload 是我的图片目录
docker run -d --name thumbor -v /opt/thumbor/app:/usr/src/app -v /opt/thumbor/docker-entrypoint.sh:/docker-entrypoint.sh  -v /home/upload:/data/upload -p 8888:8000 --restart=always docker.io/apsl/thumbor

启动成功后配置nginx反向代理

server {
    listen       80;
    #域名记得要修改
    server_name  img2.test.com;
    location / {
            proxy_set_header        Host $host;
            proxy_set_header        X-Real-IP $remote_addr;
            proxy_set_header        X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header        X-Forwarded-Proto  $scheme;
            proxy_connect_timeout   150;
            proxy_send_timeout      100;
            proxy_read_timeout      100;
            proxy_pass              http://127.0.0.1:8888$request_uri;
    }
}

使用方法

http://localhost/hmac/trim/AxB:CxD/(adaptive-)(full-)fit-in/-Ex-F/HALIGN/VALIGN/smart/filters:FILTERNAME(ARGUMENT):FILTERNAME(ARGUMENT)/image-uri
localhost：服务器的地址
hmac：安全认证（unsafe：不安全认证）
trim：使用图片左上角像素 AxB:CxD：对图片的剪裁，AxB 是左上角坐标，CxD 是右下角坐标
-Ex-F：意味着调整图像 ExF 宽度/高度的大小。负号表示水平方向和垂直方向翻转
HALIGN：水平 VALIGN：垂直
smart：智能检测要点
filter：过滤要使用的图片
image-uri：图片的存储名称 加入‘meta’可查看图片的具体信息，以 json 形式返回： http://localhost/unsafe/meta/300x200/https://www.baidu.com/img/superlogo_c4d7df0a003d3db9b65e9ef0fe6da1ec.png
返回 json 文件：

# 以下是示例数据
{
    "thumbor": 
    {
        "operations": [
             {"top": 0, "right": 1345, "type": "crop","bottom": 859, "left": 56},
             {"width": 300.0, "type": "resize", "height": 200.0},
             {"type": "flip_horizontally"}, 
             {"type": "flip_vertically"}
        ], 
        "source": 
        {
            "url": "https://www.baidu.com/img/superlogo_c4d7df0a003d3db9b65e9ef0fe6da1ec.png", 
            "width": 540, "frameCount": 1, "height":258
        }, 
        "focal_points": [
            {"origin": "alignment", "height": 1, "width": 1, "y": 429.5, "x": 700.0, "z": 1.0 }
        ], 
        "target": {"width": 300.0, "height": 200.0}
    }
} 

上传图片

上传图片有两种方式，一种是新的 API 形式，一种是旧的 API 形式，这里介绍新的 API 形式上传图片。
在配置文件里（thumbor.conf）

配置参数	默认	描述
UPLOAD_ENABLED	False	是否支持上传
UPLOAD_PUT_ALLOWED	False	是否允许修改
UPLOAD_DELETE_ALLOWED	False	是否允许删除
UPLOAD_PHOTO_STORAGE	thumbor.storages.file_stora ge	图片存储形式
UPLOAD_DEFAULT_FILENAME	image	图片默认名
UPLOAD_MAX_SIZE	0	图片最大大小
MIN_WIDTH	0	最小宽度
MIN_HEIGHT	1	最小高度

新的 API 是请求方式如下：
A.上传图片：POST 示例： curl -i -H "Content-Type: image/jpeg" -H "Slug: photo.jpg" -XPOST http://localhost/image --data-binary "@vows/crocodile.jpg"
B.修改图片：PUT 示例： curl -i -H "Content-Type: image/jpeg" -H "Slug: modified_image.jpg" -XPUT http://localhost-server/image/05b2eda857314e559630c6f3334d818d/photo.jpg --data-binary "@vows/crocodile.jpg"
C.删除图片：DELELT 示例： curl -i -XDELETE http://localhost-server/image/05b2eda857314e559630c6f3334d818d/modified_image.jpg
D.查看图片：GET 示例： curl -i -XGET http://localhost-server/unsafe/500x400/1.jpg
当然也可以使用表单提交的形式来操作。

图片的自动检测功能(人脸识别)

# yum install -y opencv GraphicsMagick openssl-devel curl-devel GraphicsMagick-c++-devel boost boost-devel boost-python

# pip install pgmagick opencv-python graphicsmagick-engine
# pip install -i http://mirrors.aliyun.com/pypi/simple --trusted-host mirrors.aliyun.com pgmagick opencv-python graphicsmagick-engine

在配置文件中加入以下内容：

DETECTORS = [ 'thumbor.detectors.face_detector', 'thumbor.detectors.feature_detector', ]

那么就有了对图片中的人脸和一些特性的自动检测。 还有一些其他的检测器可用，也可以自定义检测器。

过滤功能

可以根据某个过滤器，对原图片进行一些处理，比如亮度不够，色彩不鲜明等处理后返 回给页面显示，以达到想要的效果。当然，这个过滤器也是可以自定义的。

图片亮度调整 格式：filters:brightness(amount)

解释：amount 的范围是-100~100 的整数，对应效果暗~亮
示例：http://localhost:8888/unsafe/400x500/filters:brightness(10)/1.jpg

图片对比度 格式：filters:contrast(amount)

解释：amount 的范围是-100~100 的整数
示例：http://localhost:8888/unsafe/400x500/filters:contrast(20)/1.jpg

图片着色 格式：filters:colorize(redPercentage, greenPercentage, bluePercentage, fillColor)

解释：redPercentage 填充红色混合像素的百分比，取值范围是-100~100 的整数 greenPercentage 填充绿色混合像素的百分比，取值范围是-100~100 的整数 bluePercentage 填充蓝色混合像素的百分比，取值范围是-100~100 的整数 fillColor 填充色，取值范围是十六进制数值
示例：http://localhost:8888/unsafe/400x500/filters:colorize(20)/1.jpg

图片颜色均衡 格式：filters:equalize()

解释：均衡颜色
示例：http://localhost:8888/unsafe/400x500/filters:equalize()/1.jpg

图片填充色 格式：filters:fill(color[,fill_transparent])

解释：color 填充色，取值范围是十六进制数值或颜色的单词 fill_transparent 是否填充，取值 true，false，1，0 默认是 false 按照尺寸显示照片，图片缺少的尺寸部分填充颜色
示例：http://localhost:8888/unsafe/400x500/filters:fill(blue，1)/1.jpg

图片格式 格式：filters:format(webp)

解释：webp 可选的图片格式，取值范围是 jpeg，gif，png 按照格式显示图片
示例：http://localhost:8888/unsafe/400x500/filters:format(png)/1.jpg

提取动态图片(速度很慢) 格式：filters:extract_cover()

解释：提取动态图片的第一帧图样
示例：http://localhost:8888/unsafe/400x500/filters:extract_cover()/2.gif

图片灰度 格式：filters:grayscale()

解释：将图片变成灰色
示例：http://localhost:8888/unsafe/400x500/filters:grayscale()/1.jpg

图片字节 格式：filters:max_bytes ()

解释：根据图片的字节大小调节图片质量
示例：http://localhost:8888/unsafe/400x500/filters:max_bytes(1000)/1.jpg

图片噪点 格式：filters:noise (amount)

解释：amount 取值范围 0~100，值越大，噪点越多
示例：http://localhost:8888/unsafe/400x500/filters:noise(20)/1.jpg

图片低品质 格式：filters:no_upscale()

解释：当要显示的图片尺寸大于图片原来的尺寸，要显示图片的原尺寸 示例：http://localhost:8888/unsafe/800x1000/filters:no_upscale()/1.jpg

图片质量 格式：filters:quality(amount)

解释：amount 取值范围 0~100，质量越高越清晰，只使用于 jpeg 图片
示例：http://localhost:8888/unsafe/800x1000/filters:quality(90)/1.jpg

图片色彩 格式：filters:rgb(r，g，b)

解释：r，g，b 取值范围-100~100，分别对应红，绿，蓝颜色的百分比
示例：http://localhost:8888/unsafe/800x1000/filters:rgb(90，-20，30)/1.jpg

图片四边圆角处理 格式：filters:round_corner(a|b，r，g，b)

解释：a|b 是半径大小 r，g，b 取值范围 0~255，分别对应红，绿，蓝颜色的百分比
示例：http://localhost:8888/unsafe/800x1000/filters:round_corner(20，0，0，0)/1.jpg

图片旋转 格式：filters:rotate(angle)

解释：angle 是旋转的度数，取值为 90 的倍数，按大小逆时针旋转
示例：http://localhost:8888/unsafe/800x1000/filters:rotate(90)/1.jpg

图片饱和度 格式：filters:saturation(angle)

解释：angle 饱和度度数，取值为 0.0~2.0，由低到高
示例：http://localhost:8888/unsafe/800x1000/filters:saturation(0.5)/1.jpg

图片锐化 格式：filters:sharpen(sharpen_amount,sharpen_radius,luminance_only)

解释：sharpen_amount ，取值为 0.0~10.0， 锐化量 sharpen_radius 取值 0.0~2.0， 锐化半径 luminance_only 取值 true，false，是否锐化亮度
示例：http://localhost:8888/unsafe/800x1000/filters:sharpen(2，1.0，true)/1.jpg

图片删除 icc 信息 格式：filters:strip_icc()

解释：图片删除 icc 信息，图片有可能变小或失真
示例：http://localhost:8888/unsafe/800x1000/filters:strip_icc()/1.jpg

图片水印 格式：filters:watermakr(imageUrl,x,y,alpha)

解释：imageUrl 要水印图片的 url 地址 x 水平方向的坐标 y 垂直方向的坐标 alpha 水印图片的透明度，取值范围 0~100 图片添加水印
示例：http://localhost:8888/unsafe/filters:watermark(3.jpg,-10,-10,0)/1.jpg

图片模糊 格式：filters:blur(rate[,sigma])

解释：rate 模糊率，取值范围 0~150 sigma 使用高斯函数 使图片模糊
示例：http://localhost:8888/unsafe/800x1000/filters:blur(3)/1.jpg

图片提取要点 格式：filters:extract_focal()

解释：提取图片的要点
示例： http://localhost:8888/unsafe/800x1000/filters:extract_focal()/localhost:8888/unsafe/100x150:300x200/https://upload.wikimedia.org/wikipedia/commons/thumb/2/22/Turkish_Van_Cat.jpg/1.jpg

图片转换成 mp4 Html 格式：filters:gifv()

解释：将 gif 图片转换成 mp4 格式和 webm 格式
配置：

OPTIMIZERS = [ 'thumbor.optimizers.gifv', ] 

示例：http://localhost:8888/unsafe/800x1000/filters:gifv()/1.jpg

图片 RGB 扭曲 格式：filters:curve(curve_all, curve_r, curve_g, curve_b)

解释：curve_all 扭曲所有色调 curve_r 扭曲红色 curve_g 扭曲绿色 curve_b 扭曲蓝色
示例： http://localhost:8888/unsafe/800x1000/filters:curve([(0,0),(40,59),(255,255)],[(32,59),(64,80),(92,111),(128,153),(140,169),(164,201),(192,214),(224,215),(240,214),(255,212)],[(34,41),(64,51),(92,76),(128,112),(140,124),(164,147),(192,180),(224,216),(240,236),(255,255)],[(40,46),(64,55),(92,83),(128,127),(140,144),(164,174),(192,197),(224,199),(240,197),(255,198)])/1.jpg

矩阵卷积 格式：filters:convolution(matrix_items, number_of_columns, should_normalize)

解释：matrix_items 用分号分隔矩阵的数字 number_of_columns 矩阵的列数字 should_normalize 是否计算矩阵总和
示例： http://localhost:8888/unsafe/filters:convolution(-1;-1;-1;-1;8;-1;-1;-1;-1,3,false)/htt p://upload.wikimedia.org/wikipedia/commons/5/50/1.jpg

更多参考资料
https://github.com/thumbor/thumbor/wiki/Configuration 配置文件
https://github.com/thumbor/thumbor/wiki/Requirements 安装必看
https://github.com/thumbor/thumbor/wiki/Usage 使用介绍
https://github.com/thumbor/thumbor/wiki/Optimizers

总结

优点：
1.thumbor 可以实现动态，灵活的对图片处理
2.thumbor 可以实现对图片的复杂操作处理
3.thumbor 可以节省网络流量
缺点：
1.thumbor 的服务器使用内存较大

PHP 的签名生成方法

url, signature),'/+', '_-');

PHP 示例

signature),'/+', '-').'/200x100/2018/05/22/20180522164126.jpeg';