sloopstash/ollama

Ollama 容器镜像文档

镜像概述

本镜像为Ollama的OCI/容器化实现，集成了Linux操作系统、Ollama工具以及Supervisor进程管理工具。旨在提供一个开箱即用的环境，简化Ollama服务的部署、运行和管理流程，适用于需要快速搭建语言模型服务的场景。

核心功能和特性

• 基础环境集成：内置Linux操作系统作为运行基础，确保环境一致性
• Ollama工具：包含完整的Ollama功能，支持下载、运行和管理各类大型语言模型
• 进程管理：集成Supervisor工具，自动监控和重启Ollama进程，保障服务稳定性
• 容器化优势：提供环境隔离、资源控制和跨平台部署能力，简化依赖管理

使用场景和适用范围

• 本地开发环境中快速部署Ollama服务进行模型测试
• 个人或小型团队搭建轻量级AI模型服务
• 需要基础进程管理能力的Ollama应用场景
• 希望通过容器化简化部署流程的技术人员

使用方法和配置说明

基本部署（docker run）

bash
docker run -d --name ollama-service -p 11434:11434 ollama-image:latest

参数说明：

• -d：后台运行容器
• --name ollama-service：指定容器名称为ollama-service
• -p 11434:11434：映射Ollama默认端口（主机端口:容器端口）
• ollama-image:latest：镜像名称及标签

模型持久化配置

为避免容器重启后模型丢失，可挂载本地目录存储模型数据：

bash
docker run -d --name ollama-service \
  -p 11434:11434 \
  -v /path/to/local/models:/root/.ollama \
  ollama-image:latest

说明：/path/to/local/models为本地模型存储目录，容器内Ollama模型默认存储路径为/root/.ollama

Supervisor配置管理

容器通过Supervisor管理Ollama进程，默认配置文件路径为/etc/supervisor/conf.d/ollama.conf。如需自定义进程管理规则，可挂载外部配置文件：

bash
docker run -d --name ollama-service \
  -p 11434:11434 \
  -v /path/to/custom/ollama.conf:/etc/supervisor/conf.d/ollama.conf \
  ollama-image:latest

验证服务运行

服务启动后，可通过以下命令验证Ollama是否正常运行：

bash
docker exec -it ollama-service ollama --version

或访问http://localhost:***查看服务状态

环境变量配置

目前镜像支持通过环境变量调整基础配置，常用变量包括：

• OLLAMA_HOST：指定Ollama服务监听地址，默认值为0.0.0.0
• OLLAMA_PORT：指定Ollama服务端口，默认值为11434

示例（自定义端口）：

bash
docker run -d --name ollama-service \
  -p 8080:8080 \
  -e OLLAMA_PORT=8080 \
  ollama-image:latest