# htmltoimage

**Repository Path**: konger520/htmltoimage

## Basic Information

- **Project Name**: htmltoimage
- **Description**: 一个可以给网页指定区域截图的工具
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-05-17
- **Last Updated**: 2025-05-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# HTML转图片服务

## 项目简介
这是一个基于Python Flask的Web服务，提供将HTML内容转换为图片的功能，支持定时自动清理过期图片。

## 主要功能
- ✅ HTML内容转PNG图片
- 🗑️ 自动清理过期图片（可配置保留天数）
- 🌐 RESTful API接口
- 🔄 跨域请求支持
- ⏱️ 定时任务管理

## 快速开始

### 安装依赖
```bash
pip install -r requirements.txt
python -m playwright install
```

### 启动服务
```bash
python app.py
```

## 接口文档

### 截图接口
`POST /api/screenshot`

**请求参数**:
```json
{
    "html": "<div>要转换的HTML内容</div>",
    "width": 1200,
    "height": 800
}
```

**响应示例**:
```json
{
    "success": true,
    "image_url": "http://yourdomain.com/static/images/uuid.png"
}
```

## 配置选项
通过`.env`文件配置：
```ini
# 服务器配置
HOST=0.0.0.0
PORT=8000

# 图片保留天数(默认30天)
IMAGE_RETENTION_DAYS=30
```

## 项目结构
```
.
├── app.py                # 主应用入口
├── config.py             # 配置管理
├── static/               # 静态文件
│   └── images/           # 生成的图片
├── requirements.txt      # Python依赖
└── DEPLOYMENT.md         # 部署指南
```

## 部署指南
详细部署步骤请参考[DEPLOYMENT.md](DEPLOYMENT.md)

## 使用示例
```javascript
// 浏览器调用示例
fetch('/api/screenshot', {
    method: 'POST',
    headers: {'Content-Type': 'application/json'},
    body: JSON.stringify({
        html: '<h1>Hello World</h1>',
        width: 800,
        height: 600
    })
})
.then(console.log);
```

## 注意事项
1. 首次运行会自动安装浏览器
2. 图片默认存储在static/images目录
3. 系统每天UTC时间自动清理过期图片