m1chl/nsfw-sherlock

NSFW Sherlock 镜像说明

基于GO和TensorFlow构建

https://img.shields.io/badge/license-AGPL-blue.svg]([***] https://goreportcard.com/badge/github.com/M1chlCZ/nsfw_sherlock](https://goreportcard.com/report/github.com/M1chlCZ/nsfw_sherlock) https://godoc.org/github.com/M1chlCZ/nsfw_sherlock?status.svg](https://godoc.org/github.com/M1chlCZ/nsfw_sherlock) https://img.shields.io/docker/v/m1chl/nsfw-sherlock/latest?color=green&label=Docker%20Hub&style=flat](https://hub.docker.com/repository/docker/m1chl/nsfw-sherlock/general)

镜像概述

这是一个轻量级的NSFW（Not Safe For Work）内容检测API容器，支持HTTP和GRPC两种接口，可快速识别图像中的NSFW内容（包括图像本身及图像中的文字）。
更新说明（版本0.0.0.4）：新增分类标签接口，可直接返回详细分类结果（Drawings、Neutral、Hentai、Porn、***）及其分值，支持HTTP和GRPC接口。

核心功能

• 图像NSFW检测：判断图像是否为NSFW内容
• 图像文字NSFW检测：识别图像中的文字是否含NSFW内容
• 分类标签返回：提供详细分类结果（Drawings/Neutral/Hentai/Porn/***）及分值
• 自定义敏感词：支持挂载外部敏感词文件调整检测规则
• 双接口支持：同时提供HTTP和GRPC两种API接口

使用场景

• 社交平台、论坛等内容平台的图像审核
• 电商平台商品图片合规检查
• 企业内部内容安全过滤
• 应用程序中的图像安全验证

配置说明

• 环境变量：APP_ENV 指定接口类型，可选值为 http 或 grpc
• 端口映射：默认使用4000端口，可通过 -p 参数映射到主机端口
• 自定义敏感词：通过 -v 参数挂载本地 bad_words.txt 文件到容器内 /bad_words.txt 路径

部署示例

Git Clone方式部署

bash
# 克隆代码仓库
git clone https://github.com/M1chlCZ/nsfw_sherlock nsfw_sherlock
cd nsfw_sherlock

# 构建镜像
docker build -t nsfwsherlock .

# 启动GRPC服务
docker run -e APP_ENV=grpc -p 4000:4000 docker.xuanyuan.run/nsfwsherlock
# 注：GRPC接口需参考./proto目录下的proto文件

# 启动HTTP服务
docker run -e APP_ENV=http -p 4000:4000 docker.xuanyuan.run/nsfwsherlock
# HTTP接口说明：
# POST /pic/check：检测图像是否为NSFW
# 请求体：{"base64": "图像base64字符串", "filename": "图像名称"}
# 返回体：{"status": "ok", "message": "success", "nsfwText": true/false, "nsfwPic": true/false}
# POST /pic/labels：获取详细分类标签
# 请求体：{"base64": "图像base64字符串", "filename": "图像名称"}
# 返回体：{"status": "ok", "message": "success", "drawings": 0.0, "hentai": 0.0, "neutral":0.0, "porn":0.0, "sexy":0.0, "nsfwText": true/false}

# 挂载自定义敏感词文件
docker run -e APP_ENV=http -v /本地路径/bad_words.txt:/bad_words.txt -p 4000:4000 docker.xuanyuan.run/nsfwsherlock

Docker Hub方式部署

bash
# 拉取镜像
docker pull docker.xuanyuan.run/m1chl/nsfw-sherlock

# 启动GRPC服务
docker run -e APP_ENV=grpc -p 4000:4000 docker.xuanyuan.run/m1chl/nsfw-sherlock

# 启动HTTP服务
docker run -e APP_ENV=http -p 4000:4000 docker.xuanyuan.run/m1chl/nsfw-sherlock

# 挂载自定义敏感词文件
docker run -e APP_ENV=http -v /本地路径/bad_words.txt:/bad_words.txt -p 4000:4000 docker.xuanyuan.run/m1chl/nsfw-sherlock

参考致谢

• 模型来源：https://github.com/GantMan/nsfw_model
• TensorFlow-GO库：https://github.com/galeone/tfgo
• OCR库：https://github.com/otiai10/gosseract