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, так как настройки сохраняются в базе данных.
|