first commit

README.md

@@ -0,0 +1,39 @@
+## JD EIP 代理轮换服务 (FastAPI)
+
+基于京东 EIP API 的代理 IP 自动轮换后端。支持：
+- 鉴权获取 `X-Token`
+- 查询城市与设备
+- 设置网关链路，自动切换到未使用过的 IP（按天去重）
+- 使用 Redis 存储每日已使用 IP 与状态
+
+### 运行
+1. 创建并编辑 `.env`（参考 `.env.example`）
+2. 安装依赖：
+```bash
+pip install -r requirements.txt
+```
+3. 启动：
+```bash
+uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
+```
+
+### 目录结构
+```
+app/
+  config.py           # 配置与环境变量
+  eip_client.py       # 与 JD EIP API 交互
+  redis_store.py      # Redis 存取封装
+  rotation_service.py # 轮换逻辑
+  routers/
+    proxy.py          # /proxy API 路由
+  main.py             # FastAPI 入口
+```
+
+### API 概览
+- GET `/health` 健康检查
+- POST `/proxy/rotate` 执行轮换（可传 cityhash/num）
+- GET `/proxy/status` 当前状态
+
+### 备注
+- EIP 详细接口见 `API.md`
+