Установка OctoPrint на Linux/Ubuntu

OctoPrint на Linux — это отличная комбинация для ярых поклонников Linux и 3D-печати. Ознакомьтесь с инструкцией по установке OctoPrint-Linux!

Linux — это семейство операционных систем (ОС) с открытым исходным кодом, первая из которых была разработана Линусом Торвальдсом в начале 90-х годов. Linux существует во многих разновидностях, которые могут выглядеть и ощущаться очень непохожими друг на друга, несмотря на то, что все они являются Linux. Каждая разновидность называется дистрибутивом и одним из самых популярных является Ubuntu. На самом деле, веб-серверы под управлением Ubuntu обеспечивают работу большей части Интернета!

OctoPrint — это веб-интерфейс для мониторинга и управления вашим 3D-принтером. Вы можете отправлять G-код, загружать отпечатки, следить за состоянием принтера и многое другое. В этой статье мы обсудим, как установить OctoPrint на Ubuntu. Сначала мы рассмотрим, почему вы хотите установить Octoprint и Linux в первую очередь. Затем мы рассмотрим несколько различных способов сделать это. И наконец, в заключение мы дадим несколько советов и рекомендаций.

Чтобы получить максимальную пользу от этой инструкции, вы должны уметь программировать в терминале, а компьютер, на который вы устанавливаете OctoPrint, должен быть подключен к Интернету.

Зачем это делать

Есть много причин для установки OctoPrint на Linux. Наиболее распространенной является необходимость удаленного мониторинга и взаимодействия с 3D принтером — больше не нужно подключать USB или SD карту. Вместо этого вы можете просто перетащить G-код из вашего слайсера на принтер.

Более конкретно, большинство людей, которые хотят использовать OctoPrint, скорее всего, захотят запустить его на дешевом одноплатном компьютере (SBC), таком как Raspberry Pi. Это идеальные машины для запуска Linux. Если вы запустите легкий дистрибутив, такой как Ubuntu Server, ваш SBC отблагодарит вас и ваш интерфейс OctoPrint, вероятно будет работать быстрее, так как вы используете меньше ресурсов для работы ОС.

Способы установки

Ниже мы рассмотрим три способа установки OctoPrint на Ubuntu, каждый из которых имеет свои плюсы и минусы.

Первый способ довольно прост и предполагает установку на Pi дистрибутива Linux, поддерживающего Raspberry Pi-. Второй способ немного сложнее и предполагает, как уже говорилось выше, запуск Ubuntu Server. Хотя этот способ и сложнее, он позволяет больше настраивать систему и является более гибким, чем установка образа OctoPi. И, наконец, третий метод — более простой и может быть полезен, если у вас несколько принтеров. Он включает в себя использование скрипта OctoPrint Deploy для упрощения процесса установки OctoPrint и особенно полезен тем, что является «OS agnostic», то есть может работать на многих наиболее популярных дистрибутивах Linux.

В простом методе пользователь загружает OctoPi, которая представляет собой «легкую» версию Raspberry Pi OS, вместе с OctoPrint и всеми ее зависимостями. OctoPi облегчает работу с OctoPrint, поскольку все необходимое для начала работы уже находится на карте MicroSD вместе с ОС.

Но, возможно, все ваши Raspberry Pis заняты в других проектах, или вы хотите, скажем, перепрофилировать старый компьютер, который больше не используется. В этом случае Ubuntu Server просто незаменим! Он будет работать практически на любой машине, которая есть у вас под рукой — например, мы установили его на старый Lenovo Mini PC и OrangePi Zero 2.

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

Прежде чем мы продолжим, сделаем одно уточнение. В этом случае вы будете управлять принтером не напрямую, то есть с экрана, подключенного к принтеру, а через браузер на другом компьютере. Если вы хотите управлять принтером напрямую с SBC или другой Linux-машины, на которой запущен OctoPrint, вам понадобится сенсорный экран с совместимым с OctoPrint пользовательским интерфейсом, например OctoDash, Touch UI или аналогичный.

Простой способ

В первом руководстве мы загрузим дистрибутив Linux, в котором уже установлен OctoPrint. Этот дистрибутив называется «OctoPi», и мы будем использовать его для прошивки карты MicroSD, чтобы установить Linux и OctoPrint на Raspberry Pi.

Требования

Для того чтобы приступить к простому методу, вам понадобится следующее:

• Компьютер с доступом в Интернет
• Raspberry Pi Imager
• Raspberry Pi 3B, 3B+ или 4B
• Адаптер питания для Pi
• Карта памяти MicroSD объемом не менее 8 ГБ
• USB-кабель для подключения Pi к принтеру

Хотя вы можете установить Linux и OctoPrint практически на любой компьютер, OctoPrint рекомендует использовать вышеупомянутые Pi. Если вы пытаетесь установить OctoPrint на что-то, что не относится к этим трем Pi, смотрите более сложный способ ниже.

Что касается питания, то для всех трех моделей Pi рекомендуется источник питания 5,1 В, но необходимый вам электрический ток и тип подключения зависят от модели. Очень важно подобрать правильный блок питания, поскольку недостаточное питание Pi может привести к проблемам с печатью. Рекомендуются следующие варианты:

• 3B/3B+: подключение Micro-USB, ток 2,5 А.
• 4B: USB Type-C, ток 3,0 А.

И наконец, чем короче USB-кабель, тем лучше, так как это минимизирует помехи. Для подключения Pi к 3D-принтеру вам понадобится USB Type A.

Пошаговая инструкция

1. Загрузите и установите программу Raspberry Pi Imager на свой компьютер.
2. Запустите программу Imager, затем выберите вашу ОС. Прокрутите список опций вниз, пока не увидите вкладку «Other specific-purpose OS».
3. Выберите «3D printing», затем выберите стабильную версию OctoPi.
4. Нажмите на значок шестеренки. Откроется окно настроек вашей установки OctoPi, где вы можете ввести имя Wi-Fi (SSID) и пароль. Сделав это сейчас, вы избавите себя от многих проблем в дальнейшем!
5. Запишите настроенный образ OctoPi на карту MicroSD и дождитесь завершения установки.
6. Извлеките карту из компьютера. Не нажимайте кнопку форматирования на всплывающих окнах на вашем компьютере. Иначе вам придется начинать все сначала!
7. Вставьте карту MicroSD в Pi и подключите USB-кабель от Pi к 3D-принтеру.
8. Загрузите Pi.

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

 Более продвинутый способ

Для более продвинутого способа установки нам понадобится установить Ubuntu Server 24.04.1 LTS (долгосрочная поддержка). Мы загрузим образ Ubuntu и запишем его на USB-накопитель или SD-карту. Затем мы используем его для установки Ubuntu на выбранную вами компьютерную систему. После этого OctoPrint можно будет установить на эту операционную систему из терминала.

В качестве примечания: все команды, которые вы увидите ниже, были опробованы на Ubuntu 24.04.1 LTS.

Требования

Чтобы начать работу, вам понадобится следующее.

• Компьютер с подключением к Интернету
• Образ Ubuntu Server 20.04.1 LTS
• Balena Etcher, который вы будете использовать для записи образа Ubuntu на SD-карту
• Компьютер, на которую вы будете устанавливать OctoPrint (обычно это SBC на базе Linux)
• USB-накопитель или Micro-SD объемом 8 Гб или больше, в зависимости от того, какими портами оснащен ваш компьютер
• Ваш IP-адрес
• Ваш пароль Wi-Fi (или кабель Ethernet, если компьютер не имеет Wi-Fi)

Подготовка к установке

Здесь мы выполним предварительную настройку, чтобы подготовиться к установке OctoPrint. Это включает в себя проверку того, что у нас есть нужная версия Python. Затем мы запишем IP-адрес машины, на которой мы устанавливаем OctoPrint, чтобы иметь доступ к OctoPrint позже. Наконец, мы создадим нового пользователя для запуска экземпляра OctoPrint для большей безопасности.

Сборка Ubuntu Server

Для начала создадим загрузочный образ Ubuntu на USB-накопитель или карту MicroSD с помощью Balena Etcher.

1. Скачайте Ubuntu Server.
2. Вставьте SD-карту или USB-устройство в компьютер.
3. Откройте программу Balena Etcher.
4. Выберите «Прошить из файла» и выберите загруженный ISO-файл Ubuntu.
5. Выберите целевой диск. Убедитесь, что это USB-устройство или SD-карта, чтобы не стереть жесткий диск!
6. Нажмите «Flash!» и подождите, пока Balena Etcher запишет данные на выбранный вами диск.
7. Извлеките накопитель. В зависимости от особенностей вашего компьютера может появиться всплывающее окно о том, что ваш диск поврежден. Вы можете спокойно проигнорировать его.

Установка Ubuntu Server

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

1. Выключите целевую машину.
2. Вставьте USB-накопитель или SD-карту с Ubuntu в машину, на которой будет установлена Ubuntu.
3. Включите машину и войдите в меню загрузки. Часто в правом нижнем углу есть небольшая инструкция, например, «Нажмите F12 Boot для меню загрузки» или «Нажмите Del для Setup». Если вы застряли, сделайте поиск в Google с названием вашей машины и «загрузочное меню», и вы сможете разобраться.
4. Оттуда выберите диск Ubuntu, который вы вставили.
5. Следуйте инструкциям на экране, чтобы установить Ubuntu. Вам нужно будет добавить свои учетные данные Wi-Fi на этапе создания сети, если вы планируете использовать Wi-Fi. Более подробную информацию обо всех опциях можно найти в документации Ubuntu.

После успешной установки Ubuntu перед вами должно открыться пустое окно терминала. Давайте убедимся, что все обновлено.

6. Введите команду: sudo apt update

Обновить Python

Здесь мы дважды проверим наличие всех необходимых зависимостей для запуска OctoPrint. Нам понадобится Python 3.6 или более новая версия, так как Python 2 уже сильно устарел.

1. Проверьте версию вашего Python, введя команду python3 -V. В результате должно получиться что-то вроде следующего: Python 3.x.y
2. Если команда не выдает Python 3.x.y, установите Python командой sudo apt install python3.
3. Установите зависимости Python, необходимые для успешной настройки OctoPrint:
   • sudo apt install python3-pip
   • sudo apt install python3-dev
   • sudo apt install python3-setuptools
   • sudo apt install python3-venv
   • sudo apt install git
   • sudo apt install libyaml-dev
   • sudo apt install build-essential
4. Убедитесь, что все обновлено, выполнив команду pip install pip --upgrade.

Проверить IP-адрес

Чтобы найти ваш IP-адрес, мы воспользуемся командой ip a, которая вернет несколько длинных строк текста. Вы ищете строку в следующем формате: inet 192.168.x.yyy/zz

Это ваш IP-адрес. Запишите его, потому что он понадобится нам позже для подключения к OctoPrint.

Добавление нового пользователя OctoPrint

В этой части мы добавим нового пользователя для работы OctoPrint. Это поможет сделать вашу систему более безопасной, что особенно важно, если вы решите разрешить доступ через интернет. Введите следующие команды, чтобы выполнить следующие действия:

1. Создайте новую учетную запись пользователя под именем octo: sudo useradd -m octo.
2. Выберите пароль по своему усмотрению, мы используем простой (octo), но убедитесь, что ваш пароль соответствует современным стандартам безопасности: sudo passwd octo
3. Добавьте учетную запись octo в группы пользователей, которые понадобятся для общения с 3D-принтером: sudo usermod -a -G tty,dialout octo

Установка OctoPrint

Наконец-то мы начали — фактическую установку OctoPrint!

1. Переключите пользователя на только что созданного пользователя octo, затем мы создадим папку для OctoPrint и переключимся в нее:
   • su octo
   • cd ~
   • cd /home/octo
   • mkdir OctoPrint && cd OctoPrint
2. Создайте виртуальную среду Python для запуска OctoPrint:
   • python3 -m venv venv venv
3. Установите OctoPrint:
   • source venv/bin/activate
   • pip install --no-cache-dir octoprint
4. Скачайте и установите небольшой вспомогательный скрипт для запуска OctoPrint при загрузке:
   • wget https://github.com/OctoPrint/OctoPrint/raw/master/scripts/octoprint.service && sudo mv octoprint.service /etc/systemd/system/octoprint.service
   • ExecStart=/home/pi/OctoPrint/venv/bin/octoprint
   • sudo systemctl enable octoprint.service
5. Активируйте, наконец, OctoPrint:
   • ~/OctoPrint/venv/bin/octoprint serve
6. Вспомнили IP, который вы записали ранее? Перейдите на него, набрав [IP]:5000 (например, 192.168.1.200:5000) в веб-браузере и вы должны увидеть работающий OctoPrint!

Оптимальный вариант

И, наконец, третий способ установки OctoPrint — это использование полуавтоматического скрипта установщика, а именно OctoPrint Deploy.

Он особенно полезен, если вы планируете установить OctoPrint на несколько машин, так как его можно использовать для «развертывания» на большом количестве 3D-принтеров, подключенных к общей сети. Он также упрощает процесс установки на отдельную машину и может быть использован на многих популярных дистрибутивах Linux, включая Ubuntu Server!

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

Требования

Чтобы начать работу с OctoPrint Deploy, вам понадобится следующее.

• Компьютер с подключением к Интернету
• Любой из следующих дистрибутивов Linux: Ubuntu 20+ (включая Ubuntu Server), Mint 20.3+, Debian, DietPi, Raspberry Pi OS, Armbian, Fedora 35+, Arch Linux или openSUSE.
• Balena Etcher, который вы будете использовать для записи образа ОС на SD-карту
• Целевая машина, на которую вы будете устанавливать OctoPrint (обычно это SBC на базе Linux)
• USB-накопитель или (Micro)SD емкостью 8 ГБ или более, в зависимости от того, какими портами оснащен ваш компьютер
• Ваш IP-адрес
• Пароль Wi-Fi (или Ethernet-кабель, если на целевой машине нет Wi-Fi)

Как пользоваться OctoPrint Deploy

Установите выбранную вами ОС на Linux-машину и подключите ее к сети; это можно сделать, следуя шагам «The Slightly Trickier Way > Preliminary Steps > Install Ubuntu Server» и «The Slightly Trickier Way > Preliminary Steps > Check your IP».

Далее вам нужно подключиться к вашему устройству, чтобы загрузить и использовать сценарий оболочки OctoPrint Deploy. Если вы используете ОС без графического интерфейса или работаете «без головы» (то есть без подключенных монитора и клавиатуры), вам нужно будет подключиться к устройству по SSH, чтобы запустить скрипт. Это просто способ управлять вашей Linux-машиной с другого компьютера, используя программное обеспечение вроде PuTTY. Если вам нужна помощь в этом процессе, у нас есть статья о том, как включить SSH на вашем Raspberry Pi.

Как только вы подключитесь к вашей Linux-машине через SSH-сессию, останется всего пара шагов, чтобы получить и использовать OctoPrint Deploy:

1. Клонируйтесь в GitHub-репо OctoPrint Deploy с помощью команды: git clone https://github.com/paukstelis/octoprint_deploy.
2. Затем запустите сценарий оболочки с помощью команды: sudo octoprint_deploy/octoprint_deploy.sh
3. Выберите в меню пункт «Prepare System» и воспользуйтесь мастером установки. Следуйте подсказкам, которые проведут вас через установку OctoPrint и настройте его в соответствии с вашими потребностями и предпочтениями.

Вот и все! Многие опции, которые вам будут предложены, актуальны только в случае установки нескольких 3D-принтеров одновременно, так что в большинстве случаев можно просто продолжать использовать настройки по умолчанию, если вы устанавливаете только одну машину.

Если вам нужны более подробные инструкции или вы хотите узнать, как использовать OctoPrint Deploy в полной мере, загляните на страницу OctoPrint Deploy на GitHub. Там есть очень подробное объяснение всех шагов.

Следующие шаги

После того, как все это настроено, вы можете сделать еще много вещей. Например, вы можете установить статический IP. Чтобы сделать вашу жизнь еще проще, почему бы не попробовать установить пользовательское внутреннее доменное имя для вашего сервера OctoPrint? Вы также можете использовать Obico (ранее Spaghetti Detective), чтобы облегчить мониторинг вашей установки OctoPrint.

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

Как видите, нет недостатка в интересных вещах, которые можно делать с OctoPrint!