大模型应用开发 / 系统课时
配置跨域访问
配置跨域访问
学习目标
完成本课后,你将能够:
- 理解浏览器同源策略与 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,后端执行认证。
按自己的节奏,确认真正理解。