pavlov/match

Pavlov Match：可扩展反向图像搜索工具

镜像概述

Pavlov Match是一款基于Kubernetes和Elasticsearch构建的可扩展反向图像搜索工具，利用先进的感知哈希技术实现图像相似性搜索，不受缩放和90度旋转影响。其HTTP API易于集成，适用于多种反向图像搜索场景，可轻松扩展至数十亿图像规模，并让用户完全控制数据存储位置。该工具底层依赖开源项目ascribe/image-match完成核心图像搜索工作。

核心功能

• 添加图像：将图像签名存入数据库，支持URL或文件上传方式。
• 删除图像：从数据库中移除指定路径的图像签名。
• 搜索相似图像：根据输入图像查找数据库中相似的图像，返回相似度得分（0-100）。
• 比较图像：计算两张图像的相似度得分。
• 计数与列表：统计数据库中图像数量，或列出指定范围的图像路径。
• 健康检查：验证服务是否正常运行。

使用场景

• 电商平台：相似商品推荐、重复商品检测。
• 版权保护：图像侵权检测、原创内容验证。
• 相册管理：相似照片整理、重复照片去重。
• 内容审核：平台内重复图像识别、违规图像排查。

配置说明

通过环境变量配置工具参数：

• WORKER_COUNT：gunicorn工作进程数，默认值4。
• ELASTICSEARCH_URL：Elasticsearch数据库地址，默认值elasticsearch:9200。
• ELASTICSEARCH_INDEX：存储图像签名的索引名，默认值images。
• ELASTICSEARCH_DOC_TYPE：图像签名的文档类型，默认值images。

部署示例

Docker运行（已有Elasticsearch）

bash
docker run -e ELASTICSEARCH_URL=https://daisy.us-west-1.es.amazonaws.com -it docker.xuanyuan.run/pavlov/match

Docker Compose运行（含本地Elasticsearch）

1. 克隆仓库：git clone https://github.com/pavlovai/match.git
2. 执行命令：make dev

Kubernetes部署

服务配置（match-service.yml）

yaml
apiVersion: v1
kind: Service
metadata:
  name: match
spec:
  ports:
  - name: http
    port: 80
    protocol: TCP
  selector:
    app: match

复制控制器配置（match-rc.yml）

yaml
apiVersion: v1
kind: ReplicationController
metadata:
  name: match
spec:
  replicas: 1
  selector:
    app: match
  template:
    metadata:
      labels:
        app: match
    spec:
      containers:
      - name: match
        image: docker.xuanyuan.run/pavlov/match:latest
        ports:
        - containerPort: 80
        env:
        - name: WORKER_COUNT
          value: "4"
        - name: ELASTICSEARCH_URL
          valueFrom:
            secretKeyRef:
              name: match
              key: elasticsearch.url
        - name: ELASTICSEARCH_INDEX
          valueFrom:
            secretKeyRef:
              name: match
              key: elasticsearch.index
        - name: ELASTICSEARCH_DOC_TYPE
          valueFrom:
            secretKeyRef:
              name: match
              key: elasticsearch.doc-type

密钥配置（match-secret.yml）

yaml
apiVersion: v1
kind: Secret
metadata:
  name: match
data:
  elasticsearch.url: aHR0cHM6Ly9kYWlzeS51cy13ZXN0LTEuZXMuYW1hem9uYXdzLmNvbQ==
  elasticsearch.index: aW1hZ2Vz
  elasticsearch.doc-type: aW1hZ2Vz

许可证

Pavlov Match基于BSD 3-Clause许可证发布，底层依赖的ascribe/image-match基于Apache 2.0许可证。