octoprint/octoprint

OctoPrint-docker

这是octoprint/octoprint的主要镜像。其设计目标是与OctoPi树莓派机器镜像的工作方式相似，并支持相同的开箱即用功能，通过Docker实现。

标签

• latest - 始终跟踪最新的_稳定_版本
• edge - 始终跟踪最新版本_包括预发布版本_
• canary - 跟踪https://github.com/OctoPrint/OctoPrint/tree/maintenance%E5%88%86%E6%94%AF
• bleeding - 跟踪https://github.com/OctoPrint/OctoPrint/tree/devel%E5%88%86%E6%94%AF

目录

• OctoPrint-docker
  • 使用方法
    • 配置
      • 通过Docker启用摄像头支持
      • OctoPrint中的摄像头设置
      • 基于容器环境的配置
      • 手动编辑配置文件
  • 不使用docker-compose
  • 自行构建镜像

使用方法

我们建议通过docker-compose运行OctoPrint的Docker容器，并已包含一个推荐的https://github.com/OctoPrint/octoprint-docker/tree/master/docker-compose.yml%E6%96%87%E4%BB%B6%E4%BE%9B%E6%82%A8%E4%BD%BF%E7%94%A8%E3%80%82

将此文件内容保存到您的机器上，命名为docker-compose.yml，然后运行docker-compose up -d。

在http://<octoprint_ip_or_url>访问OctoPrint。

首次启动使用Docker的OctoPrint时，请参考初始设置获取配置值。

配置

通过Docker启用摄像头支持

要使用摄像头，需确保摄像头服务已启用。通过在docker run命令或docker-compose.yml文件中设置环境变量ENABLE_MJPG_STREAMER=true来实现。

您还需要在docker run命令中添加--device /dev/video0:/dev/video0，或确保其在docker-compose.yml的devices数组中列出。

如果映射的视频设备_不是_/dev/video0，则还需要设置环境变量CAMERA_DEV以匹配映射的设备路径。

有关通过Docker配置的完整摄像头配置选项列表，请参见基于容器环境的配置。

OctoPrint中的摄像头设置

在初始设置的“摄像头和延时摄影”设置界面中使用以下值：

基于容器环境的配置

可以通过容器的--environment选项传递配置值。以下是选项及其默认值。这些选项在示例https://github.com/OctoPrint/octoprint-docker/tree/master/docker-compose.yml%E4%B8%AD%E5%B7%B2%E9%9A%90%E5%90%AB%EF%BC%8C%E5%A6%82%E9%9C%80%E4%BF%AE%E6%94%B9%EF%BC%8C%E8%AF%B7%E5%8F%82%E8%80%83docker-compose%E6%96%87%E6%A1%A3%E4%B8%AD%E5%85%B3%E4%BA%8E%E8%AE%BE%E7%BD%AE%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%E7%9A%84%E8%AF%B4%E6%98%8E%E3%80%82

注意：即使显式声明了CAMERA_DEV，您仍然需要在docker-compose文件或docker命令中声明device映射。CAMERA_DEV的值用于启动mjpg-streamer服务，而devices映射用于让Docker确保容器可以访问该设备。

例如，如果将CAMERA_DEV更改为/dev/video1，则还需要在容器中映射/dev/video1:/dev/video1。

手动编辑配置文件

此docker-compose文件还包含一个基于容器的vscode实例，可通过与OctoPrint实例相同的URL在浏览器中访问，使您无需登录OctoPrint主机即可编辑配置文件。

要使用此编辑器，只需取消注释https://github.com/OctoPrint/octoprint-docker/tree/master/docker-compose.yml#L20-L32%E4%B8%AD%E6%8C%87%E7%A4%BA%E7%9A%84%E8%A1%8C%EF%BC%8C%E7%84%B6%E5%90%8E%E8%BF%90%E8%A1%8C%E4%BB%A5%E4%B8%8B%E5%91%BD%E4%BB%A4%EF%BC%9A

docker-compose up -d config-editor

现在在浏览器中访问http://<octoprint_ip_or_url>:8443/?folder=/config即可编辑OctoPrint文件！使用“资源管理器”（可通过点击汉堡菜单图标访问）浏览文件夹和文件，将其加载到编辑器工作区。

所有配置文件都位于/config文件夹中，活动配置可在/config/config.yaml中访问。

完成后，建议停止并删除此服务/容器：

docker-compose stop config-editor && docker-compose rm config-editor

有关配置编辑器的完整文档，请参见产品文档：https://github.com/cdr/code-server。

不使用docker-compose

如果您倾向于不使用docker-compose，首先在主机上创建octoprintdocker卷，然后启动容器：

docker volume create octoprint
docker run -d -v octoprint:/octoprint --device /dev/ttyACM0:/dev/ttyACM0 --device /dev/video0:/dev/video0 -e ENABLE_MJPG_STREAMER=true -p 80:80 --name octoprint octoprint/octoprint

自行构建镜像

如果您想自行构建docker镜像，请阅读https://github.com/OctoPrint/octoprint-docker/tree/master/CONTRIBUTING.md%E4%BA%86%E8%A7%A3%E8%AF%A6%E7%BB%86%E6%AD%A5%E9%AA%A4%E3%80%82