Ollama v0.16.2 发布：新增云模型控制、Web 搜索与安全性强化

2. 全新的云模型禁用机制：OLLAMA_NO_CLOUD

这是此次更新最实用且最受关注的改动之一。

（1）新增环境变量控制

在 v0.16.2 中，Windows 与 macOS 环境下都可以通过设置环境变量来全局禁用云模型：

export OLLAMA_NO_CLOUD=1

这样，所有任务均在本地运行，保证数据不会通过云端传输。对于 Linux 服务器部署或手动启动 ollama serve 的场景同样适用。若设置为 0，则云功能正常启用。

（2）应用层控制逻辑增强

新增文件 app/store/cloud_config.go、cloud_config_test.go 两者形成了完整的云状态控制机制。

• 若 .ollama/server.json 文件缺失，则根据 OLLAMA_NO_CLOUD 环境变量判定。
• 两种来源（env、config 或 both）均会被统一纳入 CloudStatus 数据结构：

应用优先读取 .ollama/server.json 文件中的配置项：

{"disable_ollama_cloud":true}

type CloudStatus struct {
    Disabled bool   `json:"disabled"`
    Source   string `json:"source"`
}

并可通过客户端接口 /api/status 进行验证。调用 Client.CloudStatusExperimental() 可获得当前云状态。

（3）应用与数据库联动迁移

在 app/store/database.go 中，新增字段 cloud_setting_migrated，并将数据库版本更新至 v13：

const currentSchemaVersion = 13

旧版本的 airplane_mode 字段被移除，统一迁移为云开关模式。迁移后：

• 若原先开启了 airplane_mode，则自动生成 server.json 并写入 "disable_ollama_cloud": true
• 并在数据库中标记迁移已完成，防止重复执行。

此项优化彻底告别了旧版的'飞行模式'逻辑，让云访问控制更加清晰。

3. 全新 API 接口

在 api/client.go 中新增两个关键函数：

// 获取云状态
func (c *Client) CloudStatusExperimental(ctx context.Context) (*StatusResponse, error)

// 退出登录
func (c *Client) Signout(ctx context.Context) error

返回结构体 StatusResponse：

type StatusResponse struct {
    Cloud CloudStatus `json:"cloud"`
}

由此可以获得当前云功能的启用状态及来源（'env'、'config'、'both'、'none'）。这一改动为上层应用的状态展示与 UI 控制提供了稳定接口。

4. PowerShell 渲染修复与测试增强

Windows PowerShell 下的输出渲染问题在此次版本中被彻底修复。
cmd/tui: fix powershell search 的提交中修改了 PowerShell 的搜索与渲染逻辑，确保在启用搜索时界面不再出现乱码或闪烁。

同时，测试文件 server_test.go、cloud_policy_test.go 等均新增针对这些问题的回归测试。每个测试均使用独立的临时目录、环境变量与配置文件，确保环境隔离。

三、数据库与存储层改进

1. 云设置迁移逻辑

新增函数：

func(db *database) migrateV12ToV13() error

实现数据库版本迁移及云设置标识字段的加入，同时使历史配置'飞行模式'自动转化为云开关配置。

2. 优化 Store 结构

在 store.go 中的 Store.ensureDB() 函数新增一段自动迁移逻辑：

if err := s.migrateCloudSetting(database); err != nil {
    return fmt.Errorf("migrate cloud setting: %w", err)
}

这段代码确保在应用启动时完成一次性迁移，确保兼容旧数据结构。

四、工具模块更新：Web Search 与 Fetch 安全验证

v0.16.2 中对工具层（app/tools）进行了安全性强化，引入了 ensureCloudEnabledForTool() 函数。该函数会在每次 Web 搜索或 Web fetch 调用前验证云是否启用。

if err := ensureCloudEnabledForTool(ctx, "web search is unavailable"); err != nil {
    return nil, err
}

这一机制防止禁用云后仍有网络访问请求，从而完全切断云端数据通路。

该逻辑测试由 app/tools/cloud_policy_test.go 负责验证，确保工具在三种情况下表现正确：

• 云启用：正常运行
• 云禁用：直接返回错误
• 状态无法验证：默认拒绝执行（fail closed）

设计思想遵循'宁可误拒，不可误传'，极大强化了数据隔离。

五、界面与前端更新详解

1. 新增 Cloud 状态 Hook 与 UI 控制

在前端代码中，新增 useCloudStatus() Hook，用于实时获取云状态并在 UI 层动态呈现。

页面主要变更点如下：

ChatForm.tsx

• 新增 cloudDisabled 判断逻辑，替代旧版的 airplaneMode
• 若 cloudDisabled 为真，则自动关闭 WebSearch
• 在提交前检查云禁用状态，防止云模型调用
• 登录提示逻辑调整为仅在云启用情况下显示

Settings.tsx

• 新增云状态展示与切换按钮
• 调用后端 updateCloudSetting(enabled) 更新配置文件
• 支持实时刷新与缓存更新
• 若云被环境变量强制关闭，则 UI 禁用该操作按钮
• 增加保存动画与状态回显，提高用户体验

ModelPicker.tsx

• 用 cloudDisabled 替代 airplaneMode 进行模型筛选
• 云禁用时仅展示本地模型

api.ts

新增接口：

export async function updateCloudSetting(enabled: boolean): Promise<CloudStatusResponse>;
export async function getCloudStatus(): Promise<CloudStatusResponse | null>;

用于更新与获取云状态，返回格式统一包含 disabled 与 source 字段。

六、测试体系增强

此版本新增大量测试文件，确保新功能稳定可靠：

• cloud_config_test.go：验证环境变量与配置文件双重控制逻辑
• server_test.go：验证启动命令环境变量设置
• cloud_policy_test.go：测试云禁用下的 Web 工具阻断
• migration_test.go：验证旧版'飞行模式'迁移至新机制

这些测试均覆盖多操作系统（Windows、macOS），为跨平台稳定性提供坚实保障。

七、总结

代码地址：github.com/ollama/ollama

ollama v0.16.2 是一次功能性与安全性双向提升的版本。它不仅带来了：

• 更强大的 Claude 模型网页搜索能力；
• 更智能的日志与 Trace 输出；
• 更完善的云禁用与数据隐私控制机制；
• 更健壮的跨平台渲染与数据库迁移。

通过环境变量、配置文件和接口联动实现了多层级的云策略管控，让本地与云执行分离清晰，性能与隐私得以平衡。

对于开发者而言，v0.16.2 是 ollama 向企业级数据安全迈出的重要一步。它意味着——你可以在本地安全执行任务，不让任何数据上传到云端，同时仍能在需要时快速开启云搜索能力。