yuan-lab-llm--clawmanager/docs/arm64-deployment.md

ARM64 部署说明

ARM64 平台支持

本项目支持在 ARM64 (aarch64) 架构上部署，如树莓派、ARM开发板等设备。

预构建 ARM64 镜像

以下镜像可用于 ARM64 部署：

镜像	地址	说明
ClawManager 主应用	ghcr.io/yuan-lab-llm/clawmanager:latest	官方多架构镜像，包含 ARM64
Skill Scanner	ghcr.io/yuan-lab-llm/skill-scanner:latest	官方镜像已支持 ARM64

使用预构建镜像

# 拉取ARM64镜像
docker pull ghcr.io/yuan-lab-llm/clawmanager:latest --platform linux/arm64
docker pull ghcr.io/yuan-lab-llm/skill-scanner:latest --platform linux/arm64

从源码构建 ARM64 镜像

后端静态编译

cd backend
CGO_ENABLED=0 go build -ldflags="-s -w -extldflags=-static" -o bin/clawreef-server ./cmd/server

Docker 多平台构建

# 构建并推送多平台镜像
docker buildx build --platform linux/amd64,linux/arm64 -t ghcr.io/your-name/clawmanager:latest --push .

skill-scanner ARM64 构建（可选）

ghcr.io/yuan-lab-llm/skill-scanner:latest 已支持 ARM64 平台。

如需自定义镜像，可从源码构建：

# 克隆仓库
git clone https://github.com/Yuan-lab-LLM/skill-scanner.git
cd skill-scanner

# 使用代理构建（国内网络需要）
export http_proxy="http://your-proxy:port"
export https_proxy="http://your-proxy:port"

# 构建并推送ARM64镜像
docker buildx build --platform linux/arm64 \
  -t ghcr.io/your-name/skill-scanner:latest \
  --push .

Kubernetes ARM64 部署

修改镜像地址

在 clawmanager.yaml 中确认镜像地址支持 ARM64：

# 主应用
image: ghcr.io/yuan-lab-llm/clawmanager:latest

# skill-scanner（如果需要）
image: ghcr.io/yuan-lab-llm/skill-scanner:latest

数据库初始化

首次部署需要手动创建数据库用户：

kubectl exec -it -n clawmanager-system mysql-xxx -- mysql -u root

# 在MySQL中执行
CREATE USER IF NOT EXISTS 'clawmanager'@'%' IDENTIFIED BY 'your-password';
GRANT ALL PRIVILEGES ON *.* TO 'clawmanager'@'%' WITH GRANT OPTION;
CREATE DATABASE IF NOT EXISTS clawmanager CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
FLUSH PRIVILEGES;

已知问题

ClawManager 官方镜像支持 ARM64

• 状态: ghcr.io/yuan-lab-llm/clawmanager:latest 发布为多架构镜像
• 支持平台: linux/amd64、linux/arm64
• 部署方式: ARM64 节点会自动拉取对应架构镜像，无需单独维护主应用镜像地址

skill-scanner 官方镜像支持 ARM64

• 状态: ghcr.io/yuan-lab-llm/skill-scanner:latest 已提供 ARM64 平台镜像
• 部署方式: ARM64 节点会自动拉取对应架构镜像
• 建议: 如需可复现部署，建议使用固定 tag 而非 latest

ARM64 设备性能注意

• 建议设备内存 >= 4GB
• 建议使用 SSD 存储（项目数据目录 /mnt/Storage1）
• 建议配置 swap 以避免内存不足

测试环境

以下环境已验证可正常运行：

• 开发板: S922X-Oes-Plus (Amlogic S922X)
• 系统: Armbian OS 26.05.0 trixie
• 内核: 6.12.80-ophub
• 内存: 3.6GB RAM
• 存储: 110GB SSD
• 集群: k3s v1.34.6