自建OneAPI中转站防范Ollama数据泄露配置

为什么要防范Ollama数据泄露？

自建OneAPI中转站后，如果安全配置不到位，外部的Ollama服务接口可能被未授权调用，导致模型参数、对话历史甚至本地文件泄露。
Ollama默认不限制来源IP，直接暴露在公网上风险极高。
本文针对已部署OneAPI和Ollama的用户，讲解如何通过中转站的配置和系统层安全策略来阻断此类风险。

前置准备

操作前请确保满足以下条件：

• 一台已经安装OneAPI（版本≥0.5.0）和Ollama（版本≥0.1.0）的Linux服务器。
• 拥有root或sudo权限。
• 已开通服务器防火墙（如ufw、iptables或云安全组）。
• 已获取OneAPI的管理员令牌（用于后续API配置）。

核心配置步骤：让OneAPI成为数据安全闸门

1. 修改Ollama监听地址（只允许本机访问）

Ollama默认监听0.0.0.0:11434，这会暴露给所有网络接口。
先用以下命令确认：

ss -tlnp | grep 11434

如果显示0.0.0.0:11434，则必须修改。
编辑Ollama服务文件：

sudo systemctl edit ollama.service

在空白处追加：

[Service]
Environment="OLLAMA_HOST=127.0.0.1:11434"

保存后重启：

sudo systemctl daemon-reload
sudo systemctl restart ollama

再次检查确认监听地址变为127.0.0.1:11434。
这样Ollama只对OneAPI所在的同一台服务器开放，外部无法直接访问。

2. 配置OneAPI渠道，限制可调用的模型

登录OneAPI管理后台，进入「渠道」→「添加渠道」。
类型选择「自定义」，填入Ollama的本地地址http://127.0.0.1:11434。
在「模型」栏中，只勾选你的业务确实需要的模型，比如llama3、qwen2，不要留空或填*。
这样即使外部获取了API密钥，也只能调用你指定的模型，无法枚举Ollama上的所有模型。

3. 启用IP白名单（推荐）

如果你只需要从固定IP访问OneAPI，可以在OneAPI的「系统设置」→「安全」中启用IP白名单。
填入允许的客户端IP（多个用逗号分隔）。
注意：白名单作用于OneAPI的入口访问，不适用于Ollama本身。

4. 配置服务器防火墙，封锁非OneAPI端口

使用ufw为例，只开放OneAPI的端口（默认3000）和SSH端口：

sudo ufw default deny incoming
sudo ufw allow 22/tcp
sudo ufw allow 3000/tcp
sudo ufw enable

检查规则：sudo ufw status verbose。
确保11434端口不在允许列表中。

5. 开启OneAPI的访问日志审计

在OneAPI的「系统设置」→「日志」中，勾选“记录所有API调用”。
生产环境建议保留30天。
以后可以通过日志回溯可疑调用，及时发现异常。

避坑指南：这些细节容易导致安全漏洞

• 不要使用OneAPI默认的管理员令牌。创建渠道后立刻修改管理员密码和令牌。
• 不要将OneAPI的API密钥明文写在代码中，使用环境变量或密钥管理工具。
• 不要同时在Ollama和OneAPI上开放公网访问：两者只能选其一暴露。推荐只暴露OneAPI，且通过HTTPS。
• 不要忽略Ollama的版本更新：旧版本可能存在已知漏洞。定期执行ollama pull更新模型引擎。

效果验证：确认数据泄露已被阻断

验证一：外部无法直接访问Ollama

在另一台机器上执行：

curl http://你的服务器IP:11434/api/tags

预期结果：连接超时或被拒绝。
如果返回数据，说明Ollama仍未锁定。

验证二：只有授权的模型可被调用

用正确的OneAPI Key访问OneAPI接口，请求一个未授权的模型（比如gpt-4）：

curl -X POST http://你的服务器IP:3000/v1/chat/completions \
  -H "Authorization: Bearer 你的API密钥" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-4", "messages": [{"role": "user", "content": "hello"}]}'

预期返回错误：model not found 或 invalid model。
如果成功调用说明渠道模型列表配置有误。

验证三：检查OneAPI访问日志

进入OneAPI后台「日志」页面，能看到每次调用的来源IP、模型、时间。
如果出现非白名单的IP或异常频率，及时封禁相应密钥。

常见问题解答

Q：我既需要公网访问Ollama，又需要安全防护怎么办？
A：放弃直接暴露Ollama，改为通过OneAPI中转，并给OneAPI绑定域名配置HTTPS。如果必须用Ollama原生接口，至少加上nginx反向代理和IP白名单。

Q：OneAPI的IP白名单和服务器防火墙有什么区别？
A：IP白名单只控制OneAPI业务层的访问，防火墙从网络层拦截所有未授权端口。两者叠加效果更好。

Q：配置完成后如何测试Ollama是否真的只有本地可访问？
A：登录服务器执行curl -s http://127.0.0.1:11434/api/tags，应该正常返回。然后在服务器外部执行相同命令，应失败。

如果你按以上步骤操作，自建OneAPI中转站防范Ollama数据泄露的配置就已经完成。
建议每季度复查一次防火墙规则和OneAPI日志，确保安全策略持续生效。