Агент сервера 1С:Предприятие — критически важный компонент для работы распределённых информационных баз, но иногда его требуется удалить. Причины могут быть разными: миграция на другую инфраструктуру, ошибки в работе кластера, конфликты версий или просто очистка тестового окружения. Однако неправильное удаление агента часто приводит к "мусору" в реестре, некорректной работе оставшихся компонентов 1С или даже сбоям в операционной системе.
В этой статье вы найдёте три проверенных способа удаления — через стандартный деинсталлятор, командную строку и ручную очистку. Мы также разберём типичные ошибки (например, Error 1920 при удалении службы) и объясним, как полностью очистить систему от следов агента, включая скрытые папки и записи в реестре. Если вы администрируете сервер 1С или просто хотите "почистить" рабочую машину — эта инструкция поможет сделать всё аккуратно.
Что такое агент сервера 1С и зачем его удалять
Агент сервера 1С:Предприятие (ragent.exe) — это служба, которая обеспечивает взаимодействие между клиентскими приложениями и сервером 1С. Он отвечает за:
- 🔄 Маршрутизацию запросов от клиентов к кластеру серверов
- 📡 Балансировку нагрузки между рабочими процессами (
rmngr) - 🔒 Аутентификацию пользователей и управление сессиями
- 📊 Логирование событий кластера
Причины для удаления агента сервера:
- 🚀 Обновление версии 1С — при переходе на новую платформу (например, с 8.3.20 на 8.3.22) иногда требуется полная переустановка компонентов.
- 🐛 Критические ошибки — если агент "падает" с ошибками типа
Не удалось подключиться к кластеру (2147483649)илиRAS connection failed. - 🧹 Очистка тестового окружения — после экспериментов с кластером или учебными базами.
- 🔄 Миграция на облако — при переходе на 1С:Fresh или другие SaaS-решения локальный агент становится ненужным.
⚠️ Внимание: Если вы удаляете агент на рабочем сервере, предварительно перенесите все базы на другой кластер или сделайте резервную копию через 1С:Администрирование серверов. Без агента клиенты не смогут подключиться к серверным базам!
Подготовка к удалению: что нужно сделать до деинсталляции
Перед удалением агента сервера 1С выполните обязательные шаги, чтобы избежать потери данных или сбоев в работе других компонентов:
- Остановите службу агента.
Откройте
services.msc(нажмитеWin + R, введите команду) и найдите службу1С:Предприятие 8.3. Агент сервера. Остановите её, кликнув правой кнопкой →Остановить. - Отключите все сессии пользователей.
Через
1С:Администрирование серверов(илиracв командной строке) проверьте активные соединения и принудительно завершите их командой:rac cluster --cluster=TCP://localhost:1541 disconnect --all - Сделайте резервную копию конфигураций.
Экспортируйте списки информационных баз и настройки кластера через
1С:Администрирование серверовили скопируйте папкуC:\ProgramData\1C\1cv8\conf. - Проверьте зависимости.
Если на сервере установлены другие компоненты 1С (например, Сервер 1С:Предприятия или Хранилище конфигураций), их работа может нарушиться. Уточните зависимости в документации к вашей версии платформы.
⚠️ Внимание: Если вы удаляете агент на сервере с репликацией кластера, сначала исключите этот узел из списка рабочих серверов через rac cluster, иначе возможны конфликты данных.
☑️ Подготовка к удалению агента сервера 1С
Способ 1: Удаление через стандартный деинсталлятор
Самый простой метод — использовать встроенный деинсталлятор 1С. Он корректно удаляет службу, файлы и большинство записей в реестре.
Пошаговая инструкция:
Откройте
Панель управления → Программы и компоненты(илиappwiz.cplчерезWin + R).Найдите в списке
1С:Предприятие 8.3 (x86-64)или аналогичный пункт (название зависит от версии).Кликните
Удалить/Изменить→ выберитеУдалить→ отметьте галочкойАгент сервера(не удаляйте другие компоненты, если они нужны!).Следуйте инструкциям мастера. После завершения перезагрузите сервер.
Возможные ошибки и решения:
- 🔴
Error 1920. Не удалось остановить службу 1С:Предприятие 8.3. Агент сервераРешение: Остановите службу вручную через
services.mscили выполните команду:sc stop "1C:Enterprise 8.3 Server Agent"Затем повторите удаление.
- 🔴
Не удалось получить доступ к файлу C:\Program Files\1cv8\8.3.22.123\bin\ragent.exeРешение: Закройте все процессы 1С в
Диспетчере задач(включаяrphost,rmngr) и повторите попытку.
⚠️ Внимание: Стандартный деинсталлятор не всегда удаляет папку с логами агента (C:\ProgramData\1C\1cv8\logs\ragent). Если вы хотите полностью очистить систему, удалите её вручную после деинсталляции.
Если после удаления агента в списке программ остались "пустые" пункты 1С (например, без версии), используйте утилиту Microsoft Program Install and Uninstall Troubleshooter для очистки.
Способ 2: Удаление через командную строку (для опытных пользователей)
Если стандартный деинсталлятор не работает (например, из-за повреждённых файлов) или вам нужно автоматизировать процесс, используйте командную строку.
Шаг 1. Остановите службу агента:
sc stop "1C:Enterprise 8.3 Server Agent"
Шаг 2. Удалите службу из системы:
sc delete "1C:Enterprise 8.3 Server Agent"
Шаг 3. Удалите файлы агента. По умолчанию они находятся в:
C:\Program Files\1cv8\<версия>\bin\ragent.exeC:\ProgramData\1C\1cv8\conf\*.cfg(конфигурационные файлы)C:\ProgramData\1C\1cv8\logs\ragent\(логи)
Шаг 4. Очистите реестр. Откройте regedit и удалите ветки:
HKEY_LOCAL_MACHINE\SOFTWARE\1C\1Cv8\8.3\<версия>\ServerAgentHKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\1C:Enterprise 8.3 Server Agent
Критическая информация: Если вы удаляете агент на сервере с несколькими версиями 1С, проверьте, что не удаляете общие компоненты (например, 1Cv8.cdn или gacutil). Это может сломать работу других версий платформы.
Как проверить, что агент полностью удалён?
Запустите команду sc query "1C:Enterprise 8.3 Server Agent". Если служба не найдена, а файлы ragent.exe отсутствуют в папках — агент удалён.
Способ 3: Ручное удаление с очисткой следов
Этот метод подходит, если предыдущие способы не сработали или вы хотите полностью стереть все следы агента сервера из системы. Используйте его с осторожностью!
1. Удаление файлов и папок:
- 📁 Удалите папку с бинарниками агента:
C:\Program Files\1cv8\<версия>\bin\(например,8.3.22.1854). - 📁 Очистите папки с конфигурациями и логами:
C:\ProgramData\1C\1cv8\conf\(удалите файлы с расширением.cfg, связанные с агентом).C:\ProgramData\1C\1cv8\logs\ragent\(можно удалить всю папку). - 📁 Проверьте временные файлы:
C:\Users\<Пользователь>\AppData\Local\Temp\1C\.
2. Очистка реестра:
Откройте regedit и вручную удалите следующие ключи (предварительно сделайте бэкап реестра!):
| Раздел реестра | Что удалять | Примечание |
|---|---|---|
HKEY_LOCAL_MACHINE\SOFTWARE\1C |
Ветку 1Cv8\8.3\<версия>\ServerAgent |
Содержит настройки кластера |
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services |
Ключ 1C:Enterprise 8.3 Server Agent |
Описание службы |
HKEY_CLASSES_ROOT\Installer\Products |
Ключи с GUID, содержащие "1Cv8" или "ServerAgent" | Информация об установке |
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall |
Ключи с названием "1С:Предприятие" | Список установленных компонентов |
⚠️ Внимание: Не удаляйте ключи, связанные с другими компонентами 1С (например, Client или Server), если они вам нужны. Ошибка в реестре может привести к неработоспособности всей платформы.
3. Проверка портов. Агент сервера по умолчанию использует порты 1540-1541 (для кластера) и 1560-1591 (для рабочих процессов). После удаления проверьте, что эти порты освободились, командой:
netstat -ano | findstr "1540 1541 1560"
Ручное удаление — самый радикальный метод. Используйте его только если другие способы не сработали или вам нужно полностью очистить систему от следов 1С.
Типичные ошибки при удалении и их решения
Даже при следовании инструкциям могут возникать ошибки. Разберём самые распространённые:
| Ошибка | Причина | Решение |
|---|---|---|
Error 1722. Не удалось запустить службу 1С:Предприятие 8.3. Агент сервера |
Служба повреждена или отсутствуют права | Удалите службу через sc delete, затем перезагрузите ПК |
Не удалось удалить папку: доступ запрещён |
Файлы заблокированы процессом или недостаточно прав | Запустите Unlocker или удалите папку в Безопасном режиме |
Кластер не найден (2147483649) после удаления |
Остались записи в реестре или конфигурационных файлах | Проверьте папку C:\ProgramData\1C\1cv8\conf\ и удалите файлы *.cfg |
Ошибка 0x80070005: Отказано в доступе |
Недостаточно прав администратора | Запустите командную строку от имени Администратора |
🔹 Если после удаления агент продолжает "висеть" в процессах:
- Откройте
Диспетчер задач→ найдите процессыragent.exe,rphost.exe,rmngr.exe. - Завершите их принудительно.
- Проверьте автозагрузку:
msconfig → Службыи отключите все службы 1С.
🔹 Если при повторной установке агента возникает ошибка:
Скорее всего, в системе остались "мусорные" файлы. Используйте утилиту 1C Cleaner (неофициальную) или вручную очистите папки, указанные в Способе 3.
Проверка системы после удаления
Чтобы убедиться, что агент сервера удалён полностью, выполните следующие проверки:
1. Проверка служб:
sc query | find "1C"
В выводе не должно быть службы 1C:Enterprise 8.3 Server Agent.
2. Проверка процессов:
tasklist | find "ragent"
Если процессов нет — агент остановлен.
3. Проверка портов:
netstat -ano | findstr "1540 1541"
Порты 1540-1541 должны быть свободны (статус LISTENING отсутствует).
4. Проверка реестра:
Откройте regedit и убедитесь, что нет ключей с названием ServerAgent или ragent.
⚠️ Внимание: Если вы планируете установить агент заново, перед установкой перезагрузите сервер. Это очистит кэш служб и предотвратит конфликты.
После удаления агента проверьте работу других компонентов 1С (например, Сервер 1С:Предприятия). Если они используют общие библиотеки, может потребоваться их перерегистрация через regsvr32.
FAQ: Частые вопросы по удалению агента сервера 1С
Можно ли удалить агент сервера, не удаляя сам сервер 1С?
Да, агент и сервер 1С — это разные компоненты. При удалении агента через стандартный деинсталлятор вы можете снять галочку с пункта Сервер 1С:Предприятия, оставив его работать. Однако без агента клиенты не смогут подключаться к серверным базам через сеть.
Как удалить агент, если он не отображается в "Программах и компонентах"?
Возможно, установка была повреждена. Используйте Способ 2 (удаление через командную строку) или Способ 3 (ручная очистка). Также проверьте наличие агента в списке служб (services.msc).
После удаления агента перестали работать все базы 1С. Что делать?
Скорее всего, вы удалили не только агент, но и сервер 1С или повредили конфигурационные файлы кластера. Восстановите базы из резервной копии или переустановите сервер 1С, указав путь к существующим данным (C:\ProgramData\1C\1cv8\data\).
Как удалить агент на Linux-сервере?
На Linux удаление выполняется через пакетный менеджер. Например, для Debian/Ubuntu:
sudo apt-get remove 1c-enterprise83-server-agent
Для RHEL/CentOS:
sudo yum remove 1C_Enterprise83-server-agent
После удаления проверьте отсутствие процессов ragent и очистите папки /opt/1C/v8.3/<версия>/ и /var/log/1C/.
Можно ли автоматизировать удаление агента на нескольких серверах?
Да, для этого используйте скрипт на PowerShell или Batch. Пример скрипта для удаления через командную строку:
@echo off
sc stop "1C:Enterprise 8.3 Server Agent"
sc delete "1C:Enterprise 8.3 Server Agent"
rmdir /s /q "C:\Program Files\1cv8\8.3.22.123\bin\"
reg delete "HKLM\SOFTWARE\1C\1Cv8\8.3\8.3.22.123\ServerAgent" /f
Для удалённого выполнения используйте PsExec из пакета Sysinternals.