INTEGRITY Документация

Создайте туннель с локальным управлением

Следуйте этому пошаговому руководству, чтобы запустить свой первый туннель с помощью CLI.

Предварительные требования

Прежде чем начать, убедитесь, что вы:

1. Скачайте и установите cloudflared

  1. Скачать cloudflared на вашем компьютере. Перейдите в скачивания странице, чтобы найти нужный пакет для вашей ОС.

  2. Переименуйте исполняемый файл в cloudflared.exe

  3. В PowerShell перейдите в папку Downloads и выполните .\cloudflared.exe --version. Должна выводиться версия cloudflared. Обратите внимание, что cloudflared.exe может быть cloudflared-windows-amd64.exe или cloudflared-windows-386.exe если вы его не переименовали.

    PS C:\Users\Administrator\Downloads\cloudflared-stable-windows-amd64> .\cloudflared.exe --version

Чтобы скачать и установить cloudflared:

brew install cloudflared

Как вариант, можно скачайте последний релиз для Darwin amd64 напрямую.

Debian и Ubuntu APT

Используйте менеджер пакетов apt, чтобы установить cloudflared на совместимых машинах.

  1. Добавьте ключ подписи пакетов Cloudflare:
sudo mkdir -p --mode=0755 /usr/share/keyrings
curl -fsSL https://pkg.cloudflare.com/cloudflare-main.gpg | sudo tee /usr/share/keyrings/cloudflare-main.gpg >/dev/null
  1. Добавьте apt-репозиторий Cloudflare в свои apt-репозитории:
echo "deb [signed-by=/usr/share/keyrings/cloudflare-main.gpg] https://pkg.cloudflare.com/cloudflared any main" | sudo tee /etc/apt/sources.list.d/cloudflared.list
  1. Обновите репозитории и установите cloudflared:
sudo apt-get update && sudo apt-get install cloudflared

RHEL RPM

Используйте менеджер пакетов rpm, чтобы установить cloudflared на совместимых машинах.

  1. Добавьте репозиторий Cloudflare:

    curl -fsSl https://pkg.cloudflare.com/cloudflared.repo | sudo tee /etc/yum.repos.d/cloudflared.repo
  2. Обновите репозитории и установите cloudflared:

    sudo yum update && sudo yum install cloudflared

Arch Linux

cloudflared находится в Arch Linux community репозиторий. Используйте pacman чтобы установить cloudflared на совместимых машинах.

pacman -Syu cloudflared

Прочее

Также вы можете скачать cloudflared исполняемый файл или пакеты для Linux на свою машину и установите их вручную. Перейдите на скачивания странице, чтобы найти нужный пакет для вашей ОС.

Чтобы собрать последнюю версию cloudflared из исходного кода:

git clone https://github.com/cloudflare/cloudflared.git
cd cloudflared
make cloudflared
go install github.com/cloudflare/cloudflared/cmd/cloudflared

В зависимости от того, где вы установили cloudflared, вы также можете переместить его в известный путь.

mv /root/cloudflared/cloudflared /usr/bin/cloudflared

2. Аутентифицируйте cloudflared

cloudflared tunnel login

Выполнение этой команды приведёт к следующему:

3. Создайте туннель и присвойте ему имя

cloudflared tunnel create <NAME>

Выполнение этой команды приведёт к следующему:

В выводе команды обратите внимание на UUID туннеля и путь к файлу учетных данных туннеля.

Убедитесь, что туннель был успешно создан, выполнив команду:

cloudflared tunnel list

4. Создайте файл конфигурации

  1. В вашем .cloudflared директории создайте config.yml файл в любом текстовом редакторе. Этот файл настраивает туннель для маршрутизации трафика от заданного origin к выбранному вами имени хоста.

  2. Добавьте следующие поля в файл:

    Если вы подключаете опубликованное приложение:

    url: http://localhost:8000
    tunnel: <Tunnel-UUID>
    credentials-file: /root/.cloudflared/<Tunnel-UUID>.json

    Если вы подключаете частная сеть:

    tunnel: <Tunnel-UUID>
    credentials-file: /root/.cloudflared/<Tunnel-UUID>.json
    warp-routing:
      enabled: true
  3. Убедитесь, что конфигурационный файл был успешно создан, выполнив команду:

    cat config.yml

5. Начните маршрутизацию трафика

  1. Чтобы направить опубликованное приложение через туннель:

    cloudflared tunnel route dns <UUID or NAME> <hostname>

    Эта команда создаст CNAME запись, указывающую на <UUID>.cfargotunnel.com.

2. Если вы подключаете частную сеть, направьте частный IP-адрес или CIDR через туннель:

cloudflared tunnel route ip add <IP/CIDR> <UUID or NAME>

3. Убедитесь, что маршрут успешно установлен:

cloudflared tunnel route ip show

6. Запустите туннель

Запустите туннель, чтобы проксировать входящий трафик от туннеля к любому количеству служб, запущенных локально на вашем исходном сервере.

cloudflared tunnel run <UUID or NAME>

Если ваш файл конфигурации имеет пользовательское имя или находится не в .cloudflared каталоге добавьте --config флаг и укажите путь.

cloudflared tunnel --config /path/your-config-file.yml run <UUID or NAME>

7. Проверьте туннель

Чтобы получить информацию о только что созданном туннеле, выполните:

cloudflared tunnel info <UUID or NAME>