Oxidea

Appearance

OpenWrt 远程开发环境设置 ​

目标 ​

本文档指导如何在 OpenWrt 上使用 VS Code 或 Cursor 进行远程开发，并解决连接失败的问题。

环境要求 ​

  • OpenWrt 设备
  • 可以通过 SSH 连接到 OpenWrt
  • 已安装 VS Code 或 Cursor

安装必要的包 ​

在 OpenWrt 上进行远程开发时，VS Code 和 Cursor 都需要一些额外的包才能正常工作。执行以下命令来安装这些包：

安装 VS Code 和 Cursor 所需的依赖包 ​

打开 OpenWrt 的终端并执行以下命令来安装所需的包：

bash
opkg update && \
opkg install bash tar file libstdcpp6 coreutils-sleep coreutils-printenv openssh-sftp-server \
curl ca-bundle ca-certificates gzip procps-ng-ps which coreutils-base64 wget-ssl node

配置 SSH 访问 ​

  1. 确保你的 OpenWrt 设备已启用 SSH 访问，默认端口是 22。
  2. 配置 OpenWrt 的防火墙，确保允许通过 SSH 连接。
bash
# 允许 SSH 连接
uci set firewall.@rule[0].enabled='1'
uci set firewall.@rule[0].src='wan'
uci set firewall.@rule[0].target='ACCEPT'
uci commit firewall
/etc/init.d/firewall restart

在 VS Code 中连接 ​

  1. 打开 VS Code，点击左侧栏的 "Remote Explorer" 图标。
  2. 选择 "SSH Targets" 并点击 "Add New SSH Host"。
  3. 输入 OpenWrt 设备的 IP 地址和 SSH 用户名。
  4. 使用刚才安装的 SSH 配置连接到设备。

在 Cursor 中连接 ​

  1. 打开 Cursor，选择 "SSH" 连接类型。
  2. 输入 OpenWrt 设备的 IP 地址、SSH 用户名和密码。
  3. 点击 "Connect" 进行连接。

连接失败解决方案 ​

如果在连接过程中遇到连接失败的问题，可以尝试以下步骤：

  1. 确保 OpenWrt 设备的网络配置正确，并且设备可以通过 SSH 访问。
  2. 检查 OpenWrt 上是否已安装所需的依赖包，确保没有遗漏。
  3. 检查防火墙设置，确保没有阻止 SSH 连接。
  4. 如果使用的是非默认端口（例如，端口22已被修改），请确保在 VS Code 或 Cursor 中配置正确的端口号。

其他注意事项 ​

  • 确保 OpenWrt 上的文件系统空间足够。
  • 在安装大量包时，请确保 OpenWrt 设备有足够的存储空间。