chungpt2123/sglang

自定义sglang镜像（带FastAPI根路径配置）

镜像概述

本镜像为自定义构建的sglang镜像，集成了FastAPI根路径（root path）配置功能，允许用户通过环境变量灵活设置API服务的根访问路径，适用于需要自定义API路由前缀的部署场景。

核心功能与特性

• FastAPI根路径自定义：支持通过环境变量配置FastAPI服务的根路径
• 环境变量驱动：通过SGLANG_ROOT_PATH环境变量控制API根路径
• 兼容性：基于标准sglang构建，保留其原有核心功能

使用场景

• 反向代理环境下需要统一API路径前缀
• 多服务共存时需通过路径区分不同服务
• 特定网络环境要求API路径符合企业规范

使用方法与配置说明

环境变量说明

Docker Run示例

bash
docker run -d \
  -p 8000:8000 \
  -e SGLANG_ROOT_PATH="/api/sglang" \
  --name custom-sglang \
  [镜像名称]:[标签]

上述命令将启动sglang服务，API根路径设置为/api/sglang，此时访问路径将变为http://localhost:8000/api/sglang/[原API路径]。

Docker Compose示例

yaml
version: '3'
services:
  sglang:
    image: [镜像名称]:[标签]
    ports:
      - "8000:8000"
    environment:
      - SGLANG_ROOT_PATH=/api/sglang
    restart: unless-stopped

注意事项

• SGLANG_ROOT_PATH值应以/开头（如/api）
• 配置后需确保客户端请求路径与设置的根路径匹配
• 如不设置此环境变量，将使用FastAPI默认根路径（空路径）