feat: refactor to remove www

resolves #4
This commit is contained in:
Chris Milne 2026-04-24 12:47:12 +01:00
parent 2d84b9056a
commit a1cca9205f
322 changed files with 1 additions and 30 deletions

View file

@ -0,0 +1,24 @@
---
title: "Сборка Butter Box"
nav_order: 3
has_children: true
permalink: /build-a-box/
---
# Сборка Butter Box
Ещё нет Butter Box? Вы можете легко собрать своё устройство. Выберите конфигурацию, чтобы начать.
## Конфигурации Butter Box
Программное обеспечение Butter Box в настоящее время работает на устройствах Raspberry Pi: Pi Zero 2 и Pi 4. Вы можете использовать любое из них. Подробности в сравнительной таблице ниже.
| Устройство | Ёмкость | Комплектующие |
| -------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- | ------------------------------------------------- |
| <strong>Базовая</strong> Raspberry Pi Zero Pi 2<br/><br/><a href="raspberry-pi/basic-box-supplies.mdx">Начать</a> | До 10 человек, на расстоянии около 10 метров | [Список комплектующих](raspberry-pi/basic-box-supplies.mdx) |
| <strong>Расширенная</strong> Raspberry Pi 4 в связке с роутером<br/><br/><a href="raspberry-pi/extend-your-box.mdx">Начать</a> | До 20 человек, на расстоянии около 30 метров при использовании с роутером | [Список комплектующих](raspberry-pi/extend-your-box.mdx) |
| ПК/Ноутбук (amd64) | _Скоро будет_ | _Скоро будет_ |
Мы также изготавливаем и отправляем Butter Box партнёрам по всему миру.
Если вы работаете с сообществом, которому это может быть полезно, мы будем рады сотрудничеству.

View file

@ -0,0 +1,8 @@
---
title: "ПК/Ноутбук"
nav_order: 2
parent: "Сборка Butter Box"
---
# ПК/Ноутбук

View file

@ -0,0 +1,19 @@
---
title: "Источник питания"
nav_order: 3
parent: "Сборка Butter Box"
---
# Источник питания
Если вы хотите, чтобы Butter Box работал полностью автономно и без электричества — это возможно!
Butter Box может работать от розетки, от предварительно заряженного аккумулятора или от аккумулятора с солнечной панелью.
* **Розетка:** Официальный и рекомендуемый блок питания для компьютеров Raspberry Pi (зависит от используемой модели Raspberry Pi)
* **Предварительно заряженный аккумулятор (Power Bank):** Это наиболее распространённый вариант для использования в полевых условиях.
* Портативное зарядное устройство Anker [power bank](https://www.ozon.ru/product/zaryadnoe-ustroystvo-anker-nano-charger-45w-chernyy-a2692l11-3298658513/),
[power bank](https://aliexpress.ru/item/1005011864808436.html)
* **Солнечная панель (с Power Bank):** Используйте небольшую солнечную панель для подзарядки вашего power bank. Это хороший вариант для непрерывной работы устройства в местах без электросети. Использование солнечной панели напрямую без аккумулятора возможно, но нестабильно при переменной облачности.
* Комплекты солнечных панелей: [ozon.ru](https://www.ozon.ru/search/?text=%D0%A1%D0%BE%D0%BB%D0%BD%D0%B5%D1%87%D0%BD%D0%B0%D1%8F+%D0%BF%D0%B0%D0%BD%D0%B5%D0%BB%D1%8C+%D1%81%D0%BA%D0%BB%D0%B0%D0%B4%D0%BD%D0%B0%D1%8F&from_global=true)
<figure><img src="../.gitbook/assets/Screenshot 2025-07-31 at 10.55.41 PM.png" alt=""/><figcaption></figcaption></figure>

View file

@ -0,0 +1,36 @@
---
title: "Основные комплектующие"
nav_order: 1
parent: "Raspberry Pi"
grand_parent: "Сборка Butter Box"
---
# Основные комплектующие
Базовая конфигурация Butter Box — это Raspberry Pi Zero 2 W с картой microSD, на которой установлено программное обеспечение Butter, USB-накопитель и питание от USB-источника, такого как блок питания, power bank или солнечная панель.
В большинстве таких конфигураций Butter Box может комфортно обслуживать **от 4 до 10 подключённых устройств одновременно** без замедления. Возможно подключить и больше, но производительность может снизиться, если все одновременно загружают большие файлы или видео.
Радиус действия составляет около **510 метров** в помещении, в зависимости от модели Raspberry Pi, а также от стен и помех. На открытом воздухе, на открытом пространстве, он иногда может быть больше. Представьте себе радиус действия домашнего Wi-Fi роутера — достаточно, чтобы покрыть класс, кафе, переговорную комнату или небольшое мероприятие на открытом воздухе.
## Комплектующие
* [ ] Raspberry Pi Zero 2W (64 Bit) [ozon.ru/product/raspberry-pi-zero-2-w-c-wifi-i-bluetooth-mikrokompyuter-rasberi-malina-1069765865](https://ozon.ru/product/raspberry-pi-zero-2-w-c-wifi-i-bluetooth-mikrokompyuter-rasberi-malina-1069765865); Или вы можете купить комплект здесь: [ozon.ru/product/kompyuter-v-sborke-2136359684](https://ozon.ru/product/kompyuter-v-sborke-2136359684)
* [ ] Блок питания с кабелем, входящие в комплект Raspberry Pi Zero 2W, или [альтернативный источник питания](../power-supply.mdx)
* [ ] Карта Micro SD: Образы с программным обеспечением Butter обычно занимают менее 16 ГБ (мы рекомендуем 256 ГБ). Медиафайлы, которые люди загружают в чат, сохраняются на карте; они никогда не удаляются.
* [ ] USB-накопитель (минимум 32 ГБ)
* [ ] Адаптеры (по необходимости)
* [ ] Micro USB/штекер на USB A/гнездо
* [ ] Переходник для подключения карты micro SD к вашему ноутбуку (если необходимо)
**Когда у вас будут все комплектующие, переходите к разделу «Установка Butter».**
[install-butter.md](install-butter.mdx)
![](../../assets/images/20250815_142828.jpg)

View file

@ -0,0 +1,64 @@
---
title: "Апгрейд Butter Box"
nav_order: 3
parent: "Raspberry Pi"
grand_parent: "Сборка Butter Box"
---
# Апгрейд Butter Box
Butter Box с увеличенным радиусом действия объединяет Raspberry Pi с отдельным Wi-Fi маршрутизатором, обеспечивая более сильный сигнал и большее количество одновременных подключений.
С маршрутизатором сеть может охватывать 10-30 м и комфортно поддерживать 1020 подключённых устройств одновременно. Эта конфигурация идеально подходит для средней группы людей в помещении среднего размера, например, в учебных классах, на мероприятиях или в общественных пространствах.
## Необходимые материалы
* [ ] Raspberry Pi 4, 5 или Raspberry Pi Zero 2W
* [ ] Маршрутизатор ([Opal (GL-SFT1200) Wireless Travel Router](https://store-us.gl-inet.com/products/united-states-opal-gl-sft1200-gigabit-wireless-router-dual-band-openwrt-ipv6-tor) или аналог)
* [ ] Блок питания и кабели питания для Raspberry Pi и маршрутизатора или [альтернативный источник питания](../power-supply.mdx)
* [ ] Карта Micro SD: образы с программным обеспечением Butter обычно занимают менее 16 ГБ (мы рекомендуем Micro SD карту 256 ГБ). Медиафайлы, которые пользователи загружают в чат, сохраняются на карте и никогда не удаляются.
* [ ] USB-накопитель (минимум 32 ГБ)
* [ ] Адаптеры (при необходимости)
одключение к интернету не требуется._
![](../../assets/images/20250815_142438.jpg)
## Шаги
Чтобы увиличить радиус действия вашего Butter Box, просто подключите маршрутизатор GLi-Net к Butter Box с помощью кабеля Ethernet. Вместо доступа к коробке через портальную точку доступа Wi-Fi (например, butter box или любое имя, которое вы задали в настройках администратора), пользователи будут подключаться к сети Wi-Fi маршрутизатора.
### Подключите Butter Box к источнику питания.
Подключите Butter Box к питанию.
---
### Подключите маршрутизатор
Подключите маршрутизатор к питанию. Затем используйте кабель Ethernet для подключения к Butter Box. Убедитесь, что кабель Ethernet подключён к порту LAN на вашем маршрутизаторе.
---
### Проверьте подключение
Подключитесь к Wi-Fi маршрутизатора. Если вы ещё не настраивали и не использовали этот маршрутизатор, введите пароль по умолчанию, указанный в руководстве пользователя, входящем в комплект. Через 30 секунд откройте http://butterbox.local в браузере.
---
### Отключите точку доступа Wi-Fi Butter Box
Откройте настройки администратора на портале Butter Box. Перейдите в раздел **Безопасный портал**. Отключите точку доступа Wi-Fi. Это скроет сеть Wi-Fi, транслируемую Raspberry Pi, чтобы пользователи не путались, к какой сети подключаться.
---
### Пригласите пользователей подключиться к Wi-Fi маршрутизатора
Теперь пользователи будут подключаться к сети Wi-Fi маршрутизатора, когда захотят подключиться к Butter Box.

View file

@ -0,0 +1,10 @@
---
title: "Raspberry Pi"
nav_order: 1
parent: "Сборка Butter Box"
has_children: true
permalink: /build-a-box/raspberry-pi/
---
# Raspberry Pi

View file

@ -0,0 +1,112 @@
---
title: "Установка Butter"
nav_order: 2
parent: "Raspberry Pi"
grand_parent: "Сборка Butter Box"
---
# Установка Butter
Вам понадобится:
* Настольный компьютер
* Подключение к интернету
* Butter Box
### Скачайте Butter OS для Raspberry Pi
Убедитесь, что размер файла совпадает с размером, указанным на сайте. Иногда браузеры не завершают загрузку, что может привести к повреждению файла.
[https://www.dropbox.com/scl/fo/helpqh3q2oj7ti2ia038m/h?dl=0.&rlkey=cswt4w4zksiuj3eb1oca48yw0](https://www.dropbox.com/scl/fo/helpqh3q2oj7ti2ia038m/h?dl=0.&rlkey=cswt4w4zksiuj3eb1oca48yw0)
> **Информация:**
> Всегда выбирайте последнюю версию файла.
---
### Вставьте карту micro SD в компьютер
Чтобы вставить карту micro SD в компьютер, вам может понадобиться адаптер:
![Пример адаптера (USB-C к Micro SD)](../../assets/images/image.png)
> **Информация:**
> Подключать коробку к компьютеру не нужно.
---
### Запустите Raspberry Pi Imager
После того как вы вставили карту micro SD в компьютер с подключением к интернету, запустите Raspberry Pi Imager на настольном компьютере. Программа проведёт вас через шаги установки операционной системы Butter на карту micro SD.
Если у вас нет Raspberry Pi Imager, вы можете скачать его здесь: [https://www.raspberrypi.com/software/](https://www.raspberrypi.com/software/)
---
### Выберите устройство > **Raspberry Pi Zero 2 W**
После запуска Raspberry Pi Imager вам будет предложено выбрать устройство Raspberry Pi.
<img src="../../.gitbook/assets/Screenshot 2026-02-24 at 9.56.27AM.png" alt=""/>
<p>Выберите Raspberry Pi Zero 2 W (или другое устройство, если у вас не стандартная коробка от Butter HQ)</p>
---
### Выберите операционную систему > Use Custom
* На вкладке ОС выберите **Use Custom** и загрузите файл butter-******.img Убедитесь, что вы **распаковали файл xz** перед использованием.
<figure><img src="../../.gitbook/assets/Screenshot 2026-02-24 at 9.57.31AM.png" alt=""/><figcaption><p>Выберите «Use Custom». Выберите файл .img, который скачали с Dropbox.</p></figcaption></figure>
---
### Выберите хранилище > Выберите карту Micro SD
* На вкладке **Хранилище** выберите **карту Micro SD.**
<figure><img src="../../.gitbook/assets/Screenshot 2026-02-24 at 1.27.37PM.png" alt=""/><figcaption><p>Выберите карту Micro SD.</p></figcaption></figure>
После того как вы всё выбрали, ваш экран будет выглядеть примерно так:
<figure><img src="../../.gitbook/assets/Screenshot 2026-02-24 at 1.27.43PM.png" alt=""/><figcaption><p>Финальный экран после выбора.</p></figcaption></figure>
Вам может быть показано сообщение _«Doing this will erase all data from selected external storage»_ и _«do you want to apply settings?»_, нажмите _«no, clear settings»_.
После этого выберите _«write»_ и начните процесс записи на карту Micro SD.
---
### Извлеките из компьютера и вставьте карту Micro SD в Raspberry Pi (Butter Box)
По завершении извлеките карту Micro SD. Вставьте карту Micro SD в Raspberry Pi (Butter Box), который не подключён к питанию.
---
### Перейдите к быстрому старту
Подключите Raspberry Pi (Butter Box) к питанию. Подождите несколько мгновений и подключитесь к порталу Butter Box. Перейдите в раздел [Быстрый старт](../../quick-start.mdx) для получения дополнительной информации.
---
**Если вы собираете улучшенный Butter Box (с увеличенным радиусом действия), перейдите к следующему разделу: Апгрейд Butter Box.**
[extend-your-box.md](extend-your-box.mdx)
### Устранение неполадок
Если вы видите ошибку, указывающую, что входной файл не является допустимым образом диска, проверьте скачанный файл.
Убедитесь, что размер файла совпадает с размером, указанным на сайте. Иногда браузеры не завершают загрузку, что может привести к повреждению файла.
Также убедитесь, что вы **распаковали файл** перед использованием.
<figure><img src="../../.gitbook/assets/Screenshot 2026-02-24 at 1.28.37PM.png" alt=""/><figcaption></figcaption></figure>