mirror of
https://github.com/diegosouzapw/OmniRoute.git
synced 2026-07-31 04:12:10 +03:00
b5e75bb8fe
* feat(proxy): relay repair + free-pool UX + relay awareness * fix(proxy): preserve existing notes fields on relay repair; fix cpu limit /1000 across all 5 container providers * feat(proxy): extract bulk-import and pool-modal hooks (#6625) * fix: prevent relay type normalization to http on PATCH Bug: updateProxyRegistrySchema inherited .default("http") from the base schema, causing PATCH to silently overwrite relay types (vercel/deno/cloudflare) with "http" when the client didn't send a type field. - Move .default('http') from proxyRegistryFieldsSchema to createProxyRegistrySchema (only applies to new proxies) - Strip undefined keys from validated changes before passing to updateProxy — .partial() leaves absent fields as undefined, which the spread merge in updateProxyRow would propagate to the DB - Add console.warn in extractRelayAuth when decrypt fails on a known-encrypted relayAuthEnc blob Closes #6905 * feat: replace Load More with page-number pagination in FreePoolTab - Adds page-number pagination controls with prev/next buttons - Shows per-page summary with total counts - Resets to page 1 on filter change via wrapper setters * fix(proxy): restore free-proxy sync-error tracking reverted by pagination commit commit2c8e79f13(page-number pagination for FreePoolTab) accidentally reverted the recordFreeProxySyncErrors/clearFreeProxySyncErrors/ getFreeProxySyncErrors functions and the search/sortBy list options that an earlier commit (6f9ce75f3) in this same PR had added to src/lib/db/freeProxies.ts and src/app/api/settings/free-proxies/route.ts. localDb.ts still re-exported the three sync-error functions, so every module that transitively imports it (which is most of the unit test suite, plus the Next.js build used by dast-smoke) failed at load time with "The requested module './db/freeProxies' does not provide an export named 'clearFreeProxySyncErrors'". Restores the reverted implementation (verbatim) and fixes the two new "requires management auth" tests, which asserted 401 for an unauthenticated request without configuring INITIAL_PASSWORD + requireLogin first — on a fresh DB with no password configured, isAuthRequired() treats a loopback request as the pre-setup bootstrap path and allows it through, so the assertion needs the same password/requireLogin setup already used by tests/unit/api/settings-audit.test.ts. Co-authored-by: diegosouzapw <diegosouza.pw@gmail.com> * fix(proxy): trim unrelated scope from relay-repair/free-pool PR Remove two subsystems that are unrelated to relay repair and the free-pool UX and were never wired into the app: - open-sse/services/combo/capabilityRequirements.ts and CapabilityRequirementsEditor.tsx: a combo capability-filtering feature never imported by combo.ts or combos/page.tsx, with no test coverage. - src/lib/skills/containerProvider.ts CPU-limit rescale: an untested change to sandbox resource limits, unrelated to the proxy/relay subsystem this PR targets. Restored to the release baseline. Also renumber the free_proxy_sync_errors migration 121 -> 122 to avoid colliding with #6855, which independently claims 121 on the same release branch. Co-authored-by: diegosouzapw <8016841+diegosouzapw@users.noreply.github.com> --------- Co-authored-by: oyi77 <oyi77@users.noreply.github.com> Co-authored-by: diegosouzapw <diegosouza.pw@gmail.com> Co-authored-by: diegosouzapw <8016841+diegosouzapw@users.noreply.github.com>
78 lines
3.7 KiB
Markdown
78 lines
3.7 KiB
Markdown
---
|
|
title: "Free Proxies API"
|
|
version: 3.8.43
|
|
lastUpdated: 2026-07-11
|
|
---
|
|
|
|
# Free Proxies API
|
|
|
|
OmniRoute ships a curated pool of free proxies in the `free_proxies` table,
|
|
synced from external providers (1proxy, proxifly, iplocate, webshare). The
|
|
dashboard surfaces these under **Settings → Free Proxies**. This document
|
|
covers the server-side filtering, sorting, counting, and sync-error reporting
|
|
that the list route exposes.
|
|
|
|
## List route — `GET /api/settings/free-proxies`
|
|
|
|
Returns a filtered, sorted, paginated slice plus a total count. Filtering and
|
|
counting happen in SQL, so the UI can show the real total (e.g. `Total: 0`)
|
|
without loading every row into memory.
|
|
|
|
### Query parameters
|
|
|
|
| Param | Type | Default | Meaning |
|
|
| ----------------- | ---------------------------------- | --------- | ---------------------------------------------------------------------------------------------- |
|
|
| `search` | string | `""` | Case-sensitive `LIKE` on the host (and source) column. |
|
|
| `protocol` | string | `""` | `type` filter: `http` / `https` / `socks4` / `socks5`. Empty = all. |
|
|
| `country` | string | `""` | `countryCode` filter (ISO-2). Empty = all. |
|
|
| `minQuality` | number | `0` | Only rows with `qualityScore >= minQuality`. `0` = no floor. |
|
|
| `disabledSources` | string | `""` | Comma-separated source ids to exclude (e.g. `proxifly,webshare`). |
|
|
| `sortBy` | `quality` \| `latency` \| `recent` | `quality` | `quality` = score desc; `latency` = latency asc (nulls last); `recent` = `lastValidated` desc. |
|
|
| `offset` | number | `0` | Pagination start. |
|
|
| `limit` | number | `50` | Page size (capped server-side). |
|
|
|
|
### Response
|
|
|
|
```json
|
|
{
|
|
"success": true,
|
|
"data": {
|
|
"proxies": [/* FreeProxyRecord[] */],
|
|
"total": 137,
|
|
"hasMore": true
|
|
},
|
|
"stats": {
|
|
"total": 137,
|
|
"inPool": 12,
|
|
"avgQuality": 64.2,
|
|
"bySource": [{ "source": "1proxy", "count": 90 }],
|
|
"lastSyncAt": "2026-07-11T09:30:00.000Z"
|
|
},
|
|
"syncErrors": {
|
|
"proxifly": ["HTTP 429 from upstream"],
|
|
"webshare": ["network timeout"]
|
|
}
|
|
}
|
|
```
|
|
|
|
`total` reflects the filtered total **before** pagination, so the UI can render
|
|
`Total: N` and `hasMore` independently. `syncErrors` is keyed by source id and
|
|
populated only for sources that failed their last sync — a `Total: 0` result is
|
|
never silent.
|
|
|
|
## Add-to-pool — `POST /api/settings/free-proxies/[id]/add-to-pool`
|
|
|
|
Promotes a free proxy into the managed `proxy_registry` pool. Validates the
|
|
upstream first; on success returns the new pool proxy id and measured latency.
|
|
|
|
## Sync — `POST /api/settings/free-proxies/sync`
|
|
|
|
Re-pulls all enabled sources (or the subset in `{ "sources": [...] }`). Each
|
|
source syncs independently; a failing source is recorded in `syncErrors` and the
|
|
others still complete, so partial syncs never wipe prior good data.
|
|
|
|
## Stats — `GET /api/settings/free-proxies/stats`
|
|
|
|
Returns the `total / inPool / avgQuality / bySource / lastSyncAt` aggregate
|
|
without the row payload — used by the dashboard header widgets.
|