Сводка документации
Добро пожаловать
Getting started
Welcome to the Sisk documentation!
Sisk is an open-source lightweight HTTP framework for .NET. You can use it to build a standalone web …
Установка
Вы можете установить Sisk через NuGet, dotnet CLI или another options. Вы можете легко настроить свою среду Sisk, выполнив эту команду в …
Поддержка Native AOT
.NET Native AOT позволяет публиковать родные приложения .NET, которые являются самодостаточными и не требуют установки среды выполнения .NET …
Развёртывание вашего приложения Sisk
Процесс развёртывания приложения Sisk состоит в публикации вашего проекта в продакшн. Хотя процесс относительно прост, стоит обратить …
Работа с SSL
Работа с SSL в процессе разработки может быть необходима при работе в контекстах, требующих безопасности, таких как большинство сценариев …
Cadente
Cadente — экспериментальная управляемая реализация HTTP/1.1‑слушателя для Sisk. Она заменяет стандартный System.Net.HttpListener, …
Настройка резервирования пространств имён в Windows
Примечание
Эта конфигурация является необязательной и требуется только тогда, когда вы хотите, чтобы Sisk прослушивал хосты, отличные от …
Журналы изменений
Каждое изменение, внесённое в Sisk, фиксируется в журнале изменений. Вы можете просмотреть журналы изменений для всех версий Sisk здесь. …
Часто задаваемые вопросы
Часто задаваемые вопросы о Sisk.
Является ли Sisk открытым исходным кодом? # Полностью. Всё исходный код, используемый Sisk, публикуется и …
Основы
Маршрутизация
The Router is the first step in building the server. It is responsible for housing Route objects, which are endpoints that map URLs and …
Обработка запросов
Обработчики запросов, также известные как «middleware», — это функции, которые выполняются до или после выполнения запроса роутером. Их …
Запросы
Запросы — это структуры, представляющие HTTP‑сообщение запроса. Объект HttpRequest содержит полезные функции для обработки HTTP‑сообщений во …
Ответы
Ответы представляют собой объекты, являющиеся HTTP‑ответами на HTTP‑запросы. Они отправляются сервером клиенту в качестве указания на запрос …
Возможности
Логирование
Вы можете настроить Sisk для автоматической записи журналов доступа и ошибок. Можно задать ротацию журналов, расширения и частоту.
Класс …
Server Sent Events
Sisk поддерживает отправку сообщений через Server Sent Events «из коробки». Вы можете создавать одноразовые и постоянные соединения, …
Веб-сокеты
Sisk также поддерживает веб‑сокеты, позволяя получать и отправлять сообщения клиенту.
Эта функция работает в большинстве браузеров, но в …
Синтаксис отбрасывания
Веб-сервер может использоваться для прослушивания запроса обратного вызова от действия, такого как аутентификация OAuth, и может быть …
Внедрение зависимостей
Обычно посвящают члены и экземпляры, которые существуют в течение времени жизни запроса, такие как соединение с базой данных, …
Потоковая передача контента
Sisk поддерживает чтение и отправку потоков контента клиенту и от клиента. Эта функция полезна для удаления нагрузки на память при …
Включение CORS (Cross-Origin Resource Sharing) в Sisk
Sisk предоставляет инструмент, который может быть полезен для обработки Cross-Origin Resource Sharing (CORS) при публичном предоставлении …
Файловый сервер
Sisk предоставляет пространство имён Sisk.Http.FileSystem, которое содержит инструменты для обслуживания статических файлов, отображения …
Расширения
Протокол контекста модели
Можно создавать приложения, которые предоставляют контекст моделям‑агентам, использующим большие языковые модели (LLM), с помощью пакета …
Расширение JSON-RPC
Sisk имеет экспериментальный модуль для API JSON-RPC 2.0, который позволяет создавать ещё более простые приложения. Это расширение строго …
Поставщики сервисов
Поставщики сервисов — это способ перенести ваше приложение Sisk в разные среды с помощью переносимого файла конфигурации. Эта возможность …
Поставщик конфигурации INI
Sisk имеет способ получения стартовых конфигураций, отличных от JSON. На самом деле любой конвейер, реализующий IConfigurationReader, можно …
Документация API
Расширение Sisk.Documenting позволяет автоматически генерировать документацию API для вашего приложения Sisk. Оно использует структуру …
Базовая аутентификация (устарела)
Осторожно
Discontinued, do not use. The Sisk.BasicAuth package is no longer maintained and is deprecated on NuGet, with no replacement …
SSL Proxy (прекращённый)
Осторожно
Прекращён, не использовать. Пакет Sisk.SslProxy больше не поддерживается и помечен как устаревший в NuGet, без заменяющего …
Продвинутый
Ручная (расширенная) настройка
Используйте ручную настройку, когда необходимо собрать части сервера самостоятельно, например, когда один процесс должен предоставлять …
Жизненный цикл запроса
Ниже объясняется весь жизненный цикл запроса на примере HTTP‑запроса.
Получение запроса: каждый запрос создает HTTP‑контекст между самим …
Forwarding Resolvers
Forwarding Resolver — это вспомогательный компонент, который помогает декодировать информацию, идентифицирующую клиента через запрос, …
Обработчики HTTP‑сервера
В версии Sisk 0.16 мы представили класс HttpServerHandler, который предназначен для расширения общего поведения Sisk и предоставления …
Несколько прослушивающих хостов на сервере
Фреймворк Sisk всегда поддерживал использование более одного хоста на сервере, то есть один HTTP‑сервер может прослушивать несколько портов, …
HTTP Server Engines
Фреймворк Sisk разделен на несколько пакетов, где основной пакет (Sisk.HttpServer) не включает базовый HTTP-сервер - по умолчанию …