humanmade/tachyon

Tachyon 镜像文档

镜像概述和主要用途

Tachyon是一个运行在AWS上的即时图像调整服务，旨在提供高性能、高可用性的图像处理能力。它基于以下核心假设构建：依赖AWS生态（CloudFront、Lambda、API Gateway）、原始图像存储于Amazon S3、专注于简单图像尺寸调整而非全功能图像操作。该服务特别适合与WordPress配合使用，需结合https://github.com/humanmade/s3-uploads%E6%8F%92%E4%BB%B6%E5%92%8Chttps://github.com/humanmade/tachyon-plugin%E5%AE%9E%E7%8E%B0%E5%AE%8C%E6%95%B4%E5%8A%9F%E8%83%BD%E3%80%82

核心功能和特性

• AWS原生集成：利用CloudFront、Lambda和API Gateway确保服务高可用和低延迟
• S3图像源：仅从Amazon S3存储桶获取原始图像文件
• 轻量调整能力：专注于基础图像尺寸调整，非全功能图像编辑工具
• 高性能处理：采用Sharp Node.js库（基于libvips）执行图像调整，处理效率高
• 极简HTTP接口：通过URL参数直接指定调整尺寸，使用便捷

使用场景和适用范围

• 高流量站点：适用于每月数百万页面浏览量的大规模网站
• WordPress生态：与S3 Uploads插件配合，优化WordPress媒体文件存储与处理
• 即时图像需求：需要通过简单参数动态生成不同尺寸图像的应用场景

使用方法和配置说明

组件构成

Tachyon包含两部分核心组件，需同时部署以实现完整功能：

1. 图像服务端：提供图像调整能力，提供Docker镜像版本，支持生产环境部署或本地测试
2. 客户端插件：需在所有使用Tachyon的站点安装（如WordPress的Tachyon Plugin）

Docker镜像部署

服务器端提供Docker镜像，可用于生产环境部署或本地测试环境搭建，具体部署步骤参考官方Docker文档。

HTTP接口使用

通过简单URL格式调用图像调整服务：

https://{tachyon域名}/s3上的图像路径.png?w=宽度&h=高度

示例：

https://tachyon.example.com/uploads/2023/01/photo.jpg?w=100&h=80

详细参数说明参见参数参考文档。

升级步骤

升级Tachyon服务时，需通过AWS控制台执行API Gateway部署：

1. 登录AWS控制台，导航至API Gateway服务
2. 选择"Tachyon" API
3. 点击Actions，然后选择Deploy API完成部署

相关信息

• 开发维护：由Human Made开发维护，适用于高容量和大规模站点，目前运行于数百万月浏览量的网站及数千个站点
• 技术依赖：使用Sharp Node.js库（Apache License 2.0）进行图像调整，底层依赖libvips库
• 灵感来源：受Automattic的Photon启发，但专注于S3媒体库场景，与Photon用途不同

Credits

由Human Made团队为高流量、大规模站点创建。主要维护者：https://github.com/joehoyle%E3%80%82%E4%BD%BF%E7%94%A8Sharp%E5%BA%93%EF%BC%88%E5%9F%BA%E4%BA%8EApache License 2.0）及libvips库。