Python FastAPI+Celery+RabbitMQ实现分布式图片水印处理系统

 更新时间:2025年04月04日 09:23:59   作者:老大白菜  
这篇文章主要为大家详细介绍了Python FastAPI如何结合Celery以及RabbitMQ实现简单的分布式图片水印处理系统,感兴趣的小伙伴可以跟随小编一起学习一下

实现思路

  • FastAPI 服务器
  • Celery 任务队列
  • RabbitMQ 作为消息代理
  • 定时任务处理

完整步骤

首先创建项目结构:

c:\Users\Administrator\Desktop\meitu\
├── app/
│   ├── __init__.py
│   ├── main.py
│   ├── celery_app.py
│   ├── tasks.py
│   └── config.py
├── requirements.txt
└── celery_worker.py

1.首先创建 requirements.txt:

fastapi==0.104.1
uvicorn==0.24.0
celery==5.3.4
python-dotenv==1.0.0
requests==2.31.0

2.创建配置文件:

from dotenv import load_dotenv
import os

load_dotenv()

# RabbitMQ配置
RABBITMQ_HOST = os.getenv("RABBITMQ_HOST", "localhost")
RABBITMQ_PORT = os.getenv("RABBITMQ_PORT", "5672")
RABBITMQ_USER = os.getenv("RABBITMQ_USER", "guest")
RABBITMQ_PASS = os.getenv("RABBITMQ_PASS", "guest")

# Celery配置
CELERY_BROKER_URL = f"amqp://{RABBITMQ_USER}:{RABBITMQ_PASS}@{RABBITMQ_HOST}:{RABBITMQ_PORT}//"
CELERY_RESULT_BACKEND = "rpc://"

# 定时任务配置
CELERY_BEAT_SCHEDULE = {
    'process-images-every-hour': {
        'task': 'app.tasks.process_images',
        'schedule': 3600.0,  # 每小时执行一次
    },
    'daily-cleanup': {
        'task': 'app.tasks.cleanup_old_images',
        'schedule': 86400.0,  # 每天执行一次
    }
}

3.创建 Celery 应用:

from celery import Celery
from app.config import CELERY_BROKER_URL, CELERY_RESULT_BACKEND, CELERY_BEAT_SCHEDULE

celery_app = Celery(
    'image_processing',
    broker=CELERY_BROKER_URL,
    backend=CELERY_RESULT_BACKEND,
    include=['app.tasks']
)

# 配置定时任务
celery_app.conf.beat_schedule = CELERY_BEAT_SCHEDULE
celery_app.conf.timezone = 'Asia/Shanghai'

4.创建任务文件:

from app.celery_app import celery_app
from app.watermark import ImageWatermarker
import os
from datetime import datetime, timedelta

@celery_app.task
def add_watermark_task(image_path, text, position='center'):
    """异步添加水印任务"""
    watermarker = ImageWatermarker()
    try:
        result_path = watermarker.add_watermark(
            image_path=image_path,
            text=text,
            position=position
        )
        return {"status": "success", "output_path": result_path}
    except Exception as e:
        return {"status": "error", "message": str(e)}

@celery_app.task
def process_images():
    """定时处理图片任务"""
    image_dir = "images/pending"
    if not os.path.exists(image_dir):
        return {"status": "error", "message": "Pending directory not found"}

    processed = 0
    for image in os.listdir(image_dir):
        if image.lower().endswith(('.png', '.jpg', '.jpeg')):
            add_watermark_task.delay(
                os.path.join(image_dir, image),
                "自动处理水印",
                'center'
            )
            processed += 1

    return {"status": "success", "processed": processed}

@celery_app.task
def cleanup_old_images():
    """清理旧图片任务"""
    output_dir = "images/processed"
    if not os.path.exists(output_dir):
        return {"status": "error", "message": "Output directory not found"}

    threshold_date = datetime.now() - timedelta(days=7)
    cleaned = 0

    for image in os.listdir(output_dir):
        image_path = os.path.join(output_dir, image)
        if os.path.getctime(image_path) < threshold_date.timestamp():
            os.remove(image_path)
            cleaned += 1

    return {"status": "success", "cleaned": cleaned}

5.创建 FastAPI 应用:

from fastapi import FastAPI, File, UploadFile, BackgroundTasks
from fastapi.responses import JSONResponse
import os
from app.tasks import add_watermark_task
from app.celery_app import celery_app

app = FastAPI(title="图片水印处理服务")

@app.post("/upload/")
async def upload_image(
    file: UploadFile = File(...),
    text: str = "水印文本",
    position: str = "center"
):
    # 保存上传的文件
    file_path = f"images/uploads/{file.filename}"
    os.makedirs(os.path.dirname(file_path), exist_ok=True)
    
    with open(file_path, "wb") as buffer:
        content = await file.read()
        buffer.write(content)
    
    # 创建异步任务
    task = add_watermark_task.delay(file_path, text, position)
    
    return JSONResponse({
        "status": "success",
        "message": "图片已上传并加入处理队列",
        "task_id": task.id
    })

@app.get("/task/{task_id}")
async def get_task_status(task_id: str):
    task = celery_app.AsyncResult(task_id)
    if task.ready():
        return {"status": "completed", "result": task.result}
    return {"status": "processing"}

@app.get("/tasks/scheduled")
async def get_scheduled_tasks():
    return {"tasks": celery_app.conf.beat_schedule}

6.创建 Celery worker 启动文件:

from app.celery_app import celery_app

if __name__ == '__main__':
    celery_app.start()

使用说明

首先安装依赖:

pip install -r requirements.txt

确保 RabbitMQ 服务已启动

启动 FastAPI 服务器:

uvicorn app.main:app --reload

启动 Celery worker:

celery -A celery_worker.celery_app worker --loglevel=info

启动 Celery beat(定时任务):

celery -A celery_worker.celery_app beat --loglevel=info

这个系统提供以下功能:

  • 通过 FastAPI 接口上传图片并异步处理水印
  • 使用 Celery 处理异步任务队列
  • 使用 RabbitMQ 作为消息代理
  • 支持定时任务:
    • 每小时自动处理待处理图片
    • 每天清理一周前的旧图片
  • 支持任务状态查询
  • 支持查看计划任务列表

API 端点:

  • POST /upload/ - 上传图片并创建水印任务
  • GET /task/{task_id} - 查询任务状态
  • GET /tasks/scheduled - 查看计划任务列表

以上就是Python FastAPI+Celery+RabbitMQ实现分布式图片水印处理系统的详细内容,更多关于Python图片水印的资料请关注脚本之家其它相关文章!

相关文章

  • python脚本监听域名证书过期时间并通知消息到钉钉(最新推荐)

    python脚本监听域名证书过期时间并通知消息到钉钉(最新推荐)

    这篇文章主要介绍了python脚本监听域名证书过期时间并通知消息到钉钉(最新推荐),本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2023-11-11
  • Tkinter组件Entry的具体使用

    Tkinter组件Entry的具体使用

    本文主要介绍了Tkinter组件Entry的具体使用,Entry组件通常用于获取用户的输入文本,文中通过示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2022-01-01
  • Opencv求取连通区域重心实例

    Opencv求取连通区域重心实例

    这篇文章主要介绍了Opencv求取连通区域重心实例,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-06-06
  • Python中type()函数的具体使用

    Python中type()函数的具体使用

    在Python中,type()函数是一个非常有用的工具,它可以查看变量或对象的数据类型,本文主要介绍了Python中type()函数的具体使用,感兴趣的可以一起来了解一下
    2024-01-01
  • 使用python tkinter实现各种个样的撩妹鼠标拖尾效果

    使用python tkinter实现各种个样的撩妹鼠标拖尾效果

    这篇文章主要介绍了使用python tkinter实现各种个样的撩妹鼠标拖尾效果,本文通过实例代码,给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2021-09-09
  • Python利用3D引擎做一个太阳系行星模拟器

    Python利用3D引擎做一个太阳系行星模拟器

    Python有一个不错的3D引擎——Ursina。本文就来利用Ursina这一3D引擎做一个太阳系行星模拟器,感兴趣的小伙伴可以跟随小编一起学习一下
    2023-01-01
  • Python实现中英文全文搜索的示例

    Python实现中英文全文搜索的示例

    这篇文章主要介绍了Python实现中英文全文搜索的示例,帮助大家更好的理解和学习python,感兴趣的朋友可以了解下
    2020-12-12
  • python sqlobject(mysql)中文乱码解决方法

    python sqlobject(mysql)中文乱码解决方法

    在使用python写项目的时候,用到了sqlobject库函数connectionForURI连接mysql,但是遇到了中文显示乱码的问题,在添加记录的时候还抛出异常
    2008-11-11
  • Python中Permission denied的解决方案

    Python中Permission denied的解决方案

    这篇文章主要介绍了Python中Permission denied的解决方案,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2021-04-04
  • Python实现批量填补遥感影像的无效值NoData

    Python实现批量填补遥感影像的无效值NoData

    这篇文章主要为大家介绍了如何基于Python中ArcPy模块,对大量栅格遥感影像文件批量进行无效值(NoData值)填充的方法,感兴趣的小伙伴可以了解一下
    2023-06-06

最新评论