在 Ollama 中，Modelfile 可以理解为模型的“构建说明书”：它不要求重新训练模型，而是在基础模型之上固化系统提示词、推理参数、提示模板和适配器配置。对于需要统一回答风格、控制输出稳定性或批量部署本地模型的用户来说，掌握 Modelfile 比每次手动输入参数更高效。🛠️
一、Modelfile 的核心结构
一个可用的 Modelfile 至少需要包含 FROM 指令，用来指定基础模型。除此之外，还可以配置 PARAMETER、SYSTEM、TEMPLATE、MESSAGE、ADAPTER、LICENSE 和 REQUIRES 等指令，具体定义可参考 Ollama Modelfile 官方文档。
FROM qwen3:8b
PARAMETER temperature 0.3
PARAMETER num_ctx 8192
SYSTEM 你是一名严谨的中文技术助手，回答应准确、简洁并提供可执行步骤。
将以上内容保存为名为 Modelfile 的文件，然后执行：
ollama create qwen3-tech -f ./Modelfile
ollama run qwen3-tech
这样创建的 qwen3-tech 并不是一份重新训练的模型，而是基于指定模型构建的定制版本。模型权重、提示模板及已有配置由 FROM 指定的对象提供，当前 Modelfile 中声明的设置则用于形成新的运行配置。
二、FROM 与参数继承的实际逻辑
FROM 不仅能引用模型仓库中的模型标签，也能指向已经创建的本地模型、Safetensors 模型目录或 GGUF 文件。实际使用时，推荐写明标签，例如“FROM qwen3:8b”，避免基础模型标签变化后产生难以复现的结果。📌
配置继承最实用的方式是分层构建。先创建团队通用模型，再基于它创建不同业务角色：
FROM qwen3:8b
PARAMETER temperature 0.4
PARAMETER top_p 0.9
PARAMETER num_ctx 8192
SYSTEM 你是企业内部中文助手，禁止虚构事实。
把它创建为 team-base 后，新建另一个 Modelfile：
FROM team-base
PARAMETER temperature 0.2
SYSTEM 你是代码审查助手，重点检查安全性、可维护性和异常处理。
第二层模型沿用基础模型能力，并形成新的角色与参数配置。为了避免对“继承结果”产生误判，建议每次构建后执行“ollama show --modelfile 模型名”，检查 Ollama 实际生成的 Modelfile，而不是只凭源文件推测最终配置。✅
三、常用 PARAMETER 如何搭配
- temperature：控制随机性。技术问答、信息抽取可使用较低值；创意写作可适当提高。
- top_p 与 top_k：控制候选词采样范围。一般先调整 temperature，不要同时大幅修改多个采样参数。
- num_ctx：设置上下文窗口。数值越大，通常意味着更高的内存或显存需求，同时还受模型自身能力限制。
- num_predict：限制最大生成长度，适合防止回答过长，但设置过小可能截断内容。
- repeat_penalty：用于降低重复倾向。设置过高可能导致表达生硬或遗漏必要术语。
- seed：固定随机种子，有助于对照测试；它不意味着所有环境下都能获得绝对相同的输出。
- stop：定义停止序列。需要多个停止标记时，应分别写多条 PARAMETER stop，而不是合并成普通字符串。
参数调优最好采用单变量法：准备一组固定问题，每次只修改一个参数，再比较准确性、完整性、重复率和响应资源消耗。这样比直接复制网上的“万能参数”更可靠。🔍
四、SYSTEM 与 TEMPLATE 的边界
SYSTEM 负责定义角色、语气、任务范围和约束，适合大多数定制需求。TEMPLATE 则控制系统消息、用户输入及模型回答如何拼接后再发送给模型，其语法和特殊标记往往与模型家族相关。
除非确定模型所需的聊天模板，否则不要随意覆盖 TEMPLATE。错误的起止标记、角色标记或停止序列可能造成模型复读、角色混乱，甚至直接输出模板内容。更稳妥的方法是先通过“ollama show --modelfile 基础模型名”查看原始模板，只修改确有必要的部分。
五、接入 LoRA 适配器
需要加载微调适配器时，可以使用 ADAPTER 指令：
FROM qwen3:8b
ADAPTER ./adapter
PARAMETER temperature 0.2
适配器必须与训练时使用的基础模型匹配，否则可能出现输出异常。Ollama 支持通过目录或 GGUF 文件导入相应模型与适配器，路径可以是绝对路径，也可以相对于 Modelfile 所在位置配置，操作前应核对 模型导入说明。🧩
六、构建、验证与排错流程
- 先执行“ollama pull 基础模型名”准备基础模型。
- 编写 Modelfile，并为基础模型指定清晰标签。
- 执行“ollama create 自定义名称 -f ./Modelfile”完成构建。
- 使用“ollama show --modelfile 自定义名称”核验最终配置。
- 执行“ollama run 自定义名称”进行固定问题集测试。
- 若输出异常，依次检查 TEMPLATE、stop、SYSTEM、上下文长度和适配器兼容性。
生产环境还应保存 Modelfile、基础模型标签、Ollama 版本和测试样例，并为每次修改建立新版本名称。不要直接覆盖唯一可用版本，否则参数调整失败时难以快速回滚。🔄
总结
Modelfile 的价值在于把“模型选择、提示词、运行参数和适配器”转化为可重复构建的配置。实战中应以 FROM 建立清晰的分层关系，优先使用 SYSTEM 和 PARAMETER 完成定制，谨慎修改 TEMPLATE，并通过 ollama show 检查实际结果。只要坚持固定标签、单变量调参和版本化管理，就能构建出更稳定、更容易维护的 Ollama 自定义模型工作流。🚀
