Sqproxy
Offloading Source Engine query packets (A2S) handling. Rate limits, statistics, customization
Install / Use
/learn @sqproxy/SqproxyREADME
source-query-proxy
Motivation
Basically Source game-servers works in one thread and can't use more than one core for in-game logic. For example - CS:GO, CS:Source, Left 4 Dead 2, etc.
Yes, you can use SourceMod to offload calculations (use threading), but we talking about common game logic.
E.g. you can try use DoS Protection extension <https://forums.alliedmods.net/showpost.php?p=2518787&postcount=117>_, but caching is not fast solution, cause server spent time to receiving and sending answer from cache.
This solution allow redirect some (A2S query) packets to backend and game server don't spent time to answer anymore.
IPTables (or any NAT) can't help!
If you use IPTables (NAT) to redirect queries to proxy, this rule will be remembered in routing table and if client try to connect - connection will be redirected to proxy too.
We use right way to redirect - eBPF: https://github.com/sqproxy/sqredirect
Prerequisites
Python 3.7 or above
You can use pyenv <https://github.com/pyenv/pyenv>_ to install any version of Python without root privileges
Installing
.. code-block:: bash
pip install source-query-proxy==2.5.0
Configuring
sqproxy search configs in /etc/sqproxy/conf.d and ./conf.d directories.
You should place your config files only in this directories.
For more info see examples <examples/conf.d>_
Run
.. code-block:: bash
sqproxy run
Run with eBPF
Please read the instruction and install: https://github.com/sqproxy/sqredirect
-
Enable eBPF in config (see
examples/00-globals.yaml) -
Run
.. code-block:: bash
sqproxy run
Run daemonized via systemd
-
Copy the systemd unit file
examples/systemd/system/sqproxy.serviceto/etc/systemd/system/sqproxy.service(Optional: Adjust theExecStartpath if you have installed sqproxy into a different directory) -
Enable and start the service
.. code-block:: bash
systemctl enable --now sqproxy.service
Development
.. code-block:: bash
git clone https://github.com/spumer/source-query-proxy.git
cd source-query-proxy
poetry install
Credits
Source Engine messages inspired by Python-valve https://github.com/serverstf/python-valve
Related Skills
node-connect
341.6kDiagnose OpenClaw node connection and pairing failures for Android, iOS, and macOS companion apps
claude-opus-4-5-migration
84.6kMigrate prompts and code from Claude Sonnet 4.0, Sonnet 4.5, or Opus 4.1 to Opus 4.5
frontend-design
84.6kCreate distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.
model-usage
341.6kUse CodexBar CLI local cost usage to summarize per-model usage for Codex or Claude, including the current (most recent) model or a full model breakdown. Trigger when asked for model-level usage/cost data from codexbar, or when you need a scriptable per-model summary from codexbar cost JSON.
