Требования

Перед установкой OneAPA убедитесь, что ваша система соответствует минимальным требованиям.

Аппаратные требования

Сервер 1С

Параметр	Минимум	Рекомендуется
Процессор	2 ядра	4+ ядра
Оперативная память	4 ГБ	8+ ГБ
Дисковое пространство	10 ГБ	50+ ГБ

Сервер Proxy

Параметр	Минимум	Рекомендуется
Процессор	2 ядра	4+ ядра
Оперативная память	4 ГБ	8+ ГБ
Дисковое пространство	5 ГБ	20+ ГБ

Proxy-сервер может работать на том же сервере, что и 1С, или на отдельной машине.

Для локальных моделей (Ollama)

Параметр	Минимум	Рекомендуется
Оперативная память	16 ГБ	32+ ГБ
GPU (NVIDIA)	8 ГБ VRAM	16+ ГБ VRAM
Дисковое пространство	50 ГБ	100+ ГБ

Для качественной работы локальных моделей рекомендуется использовать GPU с CUDA.

Программные требования

1С:Предприятие

Компонент	Версия
Платформа 1С:Предприятие	8.3.20 и выше
Режим совместимости конфигурации	8.3.18 и выше

Docker (альтернатива Python)

Компонент	Версия
Docker	20.10 и выше
Docker Compose	2.0 и выше (опционально)

Операционная система

Сервер 1С:

• Windows Server 2016, 2019, 2022

• Windows 10/11 (для разработки)

• Linux (Astra Linux, Ubuntu, CentOS) с 1С для Linux

Сервер Proxy:

• Windows 10/11, Windows Server 2016+

• Linux (Ubuntu 20.04+, Debian 11+, CentOS 8+)

• macOS 12+ (для разработки)

Сетевые требования

Порты

Порт	Назначение	Направление
9000	Proxy Server (HTTP API)	Входящий
9000/ui	Chainlit Web UI	Входящий
443	LLM провайдеры (OpenAI, Yandex)	Исходящий
11434	Ollama (локальные модели)	Входящий/Исходящий

Схема сетевого взаимодействия

┌─────────────────────────────────────────────────────────────────┐
│                     ЛОКАЛЬНАЯ СЕТЬ                               │
│                                                                  │
│  ┌─────────────┐         ┌─────────────┐                        │
│  │  Сервер 1С  │◄───────►│   Proxy     │                        │
│  │             │  :9000  │   Server    │                        │
│  └─────────────┘         └──────┬──────┘                        │
│                                 │                                │
└─────────────────────────────────┼────────────────────────────────┘
                                  │ :443 (HTTPS)
                                  ▼
                          ┌─────────────┐
                          │    LLM      │
                          │  Provider   │
                          │ (Internet)  │
                          └─────────────┘

Для полностью изолированной сети (Ollama)

┌─────────────────────────────────────────────────────────────────┐
│                     ИЗОЛИРОВАННАЯ СЕТЬ                           │
│                                                                  │
│  ┌─────────────┐         ┌─────────────┐         ┌───────────┐  │
│  │  Сервер 1С  │◄───────►│   Proxy     │◄───────►│  Ollama   │  │
│  │             │  :9000  │   Server    │  :11434 │  Server   │  │
│  └─────────────┘         └─────────────┘         └───────────┘  │
│                                                                  │
│            ❌ Доступ в Интернет не требуется ❌                  │
└─────────────────────────────────────────────────────────────────┘

Требования к LLM провайдеру

OpenAI

Требование	Описание
Аккаунт	Зарегистрированный аккаунт OpenAI
API ключ	Активный API ключ (sk-...)
Баланс	Положительный баланс на счёте
Доступ	Доступ к API из вашей сети

Yandex GPT

Требование	Описание
Аккаунт	Аккаунт Yandex Cloud
IAM токен	Действующий IAM токен
Folder ID	ID каталога в Yandex Cloud
Сервис	Активированный сервис YandexGPT

Ollama (локальные модели)

Требование	Описание
Установка	Установленный Ollama
Модель	Загруженная модель (llama3, mistral и др.)
Ресурсы	Достаточно RAM/VRAM для модели

Чек-лист проверки

1С:Предприятие

• Установлена платформа 8.3.20 или выше

• Есть доступ к конфигуратору

• Есть права на объединение конфигураций

Docker

• Docker

• Доступ к командной строке с правами администратора

Сеть

• Порт 9000 свободен для Proxy

• Есть доступ к LLM провайдеру (или настроен Ollama)

LLM провайдер

• Получен API ключ

• Проверен доступ к API (опционально)

Проверка версий

Docker

# Проверка версии Docker
docker --version

# Ожидаемый вывод: Docker version 20.10.x или выше

1С:Предприятие

В режиме "1С:Предприятие" → меню "Справка" → "О программе":

1С:Предприятие 8.3 (8.3.20.xxxx)

Что делать, если требования не выполнены

Проблема	Решение
Старая версия 1С	Обновите платформу до 8.3.20+
Нет Docker	Установите Docker Desktop (Windows/Mac) или docker.io (Linux)
Порт 9000 занят	Измените порт Proxy в конфигурации
Нет доступа к LLM	Настройте Ollama для локальной работы

Далее

После проверки требований переходите к установке:

Установка