tangrongs/xinference Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

xinference 容器适配说明

镜像概述

xinference官方提供的容器在部分设备上存在兼容性限制，具体表现为在CUDA版本低于12.4的环境中无法正常运行。为解决此问题，用户需自行打包适配低版本CUDA环境的容器镜像。

核心特性

• 解决官方容器对CUDA 12.4以下环境的兼容性问题
• 允许用户根据设备实际CUDA版本定制化构建容器
• 保持xinference核心功能，适配低版本CUDA运行环境

适用场景

• 设备CUDA版本低于12.4，需要部署xinference服务
• 官方容器无法在本地CUDA环境中启动时
• 需要在低版本CUDA环境中运行xinference推理服务

使用方法

前提条件

• 已安装Docker环境
• 本地设备CUDA版本低于12.4
• 已安装Git工具（用于获取源码）

自行打包步骤

1. 获取xinference源码

bash
git clone [***]
cd inference

2. 修改Dockerfile适配低版本CUDA

编辑项目根目录下的Dockerfile，将基础镜像更换为适配目标CUDA版本的镜像，例如适配CUDA 11.8：

dockerfile
# 替换原基础镜像为对应CUDA版本
FROM nvidia/cuda:11.8.0-cudnn8-devel-ubuntu22.04

3. 调整依赖版本

根据目标CUDA版本，修改requirements.txt或相关配置文件，调整PyTorch等依赖库版本以适配低版本CUDA。

4. 构建自定义镜像

bash
docker build -t xinference-custom:latest .

5. 运行自定义容器

bash
docker run -d --gpus all -p 9997:9997 xinference-custom:latest

注意事项

• 确保基础镜像的CUDA版本与本地设备匹配
• 构建过程中若出现依赖冲突，需根据错误提示调整相关库版本
• 启动后建议通过docker logs命令检查服务运行状态，确保xinference正常启动