dsfree2api

逆向 deepseek.de / deepseek.es / deepseek.fr 三个站点的 V4-Flash / V4-Pro 模型，提供 OpenAI API 完全兼容 的中转服务。

Go 实现，编译为单个静态二进制，无运行时依赖；内置 Web 管理控制台（模型 / Key / 代理 / Turnstile / 日志 / 调试）。

⚠️ 这些站点并非 DeepSeek 官方网站，请谨慎使用。

• 功能特性
• 界面预览
• 模型映射
• 快速开始
• 配置
• API 用法
• Web 管理台
• 环境变量
• 架构
• 开发
• 免责声明

• 多格式对话接口：POST /v1/chat/completions（OpenAI，流式 / 非流式）、POST /v1/responses（OpenAI Responses）、POST /v1/messages（Anthropic Messages）、GET /v1/models、GET /health
• Tool Calling：三个对话端点均支持 tools / tool_choice，模型以 JSON 输出 tool_calls，自动回填到响应（tool_calls / function_call / tool_use）；回复被上游输出上限截断时自动多轮续写拼接（continue_rounds），仍不闭合则在截断处就近补全为部分工具调用返回，由客户端下一轮继续写
• 三站点聚合：单站点每日额度耗尽自动切换到其他站点的同款模型，额度耗尽的站点临时降级 10 分钟
• 站点额度管理：额度按访客身份按日计算，控制台站点卡片可一键查询当前额度、重置访客身份（等同新开隐私窗口、额度即刻回满）；请求撞额度时也会自动轮换访客身份恢复，无需重新求解
• 代理线路：主线路 + 多条备用线路，支持 http:// https:// socks5://；slow-start 检测 + 失败降级 + 流中失败不重放
• 代理池：Xray 核心（分享链接 / 订阅 / ip:port 端点；核心可自动下载）+ 粘性选路 + 后台健康探测；每个站点可绑定独立出口，Turnstile 求解与请求共用同一出口
• Turnstile 自动突破：三种 Token 获取方式 — 求解服务 API（provider="api"）、本地浏览器自动求解（provider="browser"，CDP 直连 Chrome/Edge，无需 Playwright/Docker）、手动导入 Cookie（provider="manual"）；结果按「代理线路 × 站点」缓存，TTL 过期自动重解
• 会话自愈：nonce / data-config 缓存 + 配额耗尽 / 验证失败时自动刷新重试
• Web 管理台：仪表盘、模型与站点、API Key、代理线路、Turnstile、对话调试、实时日志、设置
• 可观测：按模型 / 站点 / 按日统计、P50/P95 延迟、最近请求、实时日志（SSE）、文件日志按日压缩轮转，数据持久化到 data/
• 安全：下游 Bearer / X-Api-Key 鉴权、每 Key 每分钟限流、每站点并发闸门、管理台独立口令

仪表盘	Turnstile
对话调试	实时日志

共 6 个模型，分布在三个欧洲站点：

三个站点各自有独立配额，聚合后每日可用 token 约 3 倍。

需要 Go ≥ 1.27。

cp config.example.toml config.toml
$EDITOR config.toml          # Turnstile 默认关闭；启用时按 provider 填 api_key 或 browser_path

go run ./cmd/dsfree2api -config config.toml

make build                   # 本机 → bin/dsfree2api
make linux                   # linux/amd64 静态二进制 → bin/dsfree2api-linux-amd64

部署到服务器：

scp bin/dsfree2api-linux-amd64 user@host:/opt/dsfree2api/dsfree2api
ssh user@host '/opt/dsfree2api/dsfree2api -config /opt/dsfree2api/config.toml'

二进制不带任何运行时依赖（CGO_ENABLED=0），无需安装 Python / glibc / libcurl。

cp config.example.toml config.toml
docker compose up -d --build

容器内监听 8000（API）与 8001（管理台），数据卷挂在 ./data。

curl http://127.0.0.1:8000/health
curl http://127.0.0.1:8000/v1/models -H "Authorization: Bearer sk-你的key"

配置文件是 TOML，结构见 config.example.toml（含全部字段注释）。

• 不存在该文件时按内置默认值启动
• 环境变量优先级高于配置文件
• 通过管理台或 PUT /api/config 修改会自动写回 config.toml（旧文件备份为 config.toml.bak）
• 启动时可用 -check 只校验配置：

dsfree2api -config config.toml -check

站点在发消息前会校验 Turnstile（ts_required），[turnstile] 默认关闭时不会自动求解。provider 决定 Token / Cookie 的获取方式，三选一：

• 求解服务风格：api_style = "ezsolver" 时兼容本地 EzSolver 形态的求解服务（{sitekey,siteurl,timeout} → {token}），api_key 可留空；环回 / 内网求解地址直连（不随 [proxy] 线路，避免 127.0.0.1 被解析到隧道另一侧）；
• 手动导入 Cookie：在走同一条出口线路的浏览器里过一次验证，把 document.cookie 粘到控制台 Turnstile → 手动导入 Cookie，在 cookie_ttl_seconds 内免求解（Cookie 与出口 IP / UA 绑定，换线路需重新导入）；
• 浏览器模式提示：求解期间会短暂弹出浏览器窗口（browser_headless = true 可关闭，但过验证率更低）；带账号密码的代理暂不支持 Chrome，请用 IP 白名单代理；浏览器被系统策略锁定时会报 browser launch failed 并附 stderr。

deepseek.fr / deepseek.es 对中国 IP 会 302 到 deepseek.com，需给 [proxy].url 配一条境外线路（如本机 http://127.0.0.1:7897），deepseek.de 不受影响。

curl http://127.0.0.1:8000/v1/chat/completions \
  -H "Authorization: Bearer sk-你的key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash-fr",
    "messages": [{"role": "user", "content": "你好"}],
    "stream": false
  }'

curl -N http://127.0.0.1:8000/v1/chat/completions \
  -H "Authorization: Bearer sk-你的key" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4-flash-fr","messages":[{"role":"user","content":"你好"}],"stream":true}'

from openai import OpenAI

client = OpenAI(base_url="http://127.0.0.1:8000/v1", api_key="sk-你的key")

stream = client.chat.completions.create(
    model="deepseek-v4-flash-fr",
    messages=[{"role": "user", "content": "写一首五言绝句"}],
    stream=True,
)
for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="")

请求里带 tools 即可，模型会返回 tool_calls：

{
  "model": "deepseek-v4-pro-fr",
  "messages": [{"role": "user", "content": "北京天气怎么样？"}],
  "tools": [{
    "type": "function",
    "function": {
      "name": "get_weather",
      "description": "获取城市天气",
      "parameters": {
        "type": "object",
        "properties": {"city": {"type": "string"}},
        "required": ["city"]
      }
    }
  }]
}

只有请求带 tools 时才会缓冲并输出 tool_calls，普通对话不受影响。

POST /v1/messages 接受 Anthropic Messages 格式（system、content blocks、tools.input_schema、tool_choice、流式 SSE message_start → content_block_* → message_stop），错误返回 {"type":"error","error":{...}} Anthropic 格式：

curl http://127.0.0.1:8000/v1/messages \
  -H "x-api-key: sk-你的key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash-fr",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "你好"}]
  }'

带 tools 时返回 tool_use content block（stop_reason: "tool_use"），多轮 tool_result 会回填为工具结果。

默认监听 http://127.0.0.1:8001。

• 登录口令取自 [admin].password；未配置时启动日志会打印一次性随机密码
• 鉴权通过 Cookie dsfr_admin，也可用 X-Admin-Token / Authorization: Bearer <token>
• 生产环境请将管理台置于反向代理后（默认只绑定 127.0.0.1）

cmd/dsfree2api        入口：配置加载、日志、双 HTTP server、优雅退出
internal/config       TOML 结构 + 默认值 + env 覆盖 + 校验 + 写回
internal/httpx        TLS 指纹会话封装（bogdanfinn/tls-client, Chrome_120）
internal/proxypool    代理池：Xray 核心管理 / 订阅拉取 / 分享链接解析 / 粘性选路与健康探测
internal/quota        配额哨兵：站点余额轮询 / 低额告警
internal/openai       OpenAI 协议类型、prompt 拼接、tool_calls 解析
internal/anthropic    Anthropic Messages 协议类型 + 与 OpenAI 消息的互转
internal/turnstile    Turnstile 三种求解方式（API / 浏览器 CDP / 手动）+ 按线路/站点的 Cookie 缓存与后台预热（warmer）
internal/upstream     上游逆向核心：data-config/nonce → SSE → 事件翻译，
                      线路降级、慢启动、会话刷新、跨站切换
internal/api          OpenAI / Anthropic 路由、鉴权、限流、流式写出
internal/admin        管理台后端 + go:embed 前端
internal/metrics      计数/分模型/分站点/按日/延迟分位数，JSON 持久化
internal/logbuf       环形日志 + 订阅广播（供 SSE 日志页）
internal/logfile      文件日志：按日轮转 + gzip 归档（`[server].log_file`）

make fmt      # gofmt -w .
make vet      # go vet ./...
make test     # go test ./...
make check    # 以上全部
make linux    # 交叉编译静态 linux 二进制

命令行参数：

-config  配置文件路径（默认 config.toml）
-host    覆盖监听地址
-port    覆盖监听端口
-check   只校验配置后退出
-version 打印版本

本项目仅供学习与研究网络协议使用，所对接站点与 DeepSeek 官方无关。使用者需自行承担因使用本项目产生的一切责任与后果。