大模型应用开发 / 系统课时

配置跨域访问

配置跨域访问

学习目标

完成本课后,你将能够:

  • 理解浏览器同源策略与 CORS 的作用
  • 使用 OLLAMA_ORIGINS 添加可信来源
  • 区分网络可达、CORS 允许和服务认证
  • 避免使用过宽来源暴露本地模型

CORS 解决的不是网络连接

浏览器页面访问不同协议、域名或端口时,会受到同源策略限制。CORS 响应头告诉浏览器哪些来源可以读取响应。

CORS 不是防火墙,也不是认证。命令行工具不受浏览器 CORS 限制,攻击者仍可能直接发送 HTTP 请求。

来源的组成

来源由三部分组成:

text
scheme://host:port

以下来源互不相同:

text
http://localhost:3000
http://localhost:5173
https://app.example.com
https://app.example.com:8443

配置时应填写实际前端来源。

临时启动配置

示例允许两个开发来源:

bash
OLLAMA_ORIGINS="http://localhost:3000,http://localhost:5173" OLLAMA_HOST="127.0.0.1:11434" ollama serve

预期输出:

text
<SERVICE_START_LOGS>

该命令占用当前终端。桌面应用和 systemd 服务应按平台设置环境变量。

Linux systemd 配置

编辑:

bash
sudo systemctl edit ollama

写入:

ini
[Service]
Environment="OLLAMA_ORIGINS=http://localhost:3000,https://app.example.com"

生效:

bash
sudo systemctl daemon-reload
sudo systemctl restart ollama
systemctl is-active ollama

预期输出:

text
active

验证预检请求

允许来源:

bash
curl -i -X OPTIONS http://localhost:11434/api/chat   -H "Origin: http://localhost:3000"   -H "Access-Control-Request-Method: POST"   -H "Access-Control-Request-Headers: content-type"

预期结果:

text
HTTP/<VERSION> <STATUS>
Access-Control-Allow-Origin: http://localhost:3000
<OTHER_CORS_HEADERS>

具体状态和头部随版本变化。重点是允许来源与请求来源匹配。不允许来源:

bash
curl -i -X OPTIONS http://localhost:11434/api/chat   -H "Origin: https://untrusted.example"   -H "Access-Control-Request-Method: POST"

预期结果:

text
响应不应把 https://untrusted.example 作为允许来源返回。

浏览器测试

前端代码片段:

js
const response = await fetch("http://localhost:11434/api/tags");
if (!response.ok) {
  throw new Error(`HTTP ${response.status}`);
}
const data = await response.json();
console.log(data.models);

预期页面效果:

text
浏览器控制台输出模型数组;来源未允许时,浏览器报告 CORS 错误。

这段代码直接访问本地服务,只适合受控开发环境。

浏览器扩展来源

浏览器扩展使用 chrome-extension://、moz-extension:// 或 safari-web-extension:// 等来源。官方文档允许配置对应模式,但应优先指定实际扩展 ID,避免允许所有扩展访问本地模型。

扩展具备的页面权限与 Ollama CORS 是两个独立安全层。

不要使用全开放替代认证

将来源设置为所有域名会让任意网页尝试调用用户本机 Ollama。如果服务同时监听局域网,还会扩大风险。推荐:

  • 开发环境只允许本地前端端口。
  • 生产前端通过同域后端代理。
  • 代理层执行认证、限流和审计。
  • Ollama 保持仅本机或容器内部可访问。

本课练习

练习 1:允许单个开发来源

任务目标:掌握精确 CORS。输入或初始条件:前端运行在固定端口。实现要求:设置来源并测试预检。验收条件:可信来源通过,其他来源不返回允许头。

练习 2:区分 CORS 与认证

任务目标:理解安全边界。输入或初始条件:使用 curl 和浏览器访问同一端点。实现要求:比较行为。验收条件:能说明 curl 不依赖 CORS。

练习 3:设计生产代理

任务目标:避免浏览器直连。输入或初始条件:前端和后端同域。实现要求:让后端代理 Ollama

验收条件:浏览器不需要访问 11434,后端执行认证。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

配置跨域访问

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通