安装与上线

先确认部署边界,再执行当前版本的安装步骤。

项目公布了一行在线安装脚本和最低基础设施数值。请把它们当作评估起点,而不是生产容量或安全保证。

直接答案MonkeyCode 可以安装在由你的团队运维的基础设施上。

当前项目 README 记录控制台与开发主机两套容量要求,并提供在线安装入口。请使用下方共享准备代码:它只下载和校验,不执行入口或安装器。

入口含临时签名地址,包哈希才标识已审阅版本。解出的文件需人工审阅,再另行决定在隔离主机安装;下载校验通过不等于产品部署成功。

从一次性测试走到被验收的部署

安装脚本只是流程的起点;是否有验收检查,才决定结果能否交给团队使用。

  • 第 1 步 · 准备隔离的基础设施:分配控制台与开发主机,定义 DNS 与 TLS,并记录允许的入站与出站路径。
  • 第 2 步 · 先校验包,再单独审阅和安装:使用下方共享准备代码,只把官方入口当数据以获取新的签名地址;强制核对已审阅版本、HTTPS 地址、包 SHA-256、归档结构、manifest 版本/架构与 compose SHA-256,全部通过才解压。未知版本或任何不符即停止。人工审阅输出目录内文件后,才另行决定在有快照的一次性主机执行安装器。保留包与 verification.json 供日后复现;镜像 tag 与运行时下载仍可变化。
  • 第 3 步 · 配置 Git 与模型访问:使用受限凭据,决定模型请求发往何处,并确认密钥不会出现在任务输出或日志中。
  • 第 4 步 · 运行一次验收任务:克隆非敏感仓库、构建、运行测试、检查 diff,并确认另一位评审者能复现结果。
  • 第 5 步 · 上线前规划运维:测试备份、恢复、升级、回滚、主机替换、容量告警、保留策略和事件责任人。

不要因为「自托管」就推定这些控制存在

请在你实际使用的版本与拓扑中逐项验证。

  • 网络边界:模型 API、Git 服务、软件包源、预览、更新与遥测。
  • 身份与密钥:管理员访问、仓库凭据、模型密钥、轮换与吊销。
  • 隔离:任务之间、项目之间、主机、文件系统、进程与网络隔离。
  • 运维:日志、保留、备份、恢复演练、升级、回滚与漏洞响应。

下载并校验当前已审阅的安装包

前提:Linux x86_64 或 aarch64,Python 3、curl、CA 证书及可写目录。代码只下载和检查文件,不执行入口或安装器。2026-10-20 已实际下载并校验两个架构的官方包;未进行产品安装与运行验收。

# Preparation only: this block NEVER runs an installer.
# Optional: use your own retained package instead of the current official entry.
# export MONKEYCODE_PACKAGE=/absolute/path/to/monkeycode-online-linux-ARCH.tgz
python3 - <<'PY'
import hashlib, json, os, pathlib, platform, re, shutil, subprocess, tarfile, tempfile
from urllib.parse import unquote, urlsplit

VERSION = "v261009"
PINS = {"amd64": "6dd439a994920e435137101a8953ec0843131110f07eb6ef48877c98d05344c4", "arm64": "ad42bf3ed93a651fb98652374ae44bd870b29288beed04e8cd28c8d2d18e1d35"}
HOST = "monkeycode-release.oss-cn-hangzhou.aliyuncs.com"
arch = {"x86_64": "amd64", "aarch64": "arm64", "arm64": "arm64"}.get(platform.machine())
if not arch:
    raise SystemExit("STOP: unsupported architecture: " + platform.machine())
work = pathlib.Path(tempfile.mkdtemp(prefix="monkeycode-review-", dir=".")).resolve()
package = work / ("monkeycode-online-linux-" + arch + ".tgz")

def fetch(url, destination):
    subprocess.run(["curl", "--proto", "=https", "--proto-redir", "=https", "--tlsv1.2",
                    "-fsSL", "--connect-timeout", "20", "--max-time", "180", url,
                    "-o", str(destination)], check=True)

try:
    retained = os.environ.get("MONKEYCODE_PACKAGE")
    if retained:
        shutil.copyfile(pathlib.Path(retained).expanduser(), package)
    else:
        entry = work / "official-entry.txt"
        fetch("https://monkeycode-ai.com/online/install", entry)
        text = entry.read_text(encoding="utf-8")
        def declaration(name):
            values = re.findall(r'^' + name + r'="([^"\r\n]+)"$', text, re.M)
            if len(values) != 1:
                raise ValueError("missing or ambiguous entry declaration: " + name)
            return values[0]
        if declaration("VERSION") != VERSION:
            raise ValueError("official release changed; review the new package before updating pins")
        url = declaration(arch.upper() + "_URL")
        parsed = urlsplit(url)
        expected = "/online-package/" + VERSION + "/" + package.name
        if (parsed.scheme != "https" or parsed.hostname != HOST or parsed.port not in (None, 443)
                or parsed.username or parsed.password or parsed.fragment or unquote(parsed.path) != expected):
            raise ValueError("unexpected package URL; review the official entry as text")
        fetch(url, package)

    actual = hashlib.sha256(package.read_bytes()).hexdigest()
    if actual != PINS[arch]:
        raise ValueError("package SHA-256 mismatch; do not extract or run it")
    root = "monkeycode-online-linux-" + arch
    required = {root + "/" + name for name in
                ("manifest.json", "docker-compose.yml", "package.env", "install.sh", "installer", ".env.example")}
    with tarfile.open(package, "r:gz") as archive:
        members = archive.getmembers()
        names = [m.name for m in members]
        if len(names) != len(set(names)) or set(names) != required | {root}:
            raise ValueError("unexpected archive layout")
        if sum(m.size for m in members) > 64 * 1024 * 1024:
            raise ValueError("unexpected unpacked size")
        for member in members:
            safe = member.isdir() if member.name == root else member.isfile() and member.name in required
            if not safe:
                raise ValueError("unsafe archive member: " + member.name)
        manifest = json.load(archive.extractfile(root + "/manifest.json"))
        if manifest.get("version") != VERSION or manifest.get("arch") != arch or manifest.get("package_type") != "online":
            raise ValueError("manifest version/architecture/type mismatch")
        compose = archive.extractfile(root + "/docker-compose.yml").read()
        if hashlib.sha256(compose).hexdigest() != manifest.get("compose_sha256"):
            raise ValueError("compose SHA-256 mismatch")
        # Package, manifest and archive checks all finish before extraction.
        (work / root).mkdir()
        for member in members:
            if member.isfile():
                target = work / member.name
                target.write_bytes(archive.extractfile(member).read())
                target.chmod(member.mode & 0o755)
    (work / "verification.json").write_text(json.dumps({"version": VERSION, "arch": arch,
        "package_sha256": actual, "manifest_commit": manifest.get("commit"),
        "compose_sha256": manifest["compose_sha256"], "installer_executed": False}, indent=2) + "\n")
    print("VERIFIED (download/archive only; NOT installed):", VERSION, arch, actual)
    print("Review directory:", work / root)
    print("Keep the .tgz and verification.json privately for this exact release.")
except Exception as error:
    raise SystemExit("STOP: " + str(error) + "\nUntrusted files retained for inspection at: " + str(work)
                     + "\nDo not run them. Retry in a new directory after resolving the cause.")
PY
官方入口含会过期的签名地址,同一版本的入口字节也会变化。只把入口当数据严格解析,核对已审阅版本与 HTTPS 包地址,再强制校验包 SHA-256、归档结构、manifest 版本/架构及 compose SHA-256,全部通过才解压。新版本或任何不符均停止;不得绕过校验或未经审阅更换哈希。
哈希是本站实测记录,不是厂商签名。镜像 tag 与其他运行时下载仍可变化。下载失败可在新目录重跑以取得新签名地址;版本、哈希或 manifest 不符必须先审阅,不能复用未验证目录。

2026-10-20 重新完成 v261009 包下载与 manifest 校验.

第一手安装包准备记录:v261009

2026-10-20 实际下载了两个 Linux 架构包,包、归档、manifest 和 Compose 校验均通过。没有执行安装器、Linux 二进制、产品登录、任务、恢复或运行依赖。这是文件校验记录,不是 Ubuntu 产品安装结果或性能基准。

实际宿主为 macOS arm64,未记录操作系统版本。arm64 准备代码使用本机架构检测;amd64 仅将 platform.machine 覆写为 x86_64,以下载和检查文件,未测试 amd64 运行或仿真。

历史观测日期:2026-10-20。脱敏报告于 2026-10-21 发布;发布不代表新做了一轮产品测试。

包架构实测安装包下载请求时间(UTC)准备流程请求时间(UTC)
amd64
monkeycode-online-linux-amd64.tgz
6377747 bytes
SHA-256 6dd439a994920e435137101a8953ec0843131110f07eb6ef48877c98d05344c4

exit 0
arm64
monkeycode-online-linux-arm64.tgz
5837528 bytes
SHA-256 ad42bf3ed93a651fb98652374ae44bd870b29288beed04e8cd28c8d2d18e1d35

exit 0

可横向滚动查看全部测量值。

manifest 内容与已校验的 Compose 文件

两个 manifest 均声明下列版本、online 包类型和 commit。这些是包内声明,不表示独立重建了产品,也未验证该 commit 到安装包的构建来源。

v261009 · online · commit bc4bd6099bb7874ed95db01c95777a748713cfae

  • amd64 — manifest 自报构建时间:
  • arm64 — manifest 自报构建时间:

docker-compose.yml 实算 SHA-256(与两个 manifest 声明相同): 2d161ca641c079dcc4ba0d9cb034feb86dec77314802e99f90e6004cd2ce4621

实际检查了什么

  1. 只把官方入口当文本读取,核对已审阅版本与 HTTPS 包地址的主机和路径。
  2. 打开归档前测量压缩包字节与 SHA-256;要求一个目录和六个普通文件,拒绝重复名、链接和其他成员。
  3. 核对 manifest 版本、架构和 online 类型,实算 Compose 哈希后才提取文件。
  4. 对两个架构运行公开的仅准备流程;原包和校验回执均私下留存。

留存 arm64 包另经离线准备流程校验通过(exit 0,不联网、不执行安装器);该次检查未记录精确时间。

另有 17 项惰性样本安全测试通过,包含拒绝异常输入的案例;未联网或执行厂商代码,不能称为 17 次产品安装。

已观察到的限制:同一发布版的入口字节也会变化

同日两次官方入口抓取均报告 v261009,SHA-256 却不同,因为入口含会过期的签名地址。下表记录的是入口文本差异,不是执行安装器后的失败。安装包校验始终保留。

  • · 1699 bytes · SHA-256 0e31f77e6689a51d8d4e989a7c7f4643939809ff9dc4f8715026ac08de8c3461
  • · 1699 bytes · SHA-256 74362954f4a5841190e1e12bcf3aada73fe4ba51160ae394836d28019657cc22

这份记录不能证明什么

SHA-256 是社区实测,不是厂商签名。运行镜像 tag 与外部资源仍可变化。尚未完成 Ubuntu 产品安装、登录、任务、恢复或生产验收。本站不镜像分发安装包,也不保证历史包持续可下载。

JSON 用文件名和 SHA-256 标识私有原始记录。抓取日志含签名地址与本机路径,因此私下保存;公开报告已脱敏。

用自己持有的包复算,不安装产品

通过上方准备流程获取包,或使用自己留存的包。下载记录与复算器,先阅读 Python 文件,再替换示例中的包路径和架构。复算器只读取本地文件,不下载、解压或执行包内容。

运行前先阅读 verify-install-preparation.py。检查 amd64 包时,将示例中的 arm64 改为 amd64。

curl --proto '=https' --tlsv1.2 -fsSLo install-preparation.json https://monkeycode.cc/evidence/install-preparation-v261009-2026-10-20.json
curl --proto '=https' --tlsv1.2 -fsSLo verify-install-preparation.py https://monkeycode.cc/evidence/verify-install-preparation.py
python3 verify-install-preparation.py install-preparation.json /path/to/monkeycode-online-linux-arm64.tgz arm64

通过时以 JSON 输出实算的包和 Compose 哈希;不符时以 STOP 退出。官方来源改变或历史包不可取时,应停止并审阅,不得擅自替换哈希或去掉校验。

先人工审阅,再单独决定安装

打开输出的目录,阅读 install.sh、package.env、docker-compose.yml、.env.example 与 manifest.json,评估包内安装器及外部下载。经你自行审阅后,仅在有快照的一次性 Linux 主机中,进入该确切目录,主动执行下方命令。本页尚未验证完整产品安装、登录、任务执行或恢复。

sudo ./install.sh

用自己留存的包复现历史版本

本站不分发历史包镜像。若已留存此 v261009 包,把 MONKEYCODE_PACKAGE 设为其绝对路径,再运行同一准备代码:跳过可变入口,仍校验包、架构、manifest 与 compose。没有留存包时由当前官方入口提供下载,不承诺历史版本始终可取。请私下保存原包、verification.json 及审阅过的运行依赖。

失败与恢复

准备代码不自动运行安装器。不支持的硬件在下载前停止;包、manifest 或归档异常在解压前停止。准备失败留下新建目录供检查,解决原因后另建目录重试。如果另行启动的安装发生部分失败,先恢复一次性主机快照再尝试,不假设重复执行安全。

已记录的起点

两类基础设施角色,而不是一台通用服务器。

这些是已公布的最低值。并发环境、仓库规模、构建、预览、模型、日志和保留策略都会抬高要求。

组件CPU内存存储
MonkeyCode 控制台2 cores4 GB40 GB
开发环境主机8 cores16 GB100 GB

由 MonkeyCode 项目公布;核验于 2026-08-05。请为并发、构建、镜像缓存、仓库、日志和留存产物预留余量。

常见问题

常见问题解答

MonkeyCode 需要什么基础设施?
当前项目 README 列出控制台至少 2 核 CPU、4 GB 内存和 40 GB 存储,开发环境主机 8 核 CPU、16 GB 内存和 100 GB 存储。
一行安装脚本足以用于生产吗?
不够。它只是安装入口。生产部署仍然需要容量规划、网络、凭据、备份、模型路径、监控、升级和安全方面的决策。

证据说明

「私有部署」「本地部署」和「离线部署」并不等价。离线环境仍需设计模型、软件包、更新和许可证获取路径。

MONKEYCODE

先确认部署边界,再执行当前版本的安装步骤。

Cookie 设置

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