← 返回列表

Tuoni: 跨平台红队演练框架

聚合站 SecWiki技术 入库 2026-11-18T02:37:37

Tuoni is a cross-platform red teaming framework built for cyber defense exercises and security training. It provides a browser-based interface, a modular plugin system, and streamlined reporting — deployed through Docker in minutes.

Agent graph view

Agent terminal

wget -O - https://tuoni.sh | bash
cd /srv/tuoni

Or with curl:

curl https://tuoni.sh | bash
cd /srv/tuoni

Running the installer again will update Tuoni to the latest version. The Tuoni service will restart automatically.

Upgrades reconcile managed configuration files with changes to their examples
before stopping services. Application and client start and restart commands
also reconcile configuration before starting containers. Currently this covers
nginx/tuoni.conf and nginx/example/example.tuoni.conf. It applies to any example
change, including the WebSocket proxy headers required by newer clients; those
headers remain compatible with client 0.16.1.

Configuration state Upgrade behavior
Example unchanged Preserve the active file, including customizations.
Example changed; active file matches the previous example Back up the active file and install the new example automatically, including in silent mode.
Example changed; active file was customized Prompt to replace, keep, or abort (default). Silent upgrades fail unless forced.
Previous example unavailable or unverified Recognize defaults from local release tags; otherwise require review or force, unless the active file already matches the new example.

The listen port from config/tuoni.yml is preserved. Configuration-only updates
restart the client and nginx. Choosing keep acknowledges the new example;
you must merge required changes yourself, and the same example will not prompt
again. Keeping a customized file means you have checked that it includes changes
required by the new release. Aborting preserves the active file and running
services, but does not undo the Git pull or a version change already made by an
older updater.

To back up and replace conflicting files during a silent upgrade:

tuoni update-silent --force-config
For older CLI versions, or the installer, use the equivalent environment flag:

TUONI_FORCE_CONFIG=1 tuoni update-silent
curl https://tuoni.sh | SILENT=1 TUONI_FORCE_CONFIG=1 bash

Force replaces the entire conflicting file; it does not merge customizations.
Each replacement saves the original as nginx/tuoni.conf.bak.<unique suffix>.
Unchanged examples still preserve customizations, even with force enabled.

The 0.16.1 CLI can write TUONI_VERSION into config/tuoni.env before pulling
new scripts, then skip its upgrade steps because the versions already match.
The installer's final tuoni start now checks the active nginx file independently
of those version values. It recognizes old shipped defaults by comparing their
contents with examples from local release tags, retaining the configured port.
This also repairs stock 0.16.1 files on installations already marked as 0.17.0.

Accepted examples are recorded in config/.example-state/v2/. Older snapshots
are rechecked because they may have recorded the new example without updating
the active file. A customized file may therefore need a one-time review, even
if the old updater reported success. Silent operation fails until that review
or an explicit force replacement; it does not silently discard customizations.

Once the checkout contains these updated scripts, recover an existing installation with:

cd /srv/tuoni
SILENT=1 ./tuoni start

If a customized file blocks recovery, manually merge the required changes and
run ./tuoni start interactively to review it, or authorize a full replacement:

SILENT=1 TUONI_FORCE_CONFIG=1 ./tuoni start
Required nginx restarts are recorded on disk before configuration changes and
cleared only after nginx is recreated and nginx -t succeeds. If startup fails
or is interrupted, rerunning tuoni start retries the pending restart. A direct
update started by the old CLI still needs a subsequent tuoni start to execute
the new startup checks; the installer already performs that step.

Set SILENT=1 to run without any prompts — useful for provisioning scripts or CI pipelines:

export SILENT=1
curl https://tuoni.sh | bash
Variable Default Description
SILENT (unset) Set to 1 to skip prompts; unresolved configuration conflicts fail the upgrade
NO_UPDATE (unset) Set to 1 to skip updating the app on re-run
TUONI_FORCE_CONFIG (unset) Set to 1 to back up and replace conflicting managed files when their examples change or the previous example is unavailable
TUONI_USERNAME tuoni Initial admin username
TUONI_PASSWORD (autogenerated) Initial admin password
TUONI_DOCKER_IPV6_ENABLED false Enable IPv6 on the Docker network
TUONI_REPO ⚗️ https://github.com/shell-dot/tuoni.git Source repository override
TUONI_BRANCH ⚗️ main Branch to install from
TUONI_VERSION ⚗️ (unset) Pin a specific version
TUONI_SUDO_COMMAND ⚗️ sudo --preserve-env=... Override the sudo invocation (see note below)
TUONI_CONTAINER_REPO ⚗️ ghcr.io Container registry or proxy for pulling images

⚗️ Experimental — intended for development and testing only.

Note on TUONI_SUDO_COMMAND: the default uses sudo --preserve-env=<list>
to retain Tuoni's Compose inputs, Docker connection and TLS settings, Compose
project settings, and proxy/package-manager configuration. It works with classic
sudo on Ubuntu/Kali and sudo-rs shipped with Ubuntu 25.10/26.04. The standalone
installer uses a smaller list for package installation.
Do not override it with sudo -E: sudo-rs ignores -E, causing Compose to lose
Tuoni's runtime settings. Custom overrides replace the complete sudo invocation;
include all required names in --preserve-env=VAR1,VAR2 (no spaces). Set
TUONI_SUDO_COMMAND='' to run without sudo. When adding runtime variables to the
Compose file, also add them to the list in scripts/_init.sh.

If wget or curl are not installed, add them first:

sudo apt-get install -y wget curl
After installation, open the URL printed by the installer in your browser and log in with the credentials shown during setup.

The tuoni CLI manages the running services:

tuoni help
Full documentation is at docs.tuoni.io.

Questions, feedback, or want to get involved? Join us on Discord.

Tuoni is built on top of a number of excellent open-source projects. See ACKNOWLEDGEMENTS.md for details.

原文链接:https://github.com/shell-dot/tuoni