https://github.com/noble-gase/oganesson-rs
[氡-Rn] Rust Web开发脚手架
https://github.com/noble-gase/oganesson-rs
actix-web api axum rust salvo web
Last synced: 17 days ago
JSON representation
[氡-Rn] Rust Web开发脚手架
- Host: GitHub
- URL: https://github.com/noble-gase/oganesson-rs
- Owner: noble-gase
- License: mit
- Created: 2025-03-11T01:50:37.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-05-29T06:46:29.000Z (21 days ago)
- Last Synced: 2026-05-29T08:27:27.073Z (21 days ago)
- Topics: actix-web, api, axum, rust, salvo, web
- Language: Rust
- Homepage: https://crates.io/crates/rnx
- Size: 243 KB
- Stars: 22
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# oganesson-rs
[
](https://crates.io/crates/oganesson-rs)
[
](http://opensource.org/licenses/MIT)
[鿫-Oganesson] Rust Web开发脚手架，支持 `actix-web`、 `axum` 和 `salvo` 框架，并支持「单应用」和「多应用」模式
## 安装
```shell
cargo install oganesson-rs
```
## 特点
- DB使用 [sqlx](https://github.com/launchbadge/sqlx)
- Redis使用 [redis-rs](https://github.com/redis-rs/redis-rs)
- 日志使用 [tracing](https://github.com/tokio-rs/tracing)
- 配置使用 [config-rs](https://github.com/mehcode/config-rs)
- 命令行使用 [clap](https://github.com/clap-rs/clap)
- 异步运行时使用 [tokio](https://github.com/tokio-rs/tokio)
- 参数验证器使用 [validator](https://github.com/Keats/validator)
- 支持 Prometheus Metrics 和 Request 中间件
- 包含 TraceId、认证、请求日志、Panic捕获 中间件
- 简单好用的 API Result 统一输出方式
## 创建项目
### 单应用
```shell
# actix-web
og new # 在当前目录初始化项目
og new --name demo # 创建demo项目
# axum
og new --axum # 在当前目录初始化项目
og new --name demo --axum # 创建demo项目
# salvo
og new --salvo # 在当前目录初始化项目
og new --name demo --salvo # 创建demo项目
.
├── Cargo.toml
├── Dockerfile
├── app/
│ ├── Cargo.toml
│ ├── config.toml
│ └── src/
│ ├── cmd/
│ ├── handler/
│ ├── middleware/
│ ├── router/
│ ├── service/
│ └── main.rs
├── infra/
│ ├── Cargo.toml
│ └── src/
│ ├── core/
│ ├── middleware/
│ ├── status/
│ ├── util/
│ └── lib.rs
└── repo/
├── Cargo.toml
└── src/
├── dao/
├── schema/
└── lib.rs
```
### 多应用
```shell
# actix-web
og new --app foo --app bar # 在当前目录初始化项目
og new --name demo --app foo --app bar # 创建demo项目
# axum
og new --app foo --app bar --axum # 在当前目录初始化项目
og new --name demo --app foo --app bar --axum # 创建demo项目
# salvo
og new --app foo --app bar --salvo # 在当前目录初始化项目
og new --name demo --app foo --app bar --salvo # 创建demo项目
.
├── Cargo.toml
├── Dockerfile.foo
├── Dockerfile.bar
├── app/
│ ├── foo/
│ │ ├── Cargo.toml
│ │ ├── config.toml
│ │ └── src/
│ │ ├── cmd/
│ │ ├── handler/
│ │ ├── middleware/
│ │ ├── router/
│ │ ├── service/
│ │ └── main.rs
│ └── bar/
│ ├── Cargo.toml
│ ├── config.toml
│ └── src/
│ ├── ...
│ └── main.rs
├── infra/
│ ├── Cargo.toml
│ └── src/
│ ├── core/
│ ├── middleware/
│ ├── status/
│ ├── util/
│ └── lib.rs
└── repo/
├── Cargo.toml
└── src/
├── dao/
├── schema/
└── lib.rs
```
## 创建应用
> 多应用项目适用，需在项目根目录执行（即：`Cargo.toml` 所在目录）
```shell
# actix-web
og app --name foo --name bar
# axum
og app --name foo --name bar --axum
# salvo
og app --name foo --name --salvo bar
.
├── Cargo.toml
├── Dockerfile.foo
├── Dockerfile.bar
├── app/
│ ├── foo/
│ │ ├── Cargo.toml
│ │ ├── config.toml
│ │ └── src/
│ │ ├── cmd/
│ │ ├── handler/
│ │ ├── middleware/
│ │ ├── router/
│ │ ├── service/
│ │ └── main.rs
│ └── bar/
│ ├── Cargo.toml
│ ├── config.toml
│ └── src/
│ ├── ...
│ └── main.rs
├── infra/
│ ├── Cargo.toml
│ └── src/
│ ├── ...
│ └── lib.rs
└── repo/
├── Cargo.toml
└── src/
├── ...
└── lib.rs
```
**Enjoy 😊**