# PicoServer：轻量高性能嵌入式WebAPI 框架

**Repository Path**: jzy168/PicoServer

## Basic Information

- **Project Name**: PicoServer：轻量高性能嵌入式WebAPI 框架
- **Description**: PicoServer是一款内嵌式高性能跨平台 WebAPI 框架，基于.NET Standard 2.0 构建，集成简单、不侵业务、开箱即用。免 IIS、单 DLL 即可让程序快速具备 WebAPI 能力，非常适合轻量部署、跨平台及 AOT 编译需求。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://picoserver.cn/
- **GVP Project**: No

## Statistics

- **Stars**: 6
- **Forks**: 1
- **Created**: 2024-10-22
- **Last Updated**: 2026-01-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: VB, vbnet, WebApi

## README

![2f4c1767266451.png](https://picoserver.cn/content/uploadfile/202601/c5481768225502.png)

**[简体中文](README.md)|[English](README.en.md)**

### 🛠️ PicoServer是什么？
> PicoServer 是一款 .NET 生态的 **轻量级 Web 请求胶水库**，主打 “集成至上、灵活嵌入”，可直接嵌入任意 .NET 应用快速搭建 Web API。

> 它无需依赖 IIS、Kestrel，开箱即用零配置，无需修改原有业务代码，无论是轻量级 Web API、WebSocket 实时通信、边缘计算 Web 服务，还是轻量流媒体服务器，用它都恰到好处。

### ❤️ **就叫他“皮卡”吧**

> 很高兴💥碰撞出了这个中文名字。皮卡，出发！

C# 一行代码实现WebAPI
```csharp
MyAPI.AddRoute("/hello", async (req, resp) => await resp.WriteAsync(@"{""code"":1,""msg"":""Hello PicoServer WebAPI""}"));
```
VB.NET 一行代码实现WebAPI
```vb
MyAPI.AddRoute("/hello", Function(req, resp) resp.WriteAsync(<t>{"code":1,"msg":"Hello PicoServer WebAPI"}</t>.Value))
```

| [快速开始](https://picoserver.cn/quikstart.html "快速开始") | [C# 示例](https://picoserver.cn/usage-csharp.html "C#示例") | [VB.NET 示例](https://picoserver.cn/usage-vbnet.html "VB.NET示例") | [性能测试](https://picoserver.cn/benchmark.html "性能测试") | [二次开发](https://picoserver.cn/developer.html "二次开发") |
| :------------: | :------------: | :------------: | :------------: | :------------: |

### ✨ PicoServer 特色

📦 **极小体积**：单 DLL 仅 60kb，**无第三方依赖**，极致轻量
💡 **极简上手**：**[NuGet 安装 PicoServer](https://picoserver.cn/quikstart.html "NuGet 安装 PicoServer")** ，再添加一个路由即可完成 Web API 搭建
🔗 **灵活兼容**：**胶水特性**完美配合其他库，老旧项目无需改动业务代码
🛡️ **开箱即用**：内置默认路由、简单 Token 验证、JWT 验证，覆盖大多数基础场景
🚀 **极速运行**：全异步非阻塞架构，原生支持 AOT 编译，毫秒级启动，轻松应对各类网关
🌍 **跨平台兼容**：基于 .NET Standard 2.0 开发，支持 .NET Framework4.6.1+/Core/5/6+ 以及 Linux、Windows、macOS
✨ **高度可扩展**：通过自定义 `AddRoute`（路由）与 `AddMiddleware`（中间件），轻松实现二次开发，解锁更多进阶功能

---

### 🎯 什么时候选择 PicoServer？
如果你的需求符合以下任何一点，请选择 **PicoServer** 这款“**胶水库**”：

* **主程序需要“顺便”加个接口**：比如给控制台程序、桌面应用、Windows 服务增加 Web API 支持。
* **追求“极致透明”**：你希望每一行处理逻辑（中间件/路由）都在你眼皮底下，而非隐藏在黑盒之中。
* **资源敏感型环境**：在工业 PC、边缘设备或 MCP (AI 大模型助手调用) 场景，每一兆内存都弥足珍贵。
* **纯粹的流处理**：只需搭建简单的文件上传下载、视频流转发或内网穿透网关。

---

### 🧰 三板斧：按需嵌入，灵活赋能
**不要被“60kb 的轻量”限制了想象力**。PicoServer 以库的形式嵌入你的应用，提供最直接的 Web 能力支撑，按需调用即可

1.  **路由映射 (AddRoute) —— 业务入口**
    「精准承接」：作为 Web 请求的核心入口，只需几行代码，即可将特定 URL 请求映射到你的业务逻辑，无论是返回 JSON 数据还是执行业务指令，即刻响应。
2.  **中间件 (AddMiddleware) —— 请求防线**
    「前置拦截」：在请求到达业务逻辑前生效，可快速集成身份校验、日志审计、IP 过滤等能力，一键实现请求的拦截或放行，无需改动核心业务。
3.  **扩展能力 —— 按需赋能**
    「轻量集成」：得益于“胶水”特性，可基于前两者灵活扩展，按需嵌入 WebAPI、文件下载、流媒体转发等能力，轻松丰富你的应用功能边界。


---

### 🚀 开启你的嵌入集成之旅
** Web 连接万物 **
**“PicoServer 负责连接，你负责创造。”**

> PicoServer 很简单，开箱即用；很友好，不侵入业务；很灵活，极简[二次开发](https://picoserver.cn/developer.html "二次开发")

立即查看 **[使用说明 (C#)](https://picoserver.cn/usage-csharp.html)** 或 **[使用说明 (VB.NET)](https://picoserver.cn/usage-vbnet.html)**，三行代码，开启你的集成之旅。