Skip to content

Latest commit

 

History

History
136 lines (101 loc) · 3.57 KB

armbian-deploy.md

File metadata and controls

136 lines (101 loc) · 3.57 KB

Armbian / ARM 设备部署指南

ClawPanel 支持在 ARM 开发板（如 Orange Pi、Raspberry Pi、RK3588 等）上运行，通过 Web 模式 或 Docker 模式 部署，无需图形界面。

系统要求

项目 最低要求 推荐
架构 ARM64 (aarch64) ARM64
内存 1GB 2GB+
存储 2GB 可用空间 4GB+
系统 Armbian / Debian / Ubuntu Armbian 24+
Node.js 18+ 22 LTS

⚠️ 当前不支持 ARM 32 位 (armv7) 的 Docker 镜像。Web 模式在 armv7 上可用（只要 Node.js 支持）。

方式一：Web 模式（推荐）

Web 模式是纯 Node.js 服务，零 GUI 依赖，最适合 ARM 板。

一键部署

curl -fsSL https://raw.githubusercontent.com/qingchencloud/clawpanel/main/scripts/linux-deploy.sh | bash

国内网络推荐使用 Gitee 镜像：

curl -fsSL https://gitee.com/QtCodeCreators/clawpanel/raw/main/scripts/linux-deploy.sh | bash

手动部署

# 1. 安装 Node.js 22 LTS
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash -
sudo apt-get install -y nodejs git

# 2. 克隆项目
git clone https://github.com/qingchencloud/clawpanel.git /opt/clawpanel
cd /opt/clawpanel

# 3. 安装依赖并构建
npm ci --registry https://registry.npmmirror.com
npm run build

# 4. 启动服务
npm run serve -- --port 1420

设置开机自启（systemd）

sudo tee /etc/systemd/system/clawpanel.service << 'EOF'
[Unit]
Description=ClawPanel Web Server
After=network.target

[Service]
Type=simple
User=root
WorkingDirectory=/opt/clawpanel
ExecStart=/usr/bin/node scripts/serve.js --port 1420
Restart=on-failure
RestartSec=5
Environment=NODE_ENV=production

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable --now clawpanel

访问 http://<板子IP>:1420 即可使用。

方式二：Docker 模式

我们的 Docker 镜像已构建 linux/arm64 架构，ARM64 板子可直接拉取。

# 安装 Docker（如果还没有）
curl -fsSL https://get.docker.com | sh

# 一键启动（OpenClaw + ClawPanel 一体）
docker run -d \
  --name openclaw \
  -p 1420:1420 \
  -p 18789:18789 \
  -v openclaw-data:/root/.openclaw \
  --restart unless-stopped \
  ghcr.io/qingchencloud/openclaw:latest

国内拉取慢可使用腾讯云镜像：

docker run -d \
  --name openclaw \
  -p 1420:1420 \
  -p 18789:18789 \
  -v openclaw-data:/root/.openclaw \
  --restart unless-stopped \
  ccr.ccs.tencentyun.com/qingchencloud/openclaw:latest

性能优化建议

  1. 内存不足时：关闭不需要的系统服务，或增加 swap

    sudo fallocate -l 1G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile swap swap defaults 0 0' | sudo tee -a /etc/fstab

  2. SD 卡寿命：日志文件较多时，考虑将日志目录挂载到 tmpfs

    echo 'tmpfs /tmp tmpfs defaults,noatime,size=256m 0 0' | sudo tee -a /etc/fstab

  3. 网络：AI 计算在云端完成，板子只需稳定网络连接即可。建议使用有线以太网。

常见问题

Q: Tauri 桌面版能在 ARM 板上运行吗？ A: 不建议。Tauri 需要 WebKitGTK + 图形界面，ARM 板通常是 headless 环境。请使用 Web 模式。

Q: armv7 (32位) 板子能用吗？ A: Web 模式可以（只要能装 Node.js 18+）。Docker 模式目前只提供 arm64 镜像。

Q: 树莓派 Zero / Pi 1 能跑吗？ A: 这些是 armv6，内存也只有 256-512MB，不推荐。建议至少树莓派 3B+ 或更新的 ARM64 板子。