WorkBuddy在ARM架构服务器上如何安装？信创环境适配方案

ARM架构信创环境部署WorkBuddy：三种主流方案详解

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

在信创环境下，基于ARM架构的服务器部署应用，总会遇到一些特有的“水土不服”。就拿WorkBuddy来说，如果你手头是麒麟、统信UOS这类国产操作系统，直接去官网下载x86_64或者Windows/macOS的客户端，那肯定是行不通的。好消息是，官方虽然没有提供原生的信创图形界面客户端，但其核心的Claw协议服务，完全可以通过Linux ARM64二进制服务端来部署。关键在于，你得选对方法。

下面，我们就来详细拆解三种经过验证的主流部署路径，你可以根据自身的技术栈和运维习惯对号入座。

一、二进制直装部署（推荐用于统信UOS/麒麟V10 SP3+）

这是最直接、资源占用也最低的方案。它绕过了图形界面的依赖，直接将WorkBuddy服务端以systemd服务的形式运行在系统后台，适合对系统可控性要求高、环境相对纯净的信创服务器。

首先，得确保你的系统“底子”够格。打开终端，执行uname -m，输出必须是aarch64；再用cat /etc/os-release看看，系统得是统信（uos）或麒麟（kylin），版本不能低于V10 SP3，内核也得在5.4以上。

接下来，安装必要的运行时依赖。这一步因系统而异：

• 如果是统信UOS，执行：sudo apt update && sudo apt install -y curl unzip libglib2.0-0 libsm6 libxrender1 libxext6 libnss3 libatk1.0-0 libatk-bridge2.0-0 libcups2 libdrm2 libxkbcommon0 libxcomposite1 libxdamage1 libxfixes3 libxrandr2 libgbm1 libasound2。
• 如果是麒麟V10，则需要使用yum命令安装对应的包。

依赖搞定后，创建一个专属目录：sudo mkdir -p /opt/workbuddy && cd /opt/workbuddy。然后，从官方拉取ARM64版本的服务端包：sudo curl -L https://www.codebuddy.cn/work/workbuddy-server-linux-arm64.tar.gz -o workbuddy-server-linux-arm64.tar.gz。

安全无小事，下载完务必校验文件完整性。使用sha256sum -c命令，比对官网公示的SHA256值，比如：echo "f3a7e9b2c8d1e0f4a5b6c7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8 workbuddy-server-linux-arm64.tar.gz" | sha256sum -c。

校验通过后，解压并赋予执行权限：sudo tar -xzf workbuddy-server-linux-arm64.tar.gz && sudo chmod +x workbuddy-server。

为了让服务能随系统自启并方便管理，我们需要将其配置为systemd服务。创建一个服务单元文件：

sudo tee /etc/systemd/system/workbuddy-server.service <<'EOF'
[Unit]
Description=WorkBuddy Server (ARM64)
After=network.target

[Service]
Type=simple
User=workbuddy
Group=workbuddy
WorkingDirectory=/opt/workbuddy
ExecStart=/opt/workbuddy/workbuddy-server --config /opt/workbuddy/config.yaml
Restart=always
RestartSec=10
Environment=CLAW_TOKEN=your_claw_token_here

[Install]
WantedBy=multi-user.target
EOF

最后，创建一个专用的系统用户，并启动服务：sudo useradd -r -s /bin/false workbuddy && sudo chown -R workbuddy:workbuddy /opt/workbuddy && sudo systemctl daemon-reload && sudo systemctl enable --now workbuddy-server。至此，服务就应该在后台跑起来了。

二、Docker容器化部署（适配海光/飞腾平台+麒麟容器运行时）

如果你的环境已经构建了信创容器底座（比如使用了iSulad或定制的KubeSphere Edge），那么容器化方案会是更优雅的选择。它能很好地隔离环境，避免宿主机复杂的库依赖冲突。

首先，确认容器运行时可用。在麒麟系统上，可以执行isula version；如果是在KubeSphere边缘集群，则用kubectl get nodes查看节点架构，确保显示为arm64。

接着，直接从镜像仓库拉取ARM64架构的官方镜像：sudo isula pull ccr.ccs.tencentyun.com/workbuddy/server:latest-arm64（麒麟V10 SP3+通常默认支持）。

在启动容器前，需要准备好配置文件挂载目录，并确保权限正确：sudo mkdir -p /data/workbuddy/config && sudo chown -R 1001:1001 /data/workbuddy（这里的1001对应镜像内workbuddy用户的UID）。

然后，在/data/workbuddy/config目录下创建config.yaml配置文件，至少需要包含Claw令牌和日志级别，例如：

claw_token: "your_claw_token_here"
log_level: info

万事俱备，现在可以启动容器了：

sudo isula run -d --name workbuddy-svr --restart=always \
-v /data/workbuddy/config:/app/config \
-p 8080:8080 \
--network host \
ccr.ccs.tencentyun.com/workbuddy/server:latest-arm64

启动后，别忘了验证一下服务是否健康：curl -s http://localhost:8080/health | grep '"status":"ok"' && echo "✅"。看到绿色的对勾，就说明部署成功了。

三、Ansible自动化集群部署（适配信创云管平台纳管场景）

当部署规模上升到几十甚至上百台飞腾、鲲鹏服务器时，再手动操作就太不现实了。这时，Ansible这类自动化工具的价值就凸显出来。它特别适合需要将WorkBuddy纳入统一云管平台进行运维的大规模信创场景。

首先，在Ansible控制节点（可以是x86管理机或ARM跳板机）上，确保Ansible版本不低于2.12，并且已经配置好到所有信创目标主机的SSH免密登录。

接着，编辑Ansible的主机清单文件/etc/ansible/hosts，添加一个信创服务器组：

[xinchuang_servers]
server1 ansible_host=192.168.10.101 ansible_user=opuser ansible_python_interpreter=/usr/bin/python3
server2 ansible_host=192.168.10.102 ansible_user=opuser anssible_python_interpreter=/usr/bin/python3

然后，创建核心的Playbook文件，例如workbuddy-xinchuang.yml。在Playbook中，需要定义好变量，比如workbuddy_arch: "arm64"和os_family: "uos"（或"kylin"）。

在任务编排中，可以利用community.general.archive模块来解压ARM64的安装包，再使用ansible.builtin.systemd模块来注册和启用系统服务。

这里有个关键点：Claw令牌这类敏感信息，绝不能明文写在Playbook里。正确的做法是使用Ansible Vault进行加密：ansible-vault encrypt_string 'your_real_token' --name 'CLAW_TOKEN'，然后将生成的加密字符串存入group_vars/xinchuang_servers.yml这样的组变量文件中。

最后，执行部署命令，可以精确控制范围，例如只对统信UOS的服务器组执行：ansible-playbook -i /etc/ansible/hosts workbuddy-xinchuang.yml --limit uos_servers。这样一来，批量部署和后续的标准化运维就变得轻松可控了。