Всегда найдутся люди, которые делают все возможное, чтобы найти проблемы у других, 
чтобы избежать путаницы, 
мы объясним все помощь и ссылки, которые мы использовали и применили. 
Если есть какие-либо упущения, пожалуйста, не стесняйтесь сообщить нам своевременно.
Спасибо всем, кто помог нам.

Стандартный базовый образ системы без x-window оконного менеджера.
**Формат имени системного образа: OPENFANS-Debian-Buster-Aarch64-XXXXXX.img

● **Окружение рабочего стола Deepin**

● **Пакет обновления ядра и твердого ПО**

----

### 1-2. Окружение системы (базовое окружение)

Все системные изображения версии 2.0 используют файловую систему ext4 по умолчанию, зеркало источника Tsinghua было установлено как основное репозиторий программного обеспечения, и версия основана на Debian Buster 10 Arm64.

**Обратите внимание, что версия 2.0 в настоящее время не поддерживает обновления с других версий и требует свежей установки.**

### 1-3. Сравнение функций между различными версиями|Проекты|BaseOS|BaseOS Plus++|Полнокомплектное окружение рабочего стола|Окружение рабочего стола Deepin|
|---|---|---|---|---|
|Поддержка аппаратного виртуализации KVM|★|★|★|★|
|Графический менеджер виртуальных машин|X|X|★|X|
|Контейнер Docker|☆|★|☆|☆|
|Платформа CecOS CaaS|☆|☆|☆|X|
|Менеджер WebGUI|X|★|★|X|
|Клиент Web SSH|★|★|★|★|
|Стандартный набор виртуальных машин|★|★|★|X|
|Набор BT-Panel|★|★|★|X|----

**(1)Примечание:**

**★ :** Обозначает поддержку и включение по умолчанию. Может быть использовано напрямую.

**☆ :** Обозначает поддержку и отключение по умолчанию. Требуется запуск вручную.

(В этом документе будет инструкция по использованию этого сервиса.)

**X :** Обозначает отсутствие поддержки.

**(2)Управление сервисами**

Контейнер Docker

Платформа CecOS CaaS (порт сервиса: 8443)

Управление WebGUI (порт сервиса: 9090)

Web SSH-клиент (порт сервиса: 4200)

----

### 1-4. Результаты некоторых тестов производительности системы

#### Версия 1.0 против других сравнимых 64-битных ОС (разработанных другими)

Неполные результаты тестирования, только теоретические данные для справки:Результаты тестирования UnixBench с использованием стандартной файловой системы Ext4 и Raspberry Pi 3B Plus (в сравнении с сравнимыми Debian Aarch64 системами):

* **Однопоточное тестирование:**

![x1](/images/u1.JPG)
* **Многопоточное тестирование:**

![x4](/images/u4.JPG)

* **Общая оценка:**

![all](/images/uall.JPG)

Общая производительность значительно превышает сравниваемую тестовую систему в 2-3 раза, некоторые показатели достигли более 10 раз, что составляет 1000% улучшения.

- Версия 1.0 против официальной 32-битной системы Raspberry Pi

Недавно Raspberry Pi официально провел много оптимизационных работ, текущая система по сравнению с предыдущей 32-битной системой имеет значительное улучшение, но ограниченная 32-битной архитектурой, разрыв производительности между 64-битной и 32-битной системами все еще велик.

**Приложение:** Pi Fan **Debian Pi Aarch64 64-битная версия 1.0 системы против Raspbian 32-битной** результаты сравнительного тестирования производительности

*Результаты Sysbench 0.4.12:*| **Проекты тестирования** | **ARM32/EXT4** | **ARM64/F2FS** | единица тестирования: **время** / **меньше** — **лучше** |
| --- | --- | --- | --- |
| **Системная информация** | 2018-11-13-Raspbian | Raspberry Pi Fan 64-битная версия U8 | Увеличение в разы |
| **Однопоточное тестирование ЦП** | 119.2072 | 9.8725 | 12.07 |
| **Четырехпоточное тестирование** | 299.5217 | 24.6616 | 12.15 |
| **Восьмипоточное тестирование** | 299.5824 | 24.6789 | 12.14 |
| **Случайное чтение и запись памяти** | 1.2625 | 0.8751 | 1.44 |
| **Последовательное чтение и запись памяти** | 1.5803 | 1.1583 | 1.36 |
| **Последовательное чтение и запись файлов** | 6.1621 | 2.2928 | 2.69 |
| **Случайное чтение и запись файлов** | 484.812 | 6.3527 | **76.32** | Максимальное соотношение производительности: **76,32** |Соотношение средней производительности: **14,95**

- Сравнительная таблица результатов тестирования версии 1.0

![sysbench](./images/sysbench_result.png)

#### Результаты тестирования последней версии 2.0 beta на официальной 32-битной системе Raspberry Pi

Тестовое оборудование: Raspberry Pi 4B

*Результаты Sysbench 0.4.12:*

| **Проекты тестирования** | **ARM32/EXT4** | **ARM64/EXT4** | Единица измерения: **время** / **меньше** — **лучше** |
| --- | --- | --- | --- |
| **Система** | 2019-06-20 raspbian-buster | 2019-07-06 Pi Fan 2.0 Beta Edition | Увеличение соотношения |
| **Однопоточный** | 92,7292 | 6,7406 | 13,757 |
| **Четырехпоточный** | 231,6591 | 16,8172 | 13,775 |
| **Восьмипоточный** | 231,5002 | 16,8282 | 13,757 |
| **Случайная память** | 2,4225 | 0,6086 | 3,980 |
| **Последовательная память** | 2,5631 | 0,9267 | 2,766 |
| **Последовательное чтение-запись файлов** | 6,3636 | 1,8859 | 3,374 |
| **Случайное чтение-запись файлов** | 627,719 | 10,6036 | 59,199 |
| **Производительность взаимоисключающего блокирования (4096)** | 0,0206 | 0,0081 | 2,543 |

Максимальное соотношение производительности: *59,199*

Среднее соотношение производительности: *14,144*

- Сравнительная таблица результатов тестирования версии 2.0 (единица измерения: время, меньше — лучше)

![sysbench](./images/sysbench_result2.png)

----

## 2. Основные характеристики

### 2.1. Веб-визуальное управление

![web manage](./images/ui2.png)

Веб-визуальное управление на всех платформах (Поддерживается только для BaseOS и полной версии с графическим интерфейсом).С поддержкой веб-управления на новой 64-битной ОС версии 2.0, система обеспечивает визуальное управление на всех платформах, будь то стандартный графический интерфейс или система без графического интерфейса (усовершенствованная версия), Debian-Pi-Aarch64 официально открывает эру визуального управления.

Поддержка веб-управления:

![shellinabox](./images/shellinabox.jpg)

**WEB SSH** клиент поддерживает отдельный веб-шель (shellinabox), предоставляющий отдельную поддержку входа в **web ssh**.

### 2-2. Поддержка виртуализации QEMU-KVM

Это виртуальная машина QEMU с локальной архитектурой Aarch64, поддерживающая аппаратное ускорение KVM.

Мы перекомпилировали бинарный файл KVM для устранения многих ошибок для **qemu-system-aarch64** в окружении с аппаратным ускорением KVM:

По умолчанию виртуальная машина системы не может запускаться, система не может быть установлена и т.д. После включения аппаратного ускорения KVM...

Мы добавили поддержку виртуальных машин KVM при компиляции ядра, что обеспечивает полную виртуализацию аппаратно-ускоренной, и добавили поддержку локальных модулей ядра KVM, основные модули ядра следующие:

14. vfio //поддержка прохода устройств

15. vhost //взаимодействие с данными хоста

16. vhost-net //взаимодействие с сетевыми данными хоста

...

### 2-3. Поддержка контейнеров Docker

Известный Docker здесь не будет подробно описан, в этот раз мы перекомпилировали ядро и добавили полную поддержку Docker, что делает эту версию самой полной поддержкой функций Docker под архитектурой Raspberry Pi Aarch64. Большинство других версий по-прежнему являются 32-битными системами с 32-битными Docker, и локальные 64-битные ядра систем недостаточно поддерживают функции Docker.

Даже последняя версия известного 32-битного Docker Raspberry Pi системы **Hypriot** не полностью поддерживает **Docker Swarm**.

Вы получите следующее сообщение об ошибке, так как **Hypriot** не поддерживает **bridge vlan/vxlan netfilter**:

Это приведет к тому, что полное использование кластера Docker Swarm не поддерживается (система Hypriot OS), отсутствие соответствующей поддержки функций сети приведет к отсутствию некоторых функций.

Вы можете найти множество ошибок и предупреждений на локальной 64-битной ARM системе, используя **systemctl status containerd** и **systemctl status docker**, а также просматривая журналы, не учитывая их полностью. Локальное ядро системы по крайней мере утратило следующие функции: (система Hypriot OS и большинство других систем)```
1. Ограничение памяти cgroup

2. Ограничение свопа cgroup

3. Период cgroup rt

4. Время выполнения cgroup rt

5. Поддержка pid cgroup
```6. cgroup памяти sysfs

7. cgroup rdma

8. cgroup perf

9. cgroup bridge vlan/vxlan

10. cgroup netfilter

11. cgroup net priority

12. cgroup cfs пропускная способность ограничение

13. Bridge vlan фильтр

14. ipvs

15. ipvs ipv6

16. память sysfs

17. Kernel KSM

...

**Docker Compose**

Официальный Docker не предоставляет arm/arm64-совместимый docker-compose для запуска бинарного файла, поэтому мы перекомпилировали и предоставили бинарный файл aarch64-bit, который можно запускать, и теперь по умолчанию он добавлен в системные образы, которые можно использовать напрямую.

### 2-4. Поддержка файловой системы AUFS

***Примечание:*** Поддержка AUFS будет прекращена после версии **2.0 U3 (включительно)**!

**Что такое файловая система AUFS?**

AUFS, полное название — это продвинутая многоуровневая файловая система объединения, основная функция которой — объединение содержимого нескольких папок для предоставления единого представления. Она主要用于各种Linux发行版的LiveCD和Docker内部用于组织镜像。

AUFS曾是Docker的默认存储驱动程序，具有非常稳定的性能，大量的实际部署，并且有强大的社区支持，具有几个关键优势：

但由于AUFS未包含在Linux内核主线中，许多Linux发行版不支持AUFS。

最新的Docker默认使用更快且最新的OverlayFS文件系统，我们保持了这一官方设置的默认值。

---

AUFS, полное название — это продвинутая многоуровневая файловая система объединения, основная функция которой — объединение содержимого нескольких папок для предоставления единого представления. Она主要用于各种Linux发行版的LiveCD和Docker内部用于组织镜像。

AUFS曾是Docker的默认存储驱动程序，具有非常稳定的性能，大量的实际部署，并且有强大的社区支持，具有几个关键优势：

但由于AUFS未包含在Linux内核主线中，许多Linux发行版不支持AUFS。

最新的Docker默认使用更快且最新的OverlayFS文件系统，我们保持了这一官方设置的默认值。**Нужно ли нам использовать AUFS?**

В связи с тем, что Docker использует разнесённую файловую систему для своих образов, а OverlayFS поддерживает только два уровня, при использовании одинаковых уровней образов, несколько копий этих уровней будут дублироваться, что приводит к увеличению занимаемого пространства и увеличению I/O. AUFS также предоставляет возможность использования многоуровневого хранения и совместного использования данных. Docker использует Copy-on-Write-технологию AUFS для реализации совместного использования образов и минимизации использования дискового пространства.

Для устройств с ограниченным пространством хранения, таких как Raspberry Pi, использование файловой системы AUFS позволяет более эффективно использовать ограниченные ресурсы хранения и уменьшить потребление I/O.

Чтобы позволить пользователям выбирать и использовать OverlayFS или AUFS в зависимости от своих потребностей, мы по умолчанию добавляем поддержку модуля AUFS в ядро.

Так как AUFS не поддерживается основным ядром Linux, мы добавили код модуля AUFS и перекомпилировали его в основное ядро 4.19, теперь модуль AUFS автоматически загружается при запуске системы, и его можно использовать без необходимости ручного вмешательства. ### 2-5. Ускорение TCP

Ядро по умолчанию включает алгоритм управления затоплением TCP BBR.

**Что такое TCP BBR?**

Просто объясним, что решает TCP BBR:

Кратко говоря, алгоритм управления затоплением TCP BBR может улучшить скорость и эффективность передачи TCP до определённого уровня и оптимизировать сетевую передачу.

**Как отключить:**

Редактируйте файл "/etc/sysctl.conf", выполните команду "sysctl -p" для просмотра результатов, и не увидите следующих строк комментариев, что означает успешное выполнение операции.```
# net.core.default-qdisc-fq
# net.ipv4.tcp.tcp-contents-control-bbr

Алгоритмы выделения памяти zpool: smalloc, zbud, z3fold
```На практике показано, что хотя zsmalloc имеет высокий коэффициент сжатия, алгоритм сложен и требует дополнительных потоков для управления памятью, что потребляет больше времени процессора.Реализация zbud проста, хранение страниц памяти не приводит к фрагментации памяти, но коэффициент сжатия низок, до 2 раз, что не соответствует реальным потребностям системы с небольшим объемом памяти.

В результате Sony разработала алгоритм выделения памяти z3fold, который точно такой же, как реализация zbud, за исключением того, что каждая страница может хранить 3 сжатые страницы, с максимальным коэффициентом сжатия 3x, и почти 4x по сравнению с zsmalloc, техникой, используемой в Xperia XZP, чтобы получить опыт 4 ГБ с вашим телефоном на 4 ГБ.

Мы выбрали алгоритм z3fold в системе, и мы можем видеть конфигурацию в системе /boot/cmdline.txt:

**Алгоритмы сжатия**

Linux имеет множество алгоритмов сжатия: lz, lzo, xz, gzip, lzma... Мы采用了**lz4**，它具有非常高的压缩速度和较高的压缩率，**lz4**与其他压缩算法相比，压缩率不是最高的，但速度确实是最快的，在使用z3fold算法的情况下，结合Raspberry Pi的性能特点和实际测试，同时也希望获得较好的压缩率，对于Raspberry Pi来说，速度是最重要的因素（考虑到其CPU性能开销和内存大小）。

### 2-7. Тема macOS Mojave для рабочего стола

![рабочий_стол](./images/apk0.jpg)

По умолчанию используется тема рабочего стола, имитирующая тему macOS Mojave.

### 2-8. CecOS-CaaS Облачное хранилище контейнеров (Только версия на китайском языке)

![caas-основное](./images/caas.png)

![caas-кластер](./images/caas2.png)

Переозвучено от открытого проекта [Portainer](http://portainer.net) и разработано для китайских и других пользователей командой OPENFANS.### 2-9. Другие возможности

- Поддержка 3D ускорения, все окружения рабочего стола включены по умолчанию.

- В версии 2.0 слишком много новых возможностей, поэтому мы не будем подробно описывать их здесь.

---

## 3. Инструкции по использованию

### 3-1. Инициализация системы (Первый запуск)

Система автоматически расширяет корневую разделу, а затем автоматически настраивает, до тех пор, пока не будет завершена нормальное использование, в процессе система автоматически перезагружается **3** раза.

### 3-2. Учетные записи и пароли

Учетная запись по умолчанию системы: **pi**, пароль по умолчанию: **raspberry**

Учетная запись pi по умолчанию поддерживает вход по SSH, для установки пароля учетной записи root, пожалуйста, войдите сначала и используйте команду **"sudo passwd root"** для установки,

Или используйте команду **"sudo -i"** для переключения на режим пользователя root.

### 3-3. Веб-интерфейс входа

### 3-4. Предварительно настроенные элементыСистема предоставляет предварительно настроенные сетевые параметры и задачи автозапуска при загрузке, с соответствующими путями и соотношениями профиля следующим образом:

| Предварительно настроенные элементы | Пути к профилям | Соответствующие пути к системным файлам |
| --- | --- | --- |
| Беспроводные сети | /boot/wpa_supplicant.conf | /etc/wpa_supplicant/wpa_supplicant.conf |
| Кабельные сети | /boot/interfaces | /etc/network/interfaces |
| Клиенты DHCP | /boot/dhclient.conf | /etc/dhcp/dhclient.conf |
| Пользовательские скрипты загрузки | /boot/rc-local | /etc/rc.local |

### 3-5. Настройка беспроводной сети

Десктопная среда может быть настроена через графический интерфейс после входа в десктопную среду. В данном разделе описывается, как изменяется файл конфигурации.

Если десктопная среда хочет подключаться к беспроводным сетям с помощью подхода, основанным на изменении конфигурации, пожалуйста, обратите внимание [здесь](./README.md#3161_Графический_интерфейс_��置使用配置文件连接无线网络).

Измените файл **"/boot/wpa_supplicant.conf"**

### 3-5. Настройка беспроводной сети

Десктопная среда может быть настроена через графический интерфейс после входа в десктопную среду. В данном разделе описывается, как изменяется файл конфигурации.

Если десктопная среда хочет подключаться к беспроводным сетям с помощью подхода, основанным на изменении конфигурации, пожалуйста, обратите внимание [здесь](./README.md#3161_Графический_интерфейс_��置使用配置文件连接无线网络).

Измените файл **"/boot/wpa_supplicant.conf"**

## Если вы не хотите настраивать несколько беспроводных сетей, ##
## вам нужно настроить только настройки "WIFI 1". ##
## WIFI 1 (Не удаляйте комментарий к этой строке!) #### Кроме отмены комментариев к содержимому, которое должно вступить в силу, ##
## вам нужно изменить только содержимое кавычек после "ssid" и "psk". ##
## ssid — это имя вашей беспроводной сети Wi-Fi, psk — это пароль вашей беспроводной сети Wi-Fi ##
#network={
#    ssid="your-wifi1-ssid"
#    psk="wifi1-password"
#    priority=1
#    id_str="wifi-1"
#}

## WIFI 2 (Не отменяйте комментарий к этой строке!) ##

#network={
#    ssid="your-wifi2-ssid"
#    psk="wifi2-password"
#    priority=2
#    id_str="wifi-2"
#}

AU Австралия
CA Канада
CN Китай
GB Великобритания
HK Гонконг
JP Япония
KR Корея
DE Германия
US США
TW Тайвань

Редактируйте файл скрипта **"/boot/rc-local"** и добавьте содержимое пользовательского скрипта до строки: **"exit 0"**.

### 3-8. НЕ УСТАНОВЛЯТЬ Обновление окружения рабочего стола Deepin

**Версии, начиная с 2019-11-10 (включительно), поддерживают обновление!**

В связи с проблемами совместимости с системой Deepin и верхнеуровневыми репозиториями (Deepin сам по себе), настоятельно не рекомендуется использовать любые из следующих команд или любые другие действия, которые могут привести к обновлению системы, если вы не знаете, что именно вы делаете!!!

Все системы Deepin требуют внимания, включая все версии Deepin 1.0 и OnClickListener 2.0!

**Примечание:**

*Некоторые проблемы установки программного обеспечения ограничены проблемами совместимости Deepin, что может вызвать ошибки, препятствующие запуску системы или другие неизвестные проблемы, поскольку программное обеспечение слишком разнообразно, мы не можем тестировать каждую программу по отдельности, приветствуем обратную связь, рекомендуем устанавливать через исходный код.**Программное обеспечение Deepin Software Store предоставляется Deepin, а не нами. В настоящее время Deepin Software Store не предоставляет поддержку программного обеспечения для arm64. Если у вас есть какие-либо потребности, пожалуйста, обратитесь на официальный форум Deepin для помощи.**Поэтому мы настоятельно рекомендуем использовать нашу кастомизированную версию рабочего стола с темой macOS Mojave.*

### 3-9. Отображение китайских шрифтов в TTY (локально, не удаленно)

Примечание: удаленный вход игнорирует эту проблему, поэтому не будет проблем с отображением. Когда используется только локальный терминал через локальный монитор или последовательное соединение, поскольку локальный стандартный TTY ядра Linux не поддерживает отображение китайских шрифтов, требуется выполнить соответствующие действия при появлении проблем с отображением.

Необходимо установить расширение fbterm для поддержки, для этого используйте следующие команды в сети:

*Вы не можете одновременно использовать веб-интерфейс и клиент для подключения к одному и тому же серверу VNC.*

Если вы хотите использовать клиент для подключения к серверу VNC, мы рекомендуем использовать RealVNC client, вы можете перейти [сюда](https://www.realvnc.com/en/connect/download/viewer/) для загрузки RealVNC client.

#### Инструкции по использованию веб-интерфейса VNC удаленного рабочего стола

Существует два способа использования по умолчанию VNC:

**● Подключение к реальному монитору**

**● Без подключения к монитору**

#### ВАЖНО

**Примечание: Режим "Виртуальный монитор" не включен по умолчанию.**#### Команды для по умолчанию VNC

**virtual-monitor-enable**

**virtual-monitor-disable**

**enable-vnc**

**disable-vnc**

**vnc-passwd**

### 3-11. Переключение каналов вывода звука

Версия 2.0: Системный стандарт использует **HDMI** для вывода аудио.

Команды для переключения вывода звука:

После того как вы завершили изменение настроек аудио, вам нужно перезагрузить Raspberry Pi, чтобы изменения вступили в силу.

**Если звук через HDMI всё ещё не воспроизводится:**

В некоторых редких случаях необходимо редактировать файл config.txt для принудительного переключения на режим HDMI (в отличие от режима DVI, который не передаёт звук).Вы можете сделать это, редактируя **/boot/config.txt** и устанавливая **hdmi_drive=2**, затем перезагрузив систему для вступления изменений в силу.


### 3-12. Поддержка 32-битного программного обеспечения armhf

### 3-13. Включение и запуск службы Docker

**BaseOS** и **Desktop Full-Features Versions** по умолчанию не включены и требуют ручного запуска.

### 3-14. Включение и запуск службы CecOS CaaS контейнерного облака

**BaseOS** и **Desktop Full-Features Versions** по умолчанию не включены и требуют ручного запуска.

**Примечание: Для включения службы CecOS CaaS контейнерного облака, сначала нужно включить и запустить службу Docker!**

systemctl disable cecos-caas.service

### 3-16 ЧАСТЫЕ ВОПРОСЫ

#### 3-16.1 Использование профилей для подключения к беспроводным сетям графического окружения

Графическое окружение использует профиль для подключения к беспроводной сети, и после изменения файла **/boot/wpa_supplicant.conf** для обеспечения хорошей совместимости сети, выполните следующие действия:

с правами root пользователя:

```Shell
systemctl disable NetworkManager

sed -i  \
's/sudo systemctl restart NetworkManager/## sudo systemctl restart NetworkManager/g' \
/home/pi/.xsessionrc

Следующие пакеты имеют неразрешенные зависимости:
 package-name-1 : Зависит от package-name-2 (>= x.x.x-xxx-2) но x.x.x-xxx-1 будет установлен
              Рекомендует package-name-3 но он не будет установлен
E: Невозможно исправить проблемы, у вас есть сломанные пакеты.
```**Причина:**

Это связано с тем, что некоторые новые пакеты верхнего уровня, установленные на нашей системе, не совпадают с версией пакетов в стандартном репозитории.

**Решение:**

Чтобы временно включить репозиторий программного обеспечения верхнего уровня **sid**, добавьте команду `sudo` перед вашей командой **apt**:

Пример: `sudo apt install package-name`

#### 3-16.3 Ошибка отображения интерфейса браузера Chromium

**Причина:**

Возможно, вы столкнетесь с этой проблемой в версии 20200615 U3, так как мы изменили mesalib, и нужно использовать другой способ для настройки Chromium.

**Решение:**

Выполните команду:

Затем перезапустите ваш браузер Chromium.

#### 3-16.4 Утрата соединения Bluetooth Audio

**Причина:**

Pi имеет проблемы совместимости Bluetooth с определенным оборудованием между alsa и pulseaudio.

**Решение:**

Отключите службу Bluealsa, используйте только pulseaudio для Bluetooth-audio. Выполните следующую команду и перезагрузите систему:

**Примечание**: Здесь вы **должны** использовать **"mask"** для деактивации bluealsa.service, **не** используйте **"disable"** !!

#### 3-16.5 Проблема загрузки с USB-накопителя

Если у вас возникла проблема с загрузкой с USB-накопителя, прочитайте [здесь](/docs/pi4-usb-boot-problems.md) для решения проблемы.#### 3-16.6 Как обновить Docker-CE

Выполните следующие команды от имени root пользователя:

#### 3-16.7 Изменение моно-вывода аудио на стерео для версии для настольной системы

Редактируйте файл **/usr/share/pulseaudio/alsa-mixer/profile-sets/default.conf**

Добавьте символ ";" в начало каждой строки следующего содержимого для комментирования:

Вот содержимое после комментирования:

Наконец, перезапустите систему для применения изменений.

### 3-17. Дополнительные инструкции по приложениям

#### 3-17.1 Примечания по установке WPS Office Arm 64-bit для настольной системыПолучите установочный пакет из папки "APP" репозитория загрузок. После распаковки установочного пакета перейдите в директорию установочного пакета. Затем подключитесь к общественной сети и выполните следующую команду от имени root пользователя:```shell
sudo ./install.sh

qq_pkg='linuxqq_2.0.0-b1-1024_arm64.deb' ; \
cd ~ ; \
wget https://raw.githubusercontent.com/openfans-community-offical/Debian-Pi-Aarch64/master/add-app/$qq_pkg ; \
apt install ./$qq_pkg -y ; \
rm -rf ./$qq_pkg

sudo apt install -y ./xxxxxx.deb

apt update ; apt install tar gzip zip unzip bzip2 xz-utils -y

xz -d -k disk.qcow2.xz

sudo ./vm-run

## Этот скриптовый командный файл запускает виртуальную машину в фоновом режиме по умолчанию.
```Запустите виртуальную машину в том же режиме, что и на предыдущей станции:

Скопируйте файл **vm_run** и переименуйте его как **vm_run2**, откройте файл **vm_run2** и удалите следующие 2 строки:

Затем запустите **"sudo ./vm_run2"**.

**Удалённый вход:**

Порт 22 виртуальной машины по умолчанию отображается на локальном порту 2222, SSH-доступ к локальному порту 2222.

Пример команды:

----
### 4-2 Инструкции по установке виртуальной машины BT-Panel PKG

Чтобы заботиться о новых пользователях и отвечать на голоса народа, мы в конечном итоге "интегрировали" Pagoda для вас, используя виртуальную машину, 32-битную сверхчистую кастомизированную ARMHF виртуальную систему, оптимизированную для Pagoda, даже для виртуальных машин, скорость значительно выше, чем у официальной системы (кто пользовался, тот поймёт :) --).

Чтобы запустить тест:

![BT-Panel](./images/bt_mark.png)

По умолчанию все программы установлены. Версия 5.9.X относительно стабильная профессиональная "обучающая версия", знаете, это только для тестирования!!

**Почему BT-Panel?**

**Почему не интегрировать напрямую в 64-битную ОС?**

3. BT-Panel крайне плохо совместима с ARM64!

4. BT-Panel не просто простая установка. 
Программы, которые нужно использовать в ARM-системе, почти все требуют перекомпиляции. 
Совместимость плохая, и это занимает много времени. 
Можно сказать, что это вызывает сомнения в жизни и желание заплакать.

5. Проблемы, связанные с различными странными ямами, с которыми мы столкнулись во время использования;

6. Не то, что BT-Panel плох в целом. 
Хотя совместимость на ARM64 является значительной проблемой. 
Чувствуется, что официальные лица не проводили тестирование. 
Все работы выполняются бесплатно, как если бы вы сами проводили тестирование.

sudo ./install

./bt_run

Пожалуйста, выполните вход в систему через ssh в виртуальную машину и выполните команду "init 0" 
для выключения виртуальной машины.

После выключения вам нужно выполнить команду "./bt_prog" в директории виртуальной машины BT-Panel 
для проверки, что виртуальная машина была выключена.
```Если нет вывода, это означает, что виртуальная машина была выключена правильно.

Если виртуальная машина не может быть выключена грациозно, 
выполните команду `./bt_prog kill` в директории виртуальной машины BT-Panel.

Также не забудьте выполнить команду `./bt_prog` снова для проверки, 
что виртуальная машина выключена.

## Включить автоматический запуск при загрузке
./install int

## Отменить автоматический запуск при загрузке
./install uint

Локальное подключение: ssh -p bk 2222 root@localhost
Внешнее подключение: ssh -p 2222 root@IP-адрес-вашего-Raspberry-Pi

Не изменяйте управляемый порт BT-Panel по умолчанию, если вы не знаете, как это сделать, 
и не знаете, как изменить скрипт установки.

Если вам нужно включить поддержку пользовательских портов, редактируйте файл портов и добавьте ваш порт, 
но не изменяйте другие порты по умолчанию в файле портов.

qemu-img info bt.qcow2.disk

Image: bt.qcow2.disk
File format: qcow2
Virtual size: 10G (10737418240 bytes) # Общий размер диска
Disk size: 6.4G # используемая емкость
Cluster_size: 65536
Format specific information:
    Compat: 1.1
    Lazy refcounts: false
    Refcount bits: 16
    Corrupt: false

qemu-img resize bt.qcow2.disk +10G

qemu-img info bt.qcow2.disk

Image: bt.qcow2.disk
File format: qcow2
Virtual size: 20G (21474836480 bytes) # Увеличение емкости выполнено успешно, общий размер 20ГБ
Disk size: 6.4G
Cluster_size: 65536
Format specific information:
    Compat: 1.1
    Lazy refcounts: false
    Refcount bits: 16
    Corrupt: false

ssh -p 2222 root@localhost
```**Просмотр размера диска**

Выполнение команды:

```shell
fdisk -l /dev/sda

Disk /dev/sda: 20 GiB, 21474836480 bytes, 41943040 sectors # Увеличено до 20ГБ
Units: sectors of 1 * 512 = 512 bytes
Sector size (logical/physical): 512 bytes / 512 bytes
I/O size (minimum/optimal): 512 bytes / 512 bytes
Disklabel type: dos
Disk identifier: 0xcd0e4df1

Device Boot Start End Sectors Size Id Type
/dev/sda1 * 2048 20969471 20967424 10 ГБ 83 Linux # Размер раздела не увеличен

df -hT

Файловая система Тип Размер Использовано Доступно Использование% Монтировано на
Udev devtmpfs 496M 0 496M 0% /dev
Tmpfs tmpfs 103M 1.5M 101M 2% /run
/dev/sda1 btrfs 10G 4.7G 4.7G 50% / # Объем раздела не расширен
Tmpfs tmpfs 513M 4.0K 513M 1% /dev/shm
Tmpfs tmpfs 5.0M 0 5.0M 0% /run/lock
Tmpfs tmpfs 513M 0 513M 0% /sys/fs/cgroup
Tmpfs tmpfs 103M 0 103M 0% /run/user/0

apt update ; apt install parted -y

parted

Внесены следующие изменения:
- "20ГБ" заменено на "21.5ГБ" для соответствия значению в начале текста.
- Убраны лишние пробелы и запятые.
- Улучшена пунктуация и грамматика.```

Далее введите следующую команду **resizepart** :

```shell
(parted) resizepart 
# Введите команду "resizepart" для расширения раздела
Номер раздела? 1 
# Введите номер раздела, который нужно расширить. Поскольку у нас здесь только один раздел, введите "1".
Предупреждение: Раздел /dev/sda1 используется. Вы уверены, что хотите продолжить?
Да/Нет? yes # Подтвердите продолжение, введите "yes"
Конец? [10.7GB]? 100% 
# Введите "100%", чтобы расширить все доступное пространство до указанного раздела.
(parted) print 
# Введите "print", чтобы просмотреть информацию о диске текущей операции
Модель: QEMU QEMU HARDDISK (scsi)
Диск /dev/sda: 21.5GB
Размер сектора (логический/физический): 512B/512B
Таблица разделов: msdos
Флаги диска:
Номер Начало Конец Размер Тип Файловая система Флаги
 1 1049kB 21.5GB 21.5GB primary btrfs boot 
# Вы можете видеть, что увеличенная размерность диска успешно расширена.

(parted) quit # Введите "quit", чтобы выйти
Информация: Возможно, вам нужно обновить /etc/fstab.

partprobe /dev/sda
partprobe /dev/sda1

btrfs filesystem resize max /

resize '/' of 'max'

```shell
mount -o remount,rw /

sync

df -hT

Файловая система Тип Размер Использовано Доступно Использование% Монтировано на
Udev devtmpfs 496M 0 496M 0% /dev
Tmpfs tmpfs 103M 1.5M 101M 2% /run
/dev/sda1 btrfs 20G 4.7G 15G 25% / # раздел успешно расширен
Tmpfs tmpfs 513M 4.0K 513M 1% /dev/shm
Tmpfs tmpfs 5.0M 0 5.0M 0% /run/lock
Tmpfs tmpfs 513M 0 513M 0% /sys/fs/cgroup
Tmpfs tmpfs 103M 0 103M 0% /run/user/0

cd ./upkg
sudo sh ./sys_upgrade

0. Сначала выполните команду:
   apt update; apt install dpkg-dev -y

1. Скачайте сжатый пакет и распакуйте его в корневую ("/") директорию.

2. Измените права доступа распакованного файла на пользователя "_apt", выполните команду:
   "chown -R _apt [Путь к распакованному файлу]"

3. Перейдите в директорию с распакованным файлом и выполните команду:
   "sh ./install.sh"

4. Затем перезагрузите систему, и все будет сделано.

Для Thunder Share: "/raspberry-pi-images/2021-new/Testing/Graphic_Libs/v2/debs_repo.zip"

Для Baidu network disk: "/Debian-Pi-Aarch64-2.0-Release/Testing/Graphic_Libs/v2/debs_repo.zip"

Для MEGA: "/Debian-Pi-Aarch64/2021/extra/Graphic_Libs_Trsting/debs_repo.zip"

1. Все вышеуказанные системы созданы сообществом OPENFANS с открытым исходным кодом и исключительно распространяются и предоставляются техническая поддержка сообществом Raspberry Pi Fan base;

2. Любое воспроизведение слов или изображений должно указывать источник системы (программного обеспечения); 
вы можете вносить любые изменения в программное обеспечение или систему, но вы должны сохранять источник и readme;

Строго запрещено использование для коммерческих целей, если вам необходимо использовать его коммерчески, 
пожалуйста, свяжитесь и получите разрешение от сообщества OPENFANS с открытым исходным кодом и 
сообщества Raspberry Pi Fan base;

3. Вышеуказанные системы и права собственности на программное обеспечение принадлежат соответствующим авторам программного обеспечения и должны соответствовать условиям лицензионного соглашения;
```4. Нарушение правил апелляции дает сообществу OPENFANS с открытым исходным кодом и сообществу Raspberry Pi Fan base право преследовать свои обязанности и приказывать прекратить все нарушения;

5. Сообщество OPENFANS с открытым исходным кодом и сообщество Raspberry Pi Fan base имеют право на окончательное толкование вышеуказанного содержания.

1. Признание культуры сообщества Raspberry Pi Fan base и наличие большой страсти к Raspberry Pi;
2. Ответственность и обязательность выполнения задач, назначенных сообществом, в срок и качественно;
3. Обладание навыками проектирования 3D-моделирования печати или DSP схем;
4. Обладание практическим опытом в разработке аппаратуры.
```- **Разработчики программного обеспечения и систем**```
1. Признать культуру сообщества Raspberry Pi Fan base и иметь огромный энтузиазм по отношению к Raspberry Pi;
2. Ответственность за выполнение задач по организации сообщества в срок и высокого качества;
3. Знакомство с построением системы сборки или разработкой программного обеспечения;
4. Нас интересуют языки программирования, включая, но не ограничиваясь: JAVA, Python, Go, NodeJS, C, C++ и т.д.;
5. Требуется сборка программного обеспечения и упаковка в формате Deb;
6. Наличие практического опыта разработки.
```**Еще один способ: организации, учреждения и бизнес-единицы приветствуются для обсуждения сотрудничества!!!**Пожалуйста, свяжитесь с нами с любыми намерениями: **[admin@openfans.org](mailto:admin@openfans.org)**

Пожалуйста, заполните детали и намерения и оставьте, по крайней мере, свой **номер мобильного телефона**, спасибо за ваше сотрудничество.

----

## Благодарности

OSCHINA : [Поддержка для git репозитория](https://gitee.com/)

Raspbian: Официальная система (часть скрипта автоматического расширения)

UMRnInside : Проект [UMRnInside/RPi-arm64](https://github.com/UMRnInside/RPi-arm64) (ссылка на раздел автоматического расширения)

Andreiw: Проект [andreiw/RaspberryPiPkg](https://github.com/andreiw/RaspberryPiPkg) (EFI firmware версии 1.0)

Sakaki(1) : [ссылка](https://www.raspberrypi.org/forums/viewtopic.php?f=56&t=244478) (ссылка на проблему загрузки ядра)

Sakaki(2) : Командная строка для воспроизведения видео с аппаратным ускорением H264-V4L2-M2M.

Margetts99 : [ссылка](http://bbs.pifan.org/?thread-132.htm) (рекомендации по интеграции WPS и отчеты о проблемах)

Windows Arm On Qemu: *см. [ссылка1](https://github.com/virtio-win/kvm-guest-drivers-windows/issues/177#issuecomment-468149012) & [ссылка2](https://www.raspberrypi.org/forums/viewtopic.php?f=56&t=248345&sid=d4dd0681937f13e9c0cb4f04e5b54979)*

**И всем остальным друзьям, которые частным образом спонсировали и помогли нам!**