核心内容摘要
78赛进13视频：探索那些令人惊叹的精彩瞬间
Clawdbot整合Qwen
B部署案例Ollama代理8080→18789网关配置详解
为什么需要这层代理网关你有没有遇到过这样的情况本地跑着一个大模型服务比如用Ollama拉下来的Qwen
B它默认监听在http://localhost:11434/api/chat但你的前端Chat平台比如Clawdbot却没法直接调用浏览器报错CORS被阻止、跨域请求失败或者干脆连不上——不是模型没启动而是网络通路没打通。
这不是模型的问题是现代Web应用的典型“最后一公里”难题。
Clawdbot作为前端交互层需要稳定、安全、可管理的后端入口而Ollama作为本地推理服务默认不开放跨域也不支持路径重写、负载均衡或统一鉴权。
这时候一个轻量但可靠的代理网关就变得不可或缺。
本文要讲的就是如何用最简方式把Ollama提供的/api/chat接口通过一层自定义代理映射到Clawdbot能直接调用的http://localhost:8080/v1/chat/completions路径并最终将流量精准转发至内部18789网关端口。
整个过程不依赖Nginx、不编译二进制、不改源码纯配置驱动5分钟可复现。
整体架构与数据流向
1 三层角色分工清晰我们先理清三个核心组件各自干什么Qwen
BOllama托管真正的推理引擎运行在本地监听
127.
0.
1:11434只响应原始Ollama格式请求如POST /api/chatbody含modelqwen3:32b代理服务本文主角一个极简HTTP反向代理监听
0.
0.
0:8080负责协议转换OpenAI兼容格式 ↔ Ollama格式、路径重写、Header透传、错误映射Clawdbot前端完全不知道背后是Ollama还是其他模型它只按标准OpenAI API规范发请求目标地址固定为http://localhost:8080/v1/chat/completions收到的响应也必须是标准OpenAI JSON结构。
2 端口映射的真实含义你可能注意到了标题里的8080→18789。
这里需要明确一点18789不是Ollama的端口也不是Clawdbot的端口而是代理服务自身暴露给内网其他服务如K8s Service、Docker Network或监控系统的管理端口。
8080对外服务端口Clawdbot直连18789对内网管端口用于健康检查、指标采集、配置热更新等运维场景例如Prometheus抓取/metrics或curlhttp://localhost:18789/health确认状态11434Ollama私有端口仅限本机访问不对外暴露。
这种“双端口单进程”的设计既保障了前端调用的简洁性又为后续可观测性留出空间还不增加额外容器或进程。
代理服务部署实操零依赖、纯配置
1 选择轻量代理方案Caddy 插件我们不用写一行Go/Python代码也不用装Nginx。
选的是Caddy 2——一个自带HTTPS、自动路由、配置即代码的现代Web服务器。
它原生支持反向代理、路径重写、Header操作且配置文件比YAML还简洁。
优势
总结单二进制无依赖Linux/macOS/Windows全平台支持配置文件Caddyfile可读性强5行搞定核心逻辑自带reverse_proxy、rewrite、header_up等指令无需插件支持bind绑定多端口天然满足8080和18789双出口需求。
2 创建Caddyfile配置关键6行新建文件Caddyfile内容如下:8080 { reverse_proxy http://
127.
0.
1:11434 { # 将 OpenAI 格式 POST /v1/chat/completions → Ollama 格式 POST /api/chat rewrite * /api/chat header_up Host {upstream_hostport} header_up X-Forwarded-For {remote} transport http { keepalive 30 } } } :18789 { respond /health 200 respond /metrics 200 respond * Caddy proxy running (8080→Ollama) 200 }说明第一个块:8080定义主服务所有请求都重写路径为/api/chat再转发给Ollamaheader_up确保Ollama能正确识别原始Host和客户端IP对日志和限流很重要第二个块:18789是纯静态响应不走代理只返回运维所需的基础信息没有tls配置因为Clawdbot跑在本地开发环境HTTP足够若上生产加一行tls internal即可启用自签名HTTPS。
3 启动代理服务三步到位#
下载Caddy以Linux x64为例 curl https://getcaddy.com | bash -s personal #
把Caddy二进制移到PATH或直接用绝对路径 sudo mv caddy /usr/local/bin/ #
启动后台常驻自动重启 caddy run --config ./Caddyfile --adapter caddyfile验证是否生效# 检查8080端口是否响应模拟Clawdbot请求 curl -X POST http://localhost:8080/v1/chat/completions \ -H Content-Type: application/json \ -d { model: qwen3:32b, messages: [{role: user, content: 你好}] } # 检查18789端口是否健康 curl http://localhost:18789/health # 应返回200如果看到JSON响应里有message: {role: assistant, content: 你好...}说明代理已通。
Clawdbot端对接要点不改一行前端代码
1 只需修改一个配置项Clawdbot作为通用Chat前端支持任意OpenAI兼容API。
你不需要动它的React/Vue源码只需在它的配置界面或.env文件中把API_BASE_URL从默认的https://api.openai.com/v1改成http://localhost:8080注意不要加/v1后缀。
Clawdbot内部会自动拼接/v1/chat/completions而我们的Caddy已把所有/v1/*路径重写为/api/chat所以前缀只需到/层级。
2 模型名称映射说明Clawdbot界面上显示的“模型列表”由后端API的/v1/models响应决定。
但Ollama本身不提供这个接口。
怎么办我们在Caddy里加一个简单路由补丁追加到Caddyfile的:8080块末尾handle_path /v1/models { respond {object:list,data:[{id:qwen
b,object:model,created:1738000000,owned_by:local}]} 200 }这样Clawdbot加载模型列表时会看到qwen
b选项选中后自动带入modelqwen
b参数完美匹配Ollama要求。
3 实际使用页面效果对应你提供的截图你贴出的第二张图image-
png正是Clawdbot成功连接后的聊天界面左侧是对话历史右侧输入框下方有模型下拉菜单选中qwen
b后发送消息右下角显示“正在思考…”——几秒后Qwen
B生成的长文本完整返回支持流式输出sse体验与官方API无异。
Qwen
B模型调优与稳定性保障
1 Ollama启动参数建议针对32B大模型Qwen
B对内存和显存要求高。
如果你发现首次响应慢、或并发卡顿不是代理问题而是Ollama没配好。
推荐启动命令ollama run --gpu qwen3:32b # 或显式指定参数Linux NVIDIA OLLAMA_NUM_GPU1 OLLAMA_MAX_LOADED_MODELS1 ollama serve关键点--gpu强制启用GPU加速需CUDA驱动OLLAMA_MAX_LOADED_MODELS1防止多模型抢占显存若用CPU推理加OLLAMA_NUM_THREADS12根据物理核数调整。
2 代理层超时与重试策略Caddy默认超时是30秒但Qwen
B首token延迟可能达40秒尤其冷启。
我们在reverse_proxy块里增强健壮性reverse_proxy http://
127.
0.
1:11434 { rewrite * /api/chat transport http { read_timeout 60s write_timeout 60s dial_timeout 5s } health_path /api/tags # Ollama健康检查接口 health_interval 10s }这样当Ollama短暂无响应时Caddy会主动探活并标记为不可用避免把请求打到宕机节点。
6.
常见问题排查清单附错误码速查现象可能原因快速验证命令解决方案Clawdbot提示“Network Error”Caddy未运行或8080端口被占lsof -i :8080pkill caddy后重启返回404 Not Found路径重写失效或Clawdbot发错URLcurl -v http://localhost:8080/v1/chat/completions检查Caddyfile中rewrite * /api/chat是否在reverse_proxy块内返回502 Bad GatewayOllama未启动或11434端口不通curl http://localhost:11434/api/tagsollama list确认qwen3:32b已加载ollama serve启动服务响应内容为空或格式错误Ollama返回非JSON或字段缺失curl -X POST http://localhost:11434/api/chat -d {model:qwen3:32b,messages:[{role:user,content:test}]}确保Ollama版本≥
0.
5Qwen3支持需新版流式输出中断Caddy未启用流式支持查看Caddy日志是否有streaming字样在reverse_proxy块加transport http { ... streaming true }提示所有日志默认输出到终端。
如需持久化启动时加--log /var/log/caddy.log。
7.
总结一条轻量链路打通本地大模型最后一公里回看整个部署链路它没有引入任何新框架、不修改任何上游代码、不依赖云服务却完成了三件事协议桥接把OpenAI标准API无缝转成Ollama私有协议端口解耦让Clawdbot只认8080Ollama只守11434运维面独占18789开箱即用Caddy配置6行启动命令1条5分钟完成小白可复制。
这不仅是Qwen
B的接入方案更是本地大模型工程化的最小可行范式用最薄的胶水层粘合最强的推理引擎与最友好的交互界面。
下一步你可以轻松扩展加JWT鉴权、接Prometheus监控、集成LangChain工具调用甚至把Caddy换成更轻的mitmproxy脚本——但起点永远是这一份干净、可读、可执行的Caddyfile。