﻿Plank Connector для Windows Server
==================================

Коннектор даёт Plank доступ к вашей базе 1С и к одной папке обмена файлами —
изнутри вашей сети, без открытия входящих портов. Он работает в фоне от имени
SYSTEM, запускается сам при старте сервера и не требует, чтобы кто-то был
залогинен.

Что в архиве
  Install-PlankConnector.ps1    установка и обновление
  Uninstall-PlankConnector.ps1  удаление
  connector.exe                 коннектор
  rclone.exe, cloudflared.exe   отдают папку обмена и держат исходящий туннель
  run-connector.cmd             запускается задачей планировщика

Перед установкой
  1. Опубликуйте базу 1С на веб-сервере с «Стандартным интерфейсом OData»
     (Конфигуратор → Администрирование → Публикация на веб-сервере).
  2. Заведите в 1С отдельного пользователя для Plank с правами на нужные
     документы и справочники.
  3. Разрешите серверу ИСХОДЯЩИЕ соединения:
       - TCP 443 до enroll.plank.md
       - TCP и UDP 7844 до Cloudflare (region1.v2.argotunnel.com,
         region2.v2.argotunnel.com)
     Входящие порты открывать не нужно.

Установка
  1. Распакуйте архив в любую временную папку (например, на рабочий стол).
  2. Правый клик по «Пуск» → «Терминал (администратор)» или
     «Windows PowerShell (администратор)», затем:

       cd <папка, куда распаковали>
       powershell -ExecutionPolicy Bypass -File .\Install-PlankConnector.ps1

  3. Ответьте на вопросы:
       - адрес базы 1С, например  http://srv-1c/buh
         (тот, что открывается в браузере; без /odata/...)
       - пользователь и пароль 1С для Plank
       - папка обмена (по умолчанию C:\PlankFiles). Сетевой диск вида Z:\
         задача от SYSTEM не видит — укажите путь \\сервер\папка.
  4. Скрипт проверит 1С и сеть, установит коннектор в C:\PlankConnector,
     зарегистрирует задачу «PlankConnector» и запустит её.
  5. Передайте нам файл  C:\PlankConnector\connection.txt
     В нём постоянная ссылка и ключ доступа — отправляйте только нам и только
     в защищённом канале. Пароль 1С в этот файл не попадает.

Где хранится пароль 1С
  Только в C:\PlankConnector\1c-accounts.json на этом сервере. Папка
  C:\PlankConnector доступна только SYSTEM и администраторам. Коннектор сам
  подставляет пароль в запросы к 1С — Plank его не видит.

Обновление
  Скачайте новый архив, распакуйте во временную папку и запустите
  Install-PlankConnector.ps1 так же, как при установке. Настройки, пароль
  и постоянная ссылка сохранятся; старая версия попадёт в
  C:\PlankConnector\backup-<дата>.
  Изменить адрес 1С, пароль или папку:  ...\Install-PlankConnector.ps1 -Reconfigure

Управление
  Состояние:   Get-ScheduledTask PlankConnector
  Остановить:  Stop-ScheduledTask PlankConnector
  Запустить:   Start-ScheduledTask PlankConnector
  Журнал:      C:\PlankConnector\connector.log
  Удалить:     powershell -ExecutionPolicy Bypass -File C:\PlankConnector\Uninstall-PlankConnector.ps1

Если что-то не так
  Пришлите нам C:\PlankConnector\connector.log — паролей в нём нет.
  «Туннель не поднялся» почти всегда означает закрытый исходящий порт 7844.
  Ответ 401 от адреса 1С, который «не похож на 1С», означает, что перед базой
  стоит ещё одна авторизация (шлюз хостинга) — напишите нам, это решается.

Подробнее: https://plank.md/ru/download/server
