Proxy Hub

---

🚀 Overview

Proxy Hub is an AI-Powered, Unified Proxy Aggregation & Delivery Platform.

It collects IP proxies from multiple providers and delivers them in a standardized format, making integration easy for all kinds of clients and services.

✨ Key Features

• 🔮 AI-powered parsing — no manual rules needed
• 🌍 Multi-source proxy aggregation
• 📦 Unified API response format
• 🔌 Seamless integration via REST API & microservices

---

🛠️ Getting Started

1. Run with Docker

docker run -e DEEPSEEK_API_KEY=${DEEPSEEK_API_KEY} galaxyeye88/proxy-hub:latest

---

2. Run with IDE

• Create an application-private.properties file in the project root:

DEEPSEEK_API_KEY=${DEEPSEEK_API_KEY}

• Open the project in your IDE
• Run the ProxyApplication main class

🔗 Choose Another LLM Provider

---

3. Run from Source Code

git clone https://github.com/platonai/ProxyHub.git
cd ProxyHub

./mvnw -DDEEPSEEK_API_KEY=${DEEPSEEK_API_KEY} spring-boot:run

---

🌐 API Usage

Retrieve Proxies

curl http://localhost:8192/api/proxies

---

Manage Proxy Providers

Proxy providers are URLs that return a list of IPs. Proxy Hub automatically handles vendor-specific formats.

Provider URL Example

https://tps.kdlapi.com/api/gettps/?secret_id={YOUR-SECRET-ID}&signature=xxx&num=1&pt=2&format=json&sep=1

Sample JSON Response from Third-Party API Provider:

{
  "msg": "",
  "code": 0,
  "data": {
    "count": 1,
    "proxy_list": [
      "a585.proxy.com:20818",
      "157.185.157.151:26589"
    ]
  }
}

Your provider's response format may vary, but ProxyHub automatically standardizes it into a unified structure.

---

Provider Management APIs

✅ Add a provider:

curl -X POST "http://localhost:8192/api/providers" -H "Content-Type: application/json" -d '
{
  "url": "https://your.ip.provider/proxy-rotation-link"
}
'

✅ Remove a provider:

curl -X DELETE "http://localhost:8192/api/providers/1"

✅ List all providers:

curl "http://localhost:8192/api/providers"

✅ Clear all providers:

curl -X DELETE "http://localhost:8192/api/providers/all"

---

📄 License

This project is licensed under the MIT License.