Настройка туннеля Raspberry Pi
Cloudflare Tunnel на Raspberry Pi для постоянного домашнего сервера
Используйте это руководство, если Raspberry Pi или мини-ПК должны поддерживать cloudflared онлайн с реальным хостом. Описаны настройка, systemd, проверки и когда проще GhostlyShare или ghs CLI.
Цель — стабильное исходящее соединение, а не магическая анонимность. Посетителям не нужен доступ к роутеру, но Cloudflare, ваши аккаунты и привычки важны.
Raspberry Pi полезен, если туннель должен работать при спящем ноутбуке, выходе из системы и обычной работе. GhostlyShare подходит для длительных сессий, если удобнее приложение или CLI, а не ручные сервисы.
Содержание
Кратко: используйте Raspberry Pi для постоянного туннеля
Raspberry Pi — хороший коннектор Cloudflare Tunnel, если сайт, панель, вебхук или лабораторный сервис должны быть доступны без зависимости от ноутбука. Это не единственный вариант, GhostlyShare тоже проще для длительной работы.
| Нужно | Используйте | Почему |
|---|---|---|
| Постоянный хост для домашнего сервиса | Cloudflare Tunnel на Raspberry Pi | Pi может работать постоянно, перезагружаться предсказуемо и запускать cloudflared как Linux-сервис. |
| Предпросмотр, вебхук или управляемый доступ | GhostlyShare | GhostlyShare управляет туннелем через приложение или CLI, что проще, чем вручную настраивать cloudflared. |
| Приложение для продакшена с усиленной изоляцией | VPS или управляемый хостинг | Публичный сервер проще контролировать, резервировать и отделять от домашней сети. |
Простая архитектура: посетитель, Cloudflare, Pi, локальный сервис
Cloudflare Tunnel поддерживает исходящее соединение. Raspberry Pi открывает коннектор к Cloudflare, а Cloudflare связывает публичный хост с локальным сервисом, например localhost:3000 или адресом LAN.
Посетитель обращается к вашему публичному имени хоста и к точке доступа Cloudflare, а не к порту маршрутизатора в вашей домашней сети.
Cloudflare управляет публичной точкой доступа, DNS-зоной, маршрутизацией туннеля и путём запроса для этого имени хоста.
cloudflared работает на Pi и поддерживает открытые исходящие соединения с Cloudflare.
Основное приложение может работать на localhost, другом порту или на хосте в LAN, доступном для Pi.
Не рассматривайте это как полную защиту приватности от всех. Это в основном предотвращает доступ посетителей и случайных сканирований к вашему домашнему роутеру или прямое определение источника.
Подготовьте Raspberry Pi перед установкой cloudflared
Большинство проблем с туннелем не связаны с Cloudflare. Они вызваны нестабильным устройством, изменяющимся адресом локального сервиса или файлом конфигурации, недоступным для пользователя сервиса.
Начните с Raspberry Pi OS или Debian, обновите систему и выбирайте 64-битную версию, если устройство это поддерживает.
Обеспечьте Pi надёжное сетевое подключение, предпочтительно проводной Ethernet или резервирование DHCP, если сервис обращается к хостам LAN.
Убедитесь, что приложение работает локально, прежде чем подключать Cloudflare, DNS или systemd.
Не открывайте панели администратора случайно. Размещайте приватные инструменты за Cloudflare Access или держите их локально.
Выбор оборудования: комплект Raspberry Pi 5, а не только плата
Для туннельного соединения комплект Raspberry Pi 5 безопаснее, чем просто плата. Вам нужна плата, стабильный блок питания USB-C, охлаждение или вентилятор в корпусе и надёжное хранилище, прежде чем обвинять Cloudflare в случайных разрывах.
Комплект Raspberry Pi 5 для небольшого домашнего сервера Cloudflare Tunnel
Ищите комплект Raspberry Pi 5 с надёжным блоком питания USB-C, охлаждением, корпусом и хранилищем. 4 ГБ достаточно для cloudflared; 8 ГБ лучше, если на Pi также работает приложение.
Предпочитайте официальный блок питания Raspberry Pi 27W USB-C или эквивалент 5V/5A и не пренебрегайте охлаждением. Слабое питание и перегрев могут выглядеть как нестабильность туннеля, даже если конфигурация cloudflared правильная.
Инструкция по настройке Cloudflare Tunnel на Raspberry Pi
Используйте панель Cloudflare или официальную документацию для актуальной команды установки пакета под архитектуру вашего Pi. Команды ниже — это безопасный порядок действий, а не гарантия неизменности URL пакетов.
Шаг 1: обновите Pi и проверьте архитектуру
Сначала установите обновления, затем проверьте архитектуру, чтобы скопировать правильную команду установки cloudflared с Cloudflare.
sudo apt update
sudo apt upgrade -y
dpkg --print-architectureШаг 2: установка cloudflared по актуальной официальной команде
Используйте панель Cloudflare или документацию для получения актуальной команды Linux, соответствующей вашей архитектуре. Проверьте бинарный файл после установки.
# Paste the current official Cloudflare install command for your Pi here.
cloudflared --versionШаг 3: аутентификация и создание именованного туннеля
Авторизуйте зону Cloudflare, создайте именованный туннель и скопируйте UUID туннеля из вывода.
cloudflared tunnel login
cloudflared tunnel create home-piШаг 4: создание явного файла config.yml
Замените UUID туннеля, имя хоста, локальный сервис и путь к учётным данным перед запуском. Правило fallback должно оставаться последним.
mkdir -p ~/.cloudflared
nano ~/.cloudflared/config.ymltunnel: <tunnel-uuid>
credentials-file: /home/pi/.cloudflared/<tunnel-uuid>.json
ingress:
- hostname: app.example.com
service: http://localhost:3000
- service: http_status:404Шаг 5: проверка, настройка DNS-маршрута и запуск в переднем плане
Проверьте правила входящего трафика, создайте DNS-маршрут и запустите туннель в переднем плане для тестирования с другой сети.
cloudflared tunnel ingress validate
cloudflared tunnel route dns home-pi app.example.com
cloudflared tunnel run home-piЗапуск cloudflared как службы Linux с правильным путём к конфигу
Важный момент в Linux — путь к конфигурации. При установке службы через sudo домашняя папка меняется на root, и служба может не найти конфиг, который вы тестировали под пользователем pi.
Шаг 1 службы: установка с явным указанием пути к конфигу
Это предотвращает распространённую ошибку несоответствия домашней директории при использовании sudo между конфигом пользователя pi и учётной записью службы.
sudo cloudflared --config /home/pi/.cloudflared/config.yml service installШаг 2 службы: включение и проверка статуса
Запустите cloudflared через systemd, затем убедитесь, что используется нужный конфиг и служба работает стабильно.
sudo systemctl enable --now cloudflared
systemctl status cloudflaredШаг 3 службы: просмотр логов и проверка перезапуска
Используйте логи для выявления ошибок пути к конфигу, учётных данных, DNS и локального сервиса до того, как начнёте полагаться на маршрут.
journalctl -u cloudflared -f
sudo systemctl restart cloudflared
systemctl status cloudflaredКонтрольный список для постоянного домашнего туннеля
Домашний туннель становится надёжным, когда перезагрузки, обновления, логи и правила доступа работают без сбоев. Проверьте эти рутинные моменты перед широким распространением URL.
Перезагрузите Pi и убедитесь, что имя хоста доступно без предварительного подключения по SSH.
Размещайте приватные приложения за Cloudflare Access, с надёжной авторизацией или в локальной сети.
Регулярно обновляйте ОС и cloudflared, затем проверяйте работу службы после обновлений.
Не публикуйте логи или скриншоты с ID туннелей, адресами электронной почты, именами хостов или приватными именами сервисов.
Создавайте резервные копии конфигурации, но храните учётные данные туннеля как секреты.
Эта настройка скрывает источник от посетителей, но не скрывает ваш аккаунт Cloudflare, следы домена или действия администратора.
Устранение неполадок: самые важные ошибки в первую очередь
| Симптом | Вероятная причина | Первая проверка |
|---|---|---|
| Страница ошибки Cloudflare вместо приложения | Туннель не работает, неверный URL сервиса или локальное приложение не отвечает. | Выполните systemctl status cloudflared, journalctl и curl локального сервиса на Pi. |
| Сервис работает в фоновом режиме, но не после установки | systemd использует другой домашний каталог или путь к конфигурации. | Переустановите сервис с явным указанием --config пути к /home/pi/.cloudflared/config.yml. |
| Имя хоста не достигает туннеля | DNS-маршрут, имя хоста или зона Cloudflare не связаны с указанным туннелем. | Подтвердите публичное имя хоста в Zero Trust и выполните cloudflared tunnel info home-pi. |
| Административная страница доступна публично | Правило входа указывает на приватный инструмент без слоя доступа. | Переместите его за Cloudflare Access или оставьте сервис доступным только локально. |
Официальная документация, которую стоит проверить перед использованием
Держите открытой официальную документацию Cloudflare при настройке Pi. Названия продуктов, команды пакетов, интерфейсы и ограничения планов могут изменяться.
Руководство по настройке Cloudflare Tunnel Руководство по сервисам Linux Параметры запуска туннеля
Часто задаваемые вопросы о Raspberry Pi и Cloudflare Tunnel
Частые вопросы
Подходит ли Raspberry Pi для Cloudflare Tunnel?
Да, если нужен постоянно работающий коннектор для небольшого домашнего сервера или лабораторного сервиса. Он энергоэффективен, стабилен и проще в постоянном использовании, чем обычный ноутбук.
Нужна ли переадресация портов роутера?
Нет. Cloudflare Tunnel использует исходящие соединения cloudflared к Cloudflare, поэтому посетителям не требуется прямой входящий маршрут к вашему роутеру.
Стоит ли использовать GhostlyShare CLI вместо этого?
Используйте GhostlyShare или ghs CLI для управляемого приложением локального шаринга для превью, вебхуков, скриптового шаринга или длительного доступа, который вы намеренно поддерживаете онлайн. Используйте Raspberry Pi с cloudflared, если хотите полный контроль над файлами сервиса, конфигурацией ingress и операционной системой хоста.
Сделает ли это мой домашний сервер анонимным?
Нет. Это может скрыть источник от посетителей, но данные аккаунта Cloudflare, записи домена, платежи, логи, содержимое и действия администратора всё равно могут связать проект с вами.