TinkerLab
ARTIFACT // NGINX-OLLAMA-LAN-AUTH.CONF (SHELL)

本地模型局域网安全反向代理配置(Bearer 鉴权 + CORS 放行 + 零缓冲流式转发) (nginx-ollama-lan-auth.conf)

让 Ollama 只监听本机 127.0.0.1,通过 Nginx 对局域网提供带 Bearer 密钥鉴权、CORS 跨域头与零缓冲 SSE 流式转发的安全接口。

[核心实测结论 / TL;DR]本配置包「本地模型局域网安全反向代理配置(Bearer 鉴权 + CORS 放行 + 零缓冲流式转发)」(文件名:nginx-ollama-lan-auth.conf,格式:SHELL)是 Tinker AI 实测工坊配套指南《cors-reverse-proxy-auth-local-llm》的参数化生产模板。支持在本地浏览器实时定制 局域网代理监听端口 (PROXY_LISTEN_PORT=11435)、局域网访问 Bearer 密钥 (LAN_BEARER_TOKEN=sk-tinker-homelab-secret-2026)、允许跨域的浏览器 Origin (ALLOWED_ORIGIN=*) 等 3 项核心变量,默认遵循 127.0.0.1 回环绑定与最小权限规范。
04 // DIAGNOSISAPI 与部署排障· 验证日期:2026-10-23
查看全部 42 套配置附件 →
nginx-ollama-lan-auth.conf

本地模型局域网安全反向代理配置(Bearer 鉴权 + CORS 放行 + 零缓冲流式转发)

让 Ollama 只监听本机 127.0.0.1,通过 Nginx 对局域网提供带 Bearer 密钥鉴权、CORS 跨域头与零缓冲 SSE 流式转发的安全接口。

查看配套实测指南 →
参数化定制变量 (Variables — 自动保存在本地浏览器)
UTF-8 编码 · 零延迟实时编译
# Tinker AI — Secure Nginx Reverse Proxy for Local Ollama (Keep Ollama on 127.0.0.1:11434)
map $http_authorization $auth_ok {
    default 0;
    "Bearer sk-tinker-homelab-secret-2026" 1;
}

server {
    listen 0.0.0.0:11435;
    server_name _;

    location / {
        # Handle browser / Chrome extension CORS preflight
        if ($request_method = OPTIONS) {
            add_header Access-Control-Allow-Origin "*" always;
            add_header Access-Control-Allow-Methods "GET, POST, OPTIONS" always;
            add_header Access-Control-Allow-Headers "Authorization, Content-Type" always;
            return 204;
        }

        if ($auth_ok = 0) {
            return 401 '{"error":"Unauthorized: valid Bearer token required"}';
        }

        proxy_pass http://127.0.0.1:11434;
        proxy_set_header Host localhost:11434;
        proxy_buffering off;
        proxy_cache off;
        proxy_read_timeout 300s;
        chunked_transfer_encoding on;
    }
}
PARAMETER SPECIFICATION // 参数化变量规范说明表

「nginx-ollama-lan-auth.conf」可定制环境变量与默认值说明

本配置模板(SHELL 格式)支持 3 项运行时参数注入,所有替换均在本地浏览器内完成。

模板占位符参数用途说明安全默认值填写示例
{{PROXY_LISTEN_PORT}}局域网代理监听端口1143511435
{{LAN_BEARER_TOKEN}}局域网访问 Bearer 密钥sk-tinker-homelab-secret-2026sk-tinker-homelab-secret-2026
{{ALLOWED_ORIGIN}}允许跨域的浏览器 Origin**
PAIRED HARDWARE MANIFEST // 配套实测环境与边界记录

配套指南《本地模型 403 CORS 跨域拒绝、Nginx/Caddy 反代报错与局域网鉴权排障指南》验证基线

实测硬件与操作系统 (Hardware & OS)

Nginx 1.26 / Caddy 2.8 · Ollama 0.5.7 · 浏览器扩展与局域网多端调用实测

锁定软件栈与模型版本 (Pinned Versions)
Ollama 0.5.7Nginx 1.26+Caddy 2.8+
离线与安全边界 (100% 局域网受控鉴权网关)

让 Ollama 原生进程严格保持在 127.0.0.1 回环地址,通过反向代理层向局域网提供强制 Bearer 密钥校验的安全接口。

已知限制与失败边界 (Known Limits)
  • 高危安全红线:切勿在未加鉴权的情况下同时设置 `OLLAMA_HOST=0.0.0.0` 与 `OLLAMA_ORIGINS=*`!否则你在浏览器中打开的任意恶意网页都能通过前端 JS 静默调用甚至删除你本机的模型。
  • 浏览器混合内容限制:任何部署在 `https://` 域名下的纯前端网页,向局域网明文 `http://192.168.x.x:11434` 发起请求时都会被浏览器直接阻断(唯独本机 `http://127.0.0.1` 例外)。
DEPLOYMENT CHECKLIST // 配置落地核验步骤

部署 nginx-ollama-lan-auth.conf 后的 3 步验收清单

  1. 已按最小范围配置 `OLLAMA_ORIGINS`(如仅放行浏览器插件协议),避免裸奔使用 `*`。
  2. 已在反向代理中配置 `Host localhost:11434` 重写与 `proxy_buffering off` 零缓冲流式转发。
  3. 已为面向局域网暴露的模型端口配置 Bearer Token 鉴权保护。