# Установка A4 для 1С

Инструкция рассчитана на администратора, который не читал внутренний протокол.

## Требования

- Windows с тонким клиентом 1С 8.3.27 и конфигурацией на БСП 3.1;
- Linux-сервер `x86_64` с Docker и не менее 8 ГиБ доступной памяти на одну
  кабинку редактора;
- частный адрес сервера и свободный TCP-порт 17867;
- комплект выпуска и совпавшие суммы из `SHA256SUMS`.

## 1. Подготовьте сервер

Создайте вне каталога программы ключ длиной не меньше 32 байт и передайте файл
служебному UID контейнера (`65532`). Другие пользователи не должны его читать:

```sh
install -d -m 700 /etc/a4
umask 077
openssl rand -base64 32 > /etc/a4/organization.key
chown 65532:65532 /etc/a4/organization.key
chmod 600 /etc/a4/organization.key
```

Загрузите образ из архива комплекта, сверьте digest с паспортом выпуска и
запустите его только на частном адресе:

```sh
gzip -dc a4-server-2026.4.1-linux-amd64.tar.gz | docker load
docker run -d --name a4-1c \
  --restart unless-stopped \
  --publish 10.0.0.20:17867:17867 \
  --volume /etc/a4/organization.key:/run/secrets/organization.key:ro \
  --volume a4-server-state:/var/lib/a4 \
  --env A4_PUBLIC_URL=http://10.0.0.20:17867 \
  --env A4_ORGANIZATION_KEY_FILE=/run/secrets/organization.key \
  --env A4_VERSION=2026.4.1 \
  --env A4_PROTOCOL=1 \
  --env A4_LATEST_1C_EXTENSION_VERSION=2026.4.1.1 \
  a4-server:2026.4.1@sha256:ЗНАЧЕНИЕ_ИЗ_ПАСПОРТА
```

Не используйте `0.0.0.0` и не открывайте порт в Интернет. Проверка:

```sh
curl --fail http://10.0.0.20:17867/health
```

Ответ должен содержать `version: "2026.4.1"`, `protocol: 1`, четыре формата и
`latestExtensionVersion: "2026.4.1.1"`.

## 2. Установите расширение

1. Остановите пользовательские сеансы и сделайте резервную копию базы.
2. Откройте конфигуратор и раздел расширений конфигурации.
3. Добавьте `A4-1C-2026.4.1.1.cfe`. В списке появится расширение `A4Office`.
4. Снимите у расширения признаки **«Безопасный режим»** и **«Защита от опасных
   действий»**. Это необходимо для записи ключа средствами БСП в
   `БезопасноеХранилище` и для обращения к частному серверу документов. Делайте
   это только после сверки CFE по `SHA256SUMS`; сервер должен оставаться в
   частной сети. Если оставить безопасный режим, 1С отклонит сохранение настройки
   сообщением «Действие недоступно в безопасном режиме».
5. Обновите конфигурацию базы и запустите тонкий клиент.
6. Дайте нужным сотрудникам роль `A4_ОсновнаяРоль`.
7. Откройте **A4: настройка подключения**. Укажите частный адрес сервера
   и ключ организации. Поле ключа скрывает ввод; после сохранения ключ лежит в
   `БезопасноеХранилище` БСП.
8. Повторно откройте настройку. Должны быть видны версии расширения и сервера и
   строка «Версии совместимы».

## 3. Первая проверка

1. Возьмите копии тестовых XLSM, DOCX и PPTX, не рабочие файлы организации.
2. Для каждого файла в карточке нажмите **Открыть в редакторе**.
3. Измените ячейку в F1, текст в A4 и добавьте слайд в P2; сохраните.
4. Убедитесь, что 1С создала новую версию каждого файла и сняла захват.
5. Скачайте версии и откройте их в Excel, Word и PowerPoint. Диалога
   восстановления быть не должно.

## Типовые отказы

| Что видит администратор | Что делать |
|---|---|
| «Сервер отклонил ключ организации» / HTTP 401 | повторно вставить тот же ключ, который смонтирован в контейнер |
| «Сервер документов недоступен» | проверить частный адрес, контейнер и межсетевой экран |
| «Все места редактора заняты» / HTTP 429 | закрыть завершённый сеанс либо увеличить число кабинок после проверки памяти |
| «Обновите расширение до X» | поставить указанную совместимую CFE |
| «Обновите сервер документов до версии Y» | заменить образ по [инструкции обновления](OBNOVLENIE.md) |
| «Объект уже заблокирован» | завершить штатный сеанс редактирования в 1С; блокировку не обходить |