OctoPrint предоставляет быстрый веб-интерфейс для управления потребительскими 3D-принтерами. Это бесплатное программное обеспечение, выпущенное под лицензией GNU Affero General Public License V3.
Его веб-сайт можно найти по адресу Octoprint.org.
Форум сообщества доступен по адресу Community.octoprint.org. Он также служит центральной базой знаний.
Приглашение на сервер Discord можно найти по адресу discord.octoprint.org.
Доступ к часто задаваемым вопросам можно получить на странице faq.octoprint.org.
Документация находится на docs.octoprint.org.
Официальный репозиторий плагинов доступен по адресу плагины.octoprint.org.
Развитие OctoPrint было бы невозможно без финансовой поддержки сообщества. Если вам нравится OctoPrint, рассмотрите возможность стать его постоянным сторонником!
В настоящее время вы просматриваете репозиторий исходного кода OctoPrint. Если вы уже установили его (например, используя целевой дистрибутив Raspberry Pi OctoPi) и хотите только узнать, как его использовать, документация может представлять для вас больший интерес. Вы также можете подписаться на форум сообщества по адресу Community.octoprint.org, где есть другие активные пользователи, которые смогут помочь вам с любыми вопросами.
Приветствуются любые вклады, не только в виде кода, но и в виде официальной документации, помощи в отладке в системе отслеживания ошибок, поддержки других пользователей на форуме сообщества по адресу Community.octoprint.org или официальном дискорде на Discord. .octoprint.org, а также в финансовом отношении.
Если вы считаете, что что-то плохое в OctoPrint или его документации в ее нынешнем виде, пожалуйста, помогите сделать ее лучше, а не просто жалуйтесь на нее — в конце концов, это проект с открытым исходным кодом :)
Информацию о том, как отправлять отчеты об ошибках или запросы на включение, см. в Руководстве по участию в проекте.
Инструкции по установке из исходников для разных операционных систем можно найти на форуме.
Если вы хотите запустить OctoPrint на Raspberry Pi, вам действительно стоит взглянуть на OctoPi, который представляет собой собственный образ SD-карты, включающий OctoPrint плюс зависимости.
Общие шаги, которые в основном следует выполнить независимо от операционной системы и среды выполнения, следующие (как обычный пользователь , пожалуйста, держите руки подальше от команды sudo
!) — это предполагает, что у вас уже есть Python 3.7+, pip и virtualenv и их зависимости, установленные в вашей системе:
virtualenv venv
. Если вы хотите указать конкретный Python для использования вместо версии, используемой в вашей системе по умолчанию, вы также можете явно потребовать это с помощью параметра --python
, например virtualenv --python=python3 venv
../venv/bin/pip install OctoPrint
Затем вы можете запустить сервер OctoPrint через /path/to/OctoPrint/venv/bin/octoprint
, подробности см. в разделе «Использование».
После установки обязательно следуйте указаниям мастера первого запуска и при необходимости настройте контроль доступа.
OctoPrint зависит от нескольких модулей Python для выполнения своей работы. Они автоматически устанавливаются при установке OctoPrint через pip
.
OctoPrint в настоящее время поддерживает Python 3.7, 3.8, 3.9, 3.10, 3.11 и 3.12.
Запуск установки pip через
pip install OctoPrint
устанавливает сценарий octoprint
в папку сценариев установки Python (которая, в зависимости от того, установили ли вы OctoPrint глобально или в виртуальную среду, будет находиться в вашем PATH
или нет). В следующих примерах использования предполагается, что сценарий octoprint
находится в вашей PATH
.
Вы можете запустить сервер через
octoprint serve
По умолчанию он привязывается ко всем интерфейсам через порт 5000 (поэтому укажите в браузере http://127.0.0.1:5000
). Если вы хотите это изменить, используйте дополнительные параметры командной строки host
и port
, которые принимают IP-адрес хоста для привязки и числовой номер порта соответственно. Если, например, вы хотите, чтобы сервер прослушивал только локальный интерфейс на порту 8080, командная строка будет такой:
octoprint serve --host=127.0.0.1 --port=8080
Альтернативно хост и порт для привязки можно определить через файл конфигурации.
Если вы хотите запустить OctoPrint в качестве демона (поддерживается только в Linux), используйте
octoprint daemon {start|stop|restart} [--pid PIDFILE]
Если вы не укажете собственное местоположение pid-файла через --pid PIDFILE
, он будет создан в /tmp/octoprint.pid
.
Вы также можете указать файл конфигурации или базовый каталог (для папок uploads
, timelapse
и logs
), например:
octoprint serve --config /path/to/another/config.yaml --basedir /path/to/my/basedir
Чтобы запустить OctoPrint в безопасном режиме, который отключает все сторонние плагины, не поставляемые в комплекте с OctoPrint, используйте флаг --safe
:
octoprint serve --safe
См. octoprint --help
для получения дополнительной информации о доступных параметрах командной строки.
OctoPrint также поставляется со сценарием run
в исходном каталоге. Вы можете вызвать его для запуска сервера. Он принимает те же аргументы командной строки, что и сценарий octoprint
.
Если он не указан в командной строке, файл конфигурации config.yaml
для OctoPrint ожидается в папке настроек, которая находится по адресу ~/.octoprint
в Linux, в %APPDATA%/OctoPrint
в Windows и в ~/Library/Application Support/OctoPrint
в MacOS.
Полный обзор всех доступных параметров конфигурации можно найти в документации. Обратите внимание, что наиболее часто используемые параметры конфигурации также можно легко редактировать в диалоговом окне настроек OctoPrint.
Услуги по кроссбраузерному тестированию любезно предоставлены BrowserStack.
Профилирование осуществляется с помощью PyVmMonitor.
Отслеживание ошибок осуществляется и спонсируется Sentry.