Files
OmniRoute/docs/i18n/th/docs/reference/FREE_PROXIES_API.md
Diego Rodrigues de Sa e Souza 8feea123bb feat(docs): mirror every docs/ page in all 65 locales (#14106)
* feat(docs): mirror every docs/ page in all 65 locales

Extends the documentation mirrors from the 22-page core set (#13940) to
every Markdown page under docs/: 152 sources x 65 locales = 9,880 mirrors
(6,208 new), language bars rewritten for the full locale list, state
adopted so the blocking drift gate now covers all 152 pages.

run-translation.mjs: an oversized block made only of table rows or list
items (PROVIDER_REFERENCE.md 244-row table, FREE_TIERS.md 71-item list) is
cut at item boundaries and rejoined without a blank line — the single
16-40 KB request outlived the backend socket for verbose scripts. 48
older mirrors whose tables had lost rows were retranslated with --force.

* docs(i18n): refresh mirrors for the sources the base changed since the branch cut

Section-level retranslation of the 29 docs (and README.md) whose source
or mirrors moved on release/v3.8.51 during the run, then state adoption;
the drift gate is green again on the merged tree.
2026-09-18 13:16:46 -03:00

11 KiB

Free Proxies API (ไทย)

🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇸 es · 🇪🇪 et · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇪 ga · 🇮🇳 gu · 🇳🇬 ha · 🇮🇱 he · 🇮🇳 hi · 🇭🇷 hr · 🇭🇺 hu · 🇦🇲 hy · 🇮🇩 id · 🇳🇬 ig · 🇮🇹 it · 🇯🇵 ja · 🇬🇪 ka · 🇰🇭 km · 🇮🇳 kn · 🇰🇷 ko · 🇱🇹 lt · 🇱🇻 lv · 🇮🇳 ml · 🇮🇳 mr · 🇲🇾 ms · 🇲🇹 mt · 🇲🇲 my · 🇳🇵 ne · 🇳🇱 nl · 🇳🇴 no · 🇮🇳 or · 🇮🇳 pa · 🇵🇭 phi · 🇵🇱 pl · 🇵🇹 pt · 🇧🇷 pt-BR · 🇷🇴 ro · 🇷🇺 ru · 🇱🇰 si · 🇸🇰 sk · 🇸🇮 sl · 🇷🇸 sr · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 ta · 🇮🇳 te · 🇹🇷 tr · 🇺🇦 uk-UA · 🇵🇰 ur · 🇺🇿 uz · 🇻🇳 vi · 🇳🇬 yo · 🇨🇳 zh-CN · 🇹🇼 zh-TW


OmniRoute มาพร้อมกับพร็อกซีฟรีที่คัดสรรไว้ในตาราง free_proxies โดยซิงค์จากผู้ให้บริการภายนอก (1proxy, proxifly, iplocate, webshare) แดชบอร์ดแสดงรายการเหล่านี้ภายใต้ Settings → Free Proxies เอกสารนี้ ครอบคลุมการกรอง การเรียงลำดับ การนับ และการรายงานข้อผิดพลาดในการซิงค์ ฝั่งเซิร์ฟเวอร์ที่เส้นทางรายการเปิดให้ใช้งาน

เส้นทางรายการ — GET /api/settings/free-proxies

ส่งคืนรายการบางส่วนที่ผ่านการกรอง เรียงลำดับ และแบ่งหน้า พร้อมจำนวนทั้งหมด การกรองและการนับเกิดขึ้นใน SQL ดังนั้น UI จึงสามารถแสดงจำนวนรวมจริง (เช่น Total: 0) โดยไม่ต้องโหลดทุกแถวเข้าสู่หน่วยความจำ

พารามิเตอร์คิวรี

พารามิเตอร์ ชนิดข้อมูล ค่าเริ่มต้น ความหมาย
search สตริง "" LIKE แบบคำนึงถึงตัวพิมพ์เล็ก-ใหญ่ในคอลัมน์โฮสต์ (และแหล่งที่มา)
protocol สตริง "" ตัวกรอง type: http / https / socks4 / socks5 ค่าว่าง = ทั้งหมด
country สตริง "" ตัวกรอง countryCode (ISO-2) ค่าว่าง = ทั้งหมด
minQuality ตัวเลข 0 เฉพาะแถวที่มี qualityScore >= minQuality โดย 0 = ไม่มีค่าขั้นต่ำ
disabledSources สตริง "" รหัสแหล่งที่มาที่คั่นด้วยจุลภาคเพื่อยกเว้น (เช่น proxifly,webshare)
sortBy quality | latency | recent quality quality = คะแนนจากมากไปน้อย; latency = เวลาแฝงจากน้อยไปมาก (ค่า null อยู่ท้ายสุด); recent = lastValidated จากใหม่ไปเก่า
offset ตัวเลข 0 ตำแหน่งเริ่มต้นของการแบ่งหน้า
limit ตัวเลข 50 ขนาดหน้า (จำกัดค่าสูงสุดที่ฝั่งเซิร์ฟเวอร์)

การตอบกลับ

{
  "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 จากต้นทาง"],
    "webshare": ["หมดเวลาการเชื่อมต่อเครือข่าย"]
  }
}

total แสดงจำนวนรวมที่ผ่านการกรอง ก่อน การแบ่งหน้า ดังนั้น UI จึงสามารถแสดง Total: N และ hasMore แยกจากกันได้ syncErrors ใช้รหัสแหล่งที่มาเป็นคีย์ และ จะมีข้อมูลเฉพาะแหล่งที่มาที่ซิงค์ครั้งล่าสุดล้มเหลวเท่านั้น — ผลลัพธ์ Total: 0 จะไม่เกิดขึ้นโดยไม่มีการแจ้งสาเหตุ

เพิ่มไปยังพูล — POST /api/settings/free-proxies/[id]/add-to-pool

เลื่อนสถานะพร็อกซีฟรีเข้าสู่พูล proxy_registry ที่มีการจัดการ โดยตรวจสอบ ต้นทางก่อน เมื่อสำเร็จจะส่งคืนรหัสพร็อกซีใหม่ในพูลและเวลาแฝงที่วัดได้

ซิงค์ — POST /api/settings/free-proxies/sync

ดึงข้อมูลใหม่จากแหล่งที่มาที่เปิดใช้งานทั้งหมด (หรือเฉพาะชุดย่อยใน { "sources": [...] }) แต่ละแหล่งจะซิงค์อย่างอิสระ หากแหล่งใดล้มเหลว ระบบจะบันทึกไว้ใน syncErrors ขณะที่แหล่งอื่นยังคงดำเนินการจนเสร็จ ดังนั้นการซิงค์เพียงบางส่วนจะไม่ลบ ข้อมูลเดิมที่ใช้งานได้

สถิติ — GET /api/settings/free-proxies/stats

ส่งคืนข้อมูลสรุป total / inPool / avgQuality / bySource / lastSyncAt โดยไม่มีเพย์โหลดของแถว — ใช้โดยวิดเจ็ตส่วนหัวของแดชบอร์ด