# salvo
**Repository Path**: limoncc/salvo
## Basic Information
- **Project Name**: salvo
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-11
- **Last Updated**: 2026-08-11
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
> 加入社区: 微信(chrislearn) | QQ群: 823441777
## 特性
- **简单强大** - 零样板代码，会写函数就会写 Handler
- **HTTP/1、HTTP/2、HTTP/3** - 开箱即用的全协议支持
- **灵活路由** - 树形路由，中间件可挂载到任意层级
- **自动证书** - 内置 ACME，自动获取和续期 TLS 证书
- **OpenAPI** - 一流的 OpenAPI 支持，自动生成文档
- **WebSocket & WebTransport** - 内置实时通信支持
- **基于 Hyper & Tokio** - 生产级异步运行时
## 快速开始
创建项目：
```bash
cargo new hello-salvo
cd hello-salvo
cargo add salvo tokio --features salvo/oapi,tokio/macros
```
编写 `src/main.rs`：
```rust
use salvo::prelude::*;
#[handler]
async fn hello() -> &'static str {
"Hello World"
}
#[tokio::main]
async fn main() {
let router = Router::new().get(hello);
let acceptor = TcpListener::new("127.0.0.1:7878").bind().await;
Server::new(acceptor).serve(router).await;
}
```
运行：
```bash
cargo run
```
## 为什么选择 Salvo？
### 中间件 = Handler
无需复杂的泛型和 trait，中间件就是普通函数：
```rust
#[handler]
async fn add_header(res: &mut Response) {
res.headers_mut().insert(header::SERVER, HeaderValue::from_static("Salvo"));
}
Router::new().hoop(add_header).get(hello)
```
### 树形路由 + 中间件
为不同路由分支应用不同的中间件：
```rust
Router::new()
// 公开路由
.push(Router::with_path("articles").get(list_articles))
// 需要认证的路由
.push(Router::with_path("articles").hoop(auth_check).post(create_article).delete(delete_article))
```
### JSON API
Handler 可以反序列化请求体，并返回类型化的 JSON 响应：
```rust
use salvo::http::ParseError;
use salvo::prelude::*;
use serde::{Deserialize, Serialize};
#[derive(Deserialize)]
struct CreateTodo {
text: String,
}
#[derive(Serialize)]
struct Todo {
id: u64,
text: String,
}
#[handler]
async fn create_todo(req: &mut Request) -> Result, ParseError> {
let payload = req.parse_json::().await?;
Ok(Json(Todo {
id: 1,
text: payload.text,
}))
}
```
这种写法需要启用 Serde 的 derive 功能：
```bash
cargo add serde --features derive
```
### 一行代码支持 OpenAPI
只需将 `#[handler]` 改为 `#[endpoint]`：
```rust
#[endpoint]
async fn hello() -> &'static str {
"Hello World"
}
```
### ACME 自动 HTTPS
自动从 Let's Encrypt 获取证书：
```rust
let listener = TcpListener::new("0.0.0.0:443")
.acme()
.add_domain("example.com")
.http01_challenge(&mut router)
.quinn("0.0.0.0:443"); // HTTP/3 支持
```
## CLI 工具
```bash
cargo install salvo-cli
salvo new my_project
```
## 了解更多
- [官方网站](https://salvo.rs)
- [API 文档](https://docs.rs/salvo)
- [示例代码](./examples/)
- [按功能拆分的 crate](./crates/)
## 推荐项目
- **[Savhub](https://github.com/savhub-ai/savhub)** - 轻松管理你的 AI 技能。基于 Salvo 构建的 AI 能力管理和分享平台。
- **[Palpo](https://github.com/palpo-matrix-server/palpo)** - 使用 Rust 实现的 Matrix 服务器，基于 Salvo 构建。
查看完整的社区项目列表：[ECOSYSTEM.md](./ECOSYSTEM.md)。
## 性能
Salvo 在 Rust Web 框架中性能名列前茅：
- [Web Frameworks Benchmark](https://web-frameworks-benchmark.netlify.app/result?l=rust)
- [TechEmpower Benchmarks](https://www.techempower.com/benchmarks/#section=data-r23)
## 赞助
如果 Salvo 对你有帮助，欢迎[请我喝杯咖啡](https://ko-fi.com/chrislearn)。
## 开源协议
基于 [Apache License 2.0](LICENSE) 授权。 
