Установка Rancher · 4 min read · Sep 10, 2025
Как установить Rancher на сервер Debian 12

Rancher — это платформа управления контейнерами с открытым исходным кодом, предназначенная для упрощения развертывания, управления и управления кластерами Kubernetes. В отличие от дистрибутива Kubernetes, который заменяет сам Kubernetes, Rancher выступает в качестве решения для управления, которое располагается над одним или несколькими кластерами Kubernetes, предоставляя централизованную платформу, с которой администраторы могут контролировать всю свою контейнерную инфраструктуру.
В этом руководстве вы узнаете, как установить Rancher на сервер Debian 12. Вы установите Rancher как один узел через Docker, который также развернет однопользовательский узел Kubernetes сверху.
Предварительные требования
Для начала этого руководства убедитесь, что у вас есть следующее:
- Сервер Debian 12 с минимум 4 ГБ оперативной памяти
- Пользователь без прав root с правами администратора
Установка Docker
Перед установкой Rancher вам нужно убедиться, что Docker установлен на вашей системе. В этом разделе вы установите Docker Engine через официальный репозиторий Docker на систему Debian.
Сначала выполните команду ниже, чтобы обновить индекс пакетов и установить такие пакеты, как ‘ca-certificates’ и ‘curl’.
sudo apt update && sudo apt install ca-certificates curl -yТеперь выполните следующую команду, чтобы добавить GPG-ключ для репозитория Docker.
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.ascЗатем выполните следующую команду, чтобы добавить репозиторий Docker в вашу систему Debian. Это автоматически определит вашу версию Debian.
echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
Теперь, когда вы добавили репозиторий Docker и GPG-ключ, выполните команду ниже, чтобы обновить индекс пакетов и установить Docker Engine на вашу систему. В этом примере вы установите Docker Engine с дополнительными пакетами, такими как Docker Compose и плагин Docker Buildx.
sudo apt update && sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-pluginВведите ‘Y’, чтобы продолжить установку.

После завершения установки проверьте статус службы Docker, используя команду ‘systemctl’ ниже. Вы увидите, что Docker работает и включен на вашем Debian-машине.
sudo systemctl is-enabled docker
sudo systemctl status docker
Наконец, вы можете выполнить команду ‘docker’ ниже, чтобы запустить контейнер ‘hello-word’.
sudo docker run hello-worldЕсли все прошло успешно, вы получите следующее сообщение ‘ Hello World ‘ от Docker.

Установка Rancher
Теперь, когда Docker установлен, вы готовы установить Rancher. В этом разделе вы загрузите образ Rancher, а затем запустите контейнер Rancher через Docker. В этом примере мы будем использовать самоподписанные сертификаты, которые автоматически генерируются контейнером Rancher. Мы также будем использовать последнюю версию образа Rancher.
Загрузите образ Rancher, используя команду ‘docker pull’ ниже. В этом примере мы будем использовать последнюю версию Rancher.
sudo docker pull rancher/rancher:latest
После загрузки образа Rancher выполните команду ‘docker run’, чтобы запустить Rancher. С этим контейнер Rancher будет работать в фоновом режиме и экспортировать порты 80 и 443 на хост-сервере Debian.
sudo docker run -d --restart=unless-stopped \
-p 80:80 -p 443:443 \
--privileged \
rancher/rancher:latestПроверьте статус контейнера, используя команду ниже.
sudo docker psВ выводе ниже вы можете увидеть, что Rancher работает на порту 443. Также вы можете увидеть идентификатор контейнера и имена контейнера.
Кроме того, если у вас возникла ошибка, вы можете проверить журнал Rancher с помощью следующей команды ‘docker’.
docker ps -a
docker log container-name or container idОпция ‘ps -a’ покажет вам контейнеры, которые работают и завершены, а команда ‘docker log’ используется для проверки журналов контейнера.
Настройка Rancher
На этом этапе Rancher работает на вашей системе Debian как контейнер. На следующем шаге вы войдете в панель управления Rancher, чтобы увидеть однопользовательский узел Kubernetes, который работает на вашей установке Rancher.
Откройте веб-браузер и перейдите по IP-адресу вашего сервера Debian, добавив порт 8080, например https://192.168.10.41:8080/. Если ваша установка прошла успешно, вы увидите следующую страницу входа в Rancher.
Вернитесь в терминал и выполните команду ниже, чтобы получить пароль Rancher. Убедитесь, что вы заменили идентификатор контейнера на свой и скопировали свой пароль.
sudo docker logs CONTAINER ID 2>&1 | grep "Bootstrap Password:"Теперь введите свой пароль и нажмите Войти с локальным пользователем.

Далее скопируйте сгенерированный пароль для вашего Rancher и убедитесь, что вы принимаете условия и лицензию.

Теперь вы увидите следующую панель управления Rancher. В приведенном ниже примере вы можете увидеть однопользовательский кластер Kubernetes, созданный с помощью K3s.

Нажмите на локальный кластер Kubernetes, и вы получите больше информации о вашем кластере Kubernetes.

Доступ к кластеру Kubernetes с помощью kubectl
Сначала загрузите KubeConfig на свой локальный компьютер. С панели управления Rancher нажмите на меню файла ниже.
Установите ‘kubectl’ на свою систему с помощью команды ниже. На Debian 12 вы можете установить пакет ‘kubernetes-client‘ через APT.
sudo apt install kubernetes-client -y
Установите значение по умолчанию KUBECONFIG на ваш файл. В этом примере файл KubeConfig называется ‘kubeconfig.yaml’.
export KUBECONFIG=~/kubeconfig.yamlНаконец, выполните команду ‘kubectl’ ниже, чтобы получить список подов во всех пространствах имен Kubernetes.
kubectl get pods --all-namespacesВы увидите, что каждый под для кластера Kubernetes под управлением Rancher работает.

Заключение
Поздравляем! Вы завершили установку Rancher с Docker на сервере Debian 12. Вы узнали, как настроить Rancher и создать кластер Kubernetes на его основе. Наконец, вы также узнали, как взаимодействовать с вашим кластером Kubernetes через клиент Kubernetes ‘kubectl’. Более того, вы можете развернуть свои контейнеризованные приложения в кластер Kubernetes через ‘kubectl’.
Get new posts in your inbox
No spam. Unsubscribe anytime.