skgate

好用

export SKGATE=https://skgate.example.com KEY=sk-...
curl -s $SKGATE/v1/models -H "Authorization: Bearer $KEY"
curl -s $SKGATE/v1/chat/completions -H "Authorization: Bearer $KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"<id from /v1/models>","messages":[{"role":"user","content":"Say hi"}]}'

export OPENAI_BASE_URL=https://skgate.example.com/v1 OPENAI_API_KEY=sk-...

from openai import OpenAI

client = OpenAI()  # reads the two variables above
r = client.chat.completions.create(model="<id from /v1/models>", messages=[{"role": "user", "content": "Say hi"}])
print(r.choices[0].message.content)

别名由用户自行定义：skgate 不提供任何预设别名。选择任意名称，并将其指向一个模型。本例使用 grok-latest，名称由你决定。

只需在这个位置更改目标，所有使用该名称的应用都会立即切换，无需更改客户端配置。

Grok > Aliases：New alias grok-latest，Target model grok-4.7，Add alias。

client sends   {"model": "grok-latest", ...}
skgate sends   {"model": "grok-4.7", ...}

别名会列在 /v1/models 的最前面。

mcp upstreams > Add upstream > 输入 managed process：

1. MCP source URL / package，以下任选其一：

   来源	运行方式
   @modelcontextprotocol/server-everything	npm 包，npx
   pypi:mcp-server-time	PyPI 包，uvx
   https://github.com/example-org/notes-mcp	git 仓库：克隆、安装、运行（私有仓库：Suggest 会要求提供令牌）

2. Suggest configuration。skgate 会获取 README 和清单（package.json、pyproject.toml、server.json）。

   MCP 辅助模型会提供命令、参数、安装步骤，以及环境变量名称（是否为密钥、是否必填）。Manual configuration 字段会自动填入，并附带置信度和任何警告。

   此时还不会保存任何内容。请设置服务器所需的变量。

3. 设置别名，填写所需变量（空值不会传递给服务器），然后点击 Save。服务器地址为 https://skgate.example.com/mcp/<alias>。

如果按钮呈灰色，请将鼠标悬停在按钮上。使用旁边的 Pick MCP helper model，或先在 status 中添加提供商。

托管连接器使用 OAuth（client ID 和 secret 留空）。脚本和 CLI 需要发送密钥：

{"mcpServers": {"skgate": {"type": "http", "url": "https://skgate.example.com/mcp/<alias>",
  "headers": {"Authorization": "Bearer sk-..."}}}}

在 RAM 受限的家庭实验室中，空闲的 MCP 服务不应产生任何开销。

托管服务（npx、pnpm dlx、bunx、deno、uvx、git）是 skgate 的子进程。

默认情况下（Lifecycle 为 on-demand），服务会在收到第一个请求时启动，并在 10 分钟没有请求后停止；下一个请求会再次启动它。

before   3 MCP servers = 3 containers, always running
after    1 skgate container; 0 server processes while idle, 1 per server in use

stopped  --request-->  starting  -->  running  --10 min idle-->  stopped

• 默认模式为按需；Lifecycle 设为 always-on 后，服务会在启动时运行。
• 服务停止后的第一个请求会等待服务启动。
• 有正在处理的请求时，服务绝不会停止。
• 空闲时间通过导入 JSON 中的 idleTimeoutSeconds 设置（默认值为 600；表单中没有此项）：

{"mcpServers": {"time": {"command": "uvx", "args": ["mcp-server-time"], "skgate": {"idleTimeoutSeconds": 120}}}}

• 聚合端点 /mcp 会包含标记为 In /mcp 的远程、OpenAPI 和常驻上游。按需服务会被排除，因此 /mcp 绝不会启动它们。要使用某个按需服务，请将客户端指向 /mcp/<alias>。
• 远程和 OpenAPI 上游没有进程，因此无需进入空闲状态。
• 管理员点击 Stop 后，服务会保持停止状态，直到点击 Start 或 Restart。

mcp upstreams > import JSON > 粘贴 > Import。需要使用 latest 镜像。

{"mcpServers": {"everything": {"command": "npx", "args": ["-y", "@modelcontextprotocol/server-everything"]}}}

服务地址为 https://skgate.example.com/mcp/everything。同一个包可以使用任意内置运行器运行：

mcp upstreams > import JSON > 粘贴 > Import。skgate 会克隆仓库、运行 install，然后执行命令。

{"mcpServers": {"notes": {"command": "node", "args": ["server.js"],
  "skgate": {"gitUrl": "https://github.com/example-org/notes-mcp.git", "gitRef": "main", "install": "npm ci"}}}}

mcp upstreams > Add upstream > 输入 remote server，或导入：

{"mcpServers": {"docs": {"type": "http", "url": "https://mcp.example.com/mcp",
  "headers": {"Authorization": "Bearer ..."}}}}

1. xAI，在 OpenCode 中使用 Grok
2. Anthropic，法律与合规
3. Google，Gemini CLI 条款
4. OpenAI，使用 ChatGPT 登录

services:
  skgate:
    container_name: skgate
    image: ghcr.io/helv-io/skgate:latest
    restart: always
    network_mode: web   # existing Docker network shared with Traefik; no ports needed
    environment:
      - PUBLIC_URL=https://skgate.example.com   # the public https origin
      - OIDC_ISSUER=https://auth.example.com
      - OIDC_CLIENT_ID=skgate
      - OIDC_CLIENT_SECRET=change-me
    volumes:
      - ./data:/data
    healthcheck:
      test: ["CMD", "/skgate", "healthcheck"]
      interval: 30s
      timeout: 5s
      retries: 3
    labels:
      # no forward-auth middleware on /v1, /api, /mcp, /sse, /messages, /authorize, /token, /register, /.well-known
      - traefik.enable=true
      - traefik.http.routers.skgate.rule=Host(`skgate.example.com`)
      - traefik.http.routers.skgate.entryPoints=websecure
      - traefik.http.services.skgate.loadbalancer.server.port=8080

server {
    listen 443 ssl;
    http2 on;
    server_name skgate.example.com;
    ssl_certificate     /etc/ssl/skgate/fullchain.pem;
    ssl_certificate_key /etc/ssl/skgate/privkey.pem;

    client_max_body_size 32m;                         # skgate accepts up to 32 MB

    location / {
        proxy_pass http://skgate:8080;
        proxy_http_version 1.1;
        proxy_set_header Connection "";
        proxy_set_header Host $host;                  # keep Host
        proxy_set_header X-Forwarded-For $remote_addr;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_buffering off;                          # SSE streaming
        proxy_read_timeout 3600s;                     # long streams
        proxy_send_timeout 3600s;
    }
}

skgate.example.com {
    # Host and X-Forwarded-* are set by default; no body limit, no response timeout
    reverse_proxy skgate:8080 {
        flush_interval -1                             # SSE streaming
    }
}

defaults
    mode http
    timeout connect 5s
    timeout client  1h                                # long streams
    timeout server  1h
    timeout tunnel  1h

frontend https
    bind :443 ssl crt /etc/haproxy/certs/skgate.pem alpn h2,http/1.1
    option forwardfor                                 # X-Forwarded-For; Host is kept, responses are not buffered
    http-request set-header X-Forwarded-Proto https
    default_backend skgate

backend skgate
    option httpchk GET /healthz
    server skgate skgate:8080 check

# a2enmod ssl proxy proxy_http headers
<VirtualHost *:443>
    ServerName skgate.example.com
    SSLEngine on
    SSLCertificateFile    /etc/ssl/skgate/fullchain.pem
    SSLCertificateKeyFile /etc/ssl/skgate/privkey.pem

    # keep Host
    ProxyPreserveHost On
    RequestHeader set X-Forwarded-Proto "https"
    # long streams
    ProxyTimeout 3600
    # flushpackets: no buffering (SSE)
    ProxyPass        / http://skgate:8080/ flushpackets=on
    ProxyPassReverse / http://skgate:8080/
</VirtualHost>