A4 для 1С
Сотрудник открывает книгу Excel прямо из карточки файла в 1С, правит её в браузере и сохраняет. 1С сама создаёт новую версию файла: не нужно выгружать книгу, искать её в папке и загружать обратно. Администратор ставит один сервер в сети организации и одно расширение в базу; файлы не уходят во внешнее облако.
Что умеет
В Windows, в тонком клиенте, с конфигурацией на БСП 3.1:
- в карточке файла есть команда «Открыть в редакторе»; книга открывается в редакторе A4 Таблица в браузере;
- после сохранения 1С создаёт новую версию файла штатным механизмом;
- книга с макросами (
.xlsm) сохраняется целиком: число частей файла не меняется, проект VBA остаётся байт в байт прежним; - сохранённую версию открывает Microsoft Excel без диалога восстановления — только обычное предупреждение о макросах;
- форма настройки показывает версии расширения и сервера и строку «Версии совместимы»;
- при обновлении адрес сервера и ключ организации переносятся сами; при откате возвращаются в прежний вид.
Как работает
- Где живут файлы. Книга хранится в 1С, как и раньше. Версии и блокировки остаются под управлением 1С; сервер их не заменяет.
- Путь документа. Тонкий клиент передаёт книгу серверу документов в частной сети. Сотрудник правит её в браузере. После сохранения сервер возвращает книгу в 1С, и 1С записывает новую версию.
- Что не уходит из сети. Документ идёт только между тонким клиентом 1С, сервером организации и браузером сотрудника. Внешней передачи нет. Сервер не публикуется в Интернет.
- Что пишется в журнал. Запуск, ошибки и число сохранений. Без содержимого документов и без ключей.
Требования
- Windows с тонким клиентом 1С:Предприятие 8.3 и конфигурацией на БСП 3.1;
- Linux-сервер
x86_64с Docker; не меньше 8 ГиБ свободной памяти на одно рабочее место редактора; - частный адрес сервера и свободный TCP-порт
17867; - комплект выпуска, у которого совпали суммы из
SHA256SUMS; - права администратора в конфигураторе и резервная копия базы.
Установка
1. Подготовьте сервер
Создайте ключ организации длиной не меньше 32 байт вне каталога программы. Отдайте файл служебному пользователю контейнера (UID 65532); другие пользователи читать его не должны:
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 с паспортом выпуска и запустите сервер только на частном адресе. Вместо ЧАСТНЫЙ_АДРЕС подставьте адрес сервера в сети организации; номера версий — из блока «Скачать» внизу страницы.
gzip -dc a4-server-ВЕРСИЯ_СЕРВЕРА-linux-amd64.tar.gz | docker load
docker run -d --name a4-1c \
--restart unless-stopped \
--publish ЧАСТНЫЙ_АДРЕС:17867:17867 \
--volume /etc/a4/organization.key:/run/secrets/organization.key:ro \
--volume a4-server-state:/var/lib/a4 \
--env A4_PUBLIC_URL=http://ЧАСТНЫЙ_АДРЕС:17867 \
--env A4_ORGANIZATION_KEY_FILE=/run/secrets/organization.key \
--env A4_VERSION=ВЕРСИЯ_СЕРВЕРА \
--env A4_PROTOCOL=1 \
--env A4_LATEST_1C_EXTENSION_VERSION=ВЕРСИЯ_РАСШИРЕНИЯ \
a4-server:ВЕРСИЯ_СЕРВЕРА@sha256:DIGEST_ИЗ_ПАСПОРТА
- не публикуйте порт на
0.0.0.0и не открывайте его в Интернет; - ключ подключается к контейнеру только на чтение;
- состояние сервера лежит в отдельном томе — при обновлении его не удаляют;
- образ запускается по точному digest, а не по метке.
Проверка:
curl --fail http://ЧАСТНЫЙ_АДРЕС:17867/health
В ответе должны быть protocol: 1, а поля version и latestExtensionVersion — как в блоке «Скачать».
2. Установите расширение
- Остановите пользовательские сеансы и сделайте резервную копию базы.
- Откройте конфигуратор, раздел расширений конфигурации.
- Добавьте файл расширения
.cfeиз комплекта. В списке появится расширениеA4Office. - Снимите у расширения признаки «Безопасный режим» и «Защита от опасных действий». Без этого 1С не сохранит ключ в безопасном хранилище БСП и не обратится к серверу. Делайте это только после сверки файла по
SHA256SUMS; сервер должен оставаться в частной сети. - Обновите конфигурацию базы и запустите тонкий клиент. В клиент-серверном варианте профиль безопасности должен разрешать расширению HTTP(S)-обращения только к частному адресу сервера A4 и работу БСП с безопасным хранилищем; доступ в Интернет не нужен.
- Дайте нужным сотрудникам роль
A4_ОсновнаяРоль. - Откройте A4: настройка подключения. Укажите частный адрес сервера и ключ организации. Поле ключа скрывает ввод.
- Откройте настройку ещё раз. Должны быть видны версии расширения и сервера и строка «Версии совместимы».
3. Первая проверка
- Возьмите копию тестовой книги
.xlsm, не рабочий файл. - В карточке файла нажмите «Открыть в редакторе».
- Измените одну ячейку и сохраните.
- Убедитесь, что 1С создала новую версию и сняла захват.
- Скачайте новую версию и откройте её в Excel. Диалога восстановления быть не должно.
Обновление и откат
SHA256SUMS. Проверьте, что активных сеансов нет: /health должен вернуть activeSessions: 0. Ключ организации и том состояния лежат вне образа — не копируйте их в каталог выпуска.Сервер
- Загрузите новый архив (
docker load) и запишите digest. - Убедитесь, что в старом контейнере нет активных сеансов, и остановите его. Файл ключа и прежний том не удаляйте.
- Создайте том
a4-server-state, один раз перенесите в него содержимое прежнего тома и запустите новый образ с тем же ключом, новым томом и точным digest. - Проверьте
/health: новая версия,protocol: 1, активных сеансов 0.
Расширение
У расширения сменилось техническое имя, поэтому это управляемая замена, а не штатное «Обновить из файла».
- Остановите сеансы пользователей и сделайте резервную копию базы.
- Не удаляйте прежнее расширение. Добавьте новое рядом, снимите у него безопасный режим и защиту от опасных действий, обновите конфигурацию базы.
- Дайте пользователям роль
A4_ОсновнаяРольвместо прежней. Прежнее расширение пока остаётся установленным, но неактивным. - Откройте форму настройки. При первом открытии A4 сам переносит адрес и ключ, проверяет, что ключ читается, и только потом удаляет старые значения. Вводить их заново не нужно.
- Убедитесь, что адрес подхвачен, сервер отвечает и версии совместимы.
- Только после этого снимите прежнее расширение, снова обновите конфигурацию базы и повторите первую проверку.
Откат
- Убедитесь, что активных сеансов нет.
- В форме «Администрирование → Настройка подключения» нажмите «Подготовить откат к …» (номер прежней версии). Команда один раз возвращает адрес и ключ в формат прежней версии. Ключ не показывается и не пишется в файл.
- Остановите новый контейнер и запустите прежний образ по сохранённому digest с прежними ключом и томом.
- Снимите
A4Officeи установите сохранённый прежний файл расширения. - Проверьте
/healthи повторите первую проверку на копии файла.
Долго работать на прежней версии не рекомендуем: в ней ключ хранился в общих настройках. После повторного обновления перенос сработает снова.
Безопасность
- Сервер слушает только частный адрес сети организации.
- На сервере ключ организации лежит в файле с правами
600вне образа. В 1С он хранится средствами БСП в безопасном хранилище; в общих настройках остаётся только адрес. - Значения ключа нет ни в файле базы, ни в пользовательской выгрузке.
- На каждый открытый документ сервер выдаёт отдельный случайный токен сеанса. Он действует только для этого документа и не заменяет ключ организации.
- Документы и ключи в журнал не пишутся.
- Если редактор прервался, сохранение не подтверждается. Неактивное рабочее место удаляется по тайм-ауту.
- Смена ключа: замените файл на сервере, перезапустите контейнер и введите новое значение в форме настройки.
Сообщая о проблеме, не прикладывайте ключ организации и рабочие файлы.
Типовые отказы
| Что видно | Что делать |
|---|---|
| «Действие недоступно в безопасном режиме» | Снять у расширения «Безопасный режим» и «Защиту от опасных действий» (шаг 4 установки) |
| «Сервер отклонил ключ организации» / HTTP 401 | Вставить тот же ключ, который смонтирован в контейнер |
| «Сервер документов недоступен» | Проверить частный адрес, контейнер и межсетевой экран |
| «Все места редактора заняты» / HTTP 429 | Закрыть завершённый сеанс или добавить мест, проверив память сервера |
| «Обновите расширение до X» | Поставить указанную совместимую версию расширения |
| «Обновите сервер документов до версии Y» | Заменить образ по разделу «Обновление и откат» |
| «Объект уже заблокирован» / файл занят другим пользователем | Закончить прежний сеанс редактирования в 1С; блокировку не обходить |
| Ошибка связи при сохранении | Не загружать файл вручную поверх исходного. Передать администратору точный текст сообщения и время |
Откроется в редакторе A4 Документ прямо в браузере. Скачать документ можно там же: «Файл → Скачать».
Скачать
| Файл | Размер | Назначение |
|---|---|---|
A4-1C.cfe | 26 756 байт | расширение конфигурации 2026.4.4 (техническое имя A4Office): документы, таблицы и презентации |
a4-server-linux-amd64.tar.gz | 223 411 077 байт | архив образа сервера 2026.4.4: A4 Таблица (xlsx/xlsm), A4 Документ (docx), A4 Презентация (pptx), linux/amd64 |
USTANOVKA-ADMIN.md | 6 345 байт | установка для администратора |
OBNOVLENIE.md | 5 262 байт | обновление с прежних версий и откат |
POLZOVATEL.md | 1 239 байт | памятка пользователю |
BEZOPASNOST.md | 3 455 байт | безопасность и хранение ключа |
PASPORT.md | 1 060 байт | паспорт выпуска: digest образа и SHA-256 архива |
SHA256SUMS | 910 байт | контрольные суммы всех файлов |
Адреса файлов постоянные: по ним всегда лежит текущая версия, имена — без номера версии. В комплекте («Скачать комплект») те же файлы лежат под полными именами (A4-1C-2026.4.4.cfe, a4-server-2026.4.4-linux-amd64.tar.gz) — для проверки командой shasum -a 256 -c SHA256SUMS.
Сведения о выпуске
| Что | Значение |
|---|---|
| Версия продукта | 2026.4.4 (расширение 2026.4.4, сервер 2026.4.4, протокол обмена 1): документы в A4 Документе, таблицы в A4 Таблице, презентации в A4 Презентации |
Ответ /health | version: "2026.4.4", protocol: 1, latestExtensionVersion: "2026.4.4" |
| Архитектура сервера | linux/amd64 |
Digest образа a4-server | sha256:d5f4593d267abd625d396196db35ead84f4d1d07777f1566e7e808fa92dd5123 |
Контрольные суммы
23670c433d3cd6e55133e29efdef90a3f6c87d7a10d01bf2759ab77767eb9519 A4-1C-2026.4.4.cfe
cd67de49c1a5c5e32c4f9e6420dacaffdf06ea32d59753db95a746efb2638545 BEZOPASNOST.md
904dda6ba26fabbee68a704d72cf455213c9c1db4b6fccbaead290f6cb373dad CHANGELOG.md
cb6077d07afe841aa701dcd518265748337d3eda7339acfe37ecac6d5967cf58 OBNOVLENIE.md
38d5def808588f8fec74dfb8e62403c6a8fad524f847350d309df52700ffc482 PASPORT.md
666a4c2e1be39c5f0762035e957d57c5f167d3c6f1154240eebb5fd42f5260a7 POLZOVATEL.md
e3af9ebdad8e3970ec085876e2bd93548bad64dff87d1806e63f64e3cb82d724 README.md
726264a3ddd7c8aeec43aea01f79b932832b68756d957e2d770c03a5d93ee15f USTANOVKA-ADMIN.md
5087114c101d71292e891c8cf2951eda2e09ee2fe0933da0de2cd320561932cc VYPUSK.md
414db5953806df0a7aed824a8d838b1aeaecb39b8f8b41db7509f6ca4854f0f6 a4-server-2026.4.4-linux-amd64.tar.gz
2e891d2cabaf5ed28d16a349e2eb932c63a2d6515e9a3787cbcb550007fa28fb server-evidence.json
Проверка комплекта после скачивания:
shasum -a 256 -c SHA256SUMS