FastAPI-DLS 搭建（NVIDIA vGPU 激活）

参考项目：https://git.collinwebdesigns.de/oscar.krause/fastapi-dls

本文用于在局域网内搭建一个可用的 DLS 服务，给 vGPU 客户端下发激活 token。

1. 生成证书#

在 Docker 主机执行：

1
WORKING_DIR=/opt/docker/fastapi-dls/cert
2
mkdir -p "$WORKING_DIR"
3
cd "$WORKING_DIR"
4

5
# 客户端依赖 HTTPS，这里生成自签证书供 uvicorn 使用
6
openssl req -x509 -nodes -days 3650 -newkey rsa:2048 \
7
  -keyout "$WORKING_DIR/webserver.key" \
8
  -out "$WORKING_DIR/webserver.crt"

2. 启动容器#

准备 compose.yaml：

1
version: "3.9"
2

3
x-dls-variables: &dls-variables
4
  TZ: Asia/Shanghai # 必填，服务端和客户端时区要一致
5
  DLS_URL: 192.168.31.52 # 必填，改成你的服务 IP 或域名
6
  DLS_PORT: 443
7
  LEASE_EXPIRE_DAYS: 90 # 最大 90 天
8
  DATABASE: sqlite:////app/database/db.sqlite
9
  DEBUG: false
10

11
services:
12
  dls:
13
    image: collinwebdesigns/fastapi-dls:latest
14
    restart: always
15
    environment:
16
      <<: *dls-variables
17
    ports:
18
      - "443:443"
19
    volumes:
20
      - /opt/docker/fastapi-dls/cert:/app/cert
21
      - dls-db:/app/database
22
    logging:
23
      driver: "json-file"
24
      options:
25
        max-file: 5
26
        max-size: 10m
27

28
volumes:
29
  dls-db:

启动：

1
docker compose up -d

3. 客户端 token 下发与授权检查#

将 <dls-hostname-or-ip> 替换成你的 DLS 地址。

Linux#

下载 client-token 到 /etc/nvidia/ClientConfigToken：

1
curl --insecure -L -X GET \
2
  https://<dls-hostname-or-ip>/-/client-token \
3
  -o /etc/nvidia/ClientConfigToken/client_configuration_token_$(date '+%d-%m-%Y-%H-%M-%S').tok

或：

1
wget --no-check-certificate \
2
  -O /etc/nvidia/ClientConfigToken/client_configuration_token_$(date '+%d-%m-%Y-%H-%M-%S').tok \
3
  https://<dls-hostname-or-ip>/-/client-token

重启 nvidia-gridd 服务：

1
service nvidia-gridd restart

检查授权状态：

1
nvidia-smi -q | grep -A 2 "vGPU Software Licensed Product"

预期输出类似：

1
vGPU Software Licensed Product
2
    License Status                    : Licensed (Expiry: YYYY-M-DD hh:mm:ss GMT)

Windows#

在 PowerShell（管理员）执行，下载 client-token 到
C:\Program Files\NVIDIA Corporation\vGPU Licensing\ClientConfigToken：

1
curl.exe --insecure -L -X GET https://<dls-hostname-or-ip>/-/client-token -o "C:\Program Files\NVIDIA Corporation\vGPU Licensing\ClientConfigToken\client_configuration_token_$($(Get-Date).ToString('dd-MM-yy-hh-mm-ss')).tok"

重启服务：

1
Restart-Service NVDisplay.ContainerLocalSystem

检查授权状态：

1
& 'nvidia-smi' -q | Select-String "License"

预期输出类似：

1
vGPU Software Licensed Product
2
    License Status                    : Licensed (Expiry: YYYY-M-DD hh:mm:ss GMT)

4. 配套项目#

需要配合使用：
https://git.collinwebdesigns.de/vgpu/gridd-unlock-patcher