本地推理服务架构指南
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kunlungrowth/local-llm-inference-service-guide
技能介绍
你要解决什么问题
很多企业的真实需求并不是“上云”,而是把模型留在自己的机房里。数据一旦离开内网,就可能触碰合规红线;可通用大模型 API 又没法满足这一点。于是问题变成:
- 7B、13B 甚至 70B 的开源模型,到底需要多少内存和显存?
- 没有 GPU 是不是就只能放弃本地推理?
- 怎样才能把本地模型接成一个OpenAI 兼容接口,让现有前端直接切换?
这个技能如何工作
它扮演「本地推理服务架构师」的角色,帮你把开源模型变成可调用的私有 API。
- 硬件评估:先算账。7B 量化模型约需 4–6 GB 内存/显存,13B 约 8–12 GB,70B 通常需要多卡或高内存机器。有 GPU 走显存,速度更快;没有 GPU 走 CPU,慢但能跑小模型。
- 引擎与模型:优先选择基于
llama.cpp等成熟开源引擎的后端,社区大、稳定性有保障。模型以GGUF格式为主,同时必须确认许可证允许商用。模型来源只用官方或可信镜像,并校验哈希,避免供应链投毒。 - 接口对接:对外暴露 OpenAI 兼容端点,例如
/v1/chat/completions。私有助手前端只需把base_url指向本地服务即可切换,先用curl自测连通性,再接入前端。 - 性能与并发:限制并发数与上下文长度,防止内存爆掉。开启持续批处理(continuous batching)提升吞吐,并配置健康检查与重启策略保活。
适用边界与注意点
- 只使用许可证明确允许商用的模型权重,不提供未授权模型。
- 推理服务应放在内网或鉴权之后,避免未授权外泄。
- 输出质量以实际测试为准,关键场景需人工复核。
使用场景
- 公司有敏感数据不能上公有云,需要在本地把 13B 开源模型跑起来并评估所需显存。
- 已经部署了开源推理引擎,需要将其封装成 OpenAI 兼容端点以便私有助手前端调用。
- 本地推理服务刚上线,需要配置并发限制、健康检查和重启策略以防服务中断。
- 团队要在内网搭建私有大模型 API,需要确认模型许可证并验证权重文件哈希以确保安全。
适合人员
- 企业 IT 架构师,需要在数据不离开内网的前提下完成大模型的私有化部署。
- 后端开发工程师,需要将本地推理服务封装成 OpenAI 兼容接口并对接私有助手。
- 运维工程师,负责本地推理服务的硬件资源规划、性能调优和日常保活。
- 安全工程师,需要确保模型权重来源可信、许可证合规且服务访问受控。