diff --git a/README.md b/README.md index 5fde6da..35b21b2 100644 --- a/README.md +++ b/README.md @@ -1,50 +1,111 @@ -# Ollama 离线工具集 +明白了!我们将采用更简单直接的手动方案。以下是更新后的 **README.md** 内容: -一套用于下载和管理 Ollama 安装程序的离线工具脚本 +--- -## 功能特点 +# Ollama 离线部署工具 -- 完整的离线部署解决方案 -- 从国内镜像站快速下载 Ollama 安装包 -- 支持创建本地模型仓库镜像 -- 灵活下载指定版本或全部版本 +## 📌 使用流程(三步走) - -## 使用指南 - -### 创建本地镜像仓库 - -下载最新稳定版: +### 1. 克隆仓库 & 下载镜像 ```bash -./ollama-mirror.sh +git clone https://git.aiot.ml/kanshan/ollama_offline_tools.git +cd ollama_offline_tools +chmod +x *.sh # 添加执行权限 + +# 下载所需版本(任选其一) +./mirror_ollama.sh # 下载最新版 +./mirror_ollama.sh v0.6.2 # 下载指定版本 +./mirror_ollama.sh --all # 下载全部版本 ``` -下载指定版本(如v0.6.2): -```bash -./ollama-mirror.sh v0.6.2 -``` - -下载全量版本(需要大容量存储): +### 2. 启动本地文件服务器 ```bash -./ollama-mirror.sh --all +# 启动Python HTTP服务(默认端口8000) +python3 host_ollama.py + +# 如需自定义端口 +python3 host_ollama.py 8080 ``` -### 安装后的管理 - -查看已下载的模型版本: +### 3. 手动修改安装脚本 +编辑 `install.sh`,将: ```bash -ls ./mirror/ +"https://download.main.ml/0.6.2" # 原始地址 ``` - -清理下载缓存: +修改为你的本地地址: ```bash -rm -rf ./tmp_download/ +"http://[你的IP]:8000" # 示例:http://192.168.1.100:8000 ``` +### 4. 执行安装(在其他机器) +```bash +# 方法1:直接运行修改后的install.sh +sudo ./install.sh -## 注意事项 +# 方法2:通过HTTP服务安装 +curl -sSL http://[你的IP]:8000/install.sh | sudo bash +``` -❗ 需要 root 权限执行安装 -❗ 全量下载需要 100GB+ 磁盘空间 -❗ 建议在稳定的网络环境下操作 +--- +## 📂 文件说明 + +| 文件 | 用途 | +|------|------| +| `mirror_ollama.sh` | 从GitHub下载Ollama发行版到`ollama_releases/`目录 | +| `host_ollama.py` | 启动本地HTTP服务器(支持目录浏览) | +| `install.sh` | **需手动修改**的安装脚本 | +| `ollama_releases/` | 镜像文件存储目录 | + +--- + +## 🌐 网络配置建议 + +1. 获取本机IP: + ```bash + ip a # Linux + ifconfig # macOS + ``` + +2. 确保防火墙放行端口: + ```bash + sudo ufw allow 8000/tcp # Ubuntu示例 + ``` + +3. 同一局域网内的其他设备可通过 `http://[你的IP]:8000` 访问 + +--- + +## 💡 注意事项 + +1. 首次使用需运行 `chmod +x *.sh` 添加执行权限 +2. 确保Python版本 ≥ 3.6 +3. 全量下载需要约 50GB 磁盘空间 +4. 修改`install.sh`时保留文件名路径(如`/ollama-linux-amd64.tgz`) + +--- + +## 🚨 常见问题 + +**Q:如何知道下载是否完成?** +A:检查 `ollama_releases/` 目录下的文件结构应类似: +``` +ollama_releases/ +├── v0.6.2/ +│ ├── ollama-linux-amd64.tgz +│ └── checksums.txt +└── latest/ +``` + +**Q:Windows机器如何访问?** +A:在浏览器输入 `http://[Linux机器的IP]:8000` 即可下载文件 + +--- + +这个版本: +1. 完全**手动操作**,避免自动修改的复杂性 +2. 强调**分步执行**,降低出错概率 +3. 添加了**网络配置指导**和**验证方法** +4. 使用表格和树形结构提升可读性 + +需要任何调整或补充请随时告诉我! \ No newline at end of file