basforge

Ищем по названиям, тексту и разборам «Если не работает».

    EN

    Python с нуля: ставим и раздаём файлы на телефон по Wi-Fi

    Ставим Python и одной командой, python -m http.server, открываем папку компьютера для телефона в той же сети: на телефоне — страница со списком файлов, нажали — скачалось. Кабель и облако не нужны, свой код — тоже.

    Нужно знатьТерминал и cdЗапуск pythonМодуль и python -m

    Что получится

    компьютер  ~/Pictures/trip               папка, которую отдаём
               python -m http.server         сервер на порту 8000, пока открыто окно
    телефон    http://192.168.1.23:8000      список файлов; нажали — файл скачался

    Сервер работает, пока открыт терминал: Ctrl+C — и папка закрыта. Пароля нет, поэтому отдаём только в своей сети и только на время передачи.

    По шагам

    1. Ставим Python

      Где Как Команда
      Windows Python install manager: Microsoft Store или python.org/downloads (это один и тот же установщик) python
      Ubuntu 24.04 уже стоит, Python 3.12 python3
      macOS установщик с python.org или brew install python python3

      На Windows прежний установщик .exe с галочкой «Add python.exe to PATH» с 3.14 устарел, а для 3.16 его не будет. Install manager сам кладёт команды python и py в путь — галочек нет. После установки открываем новое окно терминала: старое не знает про новые команды.

      python --version
      # Python 3.15.1

      Дальше пишем python; на Ubuntu и macOS — python3.

    2. Переходим в папку, которую отдаём

      cd ~/Pictures/trip

      ~ — домашняя папка; запись с / понимают и PowerShell, и терминалы Linux и macOS. Сервер отдаёт папку, где запущен, со всеми вложенными. Домашнюю папку целиком не открываем: в ней ключи .ssh, файлы браузера и документы. Без cd подойдёт ключ -d с полным путём: python -m http.server -d D:\photos\trip. Здесь ~ не годится: Windows PowerShell 5.1 не разворачивает его в аргументах программ, и Python получит его как есть.

    3. Запускаем сервер

      python -m http.server
      # Serving HTTP on :: port 8000 (http://[::]:8000/) ...

      -m http.server — запустить модуль http.server из стандартной библиотеки как программу. Модуль — файл с кодом на Python; стандартная библиотека — модули, которые ставятся вместе с Python, поэтому качать ничего не нужно. :: в выводе — сервер слушает все адреса компьютера, IPv4 тоже, порт по умолчанию — 8000.

      На Windows при первом запуске брандмауэр спрашивает, пускать ли Python в сеть. Ставим галочку «Частные сети», общественные не нужны.

    4. Узнаём адрес компьютера в сети

      Где Команда Что ищем
      Windows ipconfig строка IPv4 в блоке Wi-Fi или Ethernet
      Ubuntu hostname -I первый адрес
      macOS ipconfig getifaddr en0 адрес Wi-Fi

      Домашние адреса начинаются с 192.168., 10. или 172.16.–172.31.. Адреса из блоков WSL, Hyper-V и VirtualBox телефону не видны.

    5. Открываем с телефона

      Телефон — в той же Wi-Fi, что и компьютер. В браузере набираем http://192.168.1.23:8000: адрес свой, http, а не https, и порт через двоеточие. На странице «Directory listing for /» — файлы и папки. Нажали на файл — браузер предлагает скачать. Картинки, PDF и текст (.txt, .md) он открывает сам; текст по-русски при этом может показать кракозябрами — такой файл скачиваем долгим нажатием, «Скачать ссылку».

      В терминале на каждый запрос — строка:

      192.168.1.57 - - [21/Oct/2026 23:05:30] "GET / HTTP/1.1" 200 -

      Первым идёт адрес телефона, 200 — файл отдан.

    6. Закрываем

      Ctrl+C в окне сервера — Keyboard interrupt received, exiting., папка больше недоступна.

    Что здесь нового

    • Запуск python. Python — программа-интерпретатор: читает код и выполняет. python --version спрашивает у неё версию, python файл.py выполнит свой скрипт — подробно в «Запуск Python».
    • Модуль и python -m. http.server — модуль стандартной библиотеки, -m запускает его по имени, не зная, где лежит файл. Так же запускают python -m pip и python -m venv.

    Границы

    • Только в одну сторону. http.server отдаёт файлы, принимать не умеет: с телефона на компьютер так не передать.
    • Без пароля и шифрования. Любое устройство в сети видит всю папку, включая скрытые файлы. В документации модуль помечен как непригодный для продакшена: только базовые проверки безопасности.
    • Слушает все адреса. Ограничить одним — -b: python -m http.server -b 192.168.1.23.

    Если не работает

    Пишем python, а открывается Microsoft Store

    Причина
    Python не установлен, и Windows подставляет заглушку — псевдоним приложения, который ведёт в магазин.
    Делаем
    Ставим Python install manager (шаг 1) и открываем новое окно терминала. Не помогло — «Псевдонимы выполнения приложений» в «Пуске»: у «Python (default)» переключатель включён.

    Command 'python' not found, did you mean: command 'python3'

    Причина
    В Ubuntu Python 3 стоит, но команда называется python3; python без цифры по умолчанию нет.
    Делаем
    Пишем python3 -m http.server. Хочется python — sudo apt install python-is-python3.

    Телефон долго грузит и показывает «Не удалось открыть страницу»

    Причина
    Фаервол компьютера не пускает входящие на порт 8000, или телефон в другой сети: гостевая Wi-Fi, мобильный интернет.
    Делаем
    Windows — разрешаем Python в «Частных сетях» (окно при первом запуске или «Разрешение взаимодействия с приложением» в брандмауэре); сеть Wi-Fi должна быть «Частной». Телефон — в той же сети, что и компьютер, не в гостевой.

    Адрес набран, а открывается чужая страница или ничего

    Причина
    Взяли адрес не того адаптера: у WSL, Hyper-V и VirtualBox свои адреса, которые телефону не видны.
    Делаем
    В ipconfig берём адрес из блока Wi-Fi или Ethernet, через который компьютер в домашней сети — обычно 192.168.x.x.

    Запустили в другой папке, а телефон показывает старую

    Причина
    Первый сервер ещё работает в другом окне. На Windows второй запуск на том же порту ошибки не даёт — порт делят два процесса.
    Делаем
    Останавливаем старый Ctrl+C в его окне или запускаем новый на другом порту: python -m http.server 8080.

    Нажали на .md или .txt, а вместо скачивания — текст с кракозябрами

    Причина
    Файлы, которые браузер умеет показать, он открывает сам. http.server отдаёт их без кодировки (Content-Type: text/markdown, без charset=utf-8), и браузер читает русский текст в чужой кодировке.
    Делаем
    Долгое нажатие на файл в списке — «Скачать ссылку»: файл сохранится как есть, в UTF-8.

    Как проверить

    С телефона открываем http://<адрес компьютера>:8000 — видим «Directory listing for /» и свои файлы, в терминале появилась строка с адресом телефона и 200. После Ctrl+C та же страница на телефоне не открывается.