@@ -0,0 +1,158 @@
+## 🚀 核心命令 (Basic CLI)
+
+最常用的命令行操作。
+
+| 命令 | 说明 | 示例 |
+| :--- | :--- | :--- |
+| **`ollama run`** | 运行并进入交互模式 (如果没有模型会自动下载) | `ollama run llama3` |
+| **`ollama pull`** | 仅下载/更新模型，不运行 | `ollama pull qwen2` |
+| **`ollama list`** | 列出本地已下载的模型 | `ollama list` |
+| **`ollama rm`** | 删除本地模型 | `ollama rm llama2` |
+| **`ollama cp`** | 复制模型 (常用于重命名或备份) | `ollama cp llama3 my-model` |
+| **`ollama ps`** | 查看当前正在显存中运行的模型 | `ollama ps` |
+| **`ollama show`** | 显示模型详情 (Modelfile, 参数等) | `ollama show --modelfile llama3` |
+
+### 交互模式下的快捷指令
+在 `ollama run <model>` 进入对话框后使用：
+*   `/?`: 获取帮助
+*   `/bye` 或 `Ctrl + D`: 退出对话
+*   `/set parameter seed 123`: 临时设置参数
+*   `/show info`: 查看当前模型信息
+*   `"""`: 输入多行文本
+
+---
+
+## ⚙️ 模型定制 (Modelfile)
+
+创建自定义的角色（System Prompt）或调整参数。
+
+**1. 创建文件 `Modelfile`**
+```dockerfile
+FROM llama3
+
+# 设置温度 (越高越有创造力，越低越严谨)
+PARAMETER temperature 0.7
+
+# 设置上下文窗口大小 (默认 2048)
+PARAMETER num_ctx 4096
+
+# 设置系统提示词 (核心灵魂)
+SYSTEM """
+你是一个资深的Linux运维专家。
+请只回答与Linux、Shell、网络配置相关的问题。
+回答要简洁，并优先给出代码示例。
+"""
+```
+
+**2. 编译模型**
+```bash
+# 语法: ollama create <新模型名> -f <Modelfile路径>
+ollama create linux-expert -f ./Modelfile
+```
+
+**3. 运行新模型**
+```bash
+ollama run linux-expert
+```
+
+---
+
+## 🔌 API 调用 (cURL 示例)
+
+Ollama 默认监听 `11434` 端口。
+
+**1. 生成回复 (Generate - 流式)**
+```bash
+curl http://localhost:11434/api/generate -d '{
+  "model": "llama3",
+  "prompt": "为什么天空是蓝色的？"
+}'
+```
+
+**2. 聊天模式 (Chat - 类似 OpenAI)**
+```bash
+curl http://localhost:11434/api/chat -d '{
+  "model": "llama3",
+  "messages": [
+    { "role": "user", "content": "你好，介绍一下你自己" }
+  ],
+  "stream": false
+}'
+```
+
+**3. 获取 Embeddings (用于 RAG)**
+```bash
+curl http://localhost:11434/api/embeddings -d '{
+  "model": "nomic-embed-text",
+  "prompt": "Hello world"
+}'
+```
+
+---
+
+## 🛠️ 服务管理 (Linux Systemd)
+
+针对 Linux 系统的后台服务管理。
+
+| 操作 | 命令 |
+| :--- | :--- |
+| **启动服务** | `sudo systemctl start ollama` |
+| **停止服务** | `sudo systemctl stop ollama` |
+| **重启服务** | `sudo systemctl restart ollama` |
+| **查看状态** | `sudo systemctl status ollama` |
+| **查看日志** | `journalctl -u ollama -f` (排错神器) |
+
+---
+
+## 环境变量 (Environment Variables)
+
+配置 Ollama 行为的关键变量。
+*在 Linux 中通过 `sudo systemctl edit ollama.service` 配置*。
+
+| 变量名 | 默认值 | 说明 |
+| :--- | :--- | :--- |
+| **`OLLAMA_HOST`** | `127.0.0.1` | 设置为 `0.0.0.0` 可允许远程访问 |
+| **`OLLAMA_MODELS`** | `~/.ollama/models` | 修改模型存储路径 (如移到大硬盘 `/data/ollama`) |
+| **`OLLAMA_KEEP_ALIVE`**| `5m` | 模型加载在显存中的保留时间 (可设为 `24h` 或 `-1` 永久) |
+| **`OLLAMA_NUM_PARALLEL`** | `1` | 允许并发处理的请求数量 |
+| **`OLLAMA_MAX_LOADED_MODELS`** | `1` | 允许同时加载在显存中的模型数量 |
+| **`OLLAMA_ORIGINS`** | `*` | 跨域设置 (CORS)，限制允许访问的域名 |
+
+---
+
+## 📦 常用热门模型 (Model Library)
+
+无需死记硬背，去 [ollama.com/library](https://ollama.com/library) 查看。
+
+| 模型名 | 特点 | 适用场景 |
+| :--- | :--- | :--- |
+| **`llama3`** (8b/70b) | Meta出品，目前最强开源模型之一 | 通用助手，逻辑强，速度快 |
+| **`gemma2`** (9b/27b) | Google出品，性能优异 | 通用，知识库丰富 |
+| **`qwen2.5`** | 阿里出品，**中文能力极强** | 中文对话，写作，代码 |
+| **`mistral`** | 欧洲团队，高性价比 | 英语任务，逻辑推理 |
+| **`codellama`** | 专精代码 | 代码补全，Debug |
+| **`llava`** | 多模态 (Multimodal) | **图片识别**，图像描述 |
+| **`nomic-embed-text`** | 嵌入模型 | 用于构建 RAG (知识库) 系统 |
+
+---
+
+## ⚠️ 远程访问安全清单
+
+如果你配置了远程访问，请核对以下三点：
+
+1.  **绑定地址**：`OLLAMA_HOST=0.0.0.0`
+2.  **防火墙**：`sudo ufw allow 11434` (仅允许可信 IP) 或配置 Nginx 端口。
+3.  **认证**：**必须**配置 Nginx Basic Auth 或 LiteLLM (因为 Ollama 原生无密码)。
+
+---
+
+### 一键卸载 (Linux)
+如果需要重装或清除：
+```bash
+sudo systemctl stop ollama
+sudo systemctl disable ollama
+sudo rm /etc/systemd/system/ollama.service
+sudo rm -rf /usr/share/ollama /usr/local/bin/ollama
+sudo userdel ollama
+sudo groupdel ollama
+```
@@ -0,0 +1,114 @@
+默认情况下，Ollama 为了安全，仅绑定在本地地址 (`127.0.0.1` / `localhost`)。要实现远程访问（即让局域网内的其他设备或公网设备访问），你需要修改环境变量 `OLLAMA_HOST`。
+
+以下是针对不同操作系统的详细配置步骤：
+
+---
+
+### 1. Linux (使用 Systemd 服务)
+
+如果你是在 Linux 服务器上通过官方脚本安装的，Ollama 通常作为 systemd 服务运行。
+
+1.  **编辑服务配置**：
+    运行以下命令打开编辑器：
+    ```bash
+    sudo systemctl edit ollama.service
+    ```
+
+2.  **添加环境变量**：
+    在打开的文件中，添加以下内容（注意要在 `[Service]` 下方）：
+    ```ini
+    [Service]
+    Environment="OLLAMA_HOST=0.0.0.0"
+    ```
+    *解释：`0.0.0.0` 表示允许所有 IP 地址访问。如果只想允许特定 IP，也可以填具体 IP，但通常填 `0.0.0.0` 更通用。*
+
+3.  **保存并退出**：
+    按 `Ctrl+O` 保存，`Enter` 确认，然后 `Ctrl+X` 退出（如果是 nano 编辑器）。
+
+4.  **重启服务**：
+    ```bash
+    sudo systemctl daemon-reload
+    sudo systemctl restart ollama
+    ```
+
+---
+
+### 2. Windows
+
+在 Windows 上，你需要通过系统设置添加环境变量。
+
+1.  **退出 Ollama**：
+    点击任务栏右下角的 Ollama 图标，右键选择 "Quit Ollama"。
+
+2.  **设置环境变量**：
+    *   打开“设置” -> “系统” -> “关于” -> “高级系统设置”。
+    *   点击“环境变量”。
+    *   在“系统变量”或“用户变量”区域，点击“新建”。
+    *   **变量名**：`OLLAMA_HOST`
+    *   **变量值**：`0.0.0.0`
+    *   点击确定保存。
+
+3.  **重启 Ollama**：
+    从开始菜单重新启动 Ollama 应用程序。
+
+---
+
+### 3. macOS
+
+macOS 的配置稍微复杂一点，因为这是通过应用启动的。
+
+1.  打开终端，运行以下命令设置环境变量：
+    ```bash
+    launchctl setenv OLLAMA_HOST "0.0.0.0"
+    ```
+
+2.  **重启 Ollama 应用**：
+    完全退出 Ollama（顶部菜单栏图标 -> Quit），然后重新打开 Ollama。
+
+    *注意：这种方法在重启电脑后可能会失效。如果要永久生效，可能需要创建一个启动脚本或使用 Automator。*
+
+---
+
+### 4. Docker 部署 (最简单)
+
+如果你是使用 Docker 运行 Ollama，只需要在启动命令中添加环境变量即可：
+
+```bash
+docker run -d -v ollama:/root/.ollama -p 11434:11434 --name ollama -e OLLAMA_HOST=0.0.0.0 ollama/ollama
+```
+
+---
+
+### 5. 关键步骤：防火墙设置
+
+**配置完上述步骤后，如果还是连不上，99% 是因为防火墙。**
+
+*   **Linux (UFW)**:
+    ```bash
+    sudo ufw allow 11434/tcp
+    ```
+*   **Windows**:
+    打开“Windows Defender 防火墙”，选择“允许应用通过防火墙”，找到 `ollama.exe` 并确保“专用”和“公用”网络都被勾选。
+*   **云服务器 (AWS/阿里云/腾讯云)**:
+    需要在云服务商的控制台（安全组）中放行 **TCP 11434** 端口。
+
+---
+
+### 6. 测试连接
+
+在另一台电脑（或手机）的浏览器中输入：
+
+`http://<安装Ollama电脑的IP地址>:11434`
+
+如果显示 `Ollama is running`，则说明配置成功。
+
+---
+
+### ⚠️ 安全警告 (非常重要)
+
+Ollama 原生 **没有任何用户验证机制**（没有账号密码）。
+
+*   如果将 `OLLAMA_HOST` 设为 `0.0.0.0` 并暴露在公网（Internet），**任何人都可以使用你的显卡资源，甚至可能通过某些手段注入恶意代码**。
+*   **建议方案**：
+    1.  **局域网使用**：仅在受信任的家庭/公司 WiFi 下使用。
+    2.  **公网使用**：请务必配合 **Nginx 反向代理**（设置 Basic Auth 密码）或者使用 **VPN / Tailscale / SSH 隧道** 进行访问，不要直接暴露端口。