# dsfree2api

[![Go](https://img.shields.io/badge/Go-1.27-00ADD8?logo=go&logoColor=white)](https://go.dev)
[![MIT License](https://img.shields.io/badge/license-MIT-green)](./LICENSE)
[![Docker](https://img.shields.io/badge/docker-supported-2496ED?logo=docker&logoColor=white)](./docker-compose.yml)



# 悲报
## 把人家官网蹬没钱了，看看还能充值不，哈哈哈哈
## 不过也确认了 官网对接的是deepseek的api 不是自己部署的






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

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

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

---

## 目录

- [功能特性](#功能特性)
- [界面预览](#界面预览)
- [模型映射](#模型映射)
- [快速开始](#快速开始)
- [配置](#配置)
- [API 用法](#api-用法)
- [Web 管理台](#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 |
|--------|-----------|
| ![仪表盘](docs/screenshots/dashboard.png) | ![Turnstile 求解配置](docs/screenshots/turnstile.png) |
| **对话调试** | **实时日志** |
| ![对话调试](docs/screenshots/playground.png) | ![实时日志](docs/screenshots/logs.png) |

---

## 模型映射

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

| 模型 ID | 站点 | 对应模型 | bot_id | post_id |
|---------|------|---------|--------|---------|
| `deepseek-v4-flash-de` | deepseek.de | V4-Flash | 27487 | 106 |
| `deepseek-v4-pro-de` | deepseek.de | V4-Pro | 27533 | 27177 |
| `deepseek-v4-flash-es` | deepseek.es | V4-Flash | 27623 | 27568 |
| `deepseek-v4-pro-es` | deepseek.es | V4-Pro | 27637 | 27615 |
| `deepseek-v4-flash-fr` | deepseek.fr | V4-Flash | 27645 | 27569 |
| `deepseek-v4-pro-fr` | deepseek.fr | V4-Pro | 27647 | 27616 |

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

---

## 快速开始

### 方式一：源码运行

需要 Go ≥ 1.27。

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

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

### 方式二：编译单文件二进制

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

部署到服务器：

```bash
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。

### 方式三：Docker

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

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

### 验证

```bash
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`](./config.example.toml)（含全部字段注释）。

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

```bash
dsfree2api -config config.toml -check
```

### 常用字段

| 字段 | 说明 |
|------|------|
| `[server]` | API 监听 `host` / `port` / `log_level` / `log_file`（留空写数据目录，按日压缩轮转；`-` = 仅终端） |
| `[security].api_keys` | 下游鉴权，空数组 = 不鉴权 |
| `[admin]` | 管理台 `enabled` / `host` / `port` / `password`（留空启动时生成随机密码） |
| `[limits]` | `max_concurrent_per_site` 每站点并发、`rate_per_minute` 每 Key 每分钟限流（0 = 不限） |
| `[proxy]` | `url` 主线路、`fallback_urls` 备用线路、`slow_start_seconds` 首事件超时 |
| `[proxypool]` | 代理池总开关、健康检查间隔 / 超时 / URL、裸 `ip:port` 默认协议、Xray 路径 / 版本 / 自动下载；`[proxypool.entries.*]` 手动节点（分享链接或端点）、`[proxypool.subscriptions.*]` 订阅自动拉取 |
| `[quota]` | 配额哨兵：`enabled` / `check_seconds` / `warn_ratio`，定期用池内会话读取站点免费额度，低额告警与重置留档 |
| `[upstream]` | 超时、配置缓存 TTL、会话自动刷新、`cross_site_failover` 跨站切换、`continue_rounds` 工具调用截断续写轮数（0 = 不续写、直接截断补全） |
| `[turnstile]` | **默认 `enabled = false` 且不内置任何求解服务**；`provider` 三选一：`api`（填 `api_url` / `api_key`）、`browser`（填 `browser_path` 指向本机 Chrome/Edge）、`manual`（只用控制台导入的 Cookie），另有 Cookie TTL、重试次数、单次求解超时（`timeout_seconds`）、求解服务风格（`api_style`）与 Cookie 池（`warm_enabled` / `warm_ratio` / `warm_check_seconds`，后台预热，请求零等待） |
| `[sites.*]` | 三个站点的 `base_url` / `ajax_url` / `sitekey` / `language` / `proxies`（站点级出口绑定，按顺序粘性选路）/ `warm_pool_only`（只预热池绑定线路） |
| `[models.*]` | 模型到 `site` + `upstream_id` + `bot_id` / `post_id` 的映射 |

### Turnstile 说明

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

| provider | 方式 | 需要配置 | 说明 |
|----------|------|----------|------|
| `api`（默认） | 1 · 求解服务 API | `api_url` + `api_key` | 把站点 + sitekey 交给你的求解服务，返回 Token 后由本程序完成站点验证（**默认不预置任何求解地址**，空地址开启会被拒绝） |
| `browser` | 2 · 本地浏览器自动获取 | `browser_path` | CDP 直连你配置的 Chrome / Edge：打开站点 → 注入 Turnstile widget → 可信点击 → 轮询拿到 Token；等价于 heartmore/cloudflare-solver 的做法，但**无需 Playwright / FlareSolverr / Docker**，单二进制即可。可选 `browser_user_data_dir`（真实 profile）、`browser_timezone` / `browser_locale`（对齐代理出口） |
| `manual` | 3 · 手动导入 Cookie | — | 不自动求解，只使用控制台导入的 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` 不受影响。

---

## API 用法

### 非流式

```bash
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
  }'
```

### 流式

```bash
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}'
```

### OpenAI SDK

```python
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="")
```

### Tool Calling

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

```json
{
  "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`，普通对话不受影响。

### Anthropic Messages（Claude Code 等）

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

```bash
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` 会回填为工具结果。

### 其它端点

| 端点 | 说明 |
|------|------|
| `POST /v1/messages` | Anthropic Messages API（流式 / 非流式、tool_use；错误为 Anthropic 格式） |
| `POST /v1/responses` | OpenAI Responses API（流式错误会发 `response.failed`，支持 `tools` → `function_call`） |
| `GET /v1/models` | 模型列表（需鉴权） |
| `GET /health` | 存活状态 + 模型/站点/Turnstile 概况（免鉴权） |
| `GET /` | 服务信息（免鉴权） |

---

## Web 管理台

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

| 页面 | 功能 |
|------|------|
| 仪表盘 | 请求数 / 错误 / Token / P50·P95、模型用量、站点状态（含 Cookie TTL 进度条）、最近请求 |
| 模型与站点 | 编辑标签、路径、bot_id/post_id，启停模型与站点，修改站点 URL / 语言 |
| API Key | 生成 / 删除 / 复制下游 key，立即写回配置 |
| 代理线路 | 主线路、备用线路增删、连通性测试、slow-start / 并发 / 限流 / 跨站切换、代理池（节点 / 订阅 / 每站点绑定 / Xray 核心状态） |
| Turnstile | 三种 Token 获取方式的模式面板（求解服务 API / 本地浏览器自动获取 / 手动导入 Cookie）、求解器风格（`api_style`）、各站 Cookie 状态与 TTL、Cookie 池预热状态、强制刷新、求解历史 |
| 对话调试 | 选模型 / 系统提示 / tools JSON，流式或非流式，带连接计时与取消 |
| 实时日志 | 级别过滤 + SSE 实时推送 |
| 设置 | 服务与上游参数、数据目录、危险操作 |

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

---

## 环境变量

| 变量 | 说明 | 默认 |
|------|------|------|
| `HOST` / `PORT` | API 监听地址 | `0.0.0.0` / `8000` |
| `LOG_LEVEL` | `DEBUG` `INFO` `WARN` `ERROR` | `INFO` |
| `LOG_FILE` | 日志文件路径；留空 = `<data_dir>/logs/dsfree2api.log`，`-` = 仅终端 | —（文件日志） |
| `API_KEYS` | 下游 key，逗号分隔 | —（不鉴权） |
| `PROXY_URL` | 主代理 | —（直连） |
| `PROXY_FALLBACK_URLS` | 备用代理，逗号分隔 | — |
| `PROXY_SLOW_START_SECONDS` | 首事件超时秒数 | `8` |
| `TURNSTILE_ENABLED` | Turnstile 开关（`true`/`false`） | `false` |
| `TURNSTILE_API_KEY` | Turnstile 求解服务 key（仅在 `provider=api` 且开启时校验） | 配置文件 |
| `TURNSTILE_PROVIDER` | Token 获取方式：`api` / `browser` / `manual` | `api` |
| `TURNSTILE_BROWSER_PATH` | 浏览器模式的 Chrome / Edge 可执行文件路径 | — |
| `TURNSTILE_TIMEOUT_SECONDS` | 单次求解超时秒数（5–600） | `90` |
| `TURNSTILE_WARM_ENABLED` | Cookie 池后台预热开关 | `false` |
| `TURNSTILE_WARM_RATIO` | 剩余 TTL 低于该比例时自动续期（0–1） | `0.3` |
| `TURNSTILE_WARM_CHECK_SECONDS` | 预热巡检间隔秒数（5–3600） | `60` |
| `ADMIN_ENABLED` / `ADMIN_HOST` / `ADMIN_PORT` / `ADMIN_PASSWORD` | 管理台 | `true` / `127.0.0.1` / `8001` |
| `DATA_DIR` | 统计等运行时数据目录 | `./data` |

---

## 架构

```
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`）
```

---

## 开发

```bash
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 官方无关。使用者需自行承担因使用本项目产生的一切责任与后果。