agentsib/siteshot

网站截图生成工具

这是一个用于生成网站截图的Web服务，基于Silex框架开发，使用wkhtmltopdf实现截图功能。

镜像概述

本镜像提供轻量级Web服务，能根据用户参数生成指定网站的截图，支持多种模式、尺寸调整和格式选择，适用于快速获取网页快照的场景。

核心功能

• 两种截图模式：corner（截取左上角区域）、resize（调整至最大宽度）
• 自定义截图尺寸（如400或400x500）
• 支持PNG/JPG输出格式
• 可设置页面加载超时（适配动态内容网站）
• 缓存机制提升重复请求效率

使用场景

• 网站预览：生成可视化快照
• 页面监控：定期捕获网页变化
• 文档配图：为报告/文档提供网页截图
• 自动化测试：验证网页显示效果

配置说明

访问URL格式：http://{host}:{port}/{mode}/{sizes}/{fwidth}/{format}/t{timeout}?{url}
参数解释：

• mode：截图模式（corner/resize）
• sizes：截图尺寸（如800x600）
• fwidth：corner模式为截取区域宽高，resize模式为最大宽度
• format：输出格式（png/jpg）
• timeout：加载超时时间（默认1秒，格式如t5）
• url：目标网站URL

部署示例

常规部署

bash
docker run -d -p 8080:80 -v /tmp/siteshot_cache:/var/www/shot/cache agentsib/siteshot:latest

部署后访问http://localhost:8080测试。

开发模式（显示错误）

bash
docker run -ti -p 8080:80 -e DEBUG=1 -v /path/to/siteshot-php:/var/www/shot agentsib/siteshot:latest

使用示例

• 调整至最大宽度400px：http://localhost:8080/resize/800x600/400/png?http://google.com
• 超时5秒：http://localhost:8080/resize/800x600/400/png/t5?http://speedtest.net
• 截取左上角区域：http://localhost:8080/corner/800x600/400/png?http://vk.com