mirror of
https://github.com/qingchencloud/clawpanel.git
synced 2026-05-07 04:22:42 +08:00
137 lines
3.6 KiB
Markdown
137 lines
3.6 KiB
Markdown
# 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 板。
|
||
|
||
### 一键部署
|
||
|
||
```bash
|
||
curl -fsSL https://raw.githubusercontent.com/qingchencloud/clawpanel/main/scripts/linux-deploy.sh | bash
|
||
```
|
||
|
||
国内网络推荐使用 Gitee 镜像：
|
||
|
||
```bash
|
||
curl -fsSL https://gitee.com/QtCodeCreators/clawpanel/raw/main/scripts/linux-deploy.sh | bash
|
||
```
|
||
|
||
### 手动部署
|
||
|
||
```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）
|
||
|
||
```bash
|
||
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 板子可直接拉取。
|
||
|
||
```bash
|
||
# 安装 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
|
||
```
|
||
|
||
国内拉取慢可使用腾讯云镜像：
|
||
|
||
```bash
|
||
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
|
||
```bash
|
||
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
|
||
```bash
|
||
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 板子。
|