---

• 🚀 高性能架构 - 基于 Sanic 异步框架，支持高并发请求
• 🔄 自动验证 - 定期验证代理可用性，自动移除失效代理
• 🎭 匿名级别检测 - 自动检测代理匿名级别（透明/匿名/高匿）
• 📊 智能评分 - 基于成功率、速度和稳定性的质量评分系统
• 🌐 多协议支持 - HTTP、HTTPS、SOCKS4、SOCKS5 全协议支持

• 🗄️ PostgreSQL 存储 - 可靠的数据持久化和高效查询
• 🔍 灵活筛选 - 支持按协议、国家、匿名级别等多维度筛选

• 📡 RESTful API - 简单易用的 HTTP API 接口
• 🔧 环境变量配置 - 通过 .env 文件轻松配置
• 📝 详细日志 - 彩色日志输出，便于调试和监控
• 🐳 Docker 支持 - 一键部署，开箱即用

---

• 快速开始
• API 文档
• 配置说明
• Docker 部署
• 开发指南
• 架构设计
• 许可证

---

• Python 3.11+
• PostgreSQL 12+
• pip 或 poetry

1. 克隆项目

git clone https://github.com/yourusername/scylla.git
cd scylla

2. 安装依赖

pip install -r requirements.txt

3. 配置环境变量

cp .env.example .env
# 编辑 .env 文件，配置数据库连接等信息

54. 启动服务

python main.py

服务将在 http://localhost:8000 启动

---

http://localhost:8000/api

GET /api/proxies?protocol=http&country=US&anonymity=elite&limit=10

参数:

• protocol (可选): 协议类型 - http, https, socks4, socks5
• country (可选): 国家代码 - ISO 3166-1 alpha-2 (如: US, CN)
• anonymity (可选): 匿名级别 - transparent, anonymous, elite
• limit (可选): 返回数量 - 默认 10，最大 100

响应示例:

{
    "success": true,
    "count": 10,
    "data": [
        {
            "id": 1,
            "ip": "1.2.3.4",
            "port": 8080,
            "protocol": "http",
            "country": "US",
            "anonymity": "elite",
            "speed": 1.23,
            "success_rate": 0.85,
            "quality_score": 88.5,
            "url": "http://1.2.3.4:8080"
        }
    ]
}

---

1. 启动服务

docker-compose up -d

2. 查看日志

docker-compose logs -f scylla

3. 停止服务

docker-compose down

1. 构建镜像

docker build -t scylla:latest .

2. 运行容器

docker run -d \
  --name scylla \
  -p 8000:8000 \
  -e DB_URL=postgresql://user:password@host:5432/scylla \
  scylla:latest

---

本项目采用 MIT 许可证 - 详见 LICENSE 文件

---

• Sanic - 高性能异步 Web 框架
• asyncpg - 快速 PostgreSQL 驱动
• curl_cffi - 代理验证工具

---