YARP（代表"；另一个反向代理"；）是一个创建反向代理服务器的项目。我们在微软找到了一批内部团队，他们要么正在为他们的服务构建一个反向代理，要么一直在询问构建反向代理的API和技术，所以我们决定让他们一起开发一个共同的解决方案，这个项目。
YARP是一个反向代理工具包，用于在中构建快速代理服务器。NET中的基础结构。网和。网YARP的关键区别在于它'；它的设计可以轻松定制和调整，以满足每个部署场景的特定需求。
我们希望YARP作为一个库和项目模板提供，共同提供一个健壮、高性能的代理服务器。其管道和模块的设计使您可以根据需要定制功能。例如，虽然YARP支持配置文件，但我们预计许多用户将希望基于自己的后端配置管理系统以编程方式管理配置，而YARP将提供一个配置API，以便在proc中实现该定制。YARP的设计将可定制性作为主要场景，而不是要求您编写脚本或从源代码重建。
如需定期更新，请参阅我们的发布页面。订阅此存储库上的发布通知，以获得未来更新的通知（查看->；自定义->；发布）。
如果你想活在最前沿，你可以选择每日构建。
要构建回购协议，只需运行build。cmd（在Windows上）或build。sh（在Linux或macOS上）。脚本将下载。NET SDK并构建解决方案。
对于Windows上的VS，请安装最新的VS 2022版本，然后运行startvs。cmd脚本，以使用的相应本地副本启动Visual Studio。NET SDK。
要使用Visual Studio、Visual Studio for Mac或Visual Studio代码设置本地开发，需要将。NET SDK在PATH环境变量中。我们的恢复脚本获取最新版本的。NET并将其安装到。此存储库中的dotnet目录。
我们提供一些脚本来为您设置所有这些。只需遵循以下步骤：
运行恢复。cmd/restore。sh脚本来获取所需的。NET SDK本地（此repo中的.dotnet目录）
"点源"；激活脚本以放置本地。NET SDK在CMD的路径上，没有受支持的脚本。您可以手动添加。此repo中的dotnet目录指向您的路径。确保dotnet在此存储库中显示路径的位置！
当你'；完成后，您可以运行deactivate函数撤消对路径的更改。
如果你'；如果您在构建项目或在Visual Studio中开发时遇到问题，请提交一个问题让我们知道，我们'；我们将提供帮助（并根据需要修复我们的脚本/工具）！
生成并运行所有测试的命令：build。cmd/sh-测试。要运行特定的测试，可以使用XunitMethodName属性：dotnet build/t:test/p:XunitMethodName={FullyQualifiedNamespace}。{ClassName}。{MethodName}。如果使用startvs启动，这些测试也可以从Visual Studio运行。cmd。
YARP是一个预览项目，因此我们希望所有用户都有责任评估自己应用程序的安全性。
安全问题和漏洞应通过电子邮件私下报告给Microsoft安全响应中心（MSRC）[email protected].你应该在24小时内收到回复。如果由于某种原因您没有，请通过电子邮件跟进，以确保我们收到了您的原始消息。更多信息，包括MSRC PGP密钥，可以在Microsoft安全响应中心找到。
这个项目欢迎捐款和建议。大多数贡献都要求你同意一份贡献者许可协议（CLA），声明你有权，并且实际上确实授予我们使用你的贡献的权利。有关详细信息，请访问https://cla.opensource.microsoft.com.
当您提交请求时，CLA机器人将自动确定您是否需要提供CLA并适当装饰PR（例如，状态检查、评论）。只需按照机器人提供的说明操作即可。您只需使用我们的CLA在所有回购协议中执行一次。
该项目采用了微软的开源行为准则。有关更多信息，请参阅行为准则FAQ或[email protected]还有其他问题或意见。