---

一、问题本质

---

① 下载慢 / 卡死

现象：

Downloading server...
0.1%...

原因：

• ARM 板子访问国外服务器慢

• 无 CDN / 无代理

---

② 手动安装但不生效

 原因：

• 目录结构不对（没带 commit_id）

---

③ 一直卡 Waiting for lock

原因：

• 残留进程 / 锁文件

---

 二、最终正确的解决流程（核心步骤）

 步骤1：本地下载 server

在电脑下载：

windsurf-reh-linux-arm64-xxx.tar.gz

---

步骤2：传到板子

scp xxx.tar.gz orangepi@IP:/home/orangepi/

---

步骤3：构建正确目录结构

mkdir -p ~/.windsurf-server/bin/<commit_id>

---

步骤4：解压到指定目录

tar -zxvf xxx.tar.gz -C ~/.windsurf-server/bin/<commit_id>

例如：  id需要根据windsurf的日志里面提取

tar -zxvf windsurf-reh-linux-arm64-1.9577.43.tar.gz -C ~/.windsurf-server/bin/745a6c1ac471cc11f782a05d2c3ceacbc1de308f

---

步骤5：修复权限

chmod -R 755 ~/.windsurf-server

---

步骤6：杀掉残留进程（关键）

pkill -f curl
pkill -f windsurf
pkill -f node

---

步骤7：删除临时文件

rm -rf /tmp/tmp.*

---

步骤8：创建完成标志（最关键！）

touch ~/.windsurf-server/bin/<commit_id>/.complete

---

步骤9：重新连接

直接秒连成功