mirror of
https://github.com/hanzoai/skills.git
synced 2026-11-19 00:47:36 +00:00
hanzoskills.com/llms.txt now opens with the install line, the API reference index and the company index, so an agent that lands on any one of the three can find the rest. robots.txt claimed 537 documents while llms.txt counts 920. The number is gone from robots.txt; llms.txt derives it. public/ is regenerated from scripts/site.py, which it had fallen behind: the copy-prompt menu and agent bar were in the generator and not in the committed pages. tests/site.mjs passes against the result. Co-authored-by: Hanzo Dev <[email protected]>
349 lines
22 KiB
HTML
349 lines
22 KiB
HTML
<!doctype html>
|
|
<html lang="en"><head>
|
|
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
|
|
<title>hanzo-vm</title>
|
|
<meta name="color-scheme" content="dark">
|
|
<style>
|
|
/* Committed to one visual world: a dark instrument panel. No light variant —
|
|
the dot field and the hairline rules only read on black, and a naive
|
|
inversion would wash both out. Every colour is painted explicitly so the page
|
|
never borrows a host background. */
|
|
@font-face{font-family:'Zen';src:url('/fonts/Zen-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
|
|
@font-face{font-family:'Zen';src:url('/fonts/Zen-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
|
|
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
|
|
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
|
|
@font-face{font-family:'Zen Pixel Square';src:url('/fonts/ZenPixel-Square.woff2') format('woff2');font-style:normal;font-display:swap}
|
|
|
|
:root{
|
|
--ink:#f4f4f2; --soft:#9c9c98; --faint:#6a6a66; --ground:#000; --panel:#0a0a0a;
|
|
--line:#232323; --line-hi:#3a3a3a; --accent:#f4f4f2;
|
|
--font-zen-sans:'Zen',-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif;
|
|
--font-zen-mono:'Zen Mono',ui-monospace,"SF Mono",SFMono-Regular,Menlo,Consolas,monospace;
|
|
--font-zen-pixel-square:'Zen Pixel Square',monospace;
|
|
--mono:var(--font-zen-mono);
|
|
--sans:var(--font-zen-sans);
|
|
/* Controls are pills and surfaces are soft, as on hanzo.ai. */
|
|
--r:999px; --r-soft:14px;
|
|
}
|
|
*{box-sizing:border-box}
|
|
html{-webkit-text-size-adjust:100%}
|
|
body{margin:0;background:var(--ground);color:var(--ink);font-family:var(--sans);
|
|
font-size:16px;line-height:1.65;-webkit-font-smoothing:antialiased}
|
|
.wrap{max-width:60rem;margin:0 auto;padding:0 1.75rem}
|
|
|
|
/* The dot field. A halftone made of one repeating radial-gradient, faded out
|
|
along the diagonal by a mask so it reads as a wave rather than wallpaper. */
|
|
/* No overflow clip here: the dot field is inset to the box already, and a clip
|
|
would cut off the copy-prompt menu. */
|
|
.hero{position:relative;border-bottom:1px solid var(--line)}
|
|
.hero::before{content:"";position:absolute;inset:0;
|
|
background-image:radial-gradient(var(--line-hi) 1px, transparent 1px);
|
|
background-size:7px 7px;
|
|
-webkit-mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
|
|
mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
|
|
pointer-events:none}
|
|
.hero .wrap{position:relative;padding-top:5.5rem;padding-bottom:4rem}
|
|
|
|
nav{border-bottom:1px solid var(--line)}
|
|
nav .in{max-width:60rem;margin:0 auto;padding:1.1rem 1.75rem;display:flex;
|
|
justify-content:space-between;align-items:center;gap:1rem}
|
|
.brand{font-family:var(--mono);font-size:.85rem;letter-spacing:.14em;
|
|
text-transform:uppercase;color:var(--ink);text-decoration:none;
|
|
display:inline-flex;align-items:center;gap:.6rem}
|
|
.brand i{font-style:normal;color:var(--faint)}
|
|
.mark{width:1.15em;height:1.15em;display:block;flex:0 0 auto}
|
|
nav a.up{font-family:var(--mono);font-size:.72rem;letter-spacing:.14em;
|
|
text-transform:uppercase;color:var(--soft);text-decoration:none}
|
|
nav a.up:hover{color:var(--ink)}
|
|
|
|
h1{font-family:var(--mono);font-size:clamp(2rem,5.4vw,3.4rem);line-height:1.12;
|
|
letter-spacing:-.02em;margin:0 0 1.1rem;font-weight:500;text-wrap:balance}
|
|
h1 em{font-style:normal;color:var(--faint)}
|
|
.lede{color:var(--soft);font-size:1.05rem;max-width:52ch;margin:0 0 2.25rem}
|
|
|
|
.btns{display:flex;flex-wrap:wrap;gap:.7rem;margin:0 0 .5rem;align-items:center}
|
|
.btn{display:inline-flex;align-items:center;gap:.5rem;font-family:var(--mono);
|
|
font-size:.72rem;letter-spacing:.14em;text-transform:uppercase;
|
|
padding:.8rem 1.4rem;border:1px solid var(--line-hi);border-radius:var(--r);
|
|
color:var(--ink);text-decoration:none;background:transparent;cursor:pointer;
|
|
line-height:1.2;font-weight:400}
|
|
.btn:hover{background:#141414;text-decoration:none;border-color:var(--soft)}
|
|
.btn.solid{background:var(--ink);color:#000;border-color:var(--ink)}
|
|
.btn.solid:hover{background:#d8d8d4}
|
|
.btn .chev{width:.7em;height:.7em;flex:0 0 auto;transition:transform .15s ease}
|
|
.btn[aria-expanded="true"] .chev{transform:rotate(180deg)}
|
|
|
|
/* Copy-prompt selector. Each row copies the prompt for its own target. */
|
|
.copy{position:relative;display:inline-flex}
|
|
.menu{position:absolute;top:calc(100% + .5rem);left:0;z-index:20;min-width:21rem;
|
|
background:var(--panel);border:1px solid var(--line-hi);border-radius:var(--r-soft);
|
|
padding:.4rem;display:flex;flex-direction:column;
|
|
box-shadow:0 12px 32px rgba(0,0,0,.75)}
|
|
.menu[hidden]{display:none}
|
|
.mi{display:flex;align-items:center;gap:.7rem;width:100%;text-align:left;
|
|
padding:.62rem .8rem;border:0;border-radius:calc(var(--r-soft) - .35rem);
|
|
background:transparent;color:var(--ink);font-family:var(--mono);font-size:.76rem;
|
|
letter-spacing:.04em;text-decoration:none;cursor:pointer;line-height:1.3;
|
|
white-space:nowrap}
|
|
.mi:hover,.mi:focus-visible{background:#181818;outline:none}
|
|
.mi .mark{width:1.05rem;height:1.05rem;color:var(--soft)}
|
|
.mi:hover .mark{color:var(--ink)}
|
|
.mi u{margin-left:auto;color:var(--faint);text-decoration:none;font-size:.68rem;
|
|
letter-spacing:.1em;text-transform:uppercase}
|
|
|
|
/* Works-with bar: one scrolling row, name and mark per agent. */
|
|
.strip{border-bottom:1px solid var(--line);background:var(--panel)}
|
|
.strip .in{max-width:60rem;margin:0 auto;padding:.9rem 1.75rem;display:flex;
|
|
align-items:center;gap:1.25rem;font-family:var(--mono);font-size:.72rem;
|
|
letter-spacing:.1em;text-transform:uppercase;color:var(--faint)}
|
|
.strip b{color:var(--soft);font-weight:400;flex:0 0 auto;
|
|
border-right:1px solid var(--line);padding-right:1.25rem;align-self:stretch;
|
|
display:flex;align-items:center}
|
|
.bar{display:flex;align-items:center;gap:.5rem;flex:1 1 auto;min-width:0;
|
|
overflow-x:auto;scrollbar-width:none;scroll-snap-type:x proximity;
|
|
-webkit-overflow-scrolling:touch;
|
|
-webkit-mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent);
|
|
mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent)}
|
|
.bar::-webkit-scrollbar{display:none}
|
|
.agent{display:inline-flex;align-items:center;gap:.45rem;flex:0 0 auto;
|
|
padding:.4rem .85rem;border:1px solid var(--line);border-radius:var(--r);
|
|
color:var(--soft);white-space:nowrap;scroll-snap-align:start;
|
|
text-decoration:none;background:var(--ground)}
|
|
.agent:hover{color:var(--ink);border-color:var(--line-hi);text-decoration:none}
|
|
.agent .mark{width:.95rem;height:.95rem}
|
|
|
|
h2{font-family:var(--mono);font-size:1.1rem;letter-spacing:-.01em;margin:2.75rem 0 .75rem;font-weight:500}
|
|
h3{font-size:1rem;margin:2rem 0 .5rem;font-weight:600}
|
|
h4,h5,h6{font-size:.94rem;margin:1.5rem 0 .5rem;font-weight:600}
|
|
p{margin:0 0 1rem;max-width:70ch}
|
|
ul,ol{margin:0 0 1rem;padding-left:1.35rem;max-width:70ch}
|
|
li{margin:.22rem 0}
|
|
a{color:var(--ink);text-decoration:underline;text-underline-offset:3px;
|
|
text-decoration-color:var(--line-hi)}
|
|
a:hover{text-decoration-color:var(--ink)}
|
|
a:focus-visible{outline:1px solid var(--ink);outline-offset:3px}
|
|
code{font-family:var(--mono);font-size:.85em;background:var(--panel);
|
|
border:1px solid var(--line);border-radius:5px;padding:.1em .36em}
|
|
pre{background:var(--panel);border:1px solid var(--line);padding:1rem 1.1rem;
|
|
border-radius:var(--r-soft);overflow-x:auto;margin:0 0 1.25rem}
|
|
pre code{background:none;border:0;padding:0;font-size:.82rem;line-height:1.7}
|
|
blockquote{margin:0 0 1rem;padding-left:1rem;border-left:1px solid var(--line-hi);color:var(--soft)}
|
|
hr{border:0;border-top:1px solid var(--line);margin:2.5rem 0}
|
|
table{border-collapse:collapse;width:100%;margin:0 0 1.25rem;font-size:.92rem;
|
|
display:block;overflow-x:auto}
|
|
th,td{border:1px solid var(--line);padding:.5rem .7rem;text-align:left}
|
|
|
|
.curl{display:block;background:var(--panel);border:1px solid var(--line);
|
|
border-radius:var(--r-soft);padding:.95rem 1.1rem;font-family:var(--mono);
|
|
font-size:.8rem;color:var(--soft);overflow-x:auto;margin:0 0 2.5rem;
|
|
white-space:pre;line-height:1.9}
|
|
.curl b{color:var(--ink);font-weight:400}
|
|
.curl i{font-style:normal;color:var(--faint)}
|
|
|
|
/* index */
|
|
#q{width:100%;padding:.85rem 1.2rem;font-family:var(--mono);font-size:.85rem;color:var(--ink);
|
|
background:var(--panel);border:1px solid var(--line);border-radius:var(--r);margin:0 0 .6rem}
|
|
#q::placeholder{color:var(--faint);text-transform:uppercase;letter-spacing:.1em;font-size:.72rem}
|
|
#q:focus{outline:none;border-color:var(--soft)}
|
|
#count{color:var(--faint);font-family:var(--mono);font-size:.72rem;letter-spacing:.1em;
|
|
text-transform:uppercase;margin:0 0 2rem}
|
|
.cat{margin:2.5rem 0 .5rem;font-family:var(--mono);font-size:.7rem;letter-spacing:.16em;
|
|
text-transform:uppercase;color:var(--faint);border-bottom:1px solid var(--line);
|
|
padding-bottom:.45rem}
|
|
.row{display:block;padding:.6rem .9rem;margin:0 -.9rem;border-bottom:1px solid var(--line);
|
|
border-radius:var(--r-soft);text-decoration:none}
|
|
.row:hover{background:#0a0a0a}
|
|
.nm{font-family:var(--mono);font-size:.84rem;color:var(--ink);display:block}
|
|
.ds{color:var(--soft);font-size:.9rem;display:block;margin-top:.12rem}
|
|
footer{margin-top:4rem;padding:2rem 0 4rem;border-top:1px solid var(--line);
|
|
color:var(--faint);font-size:.85rem}
|
|
footer a{color:var(--soft)}
|
|
.fmap{display:grid;gap:1.75rem;grid-template-columns:repeat(auto-fit,minmax(11rem,1fr));
|
|
margin:0 0 2rem;font-size:.85rem}
|
|
.fmap b{display:block;font-family:var(--mono);font-size:.68rem;letter-spacing:.16em;
|
|
text-transform:uppercase;color:var(--faint);font-weight:400;margin:0 0 .6rem;
|
|
border-bottom:1px solid var(--line);padding-bottom:.4rem}
|
|
.fmap a{display:inline-block;color:var(--ink);text-decoration:none;margin:.3rem .35rem 0 0}
|
|
.fmap a:hover{text-decoration:underline}
|
|
.fmap div{color:var(--faint);line-height:1.5}
|
|
.fend{border-top:1px solid var(--line);padding-top:1.25rem;font-size:.82rem}
|
|
|
|
@media (max-width:640px){
|
|
.hero .wrap{padding-top:3.25rem;padding-bottom:2.75rem}
|
|
.btns{gap:.5rem}
|
|
.btn{padding:.75rem 1.15rem;font-size:.68rem}
|
|
.copy,.copy .btn{width:100%;justify-content:center}
|
|
.menu{left:0;right:0;min-width:0}
|
|
.strip .in{flex-direction:column;align-items:flex-start;gap:.6rem;padding:.9rem 1.75rem}
|
|
.strip b{border-right:0;padding-right:0}
|
|
.bar{width:100%}
|
|
}
|
|
</style>
|
|
<link rel="alternate" type="text/markdown" href="/hanzo-vm.md">
|
|
|
|
<link rel="icon" href="/favicon.svg">
|
|
<link rel="canonical" href="https://hanzoskills.com/hanzo-vm">
|
|
</head>
|
|
<!-- Reading this with a machine? Every page here is also plain markdown.
|
|
This one: https://hanzoskills.com/hanzo-vm.md
|
|
Index: https://hanzoskills.com/llms.txt
|
|
Corpus: https://hanzoskills.com/all.md
|
|
Append .md to any path for the markdown twin. -->
|
|
<body>
|
|
<nav><div class="in">
|
|
<a class="brand" href="/"><svg class="mark" viewBox="0 0 67 67" fill="currentColor" aria-hidden="true"><path d="M22.21 67V44.6369H0V67H22.21Z"/><path d="M66.7038 22.3184H22.2534L0.0878906 44.6367H44.4634L66.7038 22.3184Z"/><path d="M22.21 0H0V22.3184H22.21V0Z"/><path d="M66.7198 0H44.5098V22.3184H66.7198V0Z"/><path d="M66.7198 67V44.6369H44.5098V67H66.7198Z"/></svg> HANZO<i>SKILLS</i></a>
|
|
<a class="up" href="/">All skills</a>
|
|
</div></nav>
|
|
|
|
<div class="wrap">
|
|
<h1>hanzo-vm</h1><p class="lede">Hanzo VM is an open-source cloud operating system and virtual machine management platform built with Go (Beego framework) and React.</p><h1>Hanzo VM - Cloud OS and VM Management Platform</h1>
|
|
<p><strong>Category</strong>: Hanzo Ecosystem <strong>Related Skills</strong>: <code>hanzo/hanzo-iam.md</code>, <code>hanzo/hanzo-platform.md</code>, <code>hanzo/hanzo-universe.md</code></p>
|
|
<h2>Overview</h2>
|
|
<p>Hanzo VM is an <strong>open-source cloud operating system and virtual machine management platform</strong> built with Go (Beego framework) and React. Go module <code>github.com/hanzoai/vm</code>, ships as a single <code>server</code> binary with a bundled web frontend. Manages VMs across multiple cloud providers (AWS, Azure, GCP, Alibaba, Tencent, DigitalOcean) and local hypervisors (libvirt, Proxmox). Authenticates via Hanzo IAM (Hanzo IAM). License: Apache-2.0.</p>
|
|
<h3>Why Hanzo VM?</h3>
|
|
<ul><li><strong>Multi-cloud</strong>: AWS EC2, Azure, GCP, Alibaba, Tencent Cloud in one dashboard</li><li><strong>Local hypervisors</strong>: libvirt (KVM/QEMU) and Proxmox VE support</li><li><strong>Hanzo IAM integration</strong>: SSO via Hanzo IAM, Casbin RBAC authorization</li><li><strong>RDP/SSH tunneling</strong>: WebSocket-based remote desktop via vmd (Guacamole daemon)</li><li><strong>Blockchain records</strong>: On-chain VM operation audit trail (<code>chain/</code> package)</li><li><strong>React frontend</strong>: Full web UI for VM lifecycle management</li></ul>
|
|
<h3>Tech Stack</h3>
|
|
<ul><li><strong>Backend</strong>: Go 1.26, Beego web framework, XORM (ORM)</li><li><strong>Frontend</strong>: React, Node.js 18, Yarn</li><li><strong>Database</strong>: PostgreSQL (default), MySQL, or any XORM-supported DB</li><li><strong>Auth</strong>: Hanzo IAM (Hanzo IAM Go SDK), Casbin RBAC</li><li><strong>RDP</strong>: vmd (Guacamole daemon, <code>ghcr.io/hanzovm/vmd</code>)</li><li><strong>Image</strong>: Multi-stage Docker (standard + all-in-one with MariaDB)</li></ul>
|
|
<h3>OSS Base</h3>
|
|
<p>Repo: <code>hanzoai/vm</code> (Casvisor fork). Default branch: <code>master</code>.</p>
|
|
<h2>When to use</h2>
|
|
<ul><li>Manage VMs across multiple cloud providers from a single dashboard</li><li>Self-hosted cloud management with IAM integration</li><li>Remote desktop access to VMs via browser (RDP/SSH tunneling)</li><li>Audit trail for VM operations with blockchain records</li><li>Local KVM/libvirt or Proxmox VM management</li></ul>
|
|
<h2>Hard requirements</h2>
|
|
<ol><li><strong>PostgreSQL</strong> (or MySQL) database accessible</li><li><strong>Hanzo IAM</strong> (Hanzo IAM) instance for authentication</li><li><strong>Go 1.21+</strong> for building from source (or Docker)</li><li><strong>Node.js 18</strong> + Yarn for frontend build</li></ol>
|
|
<h2>Quick reference</h2>
|
|
<p>| Item | Value | |------|-------| | Default Port | 19000 | | Go Module | <code>github.com/hanzoai/vm</code> | | Go Version | 1.26 (build: 1.21) | | Config | <code>conf/app.conf</code> | | Database | PostgreSQL (<code>hanzo_vm</code>) | | IAM Endpoint | <code>http://iam.hanzo.svc:8000</code> | | RDP Daemon | <code>ghcr.io/hanzovm/vmd</code> (port 4822) | | License | Apache-2.0 | | Repo | <code>github.com/hanzoai/vm</code> | | Default Branch | <code>master</code> |</p>
|
|
<h2>One-file quickstart</h2>
|
|
<h3>Build from source</h3>
|
|
<pre><code class="lang-bash">git clone https://github.com/hanzoai/vm
|
|
cd vm
|
|
|
|
# Backend
|
|
go build -o server .
|
|
|
|
# Frontend
|
|
cd web && yarn install --frozen-lockfile && yarn build && cd ..
|
|
|
|
# Run
|
|
./server</code></pre>
|
|
<h3>Docker</h3>
|
|
<pre><code class="lang-bash"># Standard (requires external DB)
|
|
docker build -t hanzo-vm .
|
|
docker run -d -p 19000:19000 hanzo-vm
|
|
|
|
# All-in-one (includes MariaDB + vmd)
|
|
docker build --target ALLINONE -t hanzo-vm-aio .
|
|
docker run -d -p 19000:19000 hanzo-vm-aio</code></pre>
|
|
<h3>Docker Compose</h3>
|
|
<pre><code class="lang-bash">docker compose up -d
|
|
# Starts hanzo-vm + PostgreSQL
|
|
# Access at http://localhost:19000</code></pre>
|
|
<h3>RDP Daemon</h3>
|
|
<pre><code class="lang-bash">docker run --name vmd -d -p 4822:4822 ghcr.io/hanzovm/vmd</code></pre>
|
|
<h2>Core Concepts</h2>
|
|
<h3>Architecture</h3>
|
|
<pre><code>┌────────────────────────────────────────────────────────────┐
|
|
│ Hanzo VM │
|
|
│ │
|
|
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
|
|
│ │ React UI │───>│ Beego API │──>│ Cloud APIs │ │
|
|
│ │ (port 19000) │ │ Controllers │ │ AWS/Azure/ │ │
|
|
│ └──────────────┘ └──────┬───────┘ │ GCP/libvirt │ │
|
|
│ │ └──────────────┘ │
|
|
│ ┌──────┴───────┐ │
|
|
│ │ PostgreSQL │ │
|
|
│ │ (hanzo_vm) │ │
|
|
│ └──────────────┘ │
|
|
│ │
|
|
│ ┌──────────────┐ ┌──────────────┐ │
|
|
│ │ Hanzo IAM │ │ vmd (RDP) │ │
|
|
│ │ (auth/RBAC) │ │ (port 4822) │ │
|
|
│ └──────────────┘ └──────────────┘ │
|
|
└────────────────────────────────────────────────────────────┘</code></pre>
|
|
<h3>Cloud Providers</h3>
|
|
<p>| Provider | SDK | Capabilities | |----------|-----|-------------| | AWS | <code>aws-sdk-go-v2/service/ec2</code> | EC2 instances | | Azure | <code>azure-sdk-for-go/sdk/resourcemanager/compute</code> | Azure VMs | | GCP | <code>cloud.google.com/go/compute</code> | Compute Engine | | Alibaba | <code>alibaba-cloud-sdk-go</code> | ECS instances | | Tencent | <code>tencentcloud-sdk-go</code> | CVM instances | | libvirt | <code>digitalocean/go-libvirt</code> | KVM/QEMU local VMs | | Proxmox | <code>luthermonson/go-proxmox</code> | Proxmox VE |</p>
|
|
<h3>Configuration (<code>conf/app.conf</code>)</h3>
|
|
<p>| Key | Default | Description | |-----|---------|-------------| | <code>httpport</code> | 19000 | Web server port | | <code>driverName</code> | postgres | Database driver | | <code>dataSourceName</code> | <code>host=localhost port=5432 user=hanzo ...</code> | DB connection | | <code>dbName</code> | hanzo_vm | Database name | | <code>iamEndpoint</code> | <code>http://iam.hanzo.svc:8000</code> | Hanzo IAM URL | | <code>clientId</code> | - | IAM application client ID | | <code>clientSecret</code> | - | IAM application client secret | | <code>iamOrganization</code> | hanzo | IAM organization | | <code>iamApplication</code> | app-hanzo-vm | IAM application name | | <code>guacamoleEndpoint</code> | 127.0.0.1:4822 | vmd RDP endpoint |</p>
|
|
<h3>Directory Structure</h3>
|
|
<pre><code>vm/
|
|
main.go # Entry point (Beego app)
|
|
Dockerfile # Multi-stage: vmd + Node frontend + Go backend
|
|
docker-compose.yml # VM + PostgreSQL stack
|
|
build.sh # Build script
|
|
go.mod # github.com/hanzoai/vm, Go 1.26
|
|
conf/
|
|
app.conf # Beego configuration
|
|
controllers/
|
|
account.go # User account management
|
|
asset.go # Asset CRUD
|
|
machine.go # VM lifecycle (create/start/stop/delete)
|
|
provider.go # Cloud provider CRUD
|
|
record.go # Operation records
|
|
record_chain.go # Blockchain audit records
|
|
session.go # Remote desktop sessions (RDP/SSH)
|
|
tunnel.go # WebSocket tunnel for RDP
|
|
tunnel_handler.go # Tunnel message handling
|
|
base.go # Base controller
|
|
util.go # Controller utilities
|
|
object/
|
|
adapter.go # XORM database adapter
|
|
asset.go # Asset model
|
|
machine.go # Machine model + cloud operations
|
|
machine_cloud.go # Cloud-specific machine operations
|
|
provider.go # Provider model
|
|
record.go # Record model
|
|
record_chain.go # Blockchain record model
|
|
session.go # Session model (Guacamole integration)
|
|
authz/
|
|
authz.go # Casbin RBAC authorization
|
|
chain/
|
|
... # Blockchain audit trail
|
|
routers/
|
|
... # Beego route definitions
|
|
service/
|
|
... # Background services
|
|
task/
|
|
... # Scheduled tasks
|
|
util/
|
|
... # IP geolocation, user-agent parsing
|
|
data/
|
|
... # Static data files
|
|
i18n/
|
|
... # Internationalization
|
|
web/
|
|
... # React frontend (yarn build -> web/build)
|
|
swagger/
|
|
... # API documentation
|
|
k8s/
|
|
... # Kubernetes manifests
|
|
.github/
|
|
... # CI workflows</code></pre>
|
|
<h3>Module Replacement</h3>
|
|
<p>The go.mod includes a notable replacement:</p>
|
|
<pre><code>replace github.com/iam/iam-go-sdk => github.com/hanzoid/go-sdk v1.44.0</code></pre>
|
|
<p>This uses Hanzo's fork of the Hanzo IAM SDK for IAM integration.</p>
|
|
<h2>Troubleshooting</h2>
|
|
<p>| Issue | Cause | Solution | |-------|-------|----------| | Login fails | IAM not reachable | Verify <code>iamEndpoint</code> in app.conf, check Hanzo IAM is running | | DB connection error | Wrong dataSourceName | Check PostgreSQL host/port/user in <code>conf/app.conf</code> | | RDP not working | vmd not running | Start vmd container: <code>docker run -d -p 4822:4822 ghcr.io/hanzovm/vmd</code> | | Cloud provider errors | Wrong credentials | Verify cloud provider credentials in provider configuration | | Frontend 404 | Build not run | Run <code>cd web && yarn build</code> to generate <code>web/build/</code> | | Session expired | Token expired | Sessions are stateless — re-authenticate through Hanzo IAM |</p>
|
|
<h2>Related Skills</h2>
|
|
<ul><li><code>hanzo/hanzo-iam.md</code> - Authentication and RBAC (required dependency)</li><li><code>hanzo/hanzo-platform.md</code> - PaaS deployment</li><li><code>hanzo/hanzo-universe.md</code> - K8s infrastructure</li><li><code>hanzo/hanzo-sql.md</code> - PostgreSQL database</li></ul>
|
|
<hr>
|
|
<p><strong>Last Updated</strong>: 2026-03-13 <strong>Category</strong>: Hanzo Ecosystem <strong>Related</strong>: vm, cloud, hypervisor, libvirt, proxmox, aws, azure, gcp, rdp, casvisor <strong>Prerequisites</strong>: PostgreSQL, Hanzo IAM, Go 1.21+, Node.js 18</p>
|
|
<footer>
|
|
<div class="fmap">
|
|
<div><b>Build</b>
|
|
<a href="https://hanzo.app">hanzo.app</a> app builder
|
|
<a href="https://hanzo.codes">hanzo.codes</a> code with an agent
|
|
<a href="https://hanzoskills.com">hanzoskills.com</a> what an agent reads</div>
|
|
<div><b>Run</b>
|
|
<a href="https://console.hanzo.ai">console.hanzo.ai</a> cloud console
|
|
<a href="https://api.hanzo.ai">api.hanzo.ai</a> the API</div>
|
|
<div><b>Account</b>
|
|
<a href="https://hanzo.id">hanzo.id</a> sign in
|
|
<a href="https://pay.hanzo.ai">pay.hanzo.ai</a> top up
|
|
<a href="https://billing.hanzo.ai">billing.hanzo.ai</a> invoices and usage</div>
|
|
<div><b>Company</b>
|
|
<a href="https://hanzo.ai">hanzo.ai</a> canonical
|
|
<a href="https://hanzo.ventures">hanzo.ventures</a> ventures</div>
|
|
</div>
|
|
<div class="fend"><a href="/hanzo-vm.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
|
|
</footer>
|
|
</div></body></html> |