serve CLI
serve открывает локальную папку, статический сайт или одностраничное приложение через HTTP и показывает список файлов каталога.
- 9 915 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- HTTP-сервер может открыть содержимое выбранной папки другим доступным сетевым клиентам.
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/serveОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- HTTP-сервер может открыть содержимое выбранной папки другим доступным сетевым клиентам.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
После сборки фронтенда пользователь выбирает папку с готовыми файлами и открывает ее в браузере по HTTP. Команда serve раздает HTML, одностраничное приложение или отдельный файл; для каталога она показывает список содержимого. Доступ возможен на той же машине или по сети, если это допускают настройки. Для первого запуска достаточно npx. В `serve.json` внутри раздаваемой папки можно настроить перенаправления, HTTP-заголовки и показ списка файлов. CLI читает эти параметры через serve-handler. Сборка исходников и серверная логика приложения остаются за инструментами проекта.
Для кого. Авторам фронтенд-прототипов, которым нужно открыть готовую сборку или статические файлы по локальному HTTP-адресу.
Подходит, если
- После сборки автор открывает готовый сайт для ручного просмотра.
- HTML-прототип показывают коллеге на устройстве в доступной сети.
- Пользователь выбирает файл из списка каталога в браузере.
- Перед публикацией тестировщик открывает собранное одностраничное приложение.
Не подходит, если
- Нужен бэкенд с серверной логикой и обработкой данных.
- Исходники должны автоматически собираться вместо раздачи готовых файлов.
- В выбранной папке есть секреты, которые нельзя открывать сетевому клиенту.
Пример запроса к агенту
Подготовь локальный просмотр папки dist через serve, сначала проверь, что внутри нет секретов и лишних файлов.Ограничения
Для serve 14 и новее требуется Node.js 14 или новее. Проект должен быть собран заранее: этот сервер не компилирует исходники и не выполняет бэкенд. Клиент получает файлы выбранной папки, включая доступный список каталога; приватные материалы нельзя держать в этой области. Сетевую видимость определяют адрес прослушивания и настройки машины, поэтому проверьте их перед демонстрацией на другом устройстве.
Как отключить. Завершите процесс serve. Локальный сервер перестанет раздавать папку, сами файлы останутся на диске.
Частые вопросы
Нужна глобальная установка?
Нет. `npx serve` запускает сервер из текущего каталога.
Как раздать другую папку?
Без глобальной установки укажите папку в `npx serve folder-name/`. После глобальной установки тот же запуск можно записать как `serve folder-name/`. В обоих случаях сервер раздает содержимое указанной папки.
Где меняется обработка файлов?
В `serve.json` публичного каталога, с настройками serve-handler.
Можно передать исходники вместо сборки?
Сервер раздаст их как файлы. Само приложение он из исходников не соберет.
Как узнать параметры запуска?
После глобальной установки `serve --help` выводит параметры запуска. При работе через npx используйте `npx serve --help`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыОфициальный CLI Angular создает рабочее пространство приложения, запускает сервер разработки и поддерживает сопровождение проекта.
Визуальный конструктор сайтов с встроенным MCP-сервером: агент помогает собирать статические страницы с динамическими данными по вашему выбору модели
CLI и локальный MCP-сервер для веб-проектов: шаблоны, дизайн-системы, статические проверки и запуск проверочных скриптов.
Rockpack Starter, CLI для React, готовит шаблоны приложений и библиотек на Webpack с TypeScript и расширяемой сборкой.
Локальный визуальный редактор готовой HTML-страницы: правка мышью, предпросмотр скриптов, сохранение в тот же файл.
Связывает запущенный фронтенд с агентом: клик по элементу ведет к строке кода, а агент видит живой DOM, пропсы и состояние.
Коротко о README
Настройка directoryListing в serve.json отключает список файлов или ограничивает его отдельными путями. unlisted скрывает имена из списка; саму раздачу файлов эта настройка не запрещает.