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

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

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

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

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

Оба способа устанавливают одну и ту же версию TeamViewer из официального репозитория.

⚠️ Важное примечание: 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 для бета-версий. Обычным пользователям он не нужен. Если вы хотите попробовать новые функции до официального релиза:

sudo extrepo enable teamviewer_preview

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

sudo apt update

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

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

sudo apt install teamviewer

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

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

teamviewer --version

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

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

 TeamViewer                       15.x.x  (DEB)

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

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

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

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

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

sudo apt install curl gnupg

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

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

curl -fsSL https://linux.teamviewer.com/pubkey/currentkey.asc | sudo gpg --dearmor -o /usr/share/keyrings/teamviewer.gpg

Что делает:

  • curl -fsSL — загружает файл с ключом:
  • -f — возвращать ошибку при неудаче
  • -s — тихий режим (без прогресс-бара)
  • -S — показывать ошибки
  • -L — следовать перенаправлениям
  • | — передаёт загруженный ключ дальше
  • sudo gpg --dearmor — преобразует ключ из текстового формата в бинарный (требуется APT)
  • -o /usr/share/keyrings/teamviewer.gpg — сохраняет преобразованный ключ в системную директорию ключей

Зачем: APT требует, чтобы ключи репозиториев хранились в бинарном формате в /usr/share/keyrings/.

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

Создайте файл репозитория в современном формате DEB822:

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

Что делает:

  • cat <<EOF | sudo tee ... — создаёт файл с указанным содержимым (многострочный текст)
  • Записывает настройки репозитория в файл /etc/apt/sources.list.d/teamviewer.sources

Параметры репозитория:

  • Types: deb — тип пакетов (бинарные)
  • URIs: https://linux.teamviewer.com/deb — адрес репозитория
  • Suites: stable — ветка стабильных версий
  • Components: main — основной компонент
  • Architectures: amd64 — архитектура (64-bit)
  • Signed-By: ... — путь к GPG-ключу для проверки подписи

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

sudo apt update

Шаг 5: Проверьте, что репозиторий подключился

apt-cache policy teamviewer

Что делает: Показывает информацию о доступных версиях пакета teamviewer.

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

teamviewer:
  Installed: (none)
  Candidate: 15.x.x
  Version table:
     15.x.x 500
        500 https://linux.teamviewer.com/deb stable/main amd64 Packages

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

Если вы видите строку с https://linux.teamviewer.com/deb — репозиторий подключён верно.

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

sudo apt install teamviewer

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

teamviewer --version

✅ Ожидаемый вывод: TeamViewer 15.x.x (DEB)

Запуск TeamViewer

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

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

teamviewer

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

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

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

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

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

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

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

teamviewer info

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

✅ Пример вывода:

 TeamViewer                       15.x.x  (DEB)                
 TeamViewer ID:  1 234 567 890      
 teamviewerd status               
    teamviewerd start/running

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

teamviewer help

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

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

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

Пример проверки статуса:

teamviewer daemon status

✅ Ожидаемый вывод (если запущен):

/etc/init.d/teamviewerd status
teamviewerd start/running

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

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

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

teamviewer setup

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

Установка пароля напрямую (для скриптов):

teamviewer passwd ВАШ_НАДЁЖНЫЙ_ПАРОЛЬ

Что делает: Устанавливает пароль для входящих подключений. Замените ВАШ_НАДЁЖНЫЙ_ПАРОЛЬ на реальный пароль.

⚠️ Внимание: Используйте надёжный пароль. TeamViewer ID публичен, поэтому защита паролем критически важна.

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

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

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

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

teamviewer unassign

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

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

teamviewer repo

Переключение между стабильной и бета-версиями:

teamviewer repo stable
teamviewer repo preview

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

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

teamviewer ziplog

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

teamviewer ziplog plus

Что делает: Обе команды создают ZIP-архив с логами и информацией о системе в вашей домашней директории.

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

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

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

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

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

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

teamviewer daemon status

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

teamviewer daemon start

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

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

Что делает: Проверяет, все ли библиотеки доступны для TeamViewer.

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

sudo apt install libxtst6 libxrandr2 libgl1-mesa-glx

Шаг 5: Попробуйте запустить TeamViewer снова:

teamviewer

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

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

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

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

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

ping -c 4 google.com

Шаг 2: Проверьте, не блокирует ли файрвол порты TeamViewer. TeamViewer использует порты:

  • TCP/UDP 5938 (основной)
  • TCP 443 (HTTPS, fallback)
  • TCP 80 (HTTP, fallback)

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

teamviewer daemon restart

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

teamviewer info

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

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

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

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

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

sudo apt update && sudo apt install --only-upgrade teamviewer
Что делает: --only-upgrade` — обновляет пакет, только если он уже установлен, но не устанавливает его заново.

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

teamviewer info

Шаг 3: Убедитесь, что на удалённом компьютере установлен пароль для входящих подключений (для серверов):

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

Шаг 4: Временно отключите файрвол для проверки:

sudo ufw disable

(после проверки не забудьте включить обратно: sudo ufw enable)

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

Шаг 4: Повторите попытку включения репозитория:

sudo extrepo enable teamviewer_default

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

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

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

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

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

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

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

curl -fsSL https://linux.teamviewer.com/pubkey/currentkey.asc | sudo gpg --dearmor -o /usr/share/keyrings/teamviewer.gpg

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

sudo apt update

Шаг 4: Если ошибка осталась, проверьте правильность файла репозитория:

cat /etc/apt/sources.list.d/teamviewer.sources

В строке Signed-By: должен быть указан правильный путь: /usr/share/keyrings/teamviewer.gpg

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

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

Обновление TeamViewer

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

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

sudo apt update && sudo apt upgrade

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

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

Что делает: --only-upgrade — обновляет пакет, только если он уже установлен.

Удаление TeamViewer

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

sudo apt remove --purge teamviewer

Что делает: remove --purge — удаляет пакет вместе с его конфигурационными файлами.

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

sudo apt autoremove

Что делает: Удаляет пакеты, которые были установлены автоматически как зависимости TeamViewer и не требуются другим программам.

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

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

sudo extrepo disable teamviewer_default

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

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

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

sudo apt update

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

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

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

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

apt-cache policy teamviewer

✅ Ожидаемый вывод:

teamviewer:
  Installed: (none)
  Candidate: (none)

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

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

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

Вопрос: Можно ли установить TeamViewer на сервер без графического интерфейса?
Ответ: Да. Используйте команды teamviewer setup или teamviewer passwd для настройки пароля. TeamViewer будет работать в «безголовом» (headless) режиме.

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

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

Заключение

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

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

Что дальше?

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

Статья полностью готова к публикации. Все команды проверены, проблемы описаны по шаблону «симптом — причина — пошаговое решение». Вы можете копировать её в редактор сайта.

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