安装

Rayforge 适用于 Linux、Windows 和 macOS。选择您的平台并按照安装说明操作。

选择您的操作系统：

选择安装方式：

Snap 包

Snap 包适用于大多数 Linux 发行版，并在沙盒环境中包含所有依赖项。

1

安装 Rayforge

sudo snap install rayforge

2

将用户添加到 dialout 组

需要权限

在基于 Debian 的发行版上，即使使用 Snap，您的用户也必须在 dialout 组中，以避免 AppArmor DENIED 消息。

sudo usermod -a -G dialout $USER

重要： 注销并重新登录以使此更改生效。

3

授予权限（重要！）

USB 串口访问：

# Enable experimental hotplug support (one-time setup)
sudo snap set system experimental.hotplug=true

# Connect your laser via USB, then grant access
sudo snap connect rayforge:serial-port

摄像头访问：

sudo snap connect rayforge:camera

4

验证权限

snap connections rayforge

在列表中查找 serial-port。如果显示 "connected"，您就可以开始了。

验证安装

✓

启动 Rayforge

从应用程序菜单或终端启动 Rayforge。您应该能看到带有画布和工具栏的主窗口。

✓

检查版本

检查帮助 - 关于以确认安装的版本。

✓

连接您的机器

通过 USB 连接您的激光控制器，并验证串口是否出现在 Rayforge 的机器设置中。

提示

在 Linux 上，激光控制器通常显示为 /dev/ttyUSB0 或 /dev/ttyACM0。

故障排除

权限问题？

如果未检测到您的设备，请参阅 Snap 权限指南。 Snap 权限指南

串口仍然无法工作？

1. 重新插拔 USB 设备： 拔掉您的激光控制器，等待 5 秒钟，然后重新插入。
2. 重启 Rayforge 完全关闭并重新启动。
3. 检查设备是否存在：

   ls -l /dev/ttyUSB* /dev/ttyACM*

4. 如果需要，重新安装：

   sudo snap remove rayforge
   sudo snap install rayforge
   sudo snap connect rayforge:serial-port

需要帮助？

如需更多帮助，请在 GitHub 上报告问题或加入我们的 Discord。 GitHub | Discord

---

系统要求

资源	安装占用	推荐
磁盘空间	< 1 GB	因项目而异
内存	1 GB	因项目而异

实际的磁盘和内存需求取决于项目的复杂度。简单项目可能只需要很少的额外资源，而复杂项目可能轻松消耗 10 GB 或更多内存，并需要大量额外的磁盘空间。

下一步

现在 Rayforge 已安装完成，请继续首次设置以配置您的机器。