NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
crates.io
crates.io, #4173 most downloaded on crates.io
CORS support for salvo web server framework.
Latest stable
1.1.2
Last release 12 days ago
10 Nov 2026
Release timing varies
gaps range from 8 days to 2 months
Nearly every release is documented
notes for 58 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
4 years old
131 releases · first in 2022
Drag across the ruler to compare, or tap a release to open it.
Fix charset assertion and LLVM coverage CI by @chrislearn in https://github.com/salvo-rs/salvo/pull/1839
Full Changelog: https://github.com/salvo-rs/salvo/compare/v1.1.1...v1.1.2
Your coding agent can read these notes before it upgrades. Set up the MCP server →
__Host- prefixed CSRF cookie storage.Extractible.build(deps): update certon requirement from 0.3 to 0.4 by @dependabot[bot] in https://github.com/salvo-rs/salvo/pull/1837
Full Changelog: https://github.com/salvo-rs/salvo/compare/v1.1.0...v1.1.1
fix(oapi): release the METADATA_REGISTRY read guard before recursing by @ya3rub in https://github.com/salvo-rs/salvo/pull/1714
Full Changelog: https://github.com/salvo-rs/salvo/compare/v1.0.1...v1.1.0
Run core routing and dispatch Criterion benchmarks in a dedicated workflow, retaining measurements, logs, and environment metadata for review.
Expose client certificate chains, SNI and ALPN through Request::tls_info for
Rustls and Rustls-backed HTTP/3 connections, with an mTLS authorization example.
Breaking: OpenAPI Parameters.0 and its owned iterator now contain
RefOr<Parameter> so path and operation parameter lists can retain references.
Existing inline builders still accept Parameter; use Parameters::from(vec)
instead of Parameters(vec) for a Vec<Parameter>, and match RefOr when
reading the public list or use iter_inline to inspect inline entries.
Breaking: JWT finders now use Option<Vec<Method>> for their public
allowed_methods field: None accepts every method, including extensions;
Some(methods) restricts extraction to that list. Wrap direct field assignments
in Some(...). The existing allowed_methods(Vec<Method>) builder still works,
and an explicit empty list still disables token extraction. Mutable list access
turns an unrestricted finder into an explicit list of standard methods.
Breaking: tus Metadata values are now Option<Vec<u8>> instead of
Option<String>. Use Metadata::get_text for strict UTF-8 access and convert
text with into_bytes in custom stores and hooks. DiskStore reads previous
string records but writes byte arrays, which older versions cannot read.
Raise the minimum supported Rust version to 1.95 for Salvo and its examples.
Check every root workspace target and feature in the Rust 1.95 MSRV CI job.
Report dependency audit findings as CI warnings without blocking releases, while retaining audit output and the isolated default AWS-LC JWT consumer check.
Import OpenAPI documents that omit the optional paths field, including
documents containing only reusable components or incoming webhooks.
Read and write OpenAPI references in path and operation parameter lists, preserving local and external references and their sibling metadata.
Keep OpenAPI parameter schema and content mutually exclusive when merging
documents or using parameter builders. Incoming content replaces the complete
media-type map instead of accumulating multiple representations.
Combine every OIDC JWKS Cache-Control field before parsing, so later cache
directives such as stale-if-error=0 also constrain cached key use.
Stop sending HTTP/3 responses at the first header, data, trailer, or body error, reset the affected stream, and promptly release its response body. Preserve the connection when a rejected WebTransport CONNECT response fails.
Generate buffered response ETags from the ordered response bytes, regardless of
chunk boundaries, preventing incorrect 304 Not Modified responses for distinct
bodies. Single-buffer ETags and explicitly supplied response ETags are preserved.
Parse i128 and u128 request parameters, including full-width values,
lists and optional values, rather than returning an unsupported-type error.
Group repeated request headers when deserializing a complete header struct, preserving ordered sequence values and first-value scalar behavior.
Base HTTPS redirects and server request schemes on the listener's transport, preventing absolute-form URI spoofing and TLS redirect loops without URI fixing.
Preserve response bytes and representation headers when a request or response
carries Cache-Control: no-transform, including through compression-wrapped proxies.
Audit dependencies before publishing any crate and document the unresolved RustCrypto JWT advisory in the dependency security policy.
Cancel HTTP/3 request tasks when their connection closes or the server stops forcefully, while allowing accepted requests to finish on graceful shutdown.
Cancel accepted connection tasks when the server's serving future is dropped,
including pending handlers and idle keep-alive connections, while preserving
graceful draining through ServerHandle.
Resolve HTTP/3 request headers independently for peers that do not negotiate WebTransport, so incomplete headers do not block sibling HTTP requests. Preserve sequential acceptance for WebTransport's early stream handoff.
Preserve outer request extensions across direct Tower service calls, including failures and cancellation.
Keep static directory slash redirects on the same origin for paths beginning with multiple separators, including after filesystem path normalization.
Require OIDC discovery metadata to contain the exact configured issuer, and exclude JWKs whose declared use or key operations do not permit verification.
Parse OIDC JWKS cache directives with quoted-value boundaries and case-insensitive names, so extension arguments cannot extend key lifetimes.
Make the default JWT header finder use the same methods and Authorization
header as HeaderFinder::new, instead of silently rejecting every token.
Use only Authorization for Basic authentication by default, keeping proxy
credentials out of origin authentication. Applications that intentionally
accept Proxy-Authorization can opt in with BasicAuth::set_header_names.
Apply flash message minimum levels when reading incoming messages as well as saving outgoing messages, including when routes use different level policies.
Exclude request query strings and client error URL contents from proxy failure logs while retaining the request method, path, and error type.
Accept upstream protocol selections from multi-value Upgrade offers,
including repeated header fields, while rejecting unoffered protocols or versions.
Reject non-GET WebSocket handshakes before switching protocols, including when the upgrade handler is installed on a route that matches every method.
Report RustSec unsound advisories as well as vulnerability advisories,
with an offline regression for the advisory-only audit policy.
Use the same explicit crypto provider for Rustls client certificate verification and server configuration, avoiding ambiguous provider selection with mTLS.
Restore built-in ACME HTTP-01 and TLS-ALPN-01 challenge presentation, serve initial TLS validation on the bound listener, and cache newly issued certificates. Remove temporary challenges after issuance errors or cancellation. HTTP-01 examples now start the challenge route before awaiting initial TLS binding.
Reject QueryString in ToParameters derives instead of producing an invalid
schema and extracting a named query parameter. Use Query for named values
or construct a whole-query parameter with content manually.
Preserve large floating-point OpenAPI constraints when their values fall outside the integer serialization range.
Read back typeless OpenAPI schemas and preserve typed composition variants instead of rejecting generated documents or treating compositions as objects.
Preserve JSON Schema constraints and other fields alongside $ref when
reading OpenAPI schemas, instead of silently dropping reference siblings.
Apply method-aware preconditions to ReadSeeker responses: ignore Range outside GET, ignore If-Modified-Since outside GET/HEAD, and return 412 for a matching If-None-Match on other methods.
Bypass response caching and concurrent fill coalescing for conditional requests so origin handlers retain their precondition and conditional download behavior.
Read all repeated X-Forwarded-For fields as one right-to-left chain in
TrustedProxyIssuer, and stop at malformed hops so client-supplied prefixes
cannot create fresh rate-limit identities behind a trusted proxy.
Validate CSRF tokens for every unsafe HTTP method by default, including CONNECT and extension methods, while preserving explicit skipper overrides.
Return HTTP 500 when saving a new or rotated CSRF token fails, instead of exposing an unsaved token and executing the application handler.
Clean up interrupted multipart uploads and keep temporary files alive until
the last FilePart clone is released.
Retain temporary uploads in owned FormFile and FormFiles extractors until
their last owner is dropped, so files remain readable after the request ends.
Bound multipart parsing to 128 parts and 32 files by default, rejecting count
overflows with HTTP 413 before creating additional temporary files. Configure
larger or smaller route-specific limits with FormLimits middleware or
Request::set_form_limits; byte limits continue to apply independently.
Preserve multipart parsing failures in FormFile and FormFiles extractors,
returning HTTP 413 for upload byte or count limits instead of HTTP 400.
Roll back failed tus writes and discard uncommitted file tails before retrying.
Accept case-insensitive tus upload media types and surrounding HTTP whitespace in creation-with-upload and PATCH requests.
Preserve binary tus upload metadata and explicit empty values through parsing, storage reopening, and HEAD responses; ignore non-UTF-8 filename/filetype hints.
Preserve byte ranges by skipping dynamic compression for partial responses.
Inherit ancestor HTTP method constraints when generating OpenAPI operations, excluding routes whose method constraints conflict.
Exclude pending cookie jar changes and partial responses from response caching, and bypass cached representations for range requests.
Parse response cache directives as raw bytes with quoted-value boundaries, so opaque extensions cannot hide private/no-store/no-cache and quoted text cannot manufacture directives.
Forward parameter names through optional extractors and reject missing required header, query and cookie values before constructing their wrappers.
Decode escaped JSON object member names in derived request extractors while retaining borrowed values and support for field renames and aliases.
Refresh query, payload, form and cookie caches after Tower request rewrites, while preserving consumed-body caches and application cookie edits during pass-through.
Preserve bracketed query-list tokens around whitespace and opposite quote characters instead of rejecting numbers or silently corrupting string values.
Read explicit empty bracketed query and header lists as empty typed collections, while
preserving scalar strings and repeated-parameter values containing [].
Honor ETag precedence, lists and wildcards in conditional responses, while preserving write responses and non-200 statuses.
Preserve response trailers during compression and offload compression flushing and finalization together with expensive writes.
Compress boxed and channel response bodies with the same streaming negotiation, trailer forwarding, error handling and cancellation as other supported bodies.
Cancel queued compression tasks when their response body is dropped instead of continuing work for disconnected clients.
Compare wildcard and explicitly listed Accept-Encoding quality values when selecting compression with client preference enabled.
Validate tus creation requests before allocating storage, remove uploads after creation-time stream failures, and pass final storage metadata to completion hooks.
Omit unsupported TUS concatenation from advertised capabilities and reject partial or final creation requests even when a custom store declares it.
Merge multipart form and file schemas instead of overwriting earlier endpoint parameters, preserving required fields and form constraints.
Generate Allow for automatic 405 responses from complete built-in route matches,
without replaying custom callbacks or overriding middleware response policies.
When opaque filters prevent safely inferring any supported method, routing defaults
to 404; service middleware can provide its own 405 status and Allow header.
Honor TUS method overrides during endpoint selection, before access-control hoops and lifecycle hooks run, and reject malformed override headers.
Reject malformed CSRF bcrypt proofs and costs that differ from the configured cost before verification, require bcrypt 0.19.2 or newer, and omit CSRF cipher keys from debug output.
Reissue invalid session-backed CSRF proofs on safe requests after cipher key or token-size changes, instead of indefinitely reusing unusable tokens.
Replace all depot JWT authentication results on each attempt so missing or rejected credentials cannot retain another middleware instance's claims/token, and successful authentication cannot retain an earlier error.
Honor explicit OIDC JWT algorithm allowlists and share a one-second JWKS refresh cooldown across decoder clones, including failed refreshes and unknown key identifiers.
Preserve consecutive path filters on the same router when generating OpenAPI paths.
Honor If-Range validators in file responses, returning the full representation
when a resumable download refers to a different version.
Accept case-insensitive byte range units and ignore unknown range units in file, reader and embedded responses, while retaining byte-range error handling.
Advertise the stored gzip coding of embedded .svgz and compressed X3D
assets, including assets selected as directory defaults or fallbacks.
Keep file content codings off generated precondition and range error pages, while preserving them for successful and not-modified file responses.
Enforce strong If-Match preconditions for embedded assets before cache and range handling.
Restore path cursors, captured parameters and matched path templates after failed
composite filters, so alternative routes start from the original matching state.
Routing tests also compile when matched-path is disabled.
Omit query strings from core warnings about empty successful responses.
Enable only the requested salvo_extra middleware features through salvo,
avoiding unrelated WebSocket, Tower and request-ID dependencies for logging-only builds.
Declare the Hyper dependency directly for standalone tower-compat builds.
Recover request, depot and flow state when Tower layers short-circuit, fail or cancel their inner future, preserving HEAD handling and prepared response policy headers.
Invoke tus upload completion hooks when PATCH finishes an upload, sharing response customization and error handling with creation-time completion.
Preserve repeated response fields from tus completion hooks, including all
Set-Cookie values, without overriding fields already set on the response.
Apply TUS upload expiration only to unfinished resources, preserving completed uploads when their original upload timeout passes.
Keep completed tus upload IDs reserved after payload renaming, preventing duplicate custom IDs from replacing existing upload metadata and download URLs.
Preserve existing tus metadata if replacing its temporary file fails on Windows.
Keep graceful server shutdown responsive to force-stop commands and release active connection accounting when a connection task panics or is cancelled.
Enforce armed transport write-stall deadlines before accepting late scalar or vectored writes, while preserving relaxed upgraded connections.
Complete the Tokio and futures AsyncWrite shutdown operations on channel-backed
response bodies without requiring the sender to be dropped.
Retain in-memory rate-limit guards until their reset time when idle expiration would otherwise discard an active quota. Capacity eviction and restarts remain best-effort limits of the in-memory store.
Honor Logger::log_status_error(false) when recording response error details,
and align Logger::default() with Logger::new().
Log finalized response statuses after Service media checks and catchers while retaining error diagnostics.
Match Accept-Encoding content codings and the q parameter case-insensitively, so
gzip;Q=0 and GZIP;q=0 reject gzip in compression and precompressed static file selection.
Preserve leading spaces in Server-Sent Event data, event names, and IDs after standard EventSource parsing.
fix(examples): align OpenTelemetry examples with 0.33 by @chrislearn in https://github.com/salvo-rs/salvo/pull/1710
Full Changelog: https://github.com/salvo-rs/salvo/compare/v1.0.0...v1.0.1
tls_handshake_timeout.http1 and http2 feature flags when enabling Hyper protocols. HTTP/1-only
builds, including WebSocket support, no longer compile h2 unless another dependency
enables HTTP/2. Default protocol support is unchanged.salvo-otel.fix(tls): pass the rustls CryptoProvider explicitly instead of relying on crate features by @chrislearn in https://github.com/salvo-rs/salvo/pull/1699
Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.96.0...v1.0.0
image/svg+xml and text/xml were
classified as inline by their top-level image/text type, so an uploaded SVG carrying
<script> — or an XML document naming an XSLT stylesheet through <?xml-stylesheet ?> —
executed script in the serving origin when opened. XML-based content types now default to
attachment, matching how application/xml and application/xhtml+xml already behaved.
That covers the +xml suffix, an xml subtype, RFC 7303's xml-dtd and
xml-external-parsed-entity, and the legacy text/xsl that <?xml-stylesheet ?> itself
names. text/html still defaults to inline. Reported by sl91994.NamedFile and StaticEmbed responses now carry X-Content-Type-Options: nosniff.salvo-otel no longer records the full request URI. Metrics dropped url.full entirely,
so query strings no longer become metric dimensions. Tracing replaced it with url.path
plus a url.query whose sig, Signature, AWSAccessKeyId and X-Goog-Signature values
are redacted, as the semantic conventions require.NamedFileBuilder::use_content_type_options and NamedFile::use_content_type_options to
control the X-Content-Type-Options header.StaticDir::disposition_type, StaticDir::use_content_type_options,
StaticFile::disposition_type, StaticFile::attached_name and
StaticFile::use_content_type_options, so applications serving trusted assets can opt back
into inline rendering, which previously had no public API on either handler.NamedFileBuilder::disposition_name, which sets the name Content-Disposition reports
without forcing the disposition to attachment the way attached_name does.CookieParam<T> falls back to JSON when
scalar conversion fails, while #[derive(Extractible)] accepts explicit cookie field sources
such as #[salvo(extract(source(from = "cookie", parse = "json")))].rfc9457 feature.salvo-oapi, including the $self field.salvo-oapi:
summary, parent and kind.name.query (via PathItemType::Query) and additionalOperations.in: querystring (ParameterIn::QueryString) and style: cookie
(ParameterStyle::Cookie).itemSchema, prefixEncoding and itemEncoding.encoding, prefixEncoding and itemEncoding.dataValue and serializedValue.summary, and description is now optional on input.mediaTypes.defaultMapping.nodeType (new XmlNodeType enum).deprecated and oauth2MetadataUrl.deviceAuthorization (new DeviceAuthorization flow).summary.required, deprecated, style,
explode, example, examples, content and extensions, plus Header::with_content.QUERY operations and custom HTTP methods (via
additionalOperations) when the document declares OpenAPI 3.2. Documents that still declare
3.1 skip such routes and log a warning explaining how to opt in.#[endpoint] parameters accept the QueryString location and the Cookie style.Content::from_ref / Content::ref_location, so a content map entry can reference a
reusable Media Type Object without changing those maps to RefOr<Content>.examples/oapi-3-2 demonstrates emitting a 3.2 document with a QUERY route.salvo_core::fs::extension_content_encoding, which reports the content coding a file
extension implies, so a handler choosing a file to serve can tell that it already carries one.salvo_core::conn::rustls::default_crypto_provider, which reports the rustls CryptoProvider
Salvo builds its TLS configurations with. Pass it to other rustls based libraries so the whole
application agrees on one backend.salvo-otel records http.server.active_requests, http.server.request.body.size and
http.server.response.body.size, which its documentation already described. The in-flight
gauge is decremented from a drop guard, so a cancelled request — a client disconnect or a
timeout — does not leave it drifting upwards.Metrics::with_known_methods and Tracing::with_known_methods widen the set of request
methods reported verbatim in http.request.method, for applications serving methods beyond
RFC 9110 and RFC 5789 (WebDAV's PROPFIND, say).salvo-otel gained a matched-path feature, on by default, which supplies http.route.
Through the salvo crate it follows that crate's own matched-path feature.PathItemType::Query, ParameterIn::QueryString, ParameterStyle::Cookie and
Flow::DeviceAuthorization are new variants.SecurityScheme::MutualTls gained a deprecated field.Header::schema is now Option<RefOr<Schema>> so a header can describe its value with
content instead. Header::default() still yields a String schema, so serialized output
is unchanged.OpenApi still defaults to emitting OpenAPI 3.1; 3.2 remains opt-in via
OpenApi::openapi_version.salvo-otel's Metrics middleware now emits the instruments the
OpenTelemetry HTTP semantic conventions define, replacing names it had invented. Dashboards
and alerts built on the old names have to be repointed:
salvo_request_duration_ms became http.server.request.duration, and it measures
seconds rather than milliseconds, with the bucket boundaries the conventions
recommend. A Prometheus exporter renders it as http_server_request_duration_seconds.salvo_request_count and salvo_error_count are gone. The conventions define no such
instruments: the duration histogram already carries the request count
(http_server_request_duration_seconds_count), and failures are selected by filtering on
error.type or http.response.status_code.salvo-otel instrumentation scope, versioned
and carrying the semantic conventions' schema URL, instead of a bare salvo meter.salvo-otel's metric dimensions changed to the ones the conventions list, so
the number of time series is now proportional to the number of routes instead of growing
with traffic:
url.full — one series per distinct URI, query string included — was replaced by
http.route, the matched route template (/users/{id}). A request that matched no route
carries no http.route at all rather than a fallback, and a goal mounted at the router
root is reported as /.exception.message was replaced by error.type, which carries the status code of a
server error. The old attribute was unbounded, and it was appended to the labels of
salvo_request_count and salvo_request_duration_ms but not of salvo_error_count, so
a failed request produced a different label set than a successful one on the same metric._OTHER, so a client
cannot open a time series per made-up method name. See Metrics::with_known_methods.url.scheme and network.protocol.version were added. A request target given in absolute
form lets the client choose the scheme, so a scheme other than http or https is
reported as _OTHER for the same reason an unknown method is; spans still record it.salvo-otel's Tracing middleware follows the same conventions:
{method} {route} — GET /users/{id} — instead of {method} {uri},
which made every distinct URI its own span name.url.full gave way to url.path, a redacted url.query and url.scheme, and
http.route was added.network.protocol.version reports 1.1 and 2 rather than the HTTP/1.1 form
Version's Debug output produces._OTHER, with the value the client sent kept in
http.request.method_original.5xx response now sets error.type and an error span status. A 4xx does not: it is a
valid outcome for a server span.http.response.header.content-length, which was not an attribute the conventions define,
became http.response.body.size, and it is left out for a response whose body the
catcher fills in after middleware returns rather than reported as zero.client.address reports the peer's IP (198.51.100.4) with the port split out into
client.port, instead of salvo's socket://198.51.100.4:54321 display form.telemetry.sdk.name, telemetry.sdk.version and telemetry.sdk.language attributes
were removed from every span. They describe the resource, and the SDK already reports them
there.StaticDir, StaticFile or
NamedFile now sends Content-Disposition: attachment by default, so following a link to
one downloads it instead of rendering it, and <object>/<embed>/<iframe> no longer
display it. Referencing the same file from <img>, CSS url() or <use> is unaffected,
because browsers ignore Content-Disposition on subresource loads. Directories holding only
trusted assets can restore the old behavior with
StaticDir::new(..).disposition_type("inline"). text/html still defaults to inline,
since serving HTML documents is the point of a static file server.query operations. Scalar, RapiDoc and ReDoc display the rest of the
document and silently omit them. Their CDN URLs are deliberately left unpinned, since no
released build of those three renders query yet.CryptoProvider from Rustls crate features". rustls can only pick a backend by itself when
exactly one of its aws-lc-rs and ring features is enabled across the whole dependency
graph, so pulling in any crate that enables the other one made RustlsListener,
QuinnListener, AcmeListener and the proxy's default HyperClient panic. Salvo now selects
the provider from its own features and passes it to rustls explicitly. An application that
installed a process level provider through CryptoProvider::install_default still has that
one used; Salvo itself never installs one, so applications keep full control over the
process level default.StaticDir names a download after the file that was requested rather than the precompressed
sidecar it was served from, so a request for logo.svg answered out of logo.svg.br no
longer offers Content-Disposition: attachment; filename="logo.svg.br".PathItem no longer duplicates operations into extensions when deserialized, which
previously made a parsed path item re-serialize with repeated keys.clientCredentials flow no longer deserializes as Flow::Password.missing field errors..svgz files are now served with Content-Encoding: gzip. Their extension names both a
media type and the coding applied to it, but an extension resolves to a single media type,
so the response described the gzip stream as image/svg+xml and no client could render it.
The gzipped X3D forms .x3dz, .x3dvz and .x3dbz are handled the same way. .gz and
.tgz are unaffected, since there the gzip stream is the representation being served.
StaticDir also stops serving a precompressed sidecar for such a file — a logo.svgz.br
stacks a second coding on the gzip, and only the outer one can be reported.feat(db-postgres-toasty): add toasty example by @feihua in https://github.com/salvo-rs/salvo/pull/1684
Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.95.2...v0.96.0
Add baseline OpenAPI 3.2 support by @chrislearn in https://github.com/salvo-rs/salvo/pull/1686
Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.95.1...v0.95.2
build(deps): update ulid requirement from 2 to 3 by @dependabot[bot] in https://github.com/salvo-rs/salvo/pull/1675
Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.95.0...v0.95.1
Add support for OsString and PathBuf by @eythaann in https://github.com/salvo-rs/salvo/pull/1666
StaticDir by @cnlancehu in https://github.com/salvo-rs/salvo/pull/1663Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.94.0...v0.95.0
Several old names remain as deprecated aliases, but new code should use the clearer names:
Salvo 0.94.0 focuses on security hardening, OpenAPI 3.1 correctness, lower runtime overhead in core routing/dispatch paths, and API naming cleanup. This release also raises the Rust MSRV to 1.94.
1.94.Server::max_connections, ConnCtrl, improved graceful/forceful shutdown behavior, and safer default connection fuse protection.jsonSchemaDialect, webhooks, reusable components, PathItem refs, parameter content/examples/allowEmptyValue, and stricter required path parameters.Json<T> now replaces previously buffered body bytes because JSON is a complete document.salvo-tus exposes storage/locking types, adds Tus::storage_root, and adds Tus::absolute_location for safe absolute Location URLs.Update your toolchain to Rust 1.94 or newer.
rustup update stable
Several old names remain as deprecated aliases, but new code should use the clearer names:
| Old | New |
|---|---|
Depot::inject(value) |
Depot::insert_typed(value) |
Depot::obtain::<T>() |
Depot::get_typed::<T>() |
Depot::obtain_mut::<T>() |
Depot::get_typed_mut::<T>() |
Depot::contains::<T>() |
Depot::contains_typed::<T>() |
Depot::scrape::<T>() |
Depot::remove_typed::<T>() |
Depot::delete(key) |
Depot::remove(key).is_some() |
Response::stuff(status, value) |
Response::render_with_status(status, value) |
Server::stop_forcible() |
Server::stop_forceful() |
ServerHandle::stop_forcible() |
ServerHandle::stop_forceful() |
SchemeFilter::lack(...) |
SchemeFilter::fallback(...) |
HostFilter::lack(...) |
HostFilter::fallback(...) |
PortFilter::lack(...) |
PortFilter::fallback(...) |
StatusError::request_header_fields_toolarge() |
StatusError::request_header_fields_too_large() |
StatusError::unavailable_for_legalreasons() |
StatusError::unavailable_for_legal_reasons() |
AcmeListener::get_directory(...) |
AcmeListener::directory(...) |
Depot now has separate named and type-keyed storage. Use insert/get/remove for string keys and insert_typed/get_typed/remove_typed for type keys. Capacity and inner() refer to named storage.
Response::write_body appends to buffered bodies. Json<T> now replaces existing buffered bytes instead of appending, because concatenated JSON documents are invalid. If you intentionally emit NDJSON or another appendable format, serialize each record yourself and call write_body.
The tus builder API was aligned with Rust API naming guidelines. Update call sites:
| Old | New |
|---|---|
with_store(...) |
store(...) |
with_locker(...) |
locker(...) |
with_upload_id_naming_function(...) |
upload_id_naming_function(...) |
with_generate_url_function(...) |
generate_url_function(...) |
with_on_incoming_request(...) |
on_incoming_request(...) |
with_on_incoming_request_sync(...) |
on_incoming_request_sync(...) |
with_on_upload_create(...) |
on_upload_create(...) |
with_on_upload_finish(...) |
on_upload_finish(...) |
Also prefer MaybeUploadId over the deprecated UploadId alias. TusOptions::extract_file_id_from_request replaces the old file-id helper naming.
For absolute tus Location headers, prefer:
let tus = Tus::new().absolute_location("https://uploads.example.com");
Avoid relative_location(false) without a canonical origin on public services, because that derives absolute URLs from request host/forwarded headers.
$schema output was corrected to jsonSchemaDialect for OpenAPI 3.1.Parameter::parameter_in(...) is deprecated; use Parameter::location(...).ToParameters now defaults generated parameters to query location, so required query parameters are represented correctly.required: true.#[derive(Extractible)] now rejects #[serde(flatten)] on fields. Use #[salvo(extract(flatten))] for Salvo request extraction flattening.Access-Control-Allow-Credentials: true with wildcard CORS response headers. Use explicit allowed origins, headers, and methods for credentialed APIs.ForwardedHeaderIssuer is deprecated because it trusts client-controlled forwarded headers unconditionally. Use TrustedProxyIssuer::new([...]) behind known proxies, or RemoteIpIssuer for direct client IPs.Proxy now uses the standards-compliant host header getter by default, including non-default upstream ports. If you need the old bare-host behavior, configure default_host_header_getter.kty: "oct" / HS*) are rejected by default. Opt in with allow_symmetric_jwks(true) only for issuers that intentionally publish trusted symmetric keys.SecureCookiePolicy is available for CSRF, flash, and session cookies. If TLS terminates before Salvo and the request scheme appears as HTTP, force secure cookies with the relevant secure_cookie(true) or policy API.Server::max_connections to bound concurrent accepted connections.ConnCtrl to the prelude and public exports.$ref support.content, examples, and allowEmptyValue.Extractible bounds, number equality, macro diagnostics, and several user-triggerable macro panics.Set-Cookie parsing/round-tripping and tower-compatible response conversion.RequestId, caching headers, basic auth multi-header fallthrough, and logging path/address behavior.Accept parsing, text_nonce, and write_body.Thanks to everyone who contributed to this release:
FlowCtrl performance (#1608), auto_alt_svc_header for quinn::Builder (#1585), code quality cleanups (#1544, #1524), salvo-cors refactor (#1525), and docs.rs build fixes (#1523)Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.93.0...v0.94.0
Add strict proxy path normalization by @chrislearn in https://github.com/salvo-rs/salvo/pull/1434
Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.92.2...v0.93.0
Implement timeout management with Mutex and CancellationToken for FlexFusewire by @chrislearn in https://github.com/salvo-rs/salvo/pull/1426
Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.92.1...v0.92.2
Add path filter handling for invalid patterns and try_with_path method by @chrislearn in https://github.com/salvo-rs/salvo/pull/1422
Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.92.0...v0.92.1
feat(schema): implement ToSchema and ComposeSchema for serde_json::RawValue by @chrislearn in https://github.com/salvo-rs/salvo/pull/1396
Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.91.1...v0.92.0
Improve file handling and metadata retrieval in NamedFileBuilder by @chrislearn in https://github.com/salvo-rs/salvo/pull/1378
Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.90.1...v0.91.1
Nothing published for this version
Replace salvo-acme with certon for enhanced ACME support by @chrislearn in https://github.com/salvo-rs/salvo/pull/1339
Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.89.3...v0.90.1
Nothing published for this version
chore(deps): update bcrypt requirement from 0.18 to 0.19 by @dependabot[bot] in https://github.com/salvo-rs/salvo/pull/1329
Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.89.2...v0.89.3
Fix rand 0.10 compatibility issues by @Copilot in https://github.com/salvo-rs/salvo/pull/1320
Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.89.1...v0.89.2
Avoid use both futures_core and futures_util by @chrislearn in https://github.com/salvo-rs/salvo/pull/1299
Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.89.0...v0.89.1
feat(tus): add salvo-tus crate with TUS protocol support by @tyreseluo in https://github.com/salvo-rs/salvo/pull/1257
IpAddr as RemoteIpIssuer::Key by @Paraworker in https://github.com/salvo-rs/salvo/pull/1283Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.88.1...v0.89.0
Add Salvo + PostgreSQL + SeaORM Boilerplate Example by @darixsamani in https://github.com/salvo-rs/salvo/pull/1264
Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.88.0...v0.88.1
Fix etag still being added even when use_etag(false) is called in NamedFileBuilder by @cnlancehu in https://github.com/salvo-rs/salvo/pull/1265
use_etag(false) is called in NamedFileBuilder by @cnlancehu in https://github.com/salvo-rs/salvo/pull/1265Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.87.1...v0.88.0
Update examples dependencies by @chrislearn in https://github.com/salvo-rs/salvo/pull/1262
Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.87.0...v0.87.1
feat: added alias support with serde by @yohannlog in https://github.com/salvo-rs/salvo/pull/1253
swagger-ui to v5.31.0 by @tyreseluo in https://github.com/salvo-rs/salvo/pull/1254Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.86.0...v0.87.0
Update example code structure and clippy by @chrislearn in https://github.com/salvo-rs/salvo/pull/1237
SALVO_STATUS_ERROR to control default error page by @chrislearn in https://github.com/salvo-rs/salvo/pull/1240Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.85.0...v0.86.0
feat: pass req and depot into Upstreams::elect to allow more flexible upstream election by @r00t3g in https://github.com/salvo-rs/salvo/pull/1225
Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.84.2...v0.85.0
chore(deps): update jsonwebtoken requirement from 9 to 10 by @dependabot[bot] in https://github.com/salvo-rs/salvo/pull/1217
Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.84.1...v0.84.2
chore(deps): update tokio-tungstenite requirement from 0.27 to 0.28 by @dependabot[bot] in https://github.com/salvo-rs/salvo/pull/1209
NamedFile and embed file detect text content type by @chrislearn in https://github.com/salvo-rs/salvo/pull/1210Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.84.0...v0.84.1
chore(deps): update x509-parser requirement from 0.17 to 0.18 by @dependabot[bot] in https://github.com/salvo-rs/salvo/pull/1192
Cors::allow_private_network by @chrislearn in https://github.com/salvo-rs/salvo/pull/1194Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.83.0...v0.84.0
oapi: Remove ToArray trait by @chrislearn in https://github.com/salvo-rs/salvo/pull/1190
Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.82.0...v0.83.0
limit MaxConcurrency by @zaijie1213 in https://github.com/salvo-rs/salvo/pull/1168
into_boxed function to acceptors and add DynTcpAcceptors by @chrislearn in https://github.com/salvo-rs/salvo/pull/1180Cargo.toml by @chrislearn in https://github.com/salvo-rs/salvo/pull/1184Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.81.0...v0.82.0
Add unix-sock-client to the full futures for salvo-proxy by @18o in https://github.com/salvo-rs/salvo/pull/1160
unix-sock-client to the full futures for salvo-proxy by @18o in https://github.com/salvo-rs/salvo/pull/1160Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.80.0...v0.81.0
Do not log H3_NO_ERROR by @Deniskore in https://github.com/salvo-rs/salvo/pull/1144
salvo-captcha repository URL by @TheAwiteb in https://github.com/salvo-rs/salvo/pull/1151Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.79.0...v0.80.0
Update req.rs. Spell mistake. by @lazyanubis in https://github.com/salvo-rs/salvo/pull/1118
Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.78.0...v0.79.0
Update opentelemetry-* to 0.29 by @chrislearn in https://github.com/salvo-rs/salvo/pull/1087
Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.77.1...v0.78.0
set listener.set_nonblock to true in listenfd sample by @prabirshrestha in https://github.com/salvo-rs/salvo/pull/1077
Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.77.0...v0.77.1
fix: spelling mistake by @lazyanubis in https://github.com/salvo-rs/salvo/pull/1048
server::ServerHandle::stop_graceful by @YBoy-git in https://github.com/salvo-rs/salvo/pull/1049opentelemetry-prometheus to 0.28 by @chrislearn in https://github.com/salvo-rs/salvo/pull/1064Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.76.2...v0.77.0
fix(404 error): on the todo example by @gustavbrlty in https://github.com/salvo-rs/salvo/pull/1035
salvo-proxy by @markcda in https://github.com/salvo-rs/salvo/pull/1045Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.76.1...v0.76.2
Adding 'System-Monitor-Server' project case. by @SimonYen in https://github.com/salvo-rs/salvo/pull/1027
Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.76.0...v0.76.1
fix: conflict with serde deny_unknown_fields attr by @Samyak2 in https://github.com/salvo-rs/salvo/pull/1015
Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.75.0...v0.76.0
Update README.md by @Type1J in https://github.com/salvo-rs/salvo/pull/1007
Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.74.3...v0.75.0
chore(deps): update opentelemetry dependencies by @chrislearn in https://github.com/salvo-rs/salvo/pull/989
Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.74.2...v0.74.3
Add rust-version = { workspace = true } to crates Cargo.toml by @chrislearn in https://github.com/salvo-rs/salvo/pull/975
rust-version = { workspace = true } to crates Cargo.toml by @chrislearn in https://github.com/salvo-rs/salvo/pull/975force-https should depends on salvo_core/rustls by @chrislearn in https://github.com/salvo-rs/salvo/pull/978Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.74.1...v0.74.2
fix: cargo build fail by @847850277 in https://github.com/salvo-rs/salvo/pull/966
Request::try_all_files is not work correctly by @chrislearn in https://github.com/salvo-rs/salvo/pull/970Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.74.0...v0.74.1
chore(deps): update brotli requirement from 6.0 to 7.0 by @dependabot in https://github.com/salvo-rs/salvo/pull/941
try_set_header add #[inline(always)] by @andeya in https://github.com/salvo-rs/salvo/pull/951let _ = ... to replace result.ok(). by @chrislearn in https://github.com/salvo-rs/salvo/pull/954Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.73.0...v0.74.0
Make Filter::filter async by @chrislearn in https://github.com/salvo-rs/salvo/pull/933
self.0 is shadowed, it is convenient to directly call the self.deref() method. by @andeya in https://github.com/salvo-rs/salvo/pull/936Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.72.4...v0.73.0
Remove name conflict example by @chrislearn in https://github.com/salvo-rs/salvo/pull/922
Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.72.3...v0.72.4
feat: Add salvo-craft-macros, solve the issue #919 by @andeya in https://github.com/salvo-rs/salvo/pull/920
Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.72.2...v0.72.3
doc: add with-sentry example by @Vision-Zhang in https://github.com/salvo-rs/salvo/pull/914
Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.72.1...v0.72.2
security fix: Jump out of the serve dir to access files on server by @chrislearn in https://github.com/salvo-rs/salvo/pull/913
Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.72.0...v0.72.1
Impl Writer for tuple by @chrislearn in https://github.com/salvo-rs/salvo/pull/882
REQUIRED default value by @chrislearn in https://github.com/salvo-rs/salvo/pull/894Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.71.1...v0.72.0
fix: Derive ToSchema not work for unit enum variants by @chrislearn in https://github.com/salvo-rs/salvo/pull/875
Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.71.0...v0.71.1
chore(deps): update tower to 0.5 and move tower_compat to salvo_extra by @chrislearn in https://github.com/salvo-rs/salvo/pull/866
Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.70.0...v0.71.0
fix: CombWisp match is not correct by @chrislearn in https://github.com/salvo-rs/salvo/pull/856
Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.69.0...v0.70.0
chore: Update opentelemetry dependencies by @chrislearn in https://github.com/salvo-rs/salvo/pull/837
StatusError display by @TheAwiteb in https://github.com/salvo-rs/salvo/pull/841Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.68.5...v0.69.0
Improved OpenAPI docs by @markcda in https://github.com/salvo-rs/salvo/pull/820
Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.68.4...v0.68.5
fix: Tokio runtime panic when using QuinnListener by @chrislearn in https://github.com/salvo-rs/salvo/pull/819
Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.68.3...v0.68.4
HTTP/2 over HTTP by @chrislearn in https://github.com/salvo-rs/salvo/pull/815
Full Changelog: https://github.com/salvo-rs/salvo/compare/v0.68.2...v0.68.3
One column per quarter.