Add Hugging Face Docker Space files for claude2api deploy

.dockerignore

@@ -0,0 +1,5 @@
+.git
+.env
+.env.*
+!.env.example
+docker-compose.yml

Dockerfile

@@ -0,0 +1,5 @@
+FROM pushzx/claude2api:latest
+
+ENV LISTEN_ADDR=:7860
+
+EXPOSE 7860

README.md

@@ -1,10 +1,415 @@
 ---
-title: C2api
-emoji: 🌖
+title: Claude2API
+emoji: 🔁
 colorFrom: purple
-colorTo: blue
+colorTo: indigo
 sdk: docker
+app_port: 7860
 pinned: false
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# Claude2API — 部署指南
+
+Claude.ai Web → Anthropic API 兼容代理。将 Claude.ai 账号会话转换为标准 `/v1/messages` 接口，支持流式输出、工具调用、图片上传、扩展思考等功能。
+
+## Hugging Face Spaces
+
+### 推荐模式
+
+Hugging Face Spaces 推荐先使用 **Simple 模式**。Spaces 只运行单容器，当前仓库中的 `postgres`、`redis`、`watchtower` 仅适用于 `docker-compose.yml` 的本地 / VPS 部署，不直接用于 HF。
+
+### 必要 Secrets
+
+- `CLAUDE_SESSION_KEYS`
+- `CLAUDE_API_KEY`
+- `ADMIN_PASS`
+
+### 推荐 Variables
+
+- `LISTEN_ADDR=:7860`
+- `ADMIN_USER=admin`
+
+### 可选 Secrets
+
+- `PROXY_HOST`
+- `PROXY_PORT`
+- `PROXY_USER`
+- `PROXY_PASS`
+- `PROXY_REGION`
+- `DB_HOST`
+- `DB_PORT`
+- `DB_USER`
+- `DB_PASS`
+- `DB_NAME`
+- `REDIS_URL`
+
+### 说明
+
+- `config.yaml` 不参与此服务配置，运行时参数全部来自环境变量
+- 若仅提供 `CLAUDE_SESSION_KEYS`，可跳过 PostgreSQL / Redis
+- 若需要管理面板持久化能力，应改用外部 PostgreSQL / Redis，而不是复用 compose sidecar
+- 对外开放时，建议始终设置 `CLAUDE_API_KEY`
+
+### 部署后验证
+
+```bash
+curl https://<space>.hf.space/health
+
+curl https://<space>.hf.space/v1/messages \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer $CLAUDE_API_KEY" \
+  -d '{
+    "model": "claude-sonnet-4-6",
+    "max_tokens": 64,
+    "messages": [{"role": "user", "content": "hello"}]
+  }'
+```
+
+---
+
+## 快速部署
+
+### 1. 克隆此仓库
+
+```bash
+git clone https://github.com/realnoob007/claude2api-deploy.git
+cd claude2api-deploy
+```
+
+### 2. 配置环境变量
+
+```bash
+cp .env.example .env
+nano .env   # 填入你的配置
+```
+
+### 3. 启动服务
+
+```bash
+docker compose up -d
+```
+
+### 4. 验证
+
+```bash
+curl http://localhost:8080/health
+# {"status":"ok","accounts":1}
+```
+
+---
+
+## 两种运行模式
+
+### 模式一：Simple 模式（推荐新手，无需数据库）
+
+在 `.env` 中设置：
+
+```env
+CLAUDE_SESSION_KEYS=sk-ant-sid01-xxx,sk-ant-sid01-yyy
+```
+
+多个 Session Key 用逗号分隔，服务启动后自动轮询使用，无需 PostgreSQL。
+
+### 模式二：PostgreSQL 模式（推荐生产）
+
+`docker-compose.yml` 已内置 PostgreSQL 和 Redis，**开箱即用，无需额外安装**。
+
+在 `.env` 中配置（`DB_HOST` 固定填 `postgres`，对应 compose 内的服务名）：
+
+```env
+DB_HOST=postgres
+DB_PORT=5432
+DB_USER=claude2api
+DB_PASS=your_strong_password    # 必填，自定义强密码
+DB_NAME=claude2api
+
+REDIS_PASS=your_redis_password  # 必填，需与 REDIS_URL 保持一致
+REDIS_URL=redis://:your_redis_password@redis:6379/0
+```
+
+> 如需连接**外部**数据库，将 `DB_HOST` 改为远程 IP/域名，并在 `docker-compose.yml` 中删除 `postgres` 和 `redis` 服务及对应的 `depends_on`。
+
+通过管理面板动态添加/删除账号，支持每账号独立限额、封禁自动切换等高级功能。
+
+---
+
+## 获取 Session Key
+
+1. 打开 [claude.ai](https://claude.ai) 并登录
+2. 打开浏览器开发者工具（F12）→ Application → Cookies
+3. 找到 `sessionKey`，复制其值（格式：`sk-ant-sid01-...`）
+
+---
+
+## 配置说明
+
+| 变量 | 默认值 | 说明 |
+|---|---|---|
+| `LISTEN_ADDR` | `:8080` | 服务监听地址，格式为 `:端口号` |
+| `CLAUDE_SESSION_KEYS` | — | Simple 模式：逗号分隔的 Session Keys |
+| `DB_HOST` | `localhost` | PostgreSQL 主机 IP 或域名 |
+| `DB_PORT` | `5432` | PostgreSQL 端口（默认 5432，远程可能不同）|
+| `DB_USER` | `claude2api` | PostgreSQL 用户名 |
+| `DB_PASS` | — | PostgreSQL 密码 |
+| `DB_NAME` | `claude2api` | PostgreSQL 数据库名 |
+| `PROXY_HOST` | — | 住宅代理主机（留空则直连 claude.ai）|
+| `PROXY_PORT` | `3010` | 代理端口 |
+| `PROXY_USER` | — | 代理认证用户名 |
+| `PROXY_PASS` | — | 代理认证密码 |
+| `PROXY_REGION` | `US` | 代理出口区域（如 `US`、`JP`、`GB`）|
+| `ADMIN_USER` | `admin` | 管理面板用户名 |
+| `ADMIN_PASS` | `admin` | 管理面板密码（**务必修改**）|
+| `REDIS_URL` | — | Redis 连接串，用于持久化 metrics（可选）|
+| `CLAUDE_DAILY_LIMIT` | `0` | 每账号每日请求上限（`0` = 不限）|
+| `MAX_RETRIES` | `3` | 账号切换重试次数 |
+| `COOLDOWN_MINUTES` | `5` | 触发 429 后冷却时间（分钟）|
+| `CLAUDE_API_KEY` | — | 保护 `/v1/messages` 的 API Key（可选）|
+
+---
+
+## 数据库连接说明
+
+默认使用 `docker-compose.yml` 内置的 PostgreSQL 容器，`DB_HOST` 固定填服务名 `postgres`，无需额外安装。
+
+```env
+# 默认：使用内置 postgres 容器
+DB_HOST=postgres
+DB_PORT=5432
+DB_USER=claude2api
+DB_PASS=your_strong_password
+DB_NAME=claude2api
+```
+
+如需连接外部 PostgreSQL（托管云数据库等），将 `DB_HOST` 改为对应 IP 或域名，`DB_PORT` 改为实际端口，并删除 `docker-compose.yml` 中的 `postgres` 服务和 `depends_on` 相关配置。
+
+```env
+# 示例：外部托管数据库
+DB_HOST=db.example.com
+DB_PORT=5433
+DB_USER=claude2api
+DB_PASS=your_strong_password
+DB_NAME=claude2api
+```
+
+---
+
+## Redis 连接说明
+
+默认使用 `docker-compose.yml` 内置的 Redis 容器。`REDIS_PASS` 和 `REDIS_URL` 中的密码必须保持一致。
+
+```env
+# 默认：使用内置 redis 容器
+REDIS_PASS=your_redis_password
+REDIS_URL=redis://:your_redis_password@redis:6379/0
+```
+
+如需连接外部 Redis，将 `REDIS_URL` 中的主机名改为实际地址，并删除 `docker-compose.yml` 中的 `redis` 服务和 `depends_on` 相关配置：
+
+```env
+# 示例：外部 Redis（带密码，非标准端口）
+REDIS_URL=redis://:your_redis_password@redis.example.com:6388/0
+```
+
+连接串通用格式：
+```
+redis://:密码@主机:端口/库编号
+```
+
+---
+
+## 代理配置说明
+
+`PROXY_HOST`、`PROXY_PORT`、`PROXY_USER`、`PROXY_PASS`、`PROXY_REGION` 共同组成代理连接信息。留空则直连 claude.ai。
+
+代理地址由服务内部按以下规则自动拼接：
+
+| 场景 | 实际效果 |
+|---|---|
+| 仅填 `PROXY_HOST` / `PROXY_PORT` | 直连代理，无认证 |
+| 填写 `PROXY_USER` / `PROXY_PASS` | 固定用户名密码认证 |
+| 用户名含 `{sid}` 占位符 | 按账号固定出口 IP（旋转住宅代理）|
+| 用户名含 `region-XX` | 指定出口区域（arxlabs 等服务商格式）|
+
+管理面板中也可为每个账号单独配置代理，支持以下格式：
+
+```
+# 直连（不走代理）
+留空
+
+# 固定代理（无认证）
+http://proxy.example.com:3128
+
+# 固定代理（用户名密码认证）
+http://user:pass@proxy.example.com:3010
+
+# 旋转住宅代理（按账号固定 IP，{sid} 会被替换为账号唯一标识）
+http://user-session-{sid}:pass@us.arxlabs.io:3010
+
+# 旋转住宅代理 + 指定区域（arxlabs / brightdata 等常见格式）
+http://user-region-US-session-{sid}:pass@us.arxlabs.io:3010
+http://user-country-JP-session-{sid}:pass@proxy.provider.io:3010
+```
+
+---
+
+## API 使用
+
+服务兼容 Anthropic Messages API：
+
+```bash
+curl http://localhost:8080/v1/messages \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer $CLAUDE_API_KEY" \
+  -d '{
+    "model": "claude-sonnet-4-6",
+    "max_tokens": 1024,
+    "messages": [{"role": "user", "content": "你好！"}]
+  }'
+```
+
+未设置 `CLAUDE_API_KEY` 时，`Authorization` 头可省略。
+
+### 支持的模型名
+
+| 请求模型名（示例） | 实际路由 |
+|---|---|
+| `claude-sonnet-4-6` | claude-sonnet-4-6 |
+| `claude-sonnet-4-5` | claude-sonnet-4-5-20250929 |
+| `claude-haiku-4-5` | claude-haiku-4-5-20251001 |
+| `claude-opus-4-6` | claude-opus-4-6（需要 Pro）|
+| `*-thinking` 后缀 | 同模型 + 开启扩展思考 |
+| 自定义映射 | 在管理面板配置 |
+
+---
+
+## 管理面板
+
+访问 `http://localhost:8080/admin`，使用 `ADMIN_USER` / `ADMIN_PASS` 登录。
+
+功能：
+- 账号管理（添加 / 批量导入 / 删除 / 状态监控）
+- 代理配置（支持 `{sid}` 占位符实现按账号固定 IP）
+- 模型名映射（自定义入参模型名 → Claude.ai 模型名）
+- 实时 metrics（请求数、延迟、成功率）
+- 全局限速配置
+- API Key 管理
+- 支持中文 / English 切换，深色 / 浅色主题
+
+---
+
+## Docker 镜像说明
+
+| 镜像标签 | 架构 | 适用场景 |
+|---|---|---|
+| `pushzx/claude2api:latest` | amd64 (x86_64) | 普通 PC / 云服务器 |
+| `pushzx/claude2api:latest-arm64` | arm64 (aarch64) | 树莓派、Apple Silicon、ARM 云服务器 |
+
+ARM 设备部署时，在 `docker-compose.yml` 中将镜像名改为：
+
+```yaml
+image: pushzx/claude2api:latest-arm64
+```
+
+---
+
+## 更新镜像
+
+```bash
+docker compose pull
+docker compose up -d
+```
+
+---
+
+## 更新日志
+
+### v0.7.0 — 2026-03-11
+**新增 SOCKS5/SOCKS4 代理支持 + SOCKS 错误自动重试**
+
+后端：
+- `claude/client.go`：`isNetworkError()` 新增 `socks5`、`socks4`、`socks connect`、`proxy` 关键字检测，SOCKS 代理连接失败时自动触发重试
+
+管理面板：
+- Fixed 代理卡片新增 `socks5://user:pass@host:port`、`socks5h://user:pass@host:port` 示例格式
+- Rotating 代理卡片新增 SOCKS5 旋转代理示例（`socks5://user-session-{sid}:pass@host:port`）
+- 中英文 i18n 描述同步更新，注明同时支持 `socks4` / `socks4a` 格式
+- tls-client 基于 `golang.org/x/net/proxy` 原生支持全部 SOCKS 协议，无需额外依赖
+
+代理格式（管理面板中可直接填写）：
+
+```
+# SOCKS5（标准，远端 DNS 解析）
+socks5://user:pass@host:port
+
+# SOCKS5h（DNS 交由代理服务器解析，适合穿透场景）
+socks5h://user:pass@host:port
+
+# SOCKS4 / SOCKS4a
+socks4://host:port
+socks4a://host:port
+
+# 旋转 SOCKS5（{sid} 替换为账号唯一标识）
+socks5://user-session-{sid}:pass@host:port
+```
+
+---
+
+### v0.6.0 — 2026-03-10
+**修复 403 封禁判断、账号过滤器、输入样式、上下文错误处理**
+
+后端：
+- `IsBanError`：移除对 `permission_error` 的豁免 — 403 + `account_session_invalid` 现在正确标记账号为封禁（之前被静默忽略）
+- 新增 Claude stream error 事件处理（上下文过长等）：流式路径发送 SSE error 事件；非流式返回 HTTP 400 + 标准 JSON 错误体
+
+前端（管理面板）：
+- 账号状态过滤 Pills（全部 / 活跃 / 冷却 / 封禁），实时显示各状态数量
+- 邮箱 + Session Key 搜索框（纯客户端过滤，无额外请求）
+- `renderAccounts()` 与 `refreshAccounts()` 解耦，过滤操作即时响应
+- 模型映射新增行：虚线卡片展示 INPUT → TARGET 标签和箭头
+- CSS：`input:not([type])` 选择器修复裸 `<input>` 标签（mmNewKey、mmCustomVal、accountSearch 在深色模式下白色背景问题）
+- `select` 元素与 `input` 样式统一（边框、圆角、焦点环）
+- i18n 新增：filterAll / filterActive / filterLimited / filterBanned / searchPlaceholder
+
+---
+
+### v0.5.0 — 2026-03-10
+**新增精确 Token 计数（tiktoken-go / cl100k_base）+ ARM64 镜像支持**
+
+- `claude/tokens.go`：用 `github.com/tiktoken-go/tokenizer` 替换原有字符估算启发式算法，采用 cl100k_base 编码（与 Claude/GPT-4 一致）；codec 通过 `sync.Once` 初始化，不可用时自动回退到字符估算
+- `EstimateRequestTokens`：精确统计 system、messages（text / tool_use / tool_result / image）及工具定义的 token 数
+- `StreamTranslator`：在每个 `text_delta` / `thinking_delta` 事件中累计 `outputTokens`
+- 所有 SSE `message_delta` 及非流式响应现在携带真实的 `input_tokens` / `output_tokens`
+- 新增 `pushzx/claude2api:latest-arm64` Docker 镜像，支持树莓派等 ARM 设备部署
+
+---
+
+### v0.4.0 — 2026-03-10
+**Fix 502 EOF：TLS 客户端缓存 + 全链路网络重试**
+
+根本原因：原版每次 API 调用都创建全新的 TLS 客户端，导致每个子请求（GetOrgID、CreateConversation、SendMessage、UploadFile 等）都需要重新建立 TCP+TLS 握手。在住宅代理环境下，频繁触发 EOF / 连接重置错误。
+
+修复内容：
+- `proxy/session.go`：按 `(sessionKey + proxyURL)` 缓存 TLS 客户端，同一账号复用 keep-alive 连接；代理地址变更时自动创建新连接（旧缓存 GC 回收）；新增 `InvalidateAccount()` 支持封号/错误时主动驱逐缓存
+- `claude/client.go`：新增 `isNetworkError()` + `doWithRetry()` 辅助函数，所有 HTTP 调用在 EOF、连接重置、broken pipe、超时、TLS 握手错误等瞬态网络异常时自动重试最多 3 次，每次重试前主动废弃缓存连接以确保建立新连接
+- `handler/messages.go`：消息处理改进
+
+---
+
+### v0.3.0 — 2026-03-09
+**修复与优化：流式输出、重试、多轮工具调用历史**
+
+- **工具调用多轮历史**：`buildAssistantTurn` 正确合并 text + tool_use；`tool_result` 作为顶层段落输出，不再错误地包裹 `**User**:` 前缀
+- **ReAct 解析**：`extractJSONObject` 改为大括号深度解析器，替换原有正则，正确处理嵌套 `{}` 的 Python 代码块（字典、类定义、f-string）
+- **图片上传**：改为并发 goroutine 上传，N 张图片耗时从 `N×时间` 降为 `max(上传时间)`；每个文件自动重试 3 次
+- **其他**：启动时自动加载 `.env`；Paprika 模式缓存（`sync.Map`）避免每次请求都触发冗余 PATCH
+
+---
+
+### v0.2.0 — 2026-03-08
+**完整 tool_use 实现（ReAct 格式，参考 web2api 方案）**
+
+- 复刻 web2api 经过验证的 ReAct 工具调用策略，适配 Anthropic API 格式
+- **Prompt 侧**：携带 `tools` 数组时自动注入 ReAct 格式规范 + 工具定义；多轮历史中 `tool_use` 块转为 Action/Action Input，`tool_result` 块转为 Observation，支持连续工具调用推理
+- **流式解析**：`reActActive` 模式下文本块静默缓存；`message_delta` 时 `ParseReActOutput` 检测工具调用/最终回答，触发正确的 Anthropic SSE 事件序列
+- **非流式**：收集 `content_block_start(tool_use)` + `input_json_delta`，构建完整 `tool_use` 响应块
+- `stop_reason` 在检测到工具调用时正确设置为 `"tool_use"`

docker-compose.yml

@@ -0,0 +1,67 @@
+services:
+  claude2api:
+    image: pushzx/claude2api:latest
+    container_name: claude2api
+    restart: unless-stopped
+    ports:
+      - "${PORT:-8080}:8080"
+    env_file:
+      - .env
+    environment:
+      - LISTEN_ADDR=:8080
+    depends_on:
+      postgres:
+        condition: service_healthy
+      redis:
+        condition: service_healthy
+    healthcheck:
+      test: ["CMD-SHELL", "wget -qO- http://localhost:8080/health || exit 1"]
+      interval: 30s
+      timeout: 5s
+      retries: 3
+      start_period: 15s
+
+  postgres:
+    image: postgres:16-alpine
+    container_name: claude2api-postgres
+    restart: unless-stopped
+    environment:
+      POSTGRES_USER: ${DB_USER:-claude2api}
+      POSTGRES_PASSWORD: ${DB_PASS}
+      POSTGRES_DB: ${DB_NAME:-claude2api}
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U ${DB_USER:-claude2api} -d ${DB_NAME:-claude2api}"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+
+  redis:
+    image: redis:7-alpine
+    container_name: claude2api-redis
+    restart: unless-stopped
+    command: redis-server --requirepass ${REDIS_PASS:-redis_secret}
+    volumes:
+      - redis_data:/data
+    healthcheck:
+      test: ["CMD", "redis-cli", "-a", "${REDIS_PASS:-redis_secret}", "ping"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+
+  watchtower:
+    image: containrrr/watchtower
+    container_name: claude2api-watchtower
+    restart: unless-stopped
+    volumes:
+      - /var/run/docker.sock:/var/run/docker.sock
+    environment:
+      - WATCHTOWER_POLL_INTERVAL=600
+      - WATCHTOWER_CLEANUP=true
+      - WATCHTOWER_INCLUDE_STOPPED=false
+    command: claude2api
+
+volumes:
+  postgres_data:
+  redis_data: