インストール

展開境界を確認してから、現行版の公式手順を実行する。

プロジェクトは 1 行のオンラインインストーラーと最小インフラ値を公開しています。評価の出発点として扱い、本番容量やセキュリティの保証とはみなさないでください。

直接回答MonkeyCode は自社チームが運用するインフラにインストールできます。

README はコンソールと開発ホストの容量を分け、オンライン導入の入口を示します。下の共通準備コードは取得と検証のみを行い、入口もインストーラーも実行しません。

入口は一時的な署名 URL を含み、確認済みリリースを識別するのはパッケージのハッシュです。展開物を人間が確認し、隔離ホストでの導入を別途判断します。取得の検証は製品導入の成功を意味しません。

使い捨てのテストから受け入れ済みの展開へ

インストーラーは手順の入口にすぎません。受け入れチェックがあるかどうかが、その結果をチームに任せられるかを決めます。

  • ステップ 1 · 隔離したインフラを準備する:コンソールと開発ホストを割り当て、DNS と TLS を定義し、許可する受信・送信経路を記録します。
  • ステップ 2 · パッケージを検証し、確認と導入は別途行う:下の共通準備コードは公式入口をデータとして読み、新しい署名 URL を取得します。確認済みバージョン、HTTPS 取得先、パッケージ SHA-256、構造、manifest の版・arch、compose SHA-256 がすべて一致してから展開します。未確認の版や不一致なら停止します。人間がファイルを読んだ後、スナップショット付き使い捨てホストでインストーラーの実行を別途判断します。パッケージと verification.json を保管しますが、イメージ tag と実行時取得物は変わり得ます。
  • ステップ 3 · Git とモデルアクセスを構成する:範囲を限定した認証情報を使い、モデル要求の宛先を決め、secret がタスク出力やログに出ないことを確認します。
  • ステップ 4 · 受け入れタスクを実行する:非機密リポジトリを clone し、build と test を実行し、diff を確認し、別のレビュアーが再現できることを確かめます。
  • ステップ 5 · 展開前に運用を計画する:バックアップ、復元、アップグレード、ロールバック、ホスト交換、容量アラート、保持、インシデントの責任者を検証します。

「セルフホスト」からこれらの統制を推定しない

実際に使う版と構成で 1 つずつ検証してください。

  • ネットワーク境界:モデル API、Git ホスト、package レジストリ、preview、更新、telemetry。
  • アイデンティティと secret:管理者アクセス、リポジトリ認証情報、モデルキー、ローテーション、取消。
  • 分離:タスク間、プロジェクト間、ホスト、ファイルシステム、プロセス、ネットワークの分離。
  • 運用:ログ、保持、バックアップ、復元テスト、アップグレード、ロールバック、脆弱性対応。

現在確認済みのパッケージを取得・検証する

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
公式入口は期限付き署名 URL を含み、同じ版でも内容が変わります。入口をデータとして厳密に読み、確認済みバージョンと HTTPS の取得先を確認し、パッケージ SHA-256、構造、manifest の版・arch、compose SHA-256 がすべて一致してから展開します。新版や不一致なら停止します。検証を飛ばしたり未確認のハッシュに替えたりしません。
ハッシュは当サイトの実測で、ベンダー署名ではありません。イメージ tag や実行時ダウンロードは固定されません。取得失敗なら新しいディレクトリで署名 URL を取り直せます。版・ハッシュ・manifest の不一致は調査が必要で、未検証のディレクトリを使い回しません。

2026-10-20 に v261009 の取得と manifest 検証を再実施.

一次資料:v261009 パッケージ準備の実測記録

2026-10-20 に両 Linux アーキテクチャのパッケージを取得し、パッケージ・構造・manifest・Compose の検証が成功しました。インストーラー、Linux バイナリー、ログイン、タスク、復元、実行時依存は実行していません。ファイル検証であり、Ubuntu 導入結果や性能測定ではありません。

実ホストは macOS arm64 で、OS バージョンは記録していません。arm64 はネイティブのアーキテクチャ検出を使用しました。amd64 は取得・ファイル検査のため platform.machine だけを x86_64 に置き換えました。amd64 の実行やエミュレーション試験ではありません。

観測日は 2026-10-20、秘匿情報を除いたレポートの公開日は 2026-10-21 です。公開日は新しい製品試験を意味しません。

パッケージの arch実測パッケージ取得要求時刻(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 を計算。ディレクトリー1件と通常ファイル6件を要求し、重複名・リンク・その他の項目を拒否。
  3. manifest の版・arch・online 種別を確認し、Compose のハッシュを計算した後に限りファイルを展開。
  4. 両 arch で公開の準備専用フローを実行し、元パッケージと検証記録を非公開で保管。

保管済み arm64 パッケージのオフライン準備も成功しました(exit 0、ネットワーク・インストーラー実行なし)。その検査の正確な時刻は未記録です。

別途、異常入力の拒否を含む不活性フィクスチャ試験17件が成功しました。ネットワークもベンダーコードも実行しておらず、製品導入17回を意味しません。

観測した制限:同じ版でも入口テキストは変わる

同日の公式入口2件はともに v261009 を報告しましたが SHA-256 は異なりました。入口には期限付き署名 URL が含まれます。下表はテキストの差異であり、インストーラー実行後の失敗ではありません。パッケージ検証は省略しません。

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

この記録では確認できないこと

SHA-256 はコミュニティーの実測でベンダー署名ではありません。実行時イメージ tag と外部取得物は可変です。Ubuntu 製品導入・ログイン・タスク・復元・本番受け入れは未実施です。当サイトはパッケージをミラー配布せず、旧版の継続取得も保証しません。

JSON は非公開の元記録をファイル名と SHA-256 で識別します。取得ログには署名 URL とローカルパスが含まれるため非公開とし、公開レポートから除いています。

導入せずに自分のパッケージから再計算

上の準備手順で取得するか、自分で保管したコピーを使います。記録と検証器を取得し、Python ファイルを先に読んでから、例のパスと arch を置き換えます。検証器はローカルファイルを読むだけで、取得・展開・内容の実行はしません。

実行前に 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

成功時はパッケージと Compose のハッシュを JSON で出力し、不一致なら STOP で終了します。公式取得物の変更や旧版の取得不能時は調査のため停止し、ハッシュを勝手に置換したり検証を省略したりしません。

人間が確認し、導入は別の操作として行う

表示されたディレクトリで install.sh、package.env、docker-compose.yml、.env.example、manifest.json を読み、同梱 installer と外部ダウンロードを評価します。自分で確認した後に限り、スナップショット付き使い捨て Linux ホストでそのディレクトリに移動し、下のコマンドを実行します。製品全体の導入・ログイン・タスク・復元は本ページでは検証していません。

sudo ./install.sh

自組織で保管したパッケージから再現する

当サイトは過去のパッケージを配布しません。この v261009 を保管している場合は MONKEYCODE_PACKAGE に絶対パスを設定して同じ準備コードを実行します。入口を省略しても、パッケージ・arch・manifest・compose の検証は残ります。保管分がなければ現行の公式入口が取得元で、旧版の継続提供は約束しません。元のパッケージ、verification.json、確認した実行時依存を非公開で保管してください。

失敗と復旧

インストーラーは自動実行されません。未対応ハードウェアは取得前、パッケージ・manifest・構造の不一致は展開前に停止します。準備失敗時の新規ディレクトリは調査用に残り、原因解決後は別のディレクトリで再試行します。別途開始した導入が部分的に失敗したらホストのスナップショットを復元します。再実行の安全性は仮定しません。

文書化された開始点

汎用サーバー 1 台ではなく、二つのインフラ役割。

これらは公開された最小値です。並行環境、リポジトリ規模、ビルド、preview、model、ログ、保持が要件を押し上げます。

構成要素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 ストレージを挙げています。
1 行のインストーラーは本番に十分ですか?
いいえ。それは導入の入口です。本番展開には容量計画、ネットワーク、認証情報、バックアップ、モデル経路、監視、アップグレード、セキュリティの判断が別途必要です。

証拠に関する注記

プライベート、オンプレミス、オフラインは同義ではありません。オフラインではモデルや更新の経路も設計が必要です。

MONKEYCODE

展開境界を確認してから、現行版の公式手順を実行する。

Cookie 設定

分析目的(GA4・Matomo)のみにクッキーを使用します。広告やクロスサイト追跡は行いません。