AetherGate.Core 1.0.0

AetherGate.Core

AetherGate（苍穹网关）是连接多模型生态的统一 AI 智能网关。AetherGate.Core 是其核心类库，负责注册网关服务、绑定和校验配置，并提供 OpenAI、Anthropic 和可选 Ollama 兼容接口的代理能力。

代码集成

在 ASP.NET Core 应用中注册服务并启用网关：

using AetherGate.Core.Configuration;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddAetherGate(options =>
{
	options.Providers["default"] = new ProviderOptions
	{
		BaseUrl = "https://api.example.com",
		ApiKey = "your-upstream-key"
	};
});

var app = builder.Build();
app.UseAetherGate();
app.Run();

如果配置全部来自 appsettings.json 或环境变量，可以直接使用：

builder.Services.AddAetherGate();

AddAetherGate 会绑定 AetherGate 配置节，并注册上游代理、Ollama 兼容服务、默认模型转换、转发头和网络策略等服务。UseAetherGate 会注册网关路由及 IP 白名单、代理 API Key 鉴权中间件。

配置约定

配置根节点为 AetherGate：

• Upstream：默认 Provider、默认模型、上游 API Key 和超时设置。
• Providers：以一个上游 BaseUrl 为单位配置 Provider。同一个 Provider 可以同时处理 OpenAI 和 Anthropic 协议以及多个模型。
• Proxy：客户端 API Key、IP/CIDR 白名单、可信代理和 JSON 请求体大小限制。
• Olloma：Olloma 兼容层开关、匿名访问和默认模型参数。

Provider 的 BaseUrl 必须是不包含 /v1、查询字符串或片段的 HTTP/HTTPS 服务根地址：

{
	"AetherGate": {
		"Upstream": {
			"DefaultProvider": "default",
			"OpenAIDefaultModel": "gpt-5-mini",
			"AnthropicDefaultModel": "claude-sonnet-model"
		},
		"Providers": {
			"default": {
				"BaseUrl": "https://api.example.com",
				"ApiKey": "your-upstream-key",
				"AnthropicVersion": "2023-06-01"
			}
		},
		"Ollama": {
			"Enabled": true,
			"AllowUnauthenticatedAccess": false
		}
	}
}

应用启动时会校验 Provider、BaseUrl、默认 Provider 的 API Key、超时和网络规则。敏感信息建议使用环境变量或其他安全配置源注入，不要直接提交到代码仓库。

路由

启用 UseAetherGate 后提供以下接口：

其中 /api/* 路由仅在 AetherGate:Ollama:Enabled=true 时注册。

配置 AetherGate:Proxy:ApiKey 后，/v1/* 和 /api/* 会检查客户端的 Bearer 或 x-api-key。只有显式配置 AetherGate:Ollama:AllowUnauthenticatedAccess=true 时，Ollama 路由才允许匿名访问；同时启用 Ollama 和匿名访问时，还会额外放行 POST /v1/chat/completions，以兼容无法发送 Key 的 Ollama 客户端。

AetherGate:Proxy:AllowedNetworks 配置的 IP/CIDR 白名单始终应用于 /v1/* 和 /api/*，不受 Ollama 匿名访问设置影响；/health 不检查 IP 白名单和代理 API Key。

/v1/* 支持通过 X-Provider 选择已配置的 Provider，并通过 X-Provider-Api-Key 覆盖当前请求的上游 API Key。两者仅适用于 OpenAI/Anthropic 代理，不会转发到上游。

Ollama /api/* 始终使用服务端配置的默认 Provider，不读取请求级 Provider 或 API Key。