OpenRouter API 无法连接怎么办？网络、节点与请求错误排查

1
#!/usr/bin/env bash
2
# ==============================================================================
3
# OpenRouter API 全链路连通性、Cloudflare 防火墙与鉴权状态深度体检工具
4
# 用途: 一键检测代理出口 IP 信誉、TLS 握手、Token 状态与模型路由
5
# ==============================================================================
6

7
set -euo pipefail
8

9
GREEN='\033[0;32m'
10
YELLOW='\033[1;33m'
11
BLUE='\033[0;34m'
12
RED='\033[0;31m'
13
CYAN='\033[0;36m'
14
NC='\033[0m'
15

16
PROXY_ADDR="${HTTP_PROXY:-http://127.0.0.1:7890}"
17
API_KEY="${OPENROUTER_API_KEY:-}"
18

19
echo -e "${BLUE}====================================================================${NC}"
20
echo -e "${BLUE}        OpenRouter API 专属网络拓扑与全系端点连通性体检工具         ${NC}"
21
echo -e "${BLUE}====================================================================${NC}"
22
echo -e "当前指定代理出口: ${YELLOW}${PROXY_ADDR}${NC}\n"
23

24
# 1. 探测出口 IP 与地理位置归属
25
echo -e "${YELLOW}[1/4] 正在探测代理出口公网 IP 与地理位置归属...${NC}"
26
IP_RAW=$(curl -s --max-time 8 -x "${PROXY_ADDR}" https://api.ip.sb/geoip || true)
27

28
if [ -z "${IP_RAW}" ]; then
29
    echo -e "${RED}[FATAL] 代理连接超时，无法访问公网，请核验代理客户端状态！${NC}"
30
    exit 1
31
fi
32

33
OUT_IP=$(echo "${IP_RAW}" | grep -o '"ip":"[^"]*' | cut -d'"' -f4 || echo "未知")
34
OUT_CC=$(echo "${IP_RAW}" | grep -o '"country_code":"[^"]*' | cut -d'"' -f4 || echo "未知")
35
OUT_ASN=$(echo "${IP_RAW}" | grep -o '"asn":[^,]*' | cut -d':' -f2 || echo "未知")
36

37
echo -e "  - 物理出口 IP   : ${CYAN}${OUT_IP}${NC}"
38
echo -e "  - 注册国家代码  : ${GREEN}${OUT_CC}${NC}"
39
echo -e "  - 自治域 ASN    : ${CYAN}AS${OUT_ASN}${NC}"
40

41
if [[ "${OUT_CC}" =~ ^(CN|HK|MO|RU|IR)$ ]]; then
42
    echo -e "${RED}[ALERT] 警告: 当前出口位于受限区域 (${OUT_CC})！OpenRouter 请求可能被阻断！${NC}"
43
else
44
    echo -e "${GREEN}[PASS] 基础出口国家处于合规海外服务区。${NC}"
45
fi
46
echo ""
47

48
# 2. 探测 OpenRouter 核心 API 网关与 Cloudflare 拦截判定
49
echo -e "${YELLOW}[2/4] 探测 OpenRouter 边缘网关 (openrouter.ai) 与 Cloudflare 防火墙...${NC}"
50
CF_HTTP=$(curl -s -o /dev/null -w "%{http_code}" --max-time 10 -x "${PROXY_ADDR}" \
51
    https://openrouter.ai/api/v1/models || true)
52

53
echo -e "  - API 状态响应码: ${GREEN}${CF_HTTP}${NC}"
54
if [ "${CF_HTTP}" == "200" ]; then
55
    echo -e "${GREEN}[PASS] 成功穿透 Cloudflare Anycast 边缘网关！IP 信誉良好！${NC}"
56
elif [ "${CF_HTTP}" == "403" ]; then
57
    echo -e "${RED}[FAIL] 触发 Cloudflare 403 阻断！当前代理 IP 已被标记为高风险，请立即更换节点！${NC}"
58
elif [ "${CF_HTTP}" == "000" ]; then
59
    echo -e "${RED}[FAIL] 无法连通 openrouter.ai！属于物理断流或代理规则漏配，遭遇防火墙阻断！${NC}"
60
else
61
    echo -e "${YELLOW}[WARN] 收到非典型响应码 (${CF_HTTP})，请核验网络配置。${NC}"
62
fi
63
echo ""
64

65
# 3. 验证 API Key 授权与信用额度状态
66
echo -e "${YELLOW}[3/4] 验证 API Key 鉴权与账户额度状态...${NC}"
67
if [ -z "${API_KEY}" ]; then
68
    echo -e "${YELLOW}[SKIP] 未检测到 OPENROUTER_API_KEY 环境变量，跳过鉴权核验。${NC}"
69
    echo -e "提示: 可通过 export OPENROUTER_API_KEY='sk-or-v1-...' 设置后重新运行。"
70
else
71
    AUTH_RESP=$(curl -s --max-time 10 -x "${PROXY_ADDR}" \
72
        -H "Authorization: Bearer ${API_KEY}" \
73
        https://openrouter.ai/api/v1/auth/key || true)
74

75
    if echo "${AUTH_RESP}" | grep -q '"data"'; then
76
        echo -e "${GREEN}[PASS] API Key 验证成功！账户权限处于正常激活状态！${NC}"
77
        KEY_LABEL=$(echo "${AUTH_RESP}" | grep -o '"label":"[^"]*' | cut -d'"' -f4 || echo "默认密钥")
78
        LIMIT_LEFT=$(echo "${AUTH_RESP}" | grep -o '"limit_remaining":[^,}]*' | cut -d':' -f2 || echo "无限制")
79
        echo -e "  - 密钥标识名称  : ${CYAN}${KEY_LABEL}${NC}"
80
        echo -e "  - 剩余消费额度  : ${GREEN}\$${LIMIT_LEFT}${NC}"
81
    elif echo "${AUTH_RESP}" | grep -q '401'; then
82
        echo -e "${RED}[FAIL] HTTP 401: API Key 无效或已被注销，请前往控制台重新生成！${NC}"
83
    else
84
        echo -e "${RED}[FAIL] 鉴权响应异常: ${AUTH_RESP}${NC}"
85
    fi
86
fi
87
echo ""
88

89
# 4. 模拟向轻量模型发起极简端到端推理握手
90
echo -e "${YELLOW}[4/4] 模拟端到端推理请求 (测试模型: google/gemini-2.5-flash)...${NC}"
91
if [ -n "${API_KEY}" ]; then
92
    START_TIME=$(date +%s%3N)
93
    CHAT_RESP=$(curl -s --max-time 15 -x "${PROXY_ADDR}" \
94
        -X POST https://openrouter.ai/api/v1/chat/completions \
95
        -H "Authorization: Bearer ${API_KEY}" \
96
        -H "Content-Type: application/json" \
97
        -d '{
98
            "model": "google/gemini-2.5-flash",
99
            "messages": [{"role": "user", "content": "ping"}],
100
            "max_tokens": 5
101
        }' || true)
102
    END_TIME=$(date +%s%3N)
103
    ELAPSED=$((END_TIME - START_TIME))
104

105
    if echo "${CHAT_RESP}" | grep -q '"choices"'; then
106
        echo -e "${GREEN}[PASS] 端到端推理圆满成功！往返总时延: ${ELAPSED} ms！${NC}"
107
    else
108
        echo -e "${RED}[FAIL] 推理请求失败！响应内容: ${CHAT_RESP}${NC}"
109
    fi
110
else
111
    echo -e "${YELLOW}[SKIP] 未配置密钥，跳过真实推理测试。${NC}"
112
fi
113

114
echo -e "\n${BLUE}====================================================================${NC}"
115
echo -e "${GREEN}体检流程执行完毕！请根据上方状态指示完善生产环境网络配置。${NC}"
116
echo -e "${BLUE}====================================================================${NC}"

1
# ==============================================================================
2
# OpenRouter API 专属生产级高可用分流规则配置 (强制开启 TUN 虚拟网卡)
3
# 适用客户端: Mihomo (Clash.Meta) / Clash Verge Rev
4
# 核心特性: 接管本地多语言运行时与容器流量，精准分流，保障流式传输不掉线
5
# ==============================================================================
6

7
mixed-port: 7890
8
allow-lan: false
9
mode: rule
10
log-level: info
11
ipv6: false
12

13
# 核心关键项 1: 开启 TUN 虚拟网卡模式，全面接管 Node.js、Python 与 Docker 网络
14
tun:
15
  enable: true
16
  stack: mixed
17
  dns-hijack:
18
    - "tcp://any:53"
19
    - "udp://any:53"
20
  auto-route: true
21
  auto-detect-interface: true
22

23
# 核心关键项 2: 开启 Fake-IP 模式，杜绝本地 DNS 污染与解析延迟
24
dns:
25
  enable: true
26
  listen: 0.0.0.0:1053
27
  enhanced-mode: fake-ip
28
  fake-ip-range: 198.18.0.1/16
29
  nameserver:
30
    - 8.8.8.8
31
    - 1.1.1.1
32
  fallback:
33
    - https://dns.google/dns-query
34
    - https://1.1.1.1/dns-query
35

36
proxies:
37
  # 优选高信誉原生家庭宽带或低风控优质机房专线
38
  - name: "OpenRouter-US-Direct"
39
    type: ss
40
    server: us-clean.example.com
41
    port: 443
42
    cipher: 2022-blake3-aes-128-gcm
43
    password: "YourStrongPasswordHere"
44
    udp: true
45

46
  - name: "OpenRouter-JP-LowLatency"
47
    type: ss
48
    server: jp-lowlatency.example.com
49
    port: 443
50
    cipher: 2022-blake3-aes-128-gcm
51
    password: "YourStrongPasswordHere"
52
    udp: true
53

54
proxy-groups:
55
  # 统一策略组: 严禁使用随机高频轮询，保持长连接的会话粘性 (Session Affinity)
56
  - name: "OpenRouter-Service"
57
    type: select
58
    proxies:
59
      - "OpenRouter-US-Direct"
60
      - "OpenRouter-JP-LowLatency"
61

62
  - name: "Default-Group"
63
    type: select
64
    proxies:
65
      - DIRECT
66
      - "OpenRouter-US-Direct"
67

68
rules:
69
  # ==========================================================
70
  # 1. OpenRouter 核心主站、API 接口与鉴权中心
71
  # ==========================================================
72
  - DOMAIN-SUFFIX,openrouter.ai,OpenRouter-Service
73
  - DOMAIN-KEYWORD,openrouter,OpenRouter-Service
74

75
  # ==========================================================
76
  # 2. Cloudflare 边缘安全、Turnstile 验证与 Anycast 基础设施
77
  # ==========================================================
78
  - DOMAIN-SUFFIX,cloudflare.com,OpenRouter-Service
79
  - DOMAIN-SUFFIX,challenges.cloudflare.com,OpenRouter-Service
80

81
  # ==========================================================
82
  # 3. 常见关联的大模型供应商核心推理网关
83
  # ==========================================================
84
  - DOMAIN-SUFFIX,openai.com,OpenRouter-Service
85
  - DOMAIN-SUFFIX,anthropic.com,OpenRouter-Service
86
  - DOMAIN-SUFFIX,deepseek.com,OpenRouter-Service
87
  - DOMAIN-SUFFIX,together.xyz,OpenRouter-Service
88

89
  # 基础分流
90
  - GEOIP,CN,DIRECT
91
  - MATCH,Default-Group

1
import asyncio
2
import json
3
import logging
4
import httpx
5
from typing import AsyncGenerator, Dict, Any, List, Optional
6

7
logging.basicConfig(level=logging.INFO)
8
logger = logging.getLogger("OpenRouterClient")
9

10
class ResilientOpenRouterClient:
11
    """
12
    具备自动模型回退、TCP保活心跳与指数退避重试的生产级 OpenRouter 客户端
13
    """
14
    def __init__(
15
        self,
16
        api_key: str,
17
        proxy_url: Optional[str] = "http://127.0.0.1:7890",
18
        default_model: str = "anthropic/claude-3.5-sonnet",
19
        fallback_models: Optional[List[str]] = None
20
    ):
21
        self.api_key = api_key
22
        self.base_url = "https://openrouter.ai/api/v1"
23
        self.default_model = default_model
24
        self.fallback_models = fallback_models or [
25
            "openai/gpt-4o",
26
            "google/gemini-2.5-flash"
27
        ]
28

29
        # 配置具备超长读取超时与 Keep-Alive 优化的底层 HTTP 传输池
30
        limits = httpx.Limits(max_keepalive_connections=50, max_connections=100, keepalive_expiry=120.0)
31
        timeout = httpx.Timeout(connect=15.0, read=300.0, write=30.0, pool=10.0)
32

33
        self.client = httpx.AsyncClient(
34
            base_url=self.base_url,
35
            proxy=proxy_url,
36
            limits=limits,
37
            timeout=timeout,
38
            headers={
39
                "Authorization": f"Bearer {self.api_key}",
40
                "HTTP-Referer": "https://production-app.internal",
41
                "X-Title": "Production-Agent-Gateway",
42
                "Content-Type": "application/json"
43
            }
44
        )
45

46
    async def stream_chat_completion(
47
        self,
48
        messages: List[Dict[str, str]],
49
        temperature: float = 0.7
50
    ) -> AsyncGenerator[str, None]:
51
        """
52
        具备多模型容灾回退的流式文本生成生成器
53
        """
54
        # 组装优先尝试列表: 默认模型 + 容灾备用模型清单
55
        candidate_models = [self.default_model] + self.fallback_models
56

57
        for attempt_idx, current_model in enumerate(candidate_models):
58
            payload = {
59
                "model": current_model,
60
                "messages": messages,
61
                "temperature": temperature,
62
                "stream": True,
63
                # 声明由 OpenRouter 官方自动处理 Provider 层级的容灾
64
                "route": "fallback"
65
            }
66

67
            logger.info(f"正在尝试使用模型: {current_model} 发起流式推理 (尝试序列: {attempt_idx + 1}/{len(candidate_models)})")
68

69
            try:
70
                async with self.client.stream("POST", "/chat/completions", json=payload) as response:
71
                    if response.status_code == 401:
72
                        raise RuntimeError("API Key 无效或已过期，无法继续重试！")
73
                    if response.status_code == 402:
74
                        raise RuntimeError("账户余额耗尽，请充值后重试！")
75

76
                    if response.status_code != 200:
77
                        err_text = await response.aread()
78
                        logger.warning(f"模型 {current_model} 响应异常状态码 {response.status_code}: {err_text.decode('utf-8', errors='ignore')}")
79
                        # 遇到 429、500、502、524 等错误时，跳入下一个备选模型
80
                        continue
81

82
                    # 持续消费 Server-Sent Events (SSE) 流
83
                    async for line in response.aiter_lines():
84
                        line = line.strip()
85
                        if not line or line.startswith(":"):
86
                            # 忽略心跳包空行
87
                            continue
88
                        if line == "data: [DONE]":
89
                            break
90
                        if line.startswith("data: "):
91
                            data_chunk = line[6:]
92
                            try:
93
                                json_chunk = json.loads(data_chunk)
94
                                delta_text = json_chunk.get("choices", [{}])[0].get("delta", {}).get("content", "")
95
                                if delta_text:
96
                                    yield delta_text
97
                            except json.JSONDecodeError:
98
                                continue
99

100
                    # 如果流式传输圆满结束，直接返回退出整个重试循环
101
                    return
102

103
            except (httpx.ReadTimeout, httpx.ConnectError, httpx.RemoteProtocolError) as net_err:
104
                logger.warning(f"模型 {current_model} 发生网络抖动或读取超时: {str(net_err)}，准备启动下一级备选模型...")
105
                await asyncio.sleep(1.0)
106
                continue
107

108
        raise RuntimeError("所有主备模型均无法连通，网络或服务端可能发生大规模瘫痪！")
109

110
    async def close(self):
111
        await self.client.aclose()