konieshadow/fooocus-api

Fooocus-API Docker镜像文档

镜像概述

Fooocus-API Docker镜像是一个基于FastAPI构建的API服务镜像，用于为https://github.com/lllyasviel/Fooocus%E6%8F%90%E4%BE%9BAPI%E8%AE%BF%E9%97%AE%E8%83%BD%E5%8A%9B%E3%80%82%E8%AF%A5%E9%95%9C%E5%83%8F%E5%B0%81%E8%A3%85%E4%BA%86Fooocus%E7%9A%84%E6%A0%B8%E5%BF%83%E5%8A%9F%E8%83%BD%EF%BC%8C%E9%80%9A%E8%BF%87API%E6%8E%A5%E5%8F%A3%E5%BD%A2%E5%BC%8F%E6%8F%90%E4%BE%9B%E6%9C%8D%E5%8A%A1%EF%BC%8C%E6%94%AF%E6%8C%81GPU%E5%8A%A0%E9%80%9F%EF%BC%8C%E5%8F%AF%E5%BF%AB%E9%80%9F%E9%83%A8%E7%BD%B2%E5%92%8C%E9%9B%86%E6%88%90%E5%88%B0%E5%90%84%E7%B1%BB%E5%BA%94%E7%94%A8%E4%B8%AD%E3%80%82

项目源码：https://github.com/konieshadow/Fooocus-API

核心功能与特性

• FastAPI驱动：基于FastAPI框架构建，提供高性能、异步的API服务
• GPU支持：支持NVIDIA GPU加速，需配合NVIDIA Docker运行时
• 数据持久化：可通过挂载卷实现依赖仓库和pip缓存的持久化存储
• 简单部署：提供简洁的启动命令，快速部署API服务

使用场景

• 需要通过API接口调用Fooocus功能的应用开发
• 快速搭建Fooocus服务用于测试或生产环境
• 集成Fooocus能力到现有系统中

使用方法

基本用法

使用以下命令快速启动Fooocus-API服务：

bash
docker run --gpus=all -e NVIDIA_DRIVER_CAPABILITIES=compute,utility -e NVIDIA_VISIBLE_DEVICES=all -p 8888:8888 docker.xuanyuan.run/konieshadow/fooocus-api

参数说明：

• --gpus=all：启用所有可用GPU
• -e NVIDIA_DRIVER_CAPABILITIES=compute,utility：设置NVIDIA驱动能力，支持计算和工具功能
• -e NVIDIA_VISIBLE_DEVICES=all：设置可见的GPU设备
• -p 8888:8888：将容器的8888端口映射到主机的8888端口

复杂用法（数据持久化）

为持久化存储依赖仓库和pip缓存，可通过挂载卷实现：

bash
# 创建本地目录
mkdir ~/repositories
mkdir -p ~/.cache/pip

# 启动容器并挂载卷
docker run --gpus=all -e NVIDIA_DRIVER_CAPABILITIES=compute,utility -e NVIDIA_VISIBLE_DEVICES=all \
    -v ~/repositories:/app/repositories \
    -v ~/.cache/pip:/root/.cache/pip \
    -p 8888:8888 docker.xuanyuan.run/konieshadow/fooocus-api

卷挂载说明：

• -v ~/repositories:/app/repositories：持久化存储依赖仓库
• -v ~/.cache/pip:/root/.cache/pip：持久化存储pip缓存，加速后续依赖安装

访问服务

服务启动后，可通过http://localhost:8888访问API服务，具体接口文档可参考项目源码中的API说明。