OctoPrint 提供了一個用於控制消費性 3D 列印機的快速 Web 介面。它是自由軟體,根據 GNU Affero 通用公共授權 V3 發布。
其網站可以在 octoprint.org 上找到。
社群論壇位於community.octoprint.org。它還充當中央知識庫。
可以在discord.octoprint.org 上找到Discord 伺服器的邀請。
可以透過以下方式存取常見問題 faq.octoprint.org。
該文件位於 docs.octoprint.org。
可以透過plugins.octoprint.org 存取官方插件儲存庫。
如果沒有社區的財政支持,OctoPrint 的發展就不可能實現。如果您喜歡 OctoPrint,請考慮成為定期支持者!
您目前正在查看 OctoPrint 的原始碼儲存庫。如果您已經安裝了它(例如,透過使用 Raspberry Pi 目標發行版 OctoPi)並且只想了解如何使用它,那麼您可能對文件更感興趣。您可能還想訂閱加入community.octoprint.org 上的社群論壇,那裡有其他活躍用戶,他們可能能夠幫助您解決您可能遇到的任何問題。
歡迎各種形式的貢獻,不僅以程式碼的形式,還包括官方文件、錯誤追蹤器中的調試幫助、社區論壇上的其他用戶的支援community.octoprint.org或discord上的官方discord .octoprint.org 以及財務方面。
如果您認為 OctoPrint 或其文件有什麼不好的地方,請以任何方式幫助使其變得更好,而不僅僅是抱怨 - 畢竟這是一個開源專案:)
有關如何提交錯誤報告或拉取請求的信息,請參閱項目的貢獻指南。
可以在論壇上找到從原始碼安裝不同作業系統的安裝說明。
如果您想在 Raspberry Pi 上運行 OctoPrint,您確實應該看看 OctoPi,它是一個自訂 SD 卡映像,其中包含 OctoPrint 以及依賴項。
無論作業系統和執行時間環境如何,基本上應該完成的通用步驟如下(作為普通用戶,請不要使用sudo
命令!) - 這假設您已經擁有 Python 3.7+、pip 和 virtualenv 及其在您的系統上設置的依賴項:
virtualenv venv
。如果您想要指定使用特定的 python 而不是系統預設的任何版本,您也可以透過--python
參數明確要求,例如virtualenv --python=python3 venv
。./venv/bin/pip install OctoPrint
然後,您可以透過/path/to/OctoPrint/venv/bin/octoprint
啟動 OctoPrint 伺服器,有關詳細信息,請參閱用法。
安裝後,請確保遵循首次運行精靈並根據需要設定存取控制。
OctoPrint 依賴一些 python 模組來完成其工作。透過pip
安裝 OctoPrint 時會自動安裝這些。
OctoPrint 目前支援 Python 3.7、3.8、3.9、3.10、3.11 和 3.12。
透過運行 pip install
pip install OctoPrint
將octoprint
腳本安裝在 Python 安裝的腳本資料夾中(該資料夾是否位於您的PATH
中,取決於您是全域安裝 OctoPrint 還是安裝到虛擬環境中)。以下使用範例假設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 PIDFILE
提供自訂 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
腳本相同的命令列參數。
如果未透過命令列指定,則 OctoPrint 的設定config.yaml
應位於設定資料夾中,該資料夾位於 Linux 上的~/.octoprint
、Windows 上的%APPDATA%/OctoPrint
以及~/Library/Application Support/OctoPrint
MacOS上的~/Library/Application Support/OctoPrint
。
所有可用配置設定的全面概述可以在文件中找到。請注意,最常用的配置設定也可以從 OctoPrint 的設定對話框中輕鬆編輯。
BrowserStack 提供跨瀏覽器測試服務。
分析是在 PyVmMonitor 的幫助下完成的。
錯誤追蹤由 Sentry 提供支援和贊助。