Qwen3.5-9B镜像免配置指南：Supervisor自动启停+日志排查+history.json管理

Qwen3.5-9B镜像免配置指南：Supervisor自动启停+日志排查+history.json管理

1. 项目概述

Qwen3.5-9B是一个拥有90亿参数的开源大语言模型，具备强大的逻辑推理、代码生成和多轮对话能力。该模型支持多模态理解（图文输入）和长上下文处理（最高可达128K tokens），是当前开源模型中的佼佼者。

本项目基于以下环境搭建：

• 模型：Qwen3.5-9B（多模态版本）
• 环境：torch28（Conda环境）
• 端口：7860
• 进程管理：Supervisor

2. 项目结构与快速管理

2.1 项目目录结构

项目主要文件位于/root/qwen3.5-9b/目录下，包含以下关键文件：

/root/qwen3.5-9b/ ├── app.py # 主程序(Gradio WebUI) ├── start.sh # 启动脚本 ├── service.log # 运行日志 └── history.json # 对话历史记录

2.2 常用管理命令

使用Supervisor可以方便地管理服务状态：

# 查看服务状态 supervisorctl status qwen3.5-9b # 重启服务 supervisorctl restart qwen3.5-9b # 停止服务 supervisorctl stop qwen3.5-9b # 查看实时日志 tail -f /root/qwen3.5-9b/service.log # 查看错误日志 grep -i error /root/qwen3.5-9b/service.log

3. 访问与功能特性

3.1 访问地址

• 本地访问：http://localhost:7860
• 网络访问：http://服务器IP:7860

3.2 主要功能

3.3 使用示例

文本对话：

1. 在输入框输入问题
2. 点击"Send"或按回车
3. 等待模型回复

图片分析：

1. 在右侧"Upload Image"上传图片
2. 在输入框描述你想问的问题（如"这张图片里有什么？"）
3. 点击"Send"

参数调节：

• Max tokens：生成文本的最大长度(64-8192)
• Temperature：采样温度，越高越随机(0.0-1.5)
• Top P：核采样阈值，越低越确定(0.1-1.0)
• Top K：采样候选数，越少越确定(1-100)

4. Supervisor配置详解

Supervisor配置文件位于/etc/supervisor/conf.d/qwen3.5-9b.conf，内容如下：

[program:qwen3.5-9b] command=/bin/bash /root/qwen3.5-9b/start.sh directory=/root/qwen3.5-9b environment=HOME="/root",USER="root",LOGNAME="root",SHELL="/bin/bash",PATH="/opt/miniconda3/envs/torch28/bin:/usr/bin:/bin" user=root autostart=true autorestart=true startsecs=30 startretries=3 redirect_stderr=true stdout_logfile=/root/qwen3.5-9b/service.log stopasgroup=true killasgroup=true

关键配置说明：

• autostart=true：开机自动启动
• autorestart=true：进程异常退出自动重启
• startsecs=30：等待30秒确认进程稳定启动
• PATH：使用torch28 Conda环境

5. 环境要求与依赖

5.1 Conda环境

# 激活环境 conda activate torch28

5.2 关键依赖版本

5.3 模型路径

实际路径: /root/ai-models/Qwen/Qwen3___5-9B 访问路径: /root/ai-models/Qwen/Qwen3.5-9B (符号链接)

6. 日志管理与排查

6.1 日志文件位置

/root/qwen3.5-9b/service.log

6.2 常见日志信息

6.3 启动排查指南

# 1. 检查进程是否启动 supervisorctl status qwen3.5-9b # 2. 检查端口是否监听 ss -tlnp | grep 7860 # 3. 检查模型加载状态 grep "Model loaded" /root/qwen3.5-9b/service.log # 4. 检查错误信息 grep -i "error\|exception\|traceback" /root/qwen3.5-9b/service.log | tail -20

7. 常见故障排查

7.1 服务启动失败

检查步骤：

1. supervisorctl status qwen3.5-9b- 查看进程状态
2. supervisorctl tail qwen3.5-9b- 查看最新日志
3. 检查conda环境是否正常
4. 检查模型文件是否存在

7.2 模型加载慢/卡住

原因：模型文件较大(~19GB)，首次加载需要时间

解决：

• 等待2-3分钟让模型完全加载
• 检查GPU是否可用：nvidia-smi
• 查看日志确认加载进度

7.3 端口被占用

# 检查端口占用 ss -tlnp | grep 7860 # 查看哪个进程占用 lsof -i :7860

7.4 图片上传无响应

可能原因：

• 图片格式不支持
• 图片文件损坏
• 网络请求超时

解决：尝试较小尺寸的图片，或转换格式为PNG/JPEG

8. 日常维护操作

8.1 清理对话历史

rm -f /root/qwen3.5-9b/history.json supervisorctl restart qwen3.5-9b

8.2 清理日志

# 备份当前日志 cp /root/qwen3.5-9b/service.log /root/qwen3.5-9b/service.log.bak # 清空日志 > /root/qwen3.5-9b/service.log # 重启服务 supervisorctl restart qwen3.5-9b

8.3 更新代码

# 1. 编辑app.py vim /root/qwen3.5-9b/app.py # 2. 重启服务 supervisorctl restart qwen3.5-9b

9. 总结

本指南详细介绍了Qwen3.5-9B镜像的免配置部署方法，重点讲解了Supervisor自动启停管理、日志排查技巧以及history.json文件管理。通过这套方案，您可以轻松部署和管理这个强大的多模态大语言模型，充分发挥其在逻辑推理、代码生成和多轮对话方面的能力。

对于初次使用者，建议重点关注：

1. Supervisor的基本管理命令
2. 常见故障排查方法
3. 日志分析技巧
4. 日常维护操作

获取更多AI镜像

想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。