Alpamayo-R1-10B 部署：Supervisor 配置下 WebUI 端口自定义修改
1. 项目概述
Alpamayo-R1-10B 是专为自动驾驶研发设计的开源视觉 - 语言 - 动作 (VLA) 模型，拥有 100 亿参数规模。它整合了 AlpaSim 模拟器与 Physical AI AV 数据集，构建了完整的自动驾驶研发工具链。其核心价值在于通过类人因果推理机制，显著提升自动驾驶决策的可解释性，特别是在处理长尾场景时展现出优异的适应能力。
2. 环境准备
2.1 硬件要求
- GPU 配置：至少需要 NVIDIA RTX 4090 D 级别显卡（22GB 显存）
- 内存需求：推荐 32GB 以上系统内存
- 存储空间：需预留 30GB 以上可用空间
2.2 软件依赖
# 基础环境检查
nvidia-smi # 确认 GPU 驱动正常
python --version # 需 Python 3.12
supervisord --version # 需 Supervisor 4.x
3. 默认部署流程
3.1 标准安装步骤
首先解压模型权重文件（通常需要 5 个.safetensors 文件，每个约 4-5GB），并下载至指定目录：
mkdir -p /root/ai-models/nv-community/Alpamayo-R1-10B
# 将模型文件放入上述目录
启动默认 WebUI 服务：
supervisorctl start alpamayo-webui
4. 端口自定义配置
4.1 定位配置文件
WebUI 服务由 Supervisor 管理，配置文件通常位于：
/etc/supervisor/conf.d/alpamayo-webui.conf
4.2 配置文件解析
典型配置内容如下，注意 environment 字段定义了环境变量：
[program:alpamayo-webui]
command=/root/Alpamayo-R1-10B/scripts/start_webui.sh
environment=WEBUI_PORT="7860"
directory=/root/Alpamayo-R1-10B
autostart=true
autorestart=true
stderr_logfile=/root/Alpamayo-R1-10B/logs/webui_stderr.log
stdout_logfile=/root/Alpamayo-R1-10B/logs/webui_stdout.log
4.3 修改端口步骤
同步修改启动脚本以确保逻辑一致：
vi /root/Alpamayo-R1-10B/scripts/start_webui.sh
确认脚本中包含环境变量导出逻辑：
export WEBUI_PORT=${WEBUI_PORT:-7860} # 确保使用环境变量作为兜底
接下来修改 Supervisor 配置文件中的环境变量参数：
sudo vi /etc/supervisor/conf.d/alpamayo-webui.conf
将 environment 行中的端口号改为目标值，例如：
environment=WEBUI_PORT="8888" # 将 7860 改为 8888
5. 服务重启与验证
5.1 应用配置变更
修改完成后，需要重新加载配置并重启服务：
# 重新加载配置
sudo supervisorctl reread
sudo supervisorctl update
# 重启服务
sudo supervisorctl restart alpamayo-webui
5.2 端口验证方法
查看实时日志确认服务是否正常启动：
tail -f /root/Alpamayo-R1-10B/logs/webui_stdout.log
测试服务可达性：
curl -I http://localhost:8888
检查端口监听状态：
netstat -tlnp | grep 8888
6. 常见问题排查
6.1 端口冲突处理
若新端口不可用，可尝试以下命令查找占用情况：
sudo lsof -i :8888 # 查看端口占用详情
6.2 防火墙配置
如需外部访问，记得开放对应端口：
sudo ufw allow 8888/tcp
sudo ufw reload
6.3 服务启动失败
检查错误日志定位问题：
tail -50 /root/Alpamayo-R1-10B/logs/webui_stderr.log
常见错误包括：
- 端口已被占用
- 模型路径配置错误
- 权限不足
7. 进阶配置建议
7.1 多实例部署
通过复制配置文件实现多实例运行：
cp /etc/supervisor/conf.d/alpamayo-webui.conf /etc/supervisor/conf.d/alpamayo-webui-2.conf
修改新配置中的端口号和程序名称：
[program:alpamayo-webui-2]
environment=WEBUI_PORT="8889"
7.2 负载均衡设置
结合 Nginx 实现负载均衡：
upstream alpamayo {
server 127.0.0.1:8888;
server 127.0.0.1:8889;
}
server {
listen 80;
location / {
proxy_pass http://alpamayo;
}
}
8. 总结
通过修改 /etc/supervisor/conf.d 下的配置文件，我们可以灵活调整 Alpamayo-R1-10B 的 WebUI 服务端口。关键步骤包括：
- 定位并编辑 Supervisor 配置文件
- 修改 WEBUI_PORT 环境变量
- 重新加载并重启服务
- 验证新端口可用性
这种配置方式不仅适用于端口修改，也可用于调整其他运行参数，如模型加载路径、日志输出级别或 GPU 显存分配策略等。
