miniserve CLI
miniserve, файловый HTTP-сервер, показывает содержимое каталога в браузере и по настройке принимает файлы в выбранные папки.
- 8 096 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Сервер открывает выбранные файлы по сети, а при включенной загрузке принимает запись в разрешенные каталоги.
Установка
Ручная установка
chmod +x miniserve-linux
./miniserve-linuxПервый способ README: заранее скачайте miniserve-linux из Releases. Команды делают файл исполняемым и запускают сервер в текущей папке.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сервер открывает выбранные файлы по сети, а при включенной загрузке принимает запись в разрешенные каталоги.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
miniserve, CLI для передачи файлов, запускает HTTP-сервер для выбранного файла или каталога одной командой. Пользователь открывает адрес в браузере и получает список файлов либо заданную стартовую страницу. Для статического приложения можно направлять неизвестные пути его клиентскому маршрутизатору. Дополнительные настройки включают пароль, TLS и прием файлов. Агент может подготовить временный просмотр результата сборки или передачу материалов, указав точный каталог и адрес прослушивания. Сервер работает отдельным процессом, который нужно завершить после использования.
Для кого. Создателям прототипов, которым нужно временно показать статическую сборку или передать выбранную папку по сети.
Подходит, если
- Вы открываете готовую HTML-сборку в браузере через HTTP.
- Коллега скачивает один большой файл из временно опубликованной папки.
- При тестировании SPA вы переходите по вложенным адресам.
- Участники передачи загружают файлы из браузера в согласованную папку с аутентификацией.
Не подходит, если
- Планируется постоянная многопользовательская платформа хранения с учетом документов.
- В выбранной папке есть секреты, которые нельзя раскрывать посетителям.
- Нужно выполнять серверный код приложения или запросы к базе данных.
Пример запроса к агенту
Подготовь локальный просмотр этой статической сборки на loopback, без загрузки файлов. Покажи адрес и способ остановки.Ограничения
Без явного адреса привязки miniserve пытается слушать все сетевые интерфейсы, поэтому для локального просмотра задайте только адрес 127.0.0.1. Пароль и TLS включаются отдельно; наличие случайного пути не заменяет контроль доступа. Загрузка файлов разрешает запись в выбранные каталоги и требует проверки места для временных данных. Символьные ссылки могут вести за ожидаемые границы папки, поэтому используйте настройку запрета их обхода, если они не нужны для передачи.
Как отключить. Завершите процесс miniserve, чтобы остановить доступ по HTTP. Загруженные пользователями файлы останутся в выбранных папках; сохраните нужные и удалите ненужные отдельно.
Частые вопросы
Как запустить скачанный Linux-бинарник?
Сделайте файл исполняемым командой `chmod +x miniserve-linux`, затем запустите `./miniserve-linux`. До запуска проверьте текущую папку: сервер будет показывать ее содержимое.
Можно ли отдать только один файл?
Да. Укажите путь к файлу вместо каталога. По адресу сервера будет доступен выбранный файл.
Как открыть свою стартовую страницу?
Укажите `--index` с именем файла. Для клиентской SPA добавьте документированный режим `--spa`.
Можно ли включить HTTPS?
Да. Параметры `--tls-cert` и `--tls-key` принимают пути к сертификату и ключу. После запуска откройте HTTPS-адрес в браузере и проверьте цепочку сертификата.
Нужны ли дополнительные зависимости для бинарника?
Готовая поставка самодостаточна. Сборка через Cargo требует установленного Rust и относится к другому способу установки.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыКонсольный клиент файлообменника Plik со встроенным MCP-сервером для выгрузки файлов из редактора с агентом
Песочница для ИИ-агента с 1С
1c-ai-sandbox-client-server
Devcontainer и Hyper-V VM с сервером 1С, изолирующие ИИ-агента от хостовой машины, чтобы ошибочная команда не задела реальные файлы и диски
Nehemiah дает агенту через MCP виртуальные Linux-машины на Firecracker: запуск, команды, превью, форк и шаблоны.
aeroftp-cli работает с FTP, SFTP, S3 и WebDAV по профилям из хранилища без паролей в диалоге, а режим MCP открывает 78 инструментов
WebSSH-консоль для VPS с MCP-сервером: агент работает на нескольких серверах, а токены с ACL ограничивают инструменты и хосты.
CLI на Go сравнивает сервер с прошлым снимком, сообщает только значимые перемены и отдает их агенту через MCP
Коротко о README
Список файлов можно фильтровать по имени, а папку скачать архивом. Для терминальных браузеров есть упрощенное HTML-представление.