ProxySQL 3.1.8 Release Notes
Release date: 2026-04-25
ProxySQL 3.1.8 is a maintenance release for the Innovative Tier, incorporating all improvements from ProxySQL 3.0.8. This version is built using PROXYSQL31=1, which enables the Fast Forward Traffic Observer (FFTO) and Time-Series Database (TSDB) subsystems.
Release commit: 6ef036a00c6f1dbcf3f27fe7f6e07f3211d7d6f8
Highlights (Innovative Tier)
- Inherits All 3.0.8 Improvements: MySQL session-variable tracking (#5166), PostgreSQL Cluster Sync (#5297), per-server PgSQL backend SSL (#5583), PgSQL backend SSL keylog (#5567), mid-transaction backend-death recovery (#5654, #5659),
mysql-zstd_compression_level(#5637),mysql-resolution_family(#5554), and thecaching_sha2_passwordhex-rounds authentication fix. - FFTO Stays Opt-In in 3.1.x: FFTO remains disabled by default in 3.1.x (introduced in 3.1.7 for stability). Administrators who wish to use FFTO must explicitly enable it via
mysql-enable_ffto/pgsql-enable_ffto. FFTO continues to be enabled by default in 4.0.x. - TSDB Behavior Unchanged: No user-visible TSDB changes this cycle; the lib-wide warning cleanup and lint sweep also touch TSDB compile-time hygiene without altering behavior.
- No Rust Toolchain Required: Removal of the vendored
sqlite-rembedextension (the only consumer ofrustc/cargo) meansPROXYSQL31=1builds no longer require the Rust toolchain. - Innovative-Tier Package Coverage: The new on-demand package pipeline produces
proxysql-3.1.8-*RPMs / DEBs for 13 distros × 2 architectures andproxysql-3.1.8-<sha>-macos-<arch>.tar.gztarballs for macOS.
New Features (3.1.x)
This release does not add 3.1.x-specific features beyond what is inherited from 3.0.8. FFTO and TSDB behavior is unchanged from 3.1.7 except for cross-cutting code-quality improvements (warning cleanup, lint pass, deprecated-API migration) that also apply to those subsystems.
Features Inherited from v3.0.8 (Stable Tier)
ProxySQL 3.1.8 includes all features, bug fixes, and improvements from the v3.0.8 release, including:
- MySQL Session-Variable Tracking — new
mysql-session_track_system_variablesmode (DISABLED/OPTIONAL/ENFORCED) with backend-driven variable sync and per-server backoff (#5166). - PostgreSQL Cluster Sync — peer-to-peer sync for PgSQL admin tables with runtime checksums and save-to-disk (#5297).
- Per-Server PgSQL Backend SSL — new
pgsql_servers_ssl_paramsadmin table mirroringmysql_servers_ssl_params(#5583). - PgSQL Backend SSL Keylog — NSS-format keylog for PgSQL backends via libpq
PQsetSSLKeyLogCallbackpatch (#5567). - PgSQL Mid-Transaction Backend-Death Recovery —
pgsql-preserve_client_on_broken_backend_in_tx(defaulttrue) keeps client sessions alive across mid-tx backend death, with newpgsql_tx_poisoned_*counters (#5654, #5659). - PgSQL Monitor: Scheduler Clamp on Interval Change — runtime interval changes take effect immediately (#5614).
- PgSQL
CopyCmdMatcher— fast-reject + comment-tolerant regex (#5596). - GTID Ranged Updates — internal
Gtid_Interval/GTID_Setrework +I3/I4wire-message parsing (#5224, #5557). - MySQL
mysql-zstd_compression_level— decoupled from zlib, range 1–22 default 3 (#5637). - MySQL
mysql-resolution_family— deterministic IPv4/IPv6 backend hostname resolution (#5554). - Greeting Capabilities Restored — upper-word capability bits re-advertised in the MySQL greeting.
- Authentication:
caching_sha2_passwordrounds parsed as hex;CACHING_SHA2_PASSWORD()accepts an optional rounds argument (#5640). - Bug Fixes: MySQL 9.x charset handling in
validate_charset; GR Monitor first-iteration probe; GTID range validation; GTID parser NULL check afterstrchr; PgSQL MD5 → EVP migration. - Build & Platform: macOS build support (#5664); no Rust toolchain required after
sqlite-rembedremoval (#5616); 156 on-demand Linux package workflows + 6 macOS workflows landing in a single canonical draft release (#5662, #5666, #5668, #5671); ASAN unit-test coverage (#5618). - Code Quality: lint and static-analysis sweep across ~100+ files (#5594).
For a detailed list of these core improvements, please refer to the ProxySQL 3.0.8 Release Notes.
Contributors
ProxySQL is a community-driven project, and we are grateful to all the contributors who helped make this release possible. A special thank you to:
- @wazir-ahmed for MySQL session-variable tracking (#5166), GTID range parsing and unit tests, the GTID
strchrNULL-check, and ENFORCED-mode capability preservation. - @rahim-kanji for PostgreSQL Cluster Sync (#5297), the mid-transaction backend-death recovery (#5654, #5659), per-server PgSQL SSL parameters (#5583), PgSQL backend SSL keylog (#5567), the
CopyCmdMatcherimprovements (#5596), the PgSQL Monitor scheduler clamp (#5614), and the MD5→EVP migration. - @proton-lisandro-pin for the initial GTID interval refactor that made ranged updates possible (#5224).
- @mirostauder for continued build system and distribution-support work.
We also thank everyone who reported bugs, tested experimental features, and provided feedback during this release cycle.
Hashes
The release commit is: 6ef036a00c6f1dbcf3f27fe7f6e07f3211d7d6f8
SHA256s:
058ccc6436e5bb388580b24ab106828284f8a8fa157eb284ea0232f29719206d proxysql-3.1.8-1-almalinux10-clang.x86_64.rpm
163e24ed799e0f26c850f101dca029d64296192909aae6c6017dbea1768d82d7 proxysql-3.1.8-1-almalinux10.aarch64.rpm
c0b008b878e767944818afa05f2a16f7a5f043f0d7270826289e1ae289487406 proxysql-3.1.8-1-almalinux10.x86_64.rpm
9d42edbc9d3418c23a5aacb90349432f785fcf63537bed438f4c593357cc0c8a proxysql-3.1.8-1-almalinux8-clang.x86_64.rpm
4a3b647e62085d6a63eb648a72aa466a6b82a3b6aead2db5b49d4bbd427ecde8 proxysql-3.1.8-1-almalinux8.aarch64.rpm
647341fa6e70f7481a365eda5aaafa603f9724719e5d8fc0aceffeb92a28da28 proxysql-3.1.8-1-almalinux8.x86_64.rpm
543d02cbb6392873cd3c3c848d6b30e035179f692aef4a60f698a6f2f91226a4 proxysql-3.1.8-1-almalinux9-clang.x86_64.rpm
d7c728ad9bea130caf08868ab09bff008380d77a7902a1cda3f5cb41d99b3798 proxysql-3.1.8-1-almalinux9.aarch64.rpm
24b8093b906aabc69ea3ac6b8f19ab3137c98bb3226b93f77b33f1ffb0b73dca proxysql-3.1.8-1-almalinux9.x86_64.rpm
2c5d115bc0385b6c3c8fa53b7493e5967d58148f9ae868238d8cccb84beabad8 proxysql-3.1.8-1-centos10-clang.x86_64.rpm
576adc8db956e6b2dba17601464ee100670a52326d1f01683f12582c11aa9a39 proxysql-3.1.8-1-centos10.aarch64.rpm
d44265f44174f494979d9f3f7ad1df002d86682a91209309c98475da2e212285 proxysql-3.1.8-1-centos10.x86_64.rpm
bce76388616dea5cd6f9734f7a926b1e6ab462cdfae33efb911f8ebf47316278 proxysql-3.1.8-1-centos9-clang.x86_64.rpm
8b5f272789ec1a42cfbb5838040051682d57a7a5fef49ef8b612ae4aac29aafd proxysql-3.1.8-1-centos9.aarch64.rpm
355baa0fc797a6b7613fdb170252c4ca3f5ad6f1b6614bdc8524ed49ccf6be4c proxysql-3.1.8-1-centos9.x86_64.rpm
87208d5d268bed23ae6f7eb229040b6dc90505a960e6b81fe56e67c665adf7fa proxysql-3.1.8-1-dbg-almalinux10.x86_64.rpm
3d8d3ff68f0b855ebd8af9eeffab852ad79c29838d3db435a97f5ca47675aa8d proxysql-3.1.8-1-dbg-almalinux8.x86_64.rpm
ebca720f48120de7a1d8ec1db881da614db6f0978844c8611ad343faf99fe637 proxysql-3.1.8-1-dbg-almalinux9.x86_64.rpm
b0ca5a93ae20ba46d33e8c6ef546aefc51d22f1b5f22ce3e72ba24b02b10f3ed proxysql-3.1.8-1-dbg-centos10.x86_64.rpm
00f315283ec9cfd1978e9f9a9eabc41d60c5636aa4bcef1894d0c4fac90a0be5 proxysql-3.1.8-1-dbg-centos9.x86_64.rpm
911cb3feb67528aac95c766bd1ecaddec85efc4b3b246ceef84d48f5474e8052 proxysql-3.1.8-1-dbg-fedora42.x86_64.rpm
785ddfb47524ef729f7d5cc0d3194d169b28f6f70f8457f30a507853b7e7b998 proxysql-3.1.8-1-dbg-fedora43.x86_64.rpm
9cdc4805278f2312951f377ba70b47d3e000c879777a47932ab028c7094f6b50 proxysql-3.1.8-1-dbg-opensuse15.x86_64.rpm
9decea44cbfd0797d57f8622f7b78fb740bafb0995cdafeae78dafdce71d740b proxysql-3.1.8-1-dbg-opensuse16.x86_64.rpm
5f47f387ea13406d5c47316d334fffc282084594e5056309c9d029e7ee92bd48 proxysql-3.1.8-1-fedora42-clang.x86_64.rpm
5bfada6a8254650a338b750eb9ee6d133af5689cccf381465231a0b693aad22d proxysql-3.1.8-1-fedora42.aarch64.rpm
38ab361ab961328547ebc5adb9df97269bb43b5259057de893421a52d80a7779 proxysql-3.1.8-1-fedora42.x86_64.rpm
bcdc8f3ff516f37aa3e84b32985df27937779f56aea9a950fd5fafe1e011b118 proxysql-3.1.8-1-fedora43-clang.x86_64.rpm
59681cacc802b4bcd685b06289d6696836e3f6c212c5ce0843e18f919995ea01 proxysql-3.1.8-1-fedora43.aarch64.rpm
cd9bb2057061016d0f7fbfc2d36ef9c2531ac70f56a5453ae019397bd85e4e59 proxysql-3.1.8-1-fedora43.x86_64.rpm
52726d434507df2a01efc7f6a91e3db184ab4a722c0e1794a6237cdadec84c74 proxysql-3.1.8-1-opensuse15-clang.x86_64.rpm
b71d1667017ed4e0e0c68b01ff6db9ee2f0ed9105dfa83c7fbcdf888b46ba956 proxysql-3.1.8-1-opensuse15.aarch64.rpm
4f0a77c08e9eced6f4b88e73d19145e10c2819e3fa0852a90861a08fe8bca41e proxysql-3.1.8-1-opensuse15.x86_64.rpm
8f637c6d7680a3a2e577cdf45f2521873b5e488080514716c6101f02179c2ff3 proxysql-3.1.8-1-opensuse16-clang.x86_64.rpm
56e92b09e8f8ffda6e99e61facb8ca3947c6416509561a8da07ef927d9006f58 proxysql-3.1.8-1-opensuse16.aarch64.rpm
438565a0f287cb9bb79ed7e138fe85820abe911d9190de4539a3a0002109ab0d proxysql-3.1.8-1-opensuse16.x86_64.rpm
9fb0a0b010cf86706843124e5ae4b51253afb6c95bf2ad5e88f04103d119a3da proxysql_3.1.8-dbg-debian12_amd64.deb
57693c86cbbd57d56e650f593105d59ee42eaaf8d4e78a530e6db20b02998fe0 proxysql_3.1.8-dbg-debian13_amd64.deb
41aa53822d69eb174d676dc56bf0cb176aa9845144cd37677b12c23ea4ecc9a8 proxysql_3.1.8-dbg-ubuntu22_amd64.deb
768fc38f747db3a5f7f98e54347b77a9ea340f79c065c2bb5f553ff0c967d53a proxysql_3.1.8-dbg-ubuntu24_amd64.deb
53ae782d5d5be06409614bb6441eea4014ca2547a3d2e414632ba12d3b3b13d5 proxysql_3.1.8-debian12-clang_amd64.deb
b7b817a06607cae4348dde50e51c7f842a085f3816e9ec9e3e28478dd182190f proxysql_3.1.8-debian12_amd64.deb
829ade8f9ceb712624babfd3da671f932cb75cb748eb904a6a6fe5bcca94af13 proxysql_3.1.8-debian12_arm64.deb
85a25ffbdea01564deef061a0500f48a10adb0f151eab3ebb6a3f00c5200e5fd proxysql_3.1.8-debian13-clang_amd64.deb
f92c2feae29d017c58b5103589fa862291fa96340c4071accceaf8046ce148f5 proxysql_3.1.8-debian13_amd64.deb
20a75cfc241be87e922310438e6de2930987d08d159478149fb0c8de2a1a2036 proxysql_3.1.8-debian13_arm64.deb
c26bf34fbb8f7077bb7ed7a4a33d5ecf39e35dc9f6e1b1a796ef0ea8671e1339 proxysql_3.1.8-ubuntu22-clang_amd64.deb
f6083c108c74a8ebe99fd47e14e77bb880599453a6904d4d1e180a5daa14a9da proxysql_3.1.8-ubuntu22_amd64.deb
2fc38cdb62feba91d8734b239c7f68e87a52db18a1f3cbc6961fdcf8d5c6396d proxysql_3.1.8-ubuntu22_arm64.deb
9d7155e854c430f3dd92c54d725d0d972fd2622b99622fabf95281d0eee5b447 proxysql_3.1.8-ubuntu24-clang_amd64.deb
0fee057ec8719b977c714deeb846fcd8bdace1bea2c1a47ac67eaa692da82a13 proxysql_3.1.8-ubuntu24_amd64.deb
018b1df2a2d89bf31a22c85549fc3304d455959dc7c6678638624a000e3a54b5 proxysql_3.1.8-ubuntu24_arm64.deb