预览版本，不能保证API的稳定性！请勿在生产环境中使用！

以库为中心，轻量级，高性能，支持云原生的API网关🪐

SpaceGate("Spacegates是悬挂在太空或行星轨道上的星门") 来自 "星门"。

💖 核心功能

• 小巧：基于Rust，可执行文件仅占6MB。
• 云原生：实现了Kubernetes Gateway API规范。
• 易于扩展：只需用Rust编写两个函数即可构建自己的插件。
• 易于扩展：只需用Rust编写两个函数即可构建自己的插件。
• 高性能
• 低资源消耗

使用方法

在k8s中使用spacegate

为kubernetes安装

kubectl apply -f https://github.com/ideal-world/spacegate/releases/download/0.2.0-alpha.1/spacegate-0.2.0-alpha.1.yaml

打开spacegate管理Web，享受吧！

将spacegate作为可执行二进制文件使用

构建和安装

在您的Linux机器上构建和安装。

安装spacegate

sh resource/install/install.sh

安装spacegate-admin管理工具（可选）

此官方管理工具将提供Web界面以编辑网关的配置。

sh resource/install/install-admin.sh

配置您的网关

如果您安装了spacegate-admin管理工具，请访问localhost:9991。

firefox localhost:9991

或访问配置文件夹

ls /etc/spacegate

编辑配置后，使用systemctl重新加载配置。

sudo systemctl reload spacegate

安装插件

检查插件文件夹

ls /lib/spacegate/plugins

只需将.so文件放入插件文件夹下并配置它。

将spacegate作为Rust库使用

您可以使用spacegate-kernel或spacegate-shell。前者相对较低级，而后者集成了插件和配置系统。

使用spacegate-shell

spacegate-shell = { git="https://github.com/ideal-world/spacegate", branch="dev" }

通过配置更改监听器启动

async fn main() {
    let listener = todo!("create a listener!");
    spacegate_shell::startup(listener).await;
}

或使用内置监听器

// file config
spacegate_shell::startup_file("/etc/spacegate").await;
// k8s resource
spacegate_shell::startup_k8s(Some("spacegate-namespace")).await;
// fetch from redis
spacegate_shell::startup_redis("redis://my-redis").await;

使用spacegate-kernel

spacegate-kernel = { git="https://github.com/ideal-world/spacegate", branch="dev" }

创建监听器和网关服务

let cancel = CancellationToken::default();
// create a gateway service
let gateway = gateway::Gateway::builder("test_gateway")
    .http_routers([(
        "test_gateway".to_string(),
        HttpRoute::builder()
            .rule(
                HttpRouteRule::builder()
                    .match_item(HttpPathMatchRewrite::prefix("/baidu"))
                    .backend(HttpBackend::builder().schema("https").host("www.baidu.com").port(443).build())
                    .build(),
            )
            .build(),
    )])
    .build();
let addr = SocketAddr::from_str("[::]:9002")?;
// create a listener
let listener = SgListen::new(
    addr,
    gateway.as_service(),
    cancel.child_token(),
);
// start listen
listener.listen().await?;

在Rust中创建自己的插件

您只需实现一个Plugin特质

use spacegate_plugin::{SgResponse, SgRequest, Inner, BoxError, PluginConfig, Plugin};

pub struct ServerHeaderPlugin {
    header_value: String,
}

impl Plugin for ServerHeaderPlugin {
    // an unique code for this plugin
    const CODE: &'static str = "server-header";
    // this will be called when request passthrough this plugin
    async fn call(&self, req: SgRequest, inner: Inner) -> Result<SgResponse, BoxError> {
        // pre-request process

        // call inner to pass this request into inner layers
        let mut resp = inner.call(req).await;    

        // post-request process
        resp.headers_mut().insert("server", self.header_value.parse()?);

        // return the result
        Ok(resp)
    }

    // create a plugin instance from config
    fn create(plugin_config: PluginConfig) -> Result<Self, BoxError> {
        let Some(header_value) = plugin_config.spec.get("header_value") else {
            return Err("missing header_value".into())
        };
        Ok(Self {
           header_value: header_value.as_str().unwrap_or("spacegate").to_string(),
        })
    }
}

将插件作为静态库使用

在您的应用程序程序中

// register the plugin into global plugin repository
spacegate_plugin::PluginRepository::global().register::<ServerHeaderPlugin>()

将插件作为动态链接库使用

使用宏dynamic_lib

use spacegate_plugin::dynamic_lib;
dynamic_lib! { ServerHeaderPlugin }

并将crate类型设置为dylib

[lib]
crate-type = ["dylib"]

获取lib文件后，将其加载到应用程序中。

例如

spacegate_plugin::PluginRepository::global().register_dylib("/lib/spacegate/plugins/mylib.so")

为什么创建这个项目

目前市面上有很多API网关产品，但它们大多以独立服务的形式存在。定制能力相对较差，使用和部署的成本也相对较高。

本项目基于Rust语言，使用hyper作为基础网络库。目标是：提供一个以库为先、轻量级、高性能、支持云原生的API网关。

📦 组件

Crate	类型	描述
spacegate-kernel	rust-lib	创建网关服务的内核功能
spacegate-ext-redis	rust-lib	Redis功能扩展
spacegate-ext-axum	rust-lib	Axum web服务器功能扩展
spacegate-shell	rust-lib	包括插件系统、配置监听器和易于使用的程序入口的集成集合。
spacegate-plugin	rust-lib	spacegate-shell的插件系统实现
spacegate-model	rust-lib	spacegate项目中常用的数据结构。
spacegate-config	rust-lib	配置监听器接口和实现。
spacegate	bin	基于spacegate-shell的即用型可执行文件。
spacegate-admin	bin	Spacegate管理应用的后端服务。
spacegate-admin-client	js-lib	spacegate-admin的JavaScript/TypeScript sdk。
spacegate-admin-fe	web	Spacegate管理应用的前端。

项目结构

🔖 版本发布

版本发布二进制命名方法：{crate}-{arch}{OS}{abi}-{version} 下载这里