GLM 模型部署
GLM-5/5.1 模型部署
本章节以 GLM-5-FP8 部署为例,采取的方案是4P4D,即4台机器作为Prefill,4台机器为Decode。最小部署模式为2P4D,注意 256(expert数)需要能被 Decode 机器数整除。该部署方式同样适用于 GLM-5.1。
- 脚本涉及的参数说明和一键运行说明见 快速开始。
- 如果需要修改部署方式,请更新
run.sh中PREFILL_SERVER_COUNT和DECODE_SERVER_COUNT。 - DeepEP 的配置文件内容参考 DeepEP 配置文件
info
启动 SGLang 服务前需要切换python虚拟环境,执行命令:workon glm5
Prefill启动
prefill启动脚本 prefill_server.sh
#!/bin/bash
source /root/.local/bin/uv-virtualenvwrapper.sh
workon glm5
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
export LD_LIBRARY_PATH=/usr/lib/x86_64-linux-gnu/:/usr/local/musa/lib:$LD_LIBRARY_PATH
export PYTHONPATH=/sgl-workspace/sglang-glm5/python:$PYTHONPATH
export MATE_FORCE_JIT=1
export SGLANG_USE_MTT_F8GEMM=1
export SGLANG_USE_MTT_HGEMM=1
export SGLANG_USE_MTT_EPI_QKV=1
export SGLANG_USE_MTT_INDEXER=1
export SGLANG_NSA_FUSE_TOPK=1
export SGLANG_USE_MTT_ATTN=1
export TP_SOCKET_IFNAME=bond0
export GLOO_SOCKET_IFNAME=bond0
export VLLM_PATCH_MUSA_CUSTOM_OPS=1
# export PYTORCH_MUSA_ALLOC_CONF=expandable_segments:True
# export MUSA_BLOCK_SCHEDULE_MODE=1
# export MUSA_USERQ=1
export MUSA_PRINT_ENV=0
export MUSA_LAUNCH_BLOCKING=0
# export MUSA_EXECUTION_TIMEOUT=12000
export MUSA_ERROR_DUMP_VERBOSE=1
export MUSA_ENABLE_LLC_OPT=1
export MCCL_PROTOS=2
export MCCL_IB_GID_INDEX=3
export MCCL_NET_SHARED_BUFFERS=0
# mooncake
export MC_TE_METRIC=1
export MC_ENABLE_DEST_DEVICE_AFFINITY=1
export SGLANG_SET_CPU_AFFINITY=1
export SGLANG_DEEPEP_USE_MUSA_ACE=1
export SGLANG_SBO_COMBINE_SHARED=1
export SGLANG_DEEPEP_BF16_DISPATCH=0
export SGLANG_ENABLE_TORCH_INFERENCE_MODE=true
export SGLANG_DISAGGREGATION_QUEUE_SIZE=8
export SGLANG_DISAGGREGATION_THREAD_POOL_SIZE=16
export SGLANG_DISAGGREGATION_BOOTSTRAP_TIMEOUT=600
export SGLANG_DISAGGREGATION_WAITING_TIMEOUT=300
export SGLANG_DISAGGREGATION_MAPPING_IB_DEVICE_TO_GPU=1
export SGLANG_HEALTH_CHECK_TIMEOUT=100
export SGLANG_TORCH_PROFILER_DIR=$SCRIPT_DIR/traces
export SGLANG_EXPERT_DISTRIBUTION_RECORDER_DIR=$SCRIPT_DIR/traces
# 获取当前环境的 RDMA 设备名列表,在启动时作为 disaggregation-ib-device 参数值
IB_DEVS=()
for dev in /sys/class/infiniband/*; do
ibdev=$(basename "$dev")
for port in "$dev"/ports/*; do
rate=$(cat "$port/rate" 2>/dev/null)
# link_layer: InfiniBand / Ethernet (RoCE)
link=$(cat "$port/link_layer" 2>/dev/null)
state=$(cat "$port/state" 2>/dev/null)
if [[ "$rate" == *"200 Gb"* || "$rate" == *"400 Gb"* ]] && [[ "$state" == "4"* ]]; then
IB_DEVS+=("$ibdev")
break
fi
done
done
IB_DEVS_SORTED=$(printf "%s\n" "${IB_DEVS[@]}" | sort -V | uniq)
MCCL_IB_HCA=$(echo "$IB_DEVS_SORTED" | paste -sd, -)
SGLANG_IB_DEVICES="$MCCL_IB_HCA"
echo "IB_DEVICES=$MCCL_IB_HCA"
nsa_backend="tilelang"
if [ $SGLANG_USE_MTT_ATTN -gt 0 ]; then
nsa_backend="mtt_dsa"
fi
NODE_RANK=$1
PREFILL_IP="${2}:5303"
LOG_DIR=$3
MODEL_PATH=$4
HOST_IP=$5
NNODES=$6
SGLANG_PORT=20133
DEEP_EP_CONFIG="${SCRIPT_DIR}/deepep.config"
mkdir -p "${LOG_DIR}"
rm -rf ~/.triton/cache/
nohup python3 -m sglang.launch_server \
--model $MODEL_PATH \
--served-model-name glm-5-fp8 \
--trust-remote-code \
--disable-overlap-schedule \
--enable-single-batch-overlap \
--disable-cuda-graph \
--tp-size 8 \
--ep-size 8 \
--dp-size 8 \
--pp-size $NNODES \
--enable-dp-lm-head \
--moe-dense-tp-size 1 \
--enable-dp-attention \
--moe-a2a-backend deepep \
--deepep-mode normal \
--deepep-config "$DEEP_EP_CONFIG" \
--attention-backend nsa \
--nsa-prefill-backend $nsa_backend \
--nsa-decode-backend $nsa_backend \
--sampling-backend flashinfer \
--mem-fraction-static 0.75 \
--max-running-requests $((NNODES * 8)) \
--chunked-prefill-size $((8 * 4096)) \
--max-prefill-tokens $((128 * 1024)) \
--dist-init-addr ${PREFILL_IP} \
--nnodes ${NNODES} \
--node-rank ${NODE_RANK} \
--host 0.0.0.0 \
--port ${SGLANG_PORT} \
--log-requests-level 3 \
--log-level info \
--enable-metrics \
--enable-metrics-for-all-schedulers \
--export-metrics-to-file \
--export-metrics-to-file-dir ${LOG_DIR} \
--enable-cache-report \
--load-balance-method round_robin \
--disaggregation-mode prefill \
--disaggregation-ib-device $SGLANG_IB_DEVICES > "${LOG_DIR}/P${NODE_RANK}_${HOST_IP}_$(date '+%Y%m%d_%H%M%S').log" 2>&1 &
Decode启动
decoder启动脚本 decode_server.sh
#!/bin/bash
source /root/.local/bin/uv-virtualenvwrapper.sh
workon glm5
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
export LD_LIBRARY_PATH=/usr/lib/x86_64-linux-gnu/:/usr/local/musa/lib:$LD_LIBRARY_PATH
export PYTHONPATH=/sgl-workspace/sglang-glm5/python:$PYTHONPATH
export MATE_FORCE_JIT=1
export SGLANG_USE_MTT_F8GEMM=1
export SGLANG_USE_MTT_HGEMM=1
export SGLANG_USE_MTT_EPI_QKV=1
export SGLANG_USE_MTT_INDEXER=1
export SGLANG_NSA_FUSE_TOPK=1
export SGLANG_USE_MTT_ATTN=1
export TP_SOCKET_IFNAME=bond0
export GLOO_SOCKET_IFNAME=bond0
export VLLM_PATCH_MUSA_CUSTOM_OPS=1
# export PYTORCH_MUSA_ALLOC_CONF=expandable_segments:True
# export MUSA_BLOCK_SCHEDULE_MODE=1
# export MUSA_USERQ=1
export MUSA_PRINT_ENV=0
export MUSA_LAUNCH_BLOCKING=0
# export MUSA_EXECUTION_TIMEOUT=12000
export MUSA_ERROR_DUMP_VERBOSE=1
export MUSA_ENABLE_LLC_OPT=1
export MCCL_PROTOS=2
export MCCL_IB_GID_INDEX=3
export MCCL_NET_SHARED_BUFFERS=0
# mooncake
export MC_TE_METRIC=1
export MC_ENABLE_DEST_DEVICE_AFFINITY=1
export SGLANG_SET_CPU_AFFINITY=1
export SGLANG_SBO_COMBINE_SHARED=1
export SGLANG_DEEPEP_BF16_DISPATCH=0
export SGLANG_ENABLE_TORCH_INFERENCE_MODE=true
export SGLANG_DISAGGREGATION_HEARTBEAT_INTERVAL=1000
export SGLANG_DISAGGREGATION_QUEUE_SIZE=8
export SGLANG_DISAGGREGATION_THREAD_POOL_SIZE=16
export SGLANG_DISAGGREGATION_BOOTSTRAP_TIMEOUT=600
export SGLANG_DISAGGREGATION_WAITING_TIMEOUT=300
export SGLANG_DISAGGREGATION_MAPPING_IB_DEVICE_TO_GPU=1
export SGLANG_HEALTH_CHECK_TIMEOUT=100
export SGLANG_TORCH_PROFILER_DIR=$SCRIPT_DIR/traces
export SGLANG_EXPERT_DISTRIBUTION_RECORDER_DIR=$SCRIPT_DIR/traces
nsa_backend="tilelang"
if [ $SGLANG_USE_MTT_ATTN -gt 0 ]; then
nsa_backend="mtt_dsa"
fi
# 获取当前环境的 RDMA 设备名列表,在启动时作为 disaggregation-ib-device 参数值
IB_DEVS=()
for dev in /sys/class/infiniband/*; do
ibdev=$(basename "$dev")
for port in "$dev"/ports/*; do
# 速率(如 200 Gb/sec)
rate=$(cat "$port/rate" 2>/dev/null)
# link_layer: InfiniBand / Ethernet (RoCE)
link=$(cat "$port/link_layer" 2>/dev/null)
# 状态为 Up
state=$(cat "$port/state" 2>/dev/null)
# 只要是 200G/400G 且状态为 Up(IB 或 RoCE 都收)
if [[ "$rate" == *"200 Gb"* || "$rate" == *"400 Gb"* ]] && [[ "$state" == "4"* ]]; then
IB_DEVS+=("$ibdev")
break
fi
done
done
# 排序 + 去重
IB_DEVS_SORTED=$(printf "%s\n" "${IB_DEVS[@]}" | sort -V | uniq)
# 生成 MCCL / SGLang 变量
MCCL_IB_HCA=$(echo "$IB_DEVS_SORTED" | paste -sd, -)
SGLANG_IB_DEVICES="$MCCL_IB_HCA"
echo "IB_DEVICES=$MCCL_IB_HCA"
NODE_RANK=$1
DECODER_IP="${2}:5403"
LOG_DIR=$3
MODEL_PATH=$4
HOST_IP=$5
NNODES=$6
SGLANG_PORT=20143
graph_bs=4
mkdir -p "${LOG_DIR}"
rm -rf ~/.triton/cache/
nohup python3 -m sglang.launch_server \
--model $MODEL_PATH \
--trust-remote-code \
--disable-overlap-schedule \
--enable-single-batch-overlap \
--cuda-graph-bs $(seq 1 $graph_bs) \
--tp-size $((NNODES * 8)) \
--ep-size $((NNODES * 8)) \
--dp-size $((NNODES * 8)) \
--enable-dp-lm-head \
--moe-dense-tp-size 1 \
--enable-dp-attention \
--disable-shared-experts-fusion \
--moe-a2a-backend deepep \
--deepep-mode low_latency \
--attention-backend nsa \
--nsa-prefill-backend $nsa_backend \
--nsa-decode-backend $nsa_backend \
--sampling-backend flashinfer \
--speculative-algorithm EAGLE \
--speculative-num-steps 3 \
--speculative-eagle-topk 1 \
--speculative-num-draft-tokens 4 \
--reasoning-parser glm45 \
--tool-call-parser glm47 \
--mem-fraction-static 0.75 \
--max-running-requests $((NNODES * 8 * graph_bs)) \
--dist-init-addr ${DECODER_IP} \
--nnodes ${NNODES} \
--node-rank ${NODE_RANK} \
--host 0.0.0.0 \
--port ${SGLANG_PORT} \
--log-requests-level 3 \
--log-level info \
--enable-metrics \
--enable-metrics-for-all-schedulers \
--export-metrics-to-file \
--export-metrics-to-file-dir ${LOG_DIR} \
--prefill-round-robin-balance \
--load-balance-method shortest_queue \
--disaggregation-mode decode \
--disaggregation-ib-device $SGLANG_IB_DEVICES > "${LOG_DIR}/D${NODE_RANK}_${HOST_IP}_$(date '+%Y%m%d_%H%M%S').log" 2>&1 &
Router启动
Router 启动脚本 router.sh
#!/bin/bash
source /root/.local/bin/uv-virtualenvwrapper.sh
workon glm5
export PYTHONPATH=/sgl-workspace/sglang-glm5/python:$PYTHONPATH
PREFILL_IP="http://${1}:20133"
DECODE_IP="http://$2:20143"
LOG_DIR=$3
ulimit -n 65535
nohup python -m sglang_router.launch_router \
--pd-disaggregation \
--prefill $PREFILL_IP \
--decode $DECODE_IP \
--host 0.0.0.0 \
--request-timeout-secs 7200 \
--port 30000 > "${LOG_DIR}/router_$(date '+%Y%m%d_%H%M%S').log" 2>&1 &
创建 hostfile 文件
hostfile文件示例
192.168.100.101
192.168.100.102
192.168.100.103
192.168.100.104
192.168.100.105
192.168.100.106
192.168.100.107
192.168.100.108
一键启动所有服务
一键运行脚本 run.sh
#!/bin/bash
CURRENT_TIME=$(date "+%Y%m%d_%H%M%S")
#echo $CURRENT_TIME
#mkdir -p ./output/$CURRENT_TIME
PREFILL_SERVER_COUNT=${PREFILL_SERVER_COUNT:-4}
DECODER_SERVER_COUNT=${DECODER_SERVER_COUNT:-4}
WORLD_SIZE=$(( (PREFILL_SERVER_COUNT + DECODER_SERVER_COUNT) * 8 ))
port=62216
echo -e "\033[32mPREFILL_SERVER_COUNT: $PREFILL_SERVER_COUNT, DECODER_SERVER_COUNT: $DECODER_SERVER_COUNT, \033[0m"
set -u
WORK_HOME="$PWD"
EXPNAME="P${PREFILL_SERVER_COUNT}_D${DECODER_SERVER_COUNT}_gpus${WORLD_SIZE}"
MODEL_PATH=${MODEL_PATH:-"/data/models/GLM-5-FP8"}
HOSTFILE=./hostfile
LOG_DIR=$WORK_HOME/output/$EXPNAME/$CURRENT_TIME/
PREFILL_SCRIPT_FILE="$WORK_HOME/prefill_server.sh"
DECODER_SCRIPT_FILE="$WORK_HOME/decode_server.sh"
ROUTER_SCRIPT_FILE="$WORK_HOME/router.sh"
set +u
echo -e "\033[32mWORK_HOME: $WORK_HOME\033[0m"
echo -e "\033[32mMODEL_PATH: $MODEL_PATH\033[0m"
echo -e "\033[32mPREFILL_CRIPT_FILE: $PREFILL_SCRIPT_FILE\033[0m"
echo -e "\033[32mDECODER_SCRIPT_FILE: $DECODER_SCRIPT_FILE\033[0m"
# bash generate_hostfile.sh
COUNT=0
hostlist=$(grep -v '^#\|^$' $HOSTFILE | awk '{print $1}' | xargs)
# Check if hostlist is empty
if [ -z "$hostlist" ]; then
echo "Error: hostlist is empty. Please add IP addresses to the hostfile."
exit 1
fi
PREFILL_MASTER_IP=$(head -n 1 $HOSTFILE)
DECODER_MASTER_IP=$(tail -n $DECODER_SERVER_COUNT $HOSTFILE | head -n1)
echo -e "\033[32mPREFILL_MASTER_IP: $PREFILL_MASTER_IP\033[0m"
echo -e "\033[32mDECODER_MASTER_IP: $DECODER_MASTER_IP\033[0m"
mkdir -p $LOG_DIR
for host in ${hostlist[@]}; do
echo $host
if [[ $COUNT -lt $PREFILL_SERVER_COUNT ]]; then
PREFILL_INDEX=$COUNT
cmd="bash -c 'bash $PREFILL_SCRIPT_FILE $PREFILL_INDEX $PREFILL_MASTER_IP $LOG_DIR $MODEL_PATH $host $PREFILL_SERVER_COUNT'"
#cmd="bash -c 'cd $WORK_HOME; echo $PATH '"
echo $cmd
ssh -p $port -f -n $host $cmd
else
DECODER_INDEX=$((COUNT - PREFILL_SERVER_COUNT))
cmd="bash -c 'bash $DECODER_SCRIPT_FILE $DECODER_INDEX $DECODER_MASTER_IP $LOG_DIR $MODEL_PATH $host $DECODER_SERVER_COUNT'"
echo $cmd
ssh -p $port -f -n $host $cmd
fi
((COUNT++))
done
cmd="bash -c 'bash $ROUTER_SCRIPT_FILE $PREFILL_MASTER_IP $DECODER_MASTER_IP $LOG_DIR'"
echo $cmd
ssh -p $port -f -n $PREFILL_MASTER_IP $cmd
echo -e "Main log file: \033[34m$LOG_DIR\033[0m"
验证 API
在运行 Router 的机器上(若 --net host,容器内访问即可),验证是否有正常输出
curl http://127.0.0.1:30000/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{
"model": "glm-5-fp8",
"messages": [{"role": "user", "content": "你好,SGLang!"}],
"max_tokens": 100,
"temperature": 0.7
}'
预期返回 JSON,choices[0].message.content 为模型回复(示例与线上模型权重、路由配置有关)。
GLM-4.6/4.7 模型部署
部署说明
GLM-4.6/4.7 可以采用单机混布模式,也可以采用 1P1D 的PD分离部署模式。
# 启动单机混布模式
./launch_server.sh -m <模型路径> -mtp
# PD 分离部署模式,在两台机器上分别启动 prefill server 和 decode server
./launch_server.sh -m <模型路径> -mtp -pd p
./launch_server.sh -m <模型路径> -mtp -pd d
# 在启动 Prefill Server 的机器上启动 Router,注意更改脚本中对应的 IP
./router.sh
参数说明