forked from heavy-duty/box
5defd40bca
Follow-up to the rename, per operator direction — the divergence is
reversed and the cut is complete:
- Host stack: boxnet (10.88.0.0/24 — a pre-rename host may still carry
claudenet on 10.87, two bridges must not claim one subnet),
box-isolate, nft tables 'inet box'/'bridge box', box-firewall.{sh,
service}. teardown-host now strips BOTH name generations, so one
script uninstalls a host of any age.
- Default template is blank: 'box new --name x' mints bare Debian;
the claude box is '--template claude'. The login hint follows the
EFFECTIVE template read off the instance, so clones of claude boxes
still get it and blank boxes are not told to run a binary they lack.
- The drill validates templates: listing, unknown-template refusal,
the allowlist rejecting BOX_NETWORK by name, and a full blank mint —
default resolves to blank, metadata stamped, box-net placement, exec
lands in 'dev', no claude binary, and isolation parity (egress +
pinned DNS) on the same contract as every template.
- drill/wipe.sh: scorched earth for drill hosts. Both tag generations,
every drill-named instance, networks/ACLs/profiles/firewall of both
generations, cached images, and (--purge-storage) the default pool.
Ends by asserting the ABSENCE of every artifact rather than trusting
the removals' exit codes.
153 lines
7.5 KiB
Bash
Executable file
153 lines
7.5 KiB
Bash
Executable file
#!/usr/bin/env bash
|
|
# One-time host setup: install Incus, create the isolated network + ACL and
|
|
# the box-net profile. Idempotent. Ubuntu 24.04 / Debian 13.
|
|
set -euo pipefail
|
|
|
|
here="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
|
|
|
|
if ! command -v incus >/dev/null; then
|
|
sudo apt-get update
|
|
sudo apt-get install -y incus
|
|
fi
|
|
|
|
if ! id -nG "$USER" | grep -qw incus-admin; then
|
|
sudo usermod -aG incus-admin "$USER"
|
|
echo "NOTE: added $USER to incus-admin — re-login (or 'sg incus-admin') and re-run."
|
|
exit 0
|
|
fi
|
|
|
|
# Storage pool + base config (safe to re-run: skipped once the pool exists).
|
|
# NOT 'incus admin init --minimal': minimal picks the 'dir' backend, which has
|
|
# no copy-on-write — every snapshot and clone is a FULL copy of the box's root,
|
|
# several GB and minutes apiece once a box is provisioned, against a workflow
|
|
# whose whole point is "log in once, snapshot, clone forever" (#29). btrfs on
|
|
# a loop device gives CoW (near-instant, near-free clones) with no
|
|
# partitioning. The preseed mirrors exactly what --minimal creates (pool,
|
|
# incusbr0, default profile) with only the driver deliberate; dir remains the
|
|
# fallback so a host that cannot do btrfs still works — just slowly, and it
|
|
# says so.
|
|
if ! incus storage show default >/dev/null 2>&1; then
|
|
driver=btrfs
|
|
command -v mkfs.btrfs >/dev/null 2>&1 || sudo apt-get install -y btrfs-progs || driver=dir
|
|
if ! incus admin init --preseed <<PRESEED
|
|
storage_pools:
|
|
- name: default
|
|
driver: $driver
|
|
networks:
|
|
- name: incusbr0
|
|
type: bridge
|
|
profiles:
|
|
- name: default
|
|
devices:
|
|
root:
|
|
path: /
|
|
pool: default
|
|
type: disk
|
|
eth0:
|
|
name: eth0
|
|
network: incusbr0
|
|
type: nic
|
|
PRESEED
|
|
then
|
|
echo "storage: $driver preseed failed — falling back to --minimal (dir: every clone is a full disk copy)" >&2
|
|
incus admin init --minimal
|
|
fi
|
|
echo "storage: pool 'default' driver = $(incus storage show default | awk '/^driver:/ {print $2}')"
|
|
fi
|
|
|
|
# Isolated NAT network. IPv6 off: one less egress path to reason about.
|
|
# 10.88, not 10.87: a pre-rename host may still carry claudenet on 10.87 with
|
|
# legacy boxes attached — two bridges must not claim one subnet.
|
|
incus network show boxnet >/dev/null 2>&1 || incus network create boxnet \
|
|
ipv4.address=10.88.0.1/24 ipv4.nat=true ipv6.address=none
|
|
|
|
# ACL: default egress allow (internet), explicit drops for private space.
|
|
# Gateway carve-out first so instance DNS (dnsmasq on 10.88.0.1) survives.
|
|
if ! incus network acl show box-isolate >/dev/null 2>&1; then
|
|
incus network acl create box-isolate
|
|
incus network acl rule add box-isolate egress action=allow destination=10.88.0.1/32
|
|
incus network acl rule add box-isolate egress action=drop destination=10.0.0.0/8
|
|
incus network acl rule add box-isolate egress action=drop destination=172.16.0.0/12
|
|
incus network acl rule add box-isolate egress action=drop destination=192.168.0.0/16
|
|
incus network acl rule add box-isolate egress action=drop destination=169.254.0.0/16
|
|
incus network acl rule add box-isolate egress action=drop destination=100.64.0.0/10
|
|
fi
|
|
incus network set boxnet security.acls=box-isolate \
|
|
security.acls.default.egress.action=allow \
|
|
security.acls.default.ingress.action=drop
|
|
|
|
# A box must not be able to ENUMERATE its siblings, either. dnsmasq on the
|
|
# gateway serves DNS (that carve-out is what makes egress resolution work) and
|
|
# it holds a record for every instance on the network — so 'getent hosts <box>'
|
|
# from inside one box resolved another's name and address. Connection blocked,
|
|
# reconnaissance wide open. dns.mode=none stops it registering instance records;
|
|
# forwarding for public names is unaffected (verified live).
|
|
incus network set boxnet dns.mode=none
|
|
|
|
# A box's resolver must not be a function of the host's VPN posture (#33).
|
|
# The bridge's dnsmasq forwards to whatever sits in the HOST's /etc/resolv.conf
|
|
# at that moment. On a Tailscale/VPN host that is MagicDNS: box DNS flaps with
|
|
# the tailnet (this is what killed cold mints), and tailnet peer names and
|
|
# split-DNS zones RESOLVE from inside a box — name-level reconnaissance of a
|
|
# private network, the same shape as the sibling enumeration closed above.
|
|
# no-resolv detaches dnsmasq from the host's resolver entirely; server= pins a
|
|
# stable public upstream (override: BOX_DNS="ip ip…"). raw.dnsmasq is the
|
|
# lever — the bridge has no first-class upstream key. Verified live on the
|
|
# drill host: pin applied, box resolves, cold mint survives.
|
|
BOX_DNS="${BOX_DNS:-1.1.1.1 8.8.8.8}"
|
|
incus network set boxnet raw.dnsmasq \
|
|
"$(printf 'no-resolv\n'; for s in $BOX_DNS; do printf 'server=%s\n' "$s"; done)"
|
|
|
|
# Sibling isolation itself is NOT an ACL rule — an L3 ACL never sees frames
|
|
# switched between two ports of one bridge. It lives in box-firewall.sh
|
|
# as an nftables bridge-family rule. See the comment there; it is the reason
|
|
# boxes cannot reach each other.
|
|
|
|
# IPv6 stays off (ipv6.address=none, above). Every rule in the ACL and every
|
|
# rule in the firewall is IPv4-only, so IPv6 would be an uncovered path, not a
|
|
# feature. That is a contract, not a default.
|
|
|
|
# --- Firewall coexistence ---------------------------------------------------
|
|
# Hosts running UFW (INPUT drop) and/or Docker (FORWARD drop) silently eat
|
|
# boxnet traffic. Punch minimal, ordered holes; the Incus ACL still layers
|
|
# on top. The trailing deny also blocks instance -> host's own (public) IPs,
|
|
# which the RFC1918-only ACL cannot express. Rules live in
|
|
# box-firewall.sh; a boot-time systemd unit re-applies the runtime-only
|
|
# parts (nft table, DOCKER-USER) after every reboot.
|
|
# The no-UFW path drives nft directly, and a stock Debian 13 cloud image ships
|
|
# neither nftables nor UFW — install the dependency we are about to use.
|
|
if ! command -v ufw >/dev/null 2>&1 && ! command -v nft >/dev/null 2>&1; then
|
|
sudo apt-get install -y nftables
|
|
fi
|
|
sudo install -m 755 "$here/host/box-firewall.sh" /usr/local/sbin/box-firewall
|
|
sudo install -m 644 "$here/host/box-firewall.service" /etc/systemd/system/
|
|
sudo systemctl daemon-reload
|
|
sudo systemctl enable box-firewall.service
|
|
# RESTART, not 'enable --now'. The unit is RemainAfterExit, so once it has run
|
|
# it stays "active" forever — and 'enable --now' does nothing to an active unit.
|
|
# Re-running setup-host after upgrading the tool therefore installed the new
|
|
# rules to /usr/local/sbin and never applied them: the host kept the old
|
|
# firewall, silently, and the box→box hole stayed open through a release that
|
|
# claimed to close it. Restart re-runs the script, which is idempotent by design.
|
|
sudo systemctl restart box-firewall.service
|
|
|
|
# Profile — box-net, the placement contract: the isolated NIC and the root
|
|
# disk, nothing a template controls (resources are stamped per-instance from
|
|
# the template at mint time). A legacy claude-dev profile is left alone:
|
|
# Incus refuses to delete an in-use profile, and pre-rename boxes reference
|
|
# it until their last one is gone — teardown-host removes it then.
|
|
if ! incus profile show box-net >/dev/null 2>&1; then
|
|
incus profile create box-net
|
|
fi
|
|
incus profile edit box-net < "$here/profiles/box-net.yaml"
|
|
|
|
# The sibling drop is the one rule whose absence is invisible: everything keeps
|
|
# working, and boxes can simply reach each other. Assert it landed.
|
|
if sudo nft list table bridge box >/dev/null 2>&1; then
|
|
echo "Isolation: box-to-box drop is live (nft bridge table 'box')."
|
|
else
|
|
echo "WARNING: the box-to-box drop is NOT active — boxes can reach each other." >&2
|
|
echo " check: sudo /usr/local/sbin/box-firewall ; sudo nft list table bridge box" >&2
|
|
fi
|
|
|
|
echo "Host ready. Launch with: box new --name <box>"
|