Practical guides5 min read

Ubuntu 部署 MonkeyCode:预检、安装与验收

直接答案

提供已在 Ubuntu 环境验证的预检脚本、带版本的安装入口记录、具体安装步骤、预期检查和部分安装后的恢复方法。

**已测试范围:**9 月 8 日,预检脚本在 Ubuntu 24.04.4 LTS ARM64 容器通过。安装入口下载和 Shell 语法通过,入口报告 v260904。该测试没有安装或验收完整产品、控制台登录、开发主机和恢复流程。

1. 准备独立评估主机

项目 README 给出的控制台最低配置为 2 核、4 GB 内存、40 GB 存储;开发主机单独列为 8 核、16 GB、100 GB。这是公开起点,不是并发承诺;预检容器不能替代两种基础设施角色。

使用可丢弃的 Ubuntu 虚拟机,保留控制台访问并创建快照。记录架构、可用空间和网络路径。缺少基础工具时先安装系统工具,再运行只读预检:

sudo apt-get update
sudo apt-get install -y curl ca-certificates procps python3
curl -fL https://monkeycode.cc/examples/ubuntu-preflight.sh -o ubuntu-preflight.sh
less ubuntu-preflight.sh
bash ubuntu-preflight.sh

预期输出包含系统、架构、CPU、内存、存储、“Installer syntax: passed”和版本标签。可查看真实预检输出。预检不会创建产品服务。

2. 下载校验后再决定安装

在评估主机上打开中文安装包准备流程。它将官方入口当文本读取,取得新的签名包地址,强制校验已审阅包的 SHA-256、归档结构、manifest 版本/架构及 compose SHA-256,全部通过才解压。流程不运行入口或安装器。2026-10-20 已实际下载并检查两个架构包,未进行产品安装与运行验收。

入口字节会随签名地址变化,旧入口全文哈希不能标识包。共享流程继续强制校验包完整性,发现未知版本或任何不符就停止。请审阅解出的 install.sh、package.env、docker-compose.yml、.env.example、manifest.json、包内安装器及外部下载。自行审阅后,才在有快照的一次性 Linux 主机上进入输出的确切目录,另行决定执行 sudo ./install.sh。

精确复现 v261009 时,通过留存包选项使用自己保存的原包,仍执行相同校验。本站不分发历史包,也不承诺旧官方包始终可取。请私下保留原包与 verification.json。这些哈希是独立实测,不是厂商签名;镜像 tag 和运行时下载仍可变化。下载失败可另建目录重试以刷新地址;版本、哈希、manifest 或归档异常必须先审阅。包检查不能把上方历史 Ubuntu 容器预检变成已完成的产品安装。

可查看第一手安装包准备记录,核对压缩包字节、包与 Compose 哈希、manifest 字段及只读复算步骤。实际宿主为 macOS arm64,amd64 检查仅覆写架构检测;这不是 Ubuntu 产品安装验证。

3. 按实际生成的配置继续

使用安装输出给出的地址和服务说明,不猜测控制台端口、默认密码或系统服务名称。配置控制台与开发主机,连接测试仓库和可用模型路由,确认任务环境能获取依赖并运行检查命令。

4. 完整任务验收后再引入团队代码

跑通首个任务的克隆、执行和差异评审。重启任务环境后重新连接,检查文件与结果。保存实际安装版本、运行环境/镜像版本、配置位置,以及该版本提供的备份恢复命令。

失败恢复

root、系统或架构报错说明前置条件不符。下载失败可能需要新入口脚本和网络检查。部分安装失败时,先检查输出并恢复临时虚拟机快照再重试,不能假设重复运行具有幂等性。在另一个隔离主机完成备份恢复后,才能判断是否达到生产要求。

Cookie 设置

我们仅使用 cookie 用于统计分析(GA4 和 Matomo),不会投放广告或跨站追踪。