Установка TeamViewer на Debian 13, 12, 11: полное руководство

TeamViewer — это популярное приложение для удалённого доступа к компьютерам. С его помощью вы можете:

  • Управлять рабочим столом другого компьютера, как если бы сидели перед ним
  • Передавать файлы между устройствами
  • Организовывать онлайн-встречи и презентации
  • Оказывать техническую поддержку родственникам или коллегам

В этом руководстве я покажу два способа установки TeamViewer на Debian:

  • Рекомендованный — через утилиту extrepo (проще, автоматическое управление ключами)
  • Ручной — для тех, кто хочет полностью контролировать процесс или использовать в скриптах

⚠️ Важное примечание: TeamViewer — это проприетарное (закрытое) программное обеспечение. Оно не входит в официальные репозитории Debian, а устанавливается из собственного репозитория TeamViewer.

Оглавление

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

Перед установкой убедитесь, что:

  • У вас есть доступ к интернету
  • Вы имеете права sudo (администратора)

⚠️ ВАЖНО: Проверьте права sudo перед установкой

Если вы не уверены, есть ли у вашего пользователя права администратора, выполните в терминале:

sudo whoami

Что делает: sudo — выполняет команду от имени суперпользователя; whoami — показывает имя текущего пользователя.

✅ Ожидаемый вывод в терминале:

root

❌ Если выводит is not in the sudoers file — сначала пройдите наше руководство по настройке sudo.

Сравнение методов установки TeamViewer

МетодКаналУправление ключамиСложностьДля кого
extrepo
рекомендуемый		Debian extrepoАвтоматическоеНизкаяБольшинство
пользователей
Ручная
настройка		Официальный
репозиторий
TeamViewer		РучноеСредняяОпытные
пользователи,
скрипты

Способ 1: Установка TeamViewer через extrepo (рекомендуемый)

extrepo — это официальный инструмент Debian для управления сторонними репозиториями. Он автоматически скачивает и настраивает GPG-ключи, что делает процесс установки максимально простым и безопасным.

Шаг 1: Установите extrepo

sudo apt install extrepo

Что делает: Устанавливает пакет extrepo — инструмент для управления внешними репозиториями.

Зачем: Без него вы не сможете воспользоваться автоматической настройкой репозитория TeamViewer.

Шаг 2: Включите поддержку non-free политики

TeamViewer — это проприетарное (коммерческое) ПО, поэтому extrepo требует явного разрешения на работу с такими репозиториями.

sudo sed -i 's/# - non-free/- non-free/' /etc/extrepo/config.yaml

Что делает:

  • sed -i — редактирует файл конфигурации на месте
  • s/# - non-free/- non-free/ — заменяет закомментированную строку # - non-free на активную - non-free
  • /etc/extrepo/config.yaml — файл конфигурации extrepo

Зачем: Эта команда «раскомментирует» строку, разрешающую использование репозиториев с проприетарным ПО.

Шаг 3: Включите репозиторий TeamViewer

sudo extrepo enable teamviewer_default

Что делает: Активирует официальный репозиторий TeamViewer со стабильными версиями.

Что ещё бывает: TeamViewer также предоставляет репозиторий teamviewer_preview для бета-версий. Обычным пользователям он не нужен.

Шаг 4: Обновите список пакетов

sudo apt update

Что делает: Обновляет список доступных пакетов из всех подключённых репозиториев, включая только что добавленный TeamViewer.

Шаг 5: Установите TeamViewer (полный клиент)

sudo apt install teamviewer

Что делает: Устанавливает TeamViewer и все необходимые зависимости (библиотеки Qt, компоненты для работы с дисплеем и т.д.).

Шаг 6: (Опционально) Установка TeamViewer Host (для серверов)

Если вам нужен только unattended доступ (без графического интерфейса для управления), установите пакет teamviewer-host:

sudo apt install teamviewer-host

⚠️ Важно: Пакеты teamviewer и teamviewer-host конфликтуют. Установите только один из них.

Шаг 7: Проверьте установку

teamviewer --version

Что делает: Выводит версию установленного TeamViewer.

✅ Ожидаемый вывод в терминале:

 TeamViewer                       15.x.x  (DEB)

(цифры могут отличаться в зависимости от текущей версии)

Способ 2: Ручная установка TeamViewer (для опытных пользователей)

Этот способ даёт полный контроль над процессом. Вы вручную добавляете GPG-ключ и создаёте файл репозитория. Подходит для:

  • Скриптов автоматизации
  • Ситуаций, когда вы не хотите использовать extrepo
  • Обучения (чтобы понять, как устроены APT-репозитории)

Шаг 1: Проверка архитектуры

TEAMVIEWER_ARCH="$(dpkg --print-architecture)"
case "$TEAMVIEWER_ARCH" in
  amd64|arm64|armhf|i386)
    echo "Архитектура $TEAMVIEWER_ARCH поддерживается TeamViewer."
    ;;
  *)
    echo "Ошибка: архитектура $TEAMVIEWER_ARCH не поддерживается TeamViewer."
    exit 1
    ;;
esac

Шаг 2: Установите необходимые пакеты

sudo apt install curl gnupg

Что делает: Устанавливает curl (для загрузки ключа) и gnupg (для работы с GPG-ключами).

Шаг 3: Скачайте и проверьте GPG-ключ TeamViewer

curl -fsSL -o teamviewer.asc https://linux.teamviewer.com/pubkey/currentkey.asc
gpg --show-keys --with-fingerprint teamviewer.asc

✅ Ожидаемый отпечаток: AB29 85BD E164 897B A46E A69A 234F AACB 575B 15D1

Шаг 4: Импортируйте GPG-ключ TeamViewer

sudo gpg --dearmor -o /usr/share/keyrings/teamviewer.gpg teamviewer.asc
rm -f teamviewer.asc

Что делает: Преобразует ключ в бинарный формат (требуется APT) и сохраняет в системную директорию.

Шаг 5: Добавьте репозиторий TeamViewer

cat <<EOF | sudo tee /etc/apt/sources.list.d/teamviewer.sources
Types: deb
URIs: https://linux.teamviewer.com/deb
Suites: stable
Components: main
Architectures: $TEAMVIEWER_ARCH
Signed-By: /usr/share/keyrings/teamviewer.gpg
EOF

Шаг 6: Обновите список пакетов и проверьте репозиторий

sudo apt update
apt-cache policy teamviewer

✅ Ожидаемый вывод: В строке Candidate должна быть версия, а в таблице версий — https://linux.teamviewer.com/deb.

Шаг 7: Установите TeamViewer

sudo apt install teamviewer

Запуск TeamViewer

После установки вы можете запустить TeamViewer несколькими способами.

Запуск из терминала

teamviewer

Что делает: Запускает графический интерфейс TeamViewer. Если фоновый процесс (демон) не запущен, он будет запущен автоматически.

Запуск из меню приложений

Среда рабочего столаПуть в меню
GNOMEActivities → Показать приложения → TeamViewer
KDE PlasmaМеню приложений → Интернет → TeamViewer
XfceМеню приложений → Internet → TeamViewer

Управление TeamViewer через командную строку

TeamViewer предоставляет множество команд для управления без графического интерфейса. Это особенно полезно для серверов.

Основные информационные команды

Просмотр вашего ID и статуса:

teamviewer info

Что делает: Показывает ваш TeamViewer ID (нужен другим для подключения) и статус демона.

Справка по всем командам:

teamviewer help

Управление демоном TeamViewer

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

КомандаЧто делает
teamviewer daemon statusПоказывает, запущен ли демон
teamviewer daemon startЗапускает демон вручную
teamviewer daemon stopОстанавливает демон
teamviewer daemon restartПерезапускает демон
(после изменения конфигурации)
teamviewer daemon enableВключает автозапуск демона при загрузке
системы
teamviewer daemon disableОтключает автозапуск демона

Управление репозиторием

Просмотр текущих настроек репозитория:

teamviewer repo

Просмотр списка пакетов TeamViewer, видимых APT:

teamviewer repo list

Настройка для серверов (без графического интерфейса)

Если вы устанавливаете TeamViewer на сервер без графической оболочки, используйте эти команды для настройки автоматического доступа.

Интерактивная настройка:

teamviewer setup

Что делает: Запускает мастер настройки для headless-режима (без графики).

Безопасная установка пароля (без сохранения в истории):

IFS= read -rsp 'TeamViewer password: ' TEAMVIEWER_PASSWORD
printf '\n'
sudo teamviewer passwd "$TEAMVIEWER_PASSWORD"
unset TEAMVIEWER_PASSWORD

Что делает: Пароль не сохраняется в истории команд (.bash_history).

Привязка к аккаунту TeamViewer

Привязать устройство к вашему аккаунту:

teamviewer assignment --id=ВАШ_ID_НАЗНАЧЕНИЯ

Отвязать устройство:

teamviewer unassign

Сбор логов для поддержки

Если возникли проблемы, создайте архив с логами для отправки в службу поддержки TeamViewer:

teamviewer ziplog

С расширенной информацией о системе:

teamviewer ziplog plus

Решение типичных проблем

8.1 Ошибка: TeamViewer не запускается после установки

Симптом: После выполнения teamviewer ничего не происходит, или появляется сообщение об ошибке.

Причина: Отсутствуют необходимые графические библиотеки или демон не запущен.

Пошаговое решение:

Шаг 1: Проверьте статус демона:

teamviewer daemon status

Шаг 2: Если демон не запущен, запустите его:

teamviewer daemon start

Шаг 3: Проверьте, какие библиотеки отсутствуют:

ldd /opt/teamviewer/tv_bin/Teamviewer | grep "not found"

Шаг 4: Если есть сообщения о недостающих библиотеках, установите их:

sudo apt install libxtst6 libxrandr2 libgl1-mesa-glx

8.2 Ошибка: TeamViewer не показывает ID

Симптом: Команда teamviewer info не показывает TeamViewer ID или показывает ошибку.

Причина: Демон TeamViewer не может подключиться к серверам TeamViewer (проблемы с сетью или файрволом).

Пошаговое решение:

Шаг 1: Проверьте подключение к интернету:

ping -c 4 google.com

Шаг 2: Перезапустите демон:

teamviewer daemon restart

Шаг 3: Подождите 10-20 секунд и проверьте ID снова:

teamviewer info

8.3 Ошибка: Не удаётся подключиться к удалённому компьютеру

Симптом: Вы ввели ID и пароль, но подключение не устанавливается.

Причина: Проблемы с сетью, брандмауэром или версиями TeamViewer.

Пошаговое решение:

Шаг 1: Убедитесь, что на обоих компьютерах установлена совместимая версия TeamViewer:

sudo apt update && sudo apt install --only-upgrade teamviewer

Шаг 2: Проверьте, что на удалённом компьютере демон запущен:

teamviewer info

Шаг 3: Для сервера убедитесь, что установлен пароль:

teamviewer passwd НОВЫЙ_ПАРОЛЬ

8.4 Ошибка: TeamViewer не устанавливается через extrepo

Симптом: Команда sudo extrepo enable teamviewer_default выводит ошибку.

Причина: Не включена поддержка non-free политики или проблемы с сетью.

Пошаговое решение:

Шаг 1: Проверьте, что в файле /etc/extrepo/config.yaml строка non-free раскомментирована:

grep non-free /etc/extrepo/config.yaml

✅ Ожидаемый вывод: - non-free (без # в начале)

Шаг 2: Если строка закомментирована, выполните:

sudo sed -i 's/# - non-free/- non-free/' /etc/extrepo/config.yaml

Шаг 3: Обновите список доступных репозиториев extrepo:

sudo extrepo update

8.5 Ошибка: GPG key error при ручной установке

Симптом: При sudo apt update появляется ошибка о недостоверной подписи репозитория TeamViewer.

Причина: Неправильно импортирован GPG-ключ или ключ устарел.

Пошаговое решение:

Шаг 1: Удалите старый ключ:

sudo rm /usr/share/keyrings/teamviewer.gpg

Шаг 2: Скачайте и импортируйте ключ заново (с проверкой отпечатка):

curl -fsSL -o teamviewer.asc https://linux.teamviewer.com/pubkey/currentkey.asc
gpg --show-keys --with-fingerprint teamviewer.asc
sudo gpg --dearmor -o /usr/share/keyrings/teamviewer.gpg teamviewer.asc
rm -f teamviewer.asc

Шаг 3: Обновите список пакетов:

sudo apt update

8.6 Плохая работа удалённого управления под Wayland

Симптом: Удалённый пользователь подключается, но не может управлять экраном или видит артефакты.

Причина: Поддержка Wayland в TeamViewer находится в стадии эксперимента.

Решение: Выйдите из системы и выберите сессию Xorg (X11) на экране входа. На Debian 13 может потребоваться установить пакет:

sudo apt install gnome-session-xsession

Затем перезагрузитесь и выберите Xorg.

Обновление TeamViewer

Так как TeamViewer установлен из репозитория, обновления приходят через стандартные механизмы APT.

Обновить все пакеты (включая TeamViewer):

sudo apt update && sudo apt upgrade

Обновить только TeamViewer:

sudo apt update
sudo apt install --only-upgrade teamviewer

Удаление TeamViewer

Шаг 1: Удалите пакет TeamViewer

sudo apt remove --purge teamviewer

Шаг 2: Удалите зависимости, которые больше не нужны

sudo apt autoremove

Шаг 3: Удалите репозиторий

Если вы использовали extrepo:

if command -v extrepo >/dev/null 2>&1; then
  sudo extrepo disable teamviewer_default || true
fi
sudo rm -f /etc/apt/sources.list.d/extrepo_teamviewer_default.sources
sudo rm -f /var/lib/extrepo/keys/teamviewer_default.asc

Если вы настраивали репозиторий вручную:

sudo rm /etc/apt/sources.list.d/teamviewer.sources
sudo rm /usr/share/keyrings/teamviewer.gpg

Шаг 4: Обновите список пакетов

sudo apt update

Шаг 5: Удалите пользовательские данные (опционально)

⚠️ Внимание: Эти команды безвозвратно удалят все настройки TeamViewer, историю подключений и сохранённые пароли.

rm -rf ~/.config/teamviewer
rm -rf ~/.local/share/teamviewer

Шаг 6: Проверьте удаление

apt-cache policy teamviewer

✅ Ожидаемый вывод: Installed: (none)

Чек-лист: что проверить после установки

  • [ ] TeamViewer установлен: teamviewer --version показывает версию
  • [ ] Демон запущен: teamviewer daemon status → start/running
  • [ ] TeamViewer ID отображается: teamviewer info показывает ID
  • [ ] Графический интерфейс открывается: teamviewer запускает окно
  • [ ] TeamViewer есть в меню приложений (для графических сред)
  • [ ] Для сервера: установлен пароль через teamviewer passwd

Часто задаваемые вопросы (FAQ)

Вопрос: Почему extrepo требует включения non-free политики?

Ответ: TeamViewer — это проприетарное (коммерческое) ПО, а Debian разделяет репозитории на free (свободное ПО) и non-free (несвободное). Включение non-free — это ваше осознанное согласие на установку такого ПО.

Вопрос: В чём разница между extrepo и ручной установкой?

Ответ: Оба способа устанавливают один и тот же TeamViewer из одного и того же репозитория. Отличие только в процессе настройки: extrepo автоматически управляет GPG-ключами, ручной способ даёт больше контроля.

Вопрос: В чём разница между teamviewer и teamviewer-host?

Ответ: teamviewer — полный клиент с графическим интерфейсом для управления. teamviewer-host — версия только для unattended доступа (без GUI), подходит для серверов. Пакеты конфликтуют, устанавливайте только один.

Вопрос: TeamViewer бесплатен?

Ответ: TeamViewer имеет бесплатную лицензию для некоммерческого использования (помощь друзьям и семье, личное использование). Для коммерческого использования требуется покупка лицензии.

Вопрос: Какой порт использует TeamViewer?

Ответ: Основной порт — 5938 (TCP и UDP). Если он заблокирован, TeamViewer пытается использовать 443 (HTTPS) или 80 (HTTP) как fallback.

Заключение

Теперь TeamViewer установлен на вашем Debian. Вы можете:

  • Удалённо управлять другими компьютерами
  • Принимать входящие подключения (с вашего ID и пароля)
  • Передавать файлы между устройствами
  • Настроить сервер для работы без графического интерфейса

Что дальше?

  • Настройте файрвол для TeamViewer, если используете его на сервере
  • Узнайте о других способах удалённого доступа: OpenSSH для командной строки или XRDP для удалённого рабочего стола
  • Изучите альтернативы TeamViewer с открытым исходным кодом: RustDesk, AnyDesk

Связанные статьи:

Связанные записи