安装

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

选择您的操作系统：

选择安装方式：

Snap 包

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

1

安装 Rayforge

sudo snap install rayforge

2

授予权限（重要！）

需要权限

Snap 版本在沙盒中运行，需要手动授予硬件访问权限。

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

3

验证权限

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

---

下一步

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