--- title: "Интерфейс Open WebUI для доступа к ИИ-моделям" description: "Интерфейс Open WebUI для доступа к ИИ-моделям по API. Установка, настройка и примеры использования. Документация и инструкции по работе с облачными сервисами Timeweb Cloud." --- # Open WebUI > Полный индекс документации для ИИ-агентов: [llms.txt](https://timeweb.cloud/llms.txt). Open WebUI — это удобный интерфейс чата для моделей, доступ к которым предоставляется через API. С его помощью можно общаться с AI-агентами в привычном формате диалога. Разберемся, как установить Open WebUI и подключить к нему AI-агента. Предполагается, что у вас уже создан AI-агент. Если нет, поможет [наша документация](https://timeweb.cloud/docs/ai-agents), где подробно описано, что такое агент и как его создать. ## Установка Интерфейс можно развернуть как локально на рабочем компьютере, так и на удаленном сервере, если нужен постоянный доступ к чату. > [!NOTE] > Для корректной работы Open WebUI потребуется минимум 2 ГБ ОЗУ. Убедитесь, что у вас установлены `docker` и `docker compose`: ```bash docker --version docker compose version ``` Если вы разворачиваете Open WebUI локально, достаточно создать файл `docker-compose.yaml` с содержимым: ```yaml services: openwebui: image: ghcr.io/open-webui/open-webui:main ports: - "3000:8080" volumes: - open-webui:/app/backend/data volumes: open-webui: ``` Если вы хотите развернуть интерфейс на сервере, для удобства доступа стоит использовать домен и SSL-сертификат. Для этого создайте файл `.env`: ```yaml DOMAIN=openwebui.example.com LETSENCRYPT_EMAIL=admin@example.com TZ=Europe/Moscow ``` В `DOMAIN` укажите домен, на котором будет работать интерфейс. Для домена должна быть настроена A-запись на ваш сервер. `LETSENCRYPT_EMAIL` — почтовый ящик, который будет использоваться для получения сертификата. `TZ` — таймзона. Создайте файл `docker-compose.yaml` со следующим содержимым: ```yaml version: "3.8" services: traefik: image: traefik:v3.1 container_name: traefik restart: unless-stopped command: - "--providers.docker=true" - "--providers.docker.exposedbydefault=false" - "--entrypoints.web.address=:80" - "--entrypoints.websecure.address=:443" - "--certificatesresolvers.myresolver.acme.httpchallenge=true" - "--certificatesresolvers.myresolver.acme.httpchallenge.entrypoint=web" - "--certificatesresolvers.myresolver.acme.email=${LETSENCRYPT_EMAIL}" - "--certificatesresolvers.myresolver.acme.storage=/letsencrypt/acme.json" ports: - "80:80" - "443:443" volumes: - "/var/run/docker.sock:/var/run/docker.sock:ro" - "letsencrypt:/letsencrypt" openwebui: image: ghcr.io/open-webui/open-webui:main container_name: openwebui restart: unless-stopped environment: - TZ=${TZ} - WEBUI_URL=https://${DOMAIN} volumes: - openwebui-data:/app/backend/data labels: - "traefik.enable=true" # HTTPS-роутер - "traefik.http.routers.openwebui.rule=Host(`${DOMAIN}`)" - "traefik.http.routers.openwebui.entrypoints=websecure" - "traefik.http.routers.openwebui.tls.certresolver=myresolver" - "traefik.http.services.openwebui.loadbalancer.server.port=8080" - "traefik.http.services.openwebui.loadbalancer.server.scheme=http" # HTTP-роутер с редиректом на HTTPS - "traefik.http.routers.openwebui-http.rule=Host(`${DOMAIN}`)" - "traefik.http.routers.openwebui-http.entrypoints=web" - "traefik.http.routers.openwebui-http.middlewares=redirect-to-https" # Middleware для редиректа - "traefik.http.middlewares.redirect-to-https.redirectscheme.scheme=https" volumes: openwebui-data: letsencrypt: ``` Сохраните манифест и запустите контейнер: ```shell docker compose up ``` Docker скачает образ и развернет Open WebUI. После появления логотипа в терминале откройте в браузере страницу `http://localhost:3000/` или используйте ваш домен, если интерфейс разворачивается на сервере (в дальнейшем в инструкции будем использовать localhost). ![Scr 20250910 Mnln](https://content.timeweb.com/assets/7778ed8e-34a9-4d32-873a-b23244ee47b6.png?width=2096&height=722) Если загрузилась приветственная страница — установка прошла успешно. ![Scr 20250910 Mopu](https://content.timeweb.com/assets/0d61dedb-cf4b-4d46-838d-16fd573c71c9.png?width=2742&height=1538) _Приветственная страница [Open WebUI](https://openwebui.com/)_ Вернитесь в терминал и остановите контейнер сочетанием `Ctrl+C`, а затем запустите его в фоновом режиме: ```bash docker compose up -d ``` В браузере обновите страницу `http://localhost:3000/`, вы также должны наблюдать приветственную страницу. ## Подключение агента Нажмите на кнопку «Давайте начнем». Заполните данные для создания аккаунта администратора. Если приложение разворачивается локально, можно указать простой пароль, но при установке на сервере с внешним доступом рекомендуем использовать стойкий пароль. Почта, введенная при регистрации, используется только как идентификатор и как логин для входа, никакие письма на нее не приходят. ![Image 20250910141353857](https://content.timeweb.com/assets/86ce3a80-c200-4292-aaac-8d9a67529a91.png?width=1204&height=788) _Создание аккаунта администратора в интерфейсе [Open WebUI](https://openwebui.com/)_ Open WebUI поддерживает два способа подключения агентов: - **Через прямое подключение** — для каждого пользователя указывается собственный API-ключ и URL; - **Для всех пользователей** — настройки подключения задаются один раз в панели администратора и используются по умолчанию. Рассмотрим оба варианта. Прямое подключение После создания аккаунта вы окажетесь в главном рабочем пространстве. Но чтобы подключить агентов, нужно сделать еще пару шагов. Нажмите на имя аккаунта в левом нижнем углу и выберите «Панель администратора». ![Image 20250910141455584](https://content.timeweb.com/assets/7e2bfbb3-82e9-455b-8992-baefeea1ff08.png?width=2790&height=1586) _Интерфейс [Open WebUI](https://openwebui.com/)_ Дальше откройте вкладку «Настройки» → пункт «Подключения» и включите переключатель напротив «Прямые подключения». Сохраните изменения. ![Image 20250910142207787](https://content.timeweb.com/assets/7b50215b-a8e6-4d0d-adb0-4dce2b8b00b7.png?width=2804&height=1590) _Раздел «Настройки» → «Подключения» в интерфейсе [Open WebUI](https://openwebui.com/)_ Теперь перейдем к подключению модели. Вновь нажмите на имя пользователя, но теперь выберите пункт «Настройки». ![Image 20250910142341297](https://content.timeweb.com/assets/51ec1662-6bfb-4fb3-b686-8bf54a6e745b.png?width=2802&height=1590) _Раздел «Настройки» → «Подключения» в интерфейсе [Open WebUI](https://openwebui.com/)_ Перейдите в раздел «Подключения» и нажмите на иконку плюсика. ![Image 20250910142504265](https://content.timeweb.com/assets/c1a845ee-3258-4d78-b65a-f5dc17abb1e8.png?width=1974&height=1328) _Раздел «Подключения» в интерфейсе [Open WebUI](https://openwebui.com/)_ В открывшемся меню укажите: - URL — значение из поля «OpenAI URL» во вкладке «Доступ» на странице агента в панели Timeweb Cloud; - Ключ — [API-токен для доступа к агенту](https://timeweb.cloud/docs/ai-agents/manage-agents/api-access-key) После этого нажмите на кнопку проверки соединения. Если ошибок нет — сохраните. ![Image 20250910154715217](https://content.timeweb.com/assets/f28aec02-aa8c-48c9-ad90-b5bc0b988d47.png?width=2832&height=1598) _Добавление соединения в интерфейсе [Open WebUI](https://openwebui.com/)_ Закройте окно с настройками и нажмите на кнопку «Новый чат». В меню выбора модели у вас отобразится модель вашего AI-агента. Если этого не произошло — обновите страницу браузера и проверьте вновь. ![Image 20250910155234645](https://content.timeweb.com/assets/b8b1d899-3aa9-43f8-ad7b-10a00aacec88.png?width=2796&height=1590) _Окно «Новый чат» в интерфейсе [Open WebUI](https://openwebui.com/)_ Общие настройки подключения Если вы хотите настроить доступ к агенту один раз для всех пользователей, сделайте следующее: Нажмите на имя аккаунта в левом нижнем углу и выберите «Панель администратора». ![Image5](https://content.timeweb.com/assets/93e7554a-2976-474c-aee9-8f7844b76e9e.png?width=1999&height=1137) _Интерфейс [Open WebUI](https://openwebui.com/)_ Перейдите во вкладку «Настройки» и нажмите на иконку плюса рядом с пунктом «API OpenAI». ![Image10](https://content.timeweb.com/assets/51ca4d6f-1580-4737-90b1-a4b8a6ae048e.png?width=1999&height=956) _Раздел «Настройки» → «Подключения» в интерфейсе [Open WebUI](https://openwebui.com/)_ В открывшемся меню укажите: - URL — значение из поля «OpenAI URL» во вкладке «Доступ» на странице агента в панели Timeweb Cloud; - Ключ — [API-токен для доступа к агенту](https://timeweb.cloud/docs/ai-agents/manage-agents/api-access-key) После этого нажмите на кнопку проверки соединения. Если ошибок нет — сохраните. ![Image11](https://content.timeweb.com/assets/3653286d-0d58-46f2-aa3c-b81ad3401f0c.png?width=1999&height=951) _Добавление соединения в интерфейсе [Open WebUI](https://openwebui.com/)_ Закройте окно с настройками и нажмите на кнопку «Новый чат». В меню выбора модели у вас отобразится модель вашего AI-агента. Если этого не произошло — обновите страницу браузера и проверьте вновь. ![Image8](https://content.timeweb.com/assets/bf90eb29-16fd-4836-92e4-d39ee930a483.png?width=1999&height=1138) _Окно с новым чатом в интерфейсе [Open WebUI](https://openwebui.com/)_ На этом установка и настройка Open WebUI завершена.