110 lines
4.7 KiB
Markdown
110 lines
4.7 KiB
Markdown
|
# Инструкция по настройке логотипов и favicon в Open WebUI
|
|||
|
|
|
|||
|
|
## Проблема: Логотипы не меняются
|
|||
|
|
|
|||
|
|
Open WebUI может использовать скомпилированные статические файлы или кешировать логотипы. Есть несколько способов решения.
|
|||
|
|
|
|||
|
|
## Способ 1: Через Admin Panel (рекомендуется)
|
|||
|
|
|
|||
|
|
Это самый надежный способ, так как настройки сохраняются в базе данных.
|
|||
|
|
|
|||
|
|
1. Откройте Open WebUI: `https://odo.iieasy.ru` или `http://localhost:3001`
|
|||
|
|
2. Войдите как администратор
|
|||
|
|
3. Перейдите в **Settings** → **Appearance** (или **Admin** → **Settings** → **Appearance`)
|
|||
|
|
4. Найдите секцию **Logo** или **Branding**
|
|||
|
|
5. Загрузите ваши файлы:
|
|||
|
|
- **Logo**: `media/logo.png` или `media/logo-light.svg`
|
|||
|
|
- **Favicon**: `media/favicon.png` или `media/favicon.ico`
|
|||
|
|
6. Сохраните изменения
|
|||
|
|
|
|||
|
|
## Способ 2: Через скрипт ребрендинга + перезапуск
|
|||
|
|
|
|||
|
|
1. Убедитесь, что файлы есть в папке `media/`:
|
|||
|
|
```bash
|
|||
|
|
ls -la media/logo* media/favicon*
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
2. Запустите скрипт ребрендинга:
|
|||
|
|
```bash
|
|||
|
|
cd /home/its/iiEasyWeb
|
|||
|
|
sudo ./scripts/rebrand.sh
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
3. **ВАЖНО:** Перезапустите контейнер для применения изменений:
|
|||
|
|
```bash
|
|||
|
|
sudo docker compose restart open-webui
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
4. Очистите кеш браузера:
|
|||
|
|
- **Chrome/Edge**: `Ctrl+Shift+Delete` → Очистить кеш изображений
|
|||
|
|
- **Firefox**: `Ctrl+Shift+Delete` → Кеш
|
|||
|
|
- Или используйте режим инкогнито: `Ctrl+Shift+N`
|
|||
|
|
|
|||
|
|
5. Обновите страницу с принудительной перезагрузкой: `Ctrl+F5` или `Ctrl+Shift+R`
|
|||
|
|
|
|||
|
|
## Способ 3: Прямое копирование в контейнер
|
|||
|
|
|
|||
|
|
Если скрипт не работает, скопируйте файлы вручную:
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# Найдите где находятся favicon файлы
|
|||
|
|
docker exec open-webui find /app -name "favicon.png" -o -name "favicon.ico" | head -5
|
|||
|
|
|
|||
|
|
# Скопируйте ваши файлы
|
|||
|
|
docker cp media/favicon.png open-webui:/app/web/build/_app/immutable/favicon.png
|
|||
|
|
docker cp media/logo.png open-webui:/app/web/build/_app/immutable/logo.png
|
|||
|
|
|
|||
|
|
# Перезапустите контейнер
|
|||
|
|
docker compose restart open-webui
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Способ 4: Использование монтированного volume
|
|||
|
|
|
|||
|
|
Файлы уже смонтированы в контейнер через volume:
|
|||
|
|
- `./media:/app/media:ro`
|
|||
|
|
- `./media:/app/web/static/custom:ro`
|
|||
|
|
|
|||
|
|
Можно использовать эти пути в настройках Open WebUI или скопировать оттуда:
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# Скопировать из смонтированной папки в нужное место
|
|||
|
|
docker exec open-webui cp /app/media/logo.png /app/web/build/_app/immutable/logo.png
|
|||
|
|
docker exec open-webui cp /app/media/favicon.png /app/web/build/_app/immutable/favicon.png
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Проверка
|
|||
|
|
|
|||
|
|
После применения изменений:
|
|||
|
|
|
|||
|
|
1. Откройте браузер в режиме инкогнито
|
|||
|
|
2. Откройте `https://odo.iieasy.ru` или `http://localhost:3001`
|
|||
|
|
3. Проверьте favicon во вкладке браузера
|
|||
|
|
4. Проверьте логотип на странице
|
|||
|
|
|
|||
|
|
## Если ничего не помогает
|
|||
|
|
|
|||
|
|
1. Проверьте в браузере (F12 → Network), какие файлы запрашиваются:
|
|||
|
|
- Откройте вкладку Network
|
|||
|
|
- Обновите страницу
|
|||
|
|
- Найдите запросы к `favicon.*` или `logo.*`
|
|||
|
|
- Посмотрите полный URL запроса
|
|||
|
|
|
|||
|
|
2. Найдите эти файлы в контейнере и замените их:
|
|||
|
|
```bash
|
|||
|
|
docker exec open-webui find /app -path "*/favicon*" -o -path "*/logo*" | grep -v node_modules
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
3. Используйте Admin Panel Open WebUI - это самый надежный способ.
|
|||
|
|
|
|||
|
|
## Настройка через переменные окружения (если поддерживается)
|
|||
|
|
|
|||
|
|
Некоторые версии Open WebUI поддерживают переменные окружения для логотипов. Добавьте в `docker-compose.yml`:
|
|||
|
|
|
|||
|
|
```yaml
|
|||
|
|
environment:
|
|||
|
|
- CUSTOM_LOGO_URL=/static/custom/logo.png
|
|||
|
|
- CUSTOM_FAVICON_URL=/static/custom/favicon.ico
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Но лучше использовать Admin Panel, так как настройки сохраняются в базе данных.
|