PicoServer 官方文档
✨ PicoServer 个人和企业免费商用 🇨🇳 支持信创
🚀 .NET 应用 + PicoServer = Web 化应用
🛠️ PicoServer是什么？
PicoServer 是一款轻量级跨平台 Web 能力胶水库，单 DLL 零依赖，只有几十 KB，可集成进任意 .NET 程序，不依赖 IIS、Kestrel，集成简单、不入侵业务，高性能、高稳定，低资源消耗。无论是轻量级 Web API、WebSocket 实时通信、边缘计算 Web 服务，各类网关，还是轻量流媒体服务器，用它都恰到好处。
✨ PicoServer 核心特色
📦 开箱即用：内置路由、Token/JWT 认证、请求解析、WebAPI、WebSocket、静态文件服务、跨域等能力，覆盖基础 Web 场景。
🌍 跨平台兼容：基于 .NET Standard 2.0，支持 .NET Framework 4.6.1+ / Core / 5 / 6+，兼容 Win/Linux/macOS。
🔗 胶水特性：无缝配合第三方库，无需改动原有业务代码，轻松嵌入任意 .NET 程序，实现无侵入集成。
🚀 极速低耗：异步非阻塞架构，支持 AOT 编译，响应迅速，单 DLL 仅几十 KB，不拖垮主程序。
✨ 自由集成：通过AddRoute与AddMiddleware实现高度定制，逻辑全程可见可控，无黑盒封装。
❤️ 像写方法一样写 WebAPI
很多 .NET 开发者在桌面和设备领域经验丰富，但 Web 并不是主要方向。PicoServer 让你无需成为 Web 专家，也能为应用快速添加 Web 能力，实现更现代的交互方式，就像你熟悉的方法调用一样自然。
C# 一行代码实现WebAPI
MyAPI.AddRoute("/hello", async (req, resp) => await resp.WriteAsync(@"{""code"":1,""msg"":""Hello PicoServer WebAPI""}"));VB.NET 一行代码实现WebAPI
MyAPI.AddRoute("/hello", Function(req, resp) resp.WriteAsync(<t>{"code":1,"msg":"Hello PicoServer WebAPI"}</t>.Value))| 快速开始 | C# 示例 | VB.NET 示例 | 性能测试 | 集成指南 |
|---|
🎯 什么时候选择 PicoServer？
当您面临以下场景时，PicoServer 很合适：
- 追求极简集成：只需轻量 Web API 或 WebSocket，不想折腾复杂的框架配置，追求几行代码开箱即用。
- 老旧项目赋能：现有项目基于老旧 .NET Framework，或需跨平台部署，想快速增加 Web 能力而无需重构。
- Web能力集成：给控制台、WinForm、WPF、MAUI、Avalonia 、VSTO 等程序“顺便”加 Web 接口，实现远程管理或 B/S 融合。
- 资源敏感环境：工业 PC、边缘网关、AI 大模型 MCP 调用等对 DLL 体积、CPU 和内存占用有严苛要求的场景。
- 高度定制需求：需搭建文件传输、视频流转发或内网穿透网关，追求逻辑全程透明、无黑盒、易排错。
🧩 ASP.NET Core vs PicoServer
| 特性 | ASP.NET Core | PicoServer |
|---|---|---|
| 定位 | 独立 Web 项目框架 | Web 能力胶水库 |
| 集成方式 | 遵循框架规范，改动项目 | 不用改动项目，几行代码嵌入 |
| 核心优势 | 完整 Web 生态，功能全面 | 轻量、简洁、与任意库完美配合 |
需要 ASP.NET Core 来做大型项目，但是刚起步，PicoServer 可以帮你快速原型验证，伴随项目前期启动。
当 PicoServer 无法承载你业务的时候，可平滑迁移到 ASP.NET Core
PicoServer 的极简和胶水特性，完美支持 DI 依赖注入。
🧰 PicoServer 三板斧
不要被几十 KB 的轻量限制了想象力。PicoServer 以库的形式集成到你的应用，提供最直接的 Web 能力支撑
- 路由映射 (AddRoute) —— 业务入口 精准承接 URL 请求，快速映射到自定义业务逻辑，轻松返回 JSON、页面等各类响应
- 中间件 (AddMiddleware) —— 前置拦截 搭配身份校验、日志审计、IP 过滤等能力，在请求到达业务逻辑前生效，一键拦截或放行，无需改动核心业务
- 内置安全 —— 开箱即用 路由原生安全，防目录遍历，内置简单 Token 认证、JWT 认证，快速保障接口安全，无需额外引入第三方安全库。支持SSL（需系统配置）
🚀 开启你的嵌入集成之旅
Web 连接万物
“PicoServer 负责连接，你负责创造。”
立即查看 使用说明 (C#) 或 使用说明 (VB.NET)，三行代码，开启你的集成之旅。