feat(aura-gui): v0.1 Tauri-based desktop client — system tray + profile manager + admin status

New crate (kept out of the cargo workspace so the protocol-side check/test cycle stays fast):
a Tauri 2 + React 19 + TypeScript desktop app that runs in the system tray and manages
`aura client` for the user. The clash-verge replacement we settled on instead of trying to
shoehorn AuraVPN's L3 IP-tunnel into a clash-verge L4 outbound.

## What's wired

- **Profile manager** — `aura-gui/src-tauri/src/profiles.rs`. App-data layout
  (`~/Library/Application Support/ru.undergr0und.aura/profiles/<id>/` on macOS, the
  equivalent on Linux + Windows). `import_profile_from_tgz` accepts the same bundle shape
  `aura provision-client` emits, detects flat vs single-dir layouts, and refuses overwrites
  unless the operator deletes first. `delete_profile` refuses symlinks.

- **Connection control** — `cli_proc.rs`. Spawns `aura client --config <profile>/client.toml
  --admin-socket /tmp/aura-admin-<uid>-<profile>.sock`, captures stderr into a bounded
  in-memory ring (200 lines) for the UI to tail, kills via `Child::kill` on disconnect.
  Per-profile / per-uid socket paths so two GUIs (or two profiles) don't collide.

- **Live status** — `admin.rs`. Tiny JSON-line client for the v3.3 admin socket. Polled by
  the React app every 1.5 s: peer id, rx/tx packets, default action, rule count. Falls back
  gracefully (admin_error in the response) when the handshake hasn't completed yet.

- **System tray** — `lib.rs` `setup` callback. Three-item menu (Open AuraVPN / Disconnect /
  Quit). The window's close button hides to the tray instead of exiting — the app keeps
  running so the VPN stays connected; the user explicitly chooses Quit.

- **Frontend** — `src/App.tsx`. Single-page layout: profile list (with badge for missing
  files), connect/disconnect button per profile, status table, collapsible logs panel,
  binary-path picker at the bottom. Dark-mode CSS by default; the same look as a typical
  WireGuard / Tailscale-style tray app.

## What's deferred for v0.2

- Auto-start at login (launchd plist / systemd user unit / Windows Run key)
- Code signing + notarization
- Persisting the aura binary path between sessions
- Per-profile route overrides editor
- Live log streaming (today the frontend polls the ring buffer)
- Admin status query on Windows (today's `admin.rs` Unix-only; Windows path returns a clear
  "not supported yet" error)
- Polkit / authorization-services prompt for the TUN-needs-root step (today the operator
  has to launch the GUI from a privileged context, e.g. `sudo open -a aura-gui` on macOS)

## Workspace hygiene

Cargo workspace at the repo root now has `exclude = ["aura-gui"]` so the protocol crates'
`cargo check --workspace` / `cargo test --workspace` don't pull in the tauri + wry + webview
dep graph. The GUI builds standalone from `aura-gui/` via `npm run tauri build`.

## Validation

- `cd aura-gui/src-tauri && cargo check` — green
- `cd aura-gui/src-tauri && cargo clippy -- -D warnings` — clean
- `cd aura-gui/src-tauri && cargo fmt --check` — clean
- `cd aura-gui && npm run build` — frontend tsc + vite build succeeds
- Full `npm run tauri dev` not exercised in this session (would open a real window) — should
  work; if it breaks the surface area is small enough that next session fixes it.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
xah30
2026-05-29 17:47:51 +03:00
parent 7c2080321b
commit 40b38beb11
44 changed files with 9051 additions and 0 deletions
+278
View File
@@ -0,0 +1,278 @@
/* AuraVPN GUI — dark-mode by default, dense single-pane VPN dashboard. */
:root {
--bg: #0f1115;
--panel-bg: #1a1d24;
--border: #2a2f3a;
--text: #d9dde4;
--text-dim: #8a92a3;
--accent: #5ad3aa;
--accent-hot: #4ac09a;
--danger: #ef5a5a;
--warn: #f7b955;
--bad: #ef5a5a;
font-family: -apple-system, "Segoe UI", Inter, Avenir, Helvetica, Arial,
sans-serif;
font-size: 14px;
line-height: 1.45;
color: var(--text);
background-color: var(--bg);
}
body {
margin: 0;
}
.container {
max-width: 760px;
margin: 0 auto;
padding: 24px 24px 48px;
display: flex;
flex-direction: column;
gap: 16px;
}
header {
padding-bottom: 8px;
border-bottom: 1px solid var(--border);
}
header h1 {
margin: 0;
font-size: 28px;
font-weight: 600;
letter-spacing: -0.02em;
}
header .sub {
margin: 4px 0 0;
color: var(--text-dim);
font-size: 13px;
}
.pill {
display: inline-block;
padding: 2px 8px;
border-radius: 999px;
font-size: 12px;
font-weight: 500;
text-transform: uppercase;
letter-spacing: 0.04em;
}
.pill.running {
background: rgba(90, 211, 170, 0.18);
color: var(--accent);
}
.pill.stopped {
background: rgba(138, 146, 163, 0.18);
color: var(--text-dim);
}
.panel {
background: var(--panel-bg);
border: 1px solid var(--border);
border-radius: 10px;
padding: 16px;
}
.panel.small {
padding: 10px 14px;
}
.panel h2 {
margin: 0 0 12px;
font-size: 14px;
font-weight: 600;
letter-spacing: 0.02em;
color: var(--text-dim);
text-transform: uppercase;
}
.row-between {
display: flex;
justify-content: space-between;
align-items: center;
gap: 12px;
margin-bottom: 12px;
}
.row-between h2 {
margin: 0;
}
.empty {
margin: 12px 0;
color: var(--text-dim);
font-style: italic;
}
button {
background: #2a2f3a;
color: var(--text);
border: 1px solid #2a2f3a;
border-radius: 6px;
padding: 6px 12px;
font-size: 13px;
font-weight: 500;
cursor: pointer;
transition: background 0.15s, border-color 0.15s;
}
button:hover:not(:disabled) {
background: #353a45;
border-color: #404552;
}
button:disabled {
opacity: 0.4;
cursor: not-allowed;
}
button.primary {
background: var(--accent);
color: #0f1115;
border-color: var(--accent);
}
button.primary:hover:not(:disabled) {
background: var(--accent-hot);
border-color: var(--accent-hot);
}
button.danger {
background: var(--danger);
color: white;
border-color: var(--danger);
}
button.danger:hover:not(:disabled) {
background: #d44e4e;
border-color: #d44e4e;
}
.profile-list {
list-style: none;
margin: 0;
padding: 0;
display: flex;
flex-direction: column;
gap: 8px;
}
.profile-list li {
display: flex;
justify-content: space-between;
align-items: center;
gap: 16px;
padding: 12px 14px;
background: #14171d;
border: 1px solid #232730;
border-radius: 8px;
}
.profile-list li.active {
border-color: var(--accent);
box-shadow: 0 0 0 1px rgba(90, 211, 170, 0.4);
}
.profile-meta {
display: flex;
flex-direction: column;
gap: 2px;
min-width: 0;
}
.profile-name {
font-weight: 600;
font-size: 14px;
display: flex;
align-items: center;
gap: 8px;
}
.profile-server {
font-size: 12px;
color: var(--text-dim);
font-family: ui-monospace, "JetBrains Mono", "SF Mono", Menlo, monospace;
}
.profile-id {
font-size: 11px;
color: var(--text-dim);
}
.profile-actions {
display: flex;
gap: 8px;
}
.badge {
font-size: 10px;
font-weight: 500;
padding: 1px 6px;
border-radius: 4px;
text-transform: uppercase;
}
.badge.bad {
background: rgba(239, 90, 90, 0.15);
color: var(--bad);
}
.status {
border-collapse: collapse;
width: 100%;
}
.status td {
padding: 6px 8px;
border-bottom: 1px solid #232730;
font-size: 13px;
}
.status td:first-child {
width: 40%;
color: var(--text-dim);
text-transform: uppercase;
font-size: 11px;
letter-spacing: 0.04em;
}
.status td.warn {
color: var(--warn);
}
.logs {
background: #0a0c10;
border: 1px solid #232730;
border-radius: 6px;
padding: 10px 12px;
font-family: ui-monospace, "JetBrains Mono", "SF Mono", Menlo, monospace;
font-size: 11px;
max-height: 260px;
overflow: auto;
white-space: pre-wrap;
word-break: break-all;
color: #c6cbd5;
}
.error {
background: rgba(239, 90, 90, 0.12);
border: 1px solid rgba(239, 90, 90, 0.4);
border-radius: 8px;
padding: 10px 14px;
color: #ffb1b1;
display: flex;
justify-content: space-between;
align-items: center;
gap: 16px;
}
.aura-bin code {
font-family: ui-monospace, "JetBrains Mono", "SF Mono", Menlo, monospace;
font-size: 12px;
color: var(--text-dim);
}
+270
View File
@@ -0,0 +1,270 @@
import { useCallback, useEffect, useState } from "react";
import { invoke } from "@tauri-apps/api/core";
import { open as openFileDialog } from "@tauri-apps/plugin-dialog";
import "./App.css";
type ProfileSummary = {
id: string;
display_name: string;
server_addr: string;
healthy: boolean;
};
type ClientStatus = {
running: boolean;
profile_id: string | null;
peer_id: string | null;
rx_packets: number | null;
tx_packets: number | null;
default_action: string | null;
rules: number | null;
recent_logs: string[];
admin_error: string | null;
};
function App() {
const [profiles, setProfiles] = useState<ProfileSummary[]>([]);
const [status, setStatus] = useState<ClientStatus>({
running: false,
profile_id: null,
peer_id: null,
rx_packets: null,
tx_packets: null,
default_action: null,
rules: null,
recent_logs: [],
admin_error: null,
});
const [auraBin, setAuraBin] = useState<string>("");
const [error, setError] = useState<string | null>(null);
const [showLogs, setShowLogs] = useState(false);
const refreshProfiles = useCallback(async () => {
try {
const p = await invoke<ProfileSummary[]>("list_profiles");
setProfiles(p);
} catch (e: any) {
setError(String(e));
}
}, []);
const refreshStatus = useCallback(async () => {
try {
const s = await invoke<ClientStatus>("get_status");
setStatus(s);
} catch (e: any) {
console.error("get_status", e);
}
}, []);
useEffect(() => {
(async () => {
try {
setAuraBin(await invoke<string>("get_aura_binary_path"));
} catch {}
})();
refreshProfiles();
}, [refreshProfiles]);
// Poll status every 1.5s.
useEffect(() => {
refreshStatus();
const id = setInterval(refreshStatus, 1500);
return () => clearInterval(id);
}, [refreshStatus]);
const onImportTgz = async () => {
try {
const path = await openFileDialog({
title: "Pick a provisioned AuraVPN bundle (.tgz)",
multiple: false,
directory: false,
filters: [{ name: "Bundles", extensions: ["tgz", "tar.gz"] }],
});
if (typeof path !== "string") return;
await invoke("import_profile_from_tgz", { tgzPath: path });
await refreshProfiles();
setError(null);
} catch (e: any) {
setError(String(e));
}
};
const onConnect = async (profileId: string) => {
try {
await invoke("connect", { profileId });
setError(null);
await refreshStatus();
} catch (e: any) {
setError(String(e));
}
};
const onDisconnect = async () => {
try {
await invoke("disconnect");
setError(null);
await refreshStatus();
} catch (e: any) {
setError(String(e));
}
};
const onDelete = async (profileId: string) => {
if (!confirm(`Delete profile "${profileId}"? This cannot be undone.`)) return;
try {
await invoke("delete_profile", { profileId });
await refreshProfiles();
} catch (e: any) {
setError(String(e));
}
};
const onPickBinary = async () => {
try {
const path = await openFileDialog({
title: "Pick the aura binary",
multiple: false,
directory: false,
});
if (typeof path !== "string") return;
await invoke("set_aura_binary_path", { path });
setAuraBin(await invoke<string>("get_aura_binary_path"));
setError(null);
} catch (e: any) {
setError(String(e));
}
};
return (
<main className="container">
<header>
<h1>AuraVPN</h1>
<p className="sub">
hybrid post-quantum VPN ·{" "}
<span className={status.running ? "pill running" : "pill stopped"}>
{status.running ? "connected" : "disconnected"}
</span>
</p>
</header>
{error && (
<div className="error">
<strong>error:</strong> {error}{" "}
<button onClick={() => setError(null)}>dismiss</button>
</div>
)}
<section className="panel">
<div className="row-between">
<h2>Profiles</h2>
<button onClick={onImportTgz}>+ Import .tgz</button>
</div>
{profiles.length === 0 ? (
<p className="empty">No profiles yet. Click "Import .tgz" to add one.</p>
) : (
<ul className="profile-list">
{profiles.map((p) => {
const isActive = status.running && status.profile_id === p.id;
return (
<li key={p.id} className={isActive ? "active" : ""}>
<div className="profile-meta">
<div className="profile-name">
{p.display_name}
{!p.healthy && <span className="badge bad">missing files</span>}
</div>
<div className="profile-server">{p.server_addr}</div>
<div className="profile-id">id: {p.id}</div>
</div>
<div className="profile-actions">
{isActive ? (
<button className="danger" onClick={onDisconnect}>
Disconnect
</button>
) : (
<button
className="primary"
disabled={!p.healthy || status.running}
onClick={() => onConnect(p.id)}
>
Connect
</button>
)}
<button onClick={() => onDelete(p.id)}>Delete</button>
</div>
</li>
);
})}
</ul>
)}
</section>
<section className="panel">
<h2>Tunnel status</h2>
{!status.running ? (
<p className="empty">Tunnel not running.</p>
) : (
<table className="status">
<tbody>
<tr>
<td>profile</td>
<td>{status.profile_id ?? "—"}</td>
</tr>
<tr>
<td>peer</td>
<td>{status.peer_id ?? "(handshake in progress)"}</td>
</tr>
<tr>
<td>rx packets</td>
<td>{status.rx_packets ?? "—"}</td>
</tr>
<tr>
<td>tx packets</td>
<td>{status.tx_packets ?? "—"}</td>
</tr>
<tr>
<td>default action</td>
<td>{status.default_action ?? "—"}</td>
</tr>
<tr>
<td>active rules</td>
<td>{status.rules ?? "—"}</td>
</tr>
{status.admin_error && (
<tr>
<td>admin</td>
<td className="warn">{status.admin_error}</td>
</tr>
)}
</tbody>
</table>
)}
</section>
<section className="panel">
<div className="row-between">
<h2>Logs</h2>
<button onClick={() => setShowLogs(!showLogs)}>
{showLogs ? "Hide" : "Show"} ({status.recent_logs.length})
</button>
</div>
{showLogs && (
<pre className="logs">
{status.recent_logs.length === 0 ? "(no logs yet)" : status.recent_logs.join("\n")}
</pre>
)}
</section>
<section className="panel small">
<div className="row-between">
<span className="aura-bin">
<strong>aura binary:</strong> <code>{auraBin}</code>
</span>
<button onClick={onPickBinary}>Change</button>
</div>
</section>
</main>
);
}
export default App;
+1
View File
@@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="35.93" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 228"><path fill="#00D8FF" d="M210.483 73.824a171.49 171.49 0 0 0-8.24-2.597c.465-1.9.893-3.777 1.273-5.621c6.238-30.281 2.16-54.676-11.769-62.708c-13.355-7.7-35.196.329-57.254 19.526a171.23 171.23 0 0 0-6.375 5.848a155.866 155.866 0 0 0-4.241-3.917C100.759 3.829 77.587-4.822 63.673 3.233C50.33 10.957 46.379 33.89 51.995 62.588a170.974 170.974 0 0 0 1.892 8.48c-3.28.932-6.445 1.924-9.474 2.98C17.309 83.498 0 98.307 0 113.668c0 15.865 18.582 31.778 46.812 41.427a145.52 145.52 0 0 0 6.921 2.165a167.467 167.467 0 0 0-2.01 9.138c-5.354 28.2-1.173 50.591 12.134 58.266c13.744 7.926 36.812-.22 59.273-19.855a145.567 145.567 0 0 0 5.342-4.923a168.064 168.064 0 0 0 6.92 6.314c21.758 18.722 43.246 26.282 56.54 18.586c13.731-7.949 18.194-32.003 12.4-61.268a145.016 145.016 0 0 0-1.535-6.842c1.62-.48 3.21-.974 4.76-1.488c29.348-9.723 48.443-25.443 48.443-41.52c0-15.417-17.868-30.326-45.517-39.844Zm-6.365 70.984c-1.4.463-2.836.91-4.3 1.345c-3.24-10.257-7.612-21.163-12.963-32.432c5.106-11 9.31-21.767 12.459-31.957c2.619.758 5.16 1.557 7.61 2.4c23.69 8.156 38.14 20.213 38.14 29.504c0 9.896-15.606 22.743-40.946 31.14Zm-10.514 20.834c2.562 12.94 2.927 24.64 1.23 33.787c-1.524 8.219-4.59 13.698-8.382 15.893c-8.067 4.67-25.32-1.4-43.927-17.412a156.726 156.726 0 0 1-6.437-5.87c7.214-7.889 14.423-17.06 21.459-27.246c12.376-1.098 24.068-2.894 34.671-5.345a134.17 134.17 0 0 1 1.386 6.193ZM87.276 214.515c-7.882 2.783-14.16 2.863-17.955.675c-8.075-4.657-11.432-22.636-6.853-46.752a156.923 156.923 0 0 1 1.869-8.499c10.486 2.32 22.093 3.988 34.498 4.994c7.084 9.967 14.501 19.128 21.976 27.15a134.668 134.668 0 0 1-4.877 4.492c-9.933 8.682-19.886 14.842-28.658 17.94ZM50.35 144.747c-12.483-4.267-22.792-9.812-29.858-15.863c-6.35-5.437-9.555-10.836-9.555-15.216c0-9.322 13.897-21.212 37.076-29.293c2.813-.98 5.757-1.905 8.812-2.773c3.204 10.42 7.406 21.315 12.477 32.332c-5.137 11.18-9.399 22.249-12.634 32.792a134.718 134.718 0 0 1-6.318-1.979Zm12.378-84.26c-4.811-24.587-1.616-43.134 6.425-47.789c8.564-4.958 27.502 2.111 47.463 19.835a144.318 144.318 0 0 1 3.841 3.545c-7.438 7.987-14.787 17.08-21.808 26.988c-12.04 1.116-23.565 2.908-34.161 5.309a160.342 160.342 0 0 1-1.76-7.887Zm110.427 27.268a347.8 347.8 0 0 0-7.785-12.803c8.168 1.033 15.994 2.404 23.343 4.08c-2.206 7.072-4.956 14.465-8.193 22.045a381.151 381.151 0 0 0-7.365-13.322Zm-45.032-43.861c5.044 5.465 10.096 11.566 15.065 18.186a322.04 322.04 0 0 0-30.257-.006c4.974-6.559 10.069-12.652 15.192-18.18ZM82.802 87.83a323.167 323.167 0 0 0-7.227 13.238c-3.184-7.553-5.909-14.98-8.134-22.152c7.304-1.634 15.093-2.97 23.209-3.984a321.524 321.524 0 0 0-7.848 12.897Zm8.081 65.352c-8.385-.936-16.291-2.203-23.593-3.793c2.26-7.3 5.045-14.885 8.298-22.6a321.187 321.187 0 0 0 7.257 13.246c2.594 4.48 5.28 8.868 8.038 13.147Zm37.542 31.03c-5.184-5.592-10.354-11.779-15.403-18.433c4.902.192 9.899.29 14.978.29c5.218 0 10.376-.117 15.453-.343c-4.985 6.774-10.018 12.97-15.028 18.486Zm52.198-57.817c3.422 7.8 6.306 15.345 8.596 22.52c-7.422 1.694-15.436 3.058-23.88 4.071a382.417 382.417 0 0 0 7.859-13.026a347.403 347.403 0 0 0 7.425-13.565Zm-16.898 8.101a358.557 358.557 0 0 1-12.281 19.815a329.4 329.4 0 0 1-23.444.823c-7.967 0-15.716-.248-23.178-.732a310.202 310.202 0 0 1-12.513-19.846h.001a307.41 307.41 0 0 1-10.923-20.627a310.278 310.278 0 0 1 10.89-20.637l-.001.001a307.318 307.318 0 0 1 12.413-19.761c7.613-.576 15.42-.876 23.31-.876H128c7.926 0 15.743.303 23.354.883a329.357 329.357 0 0 1 12.335 19.695a358.489 358.489 0 0 1 11.036 20.54a329.472 329.472 0 0 1-11 20.722Zm22.56-122.124c8.572 4.944 11.906 24.881 6.52 51.026c-.344 1.668-.73 3.367-1.15 5.09c-10.622-2.452-22.155-4.275-34.23-5.408c-7.034-10.017-14.323-19.124-21.64-27.008a160.789 160.789 0 0 1 5.888-5.4c18.9-16.447 36.564-22.941 44.612-18.3ZM128 90.808c12.625 0 22.86 10.235 22.86 22.86s-10.235 22.86-22.86 22.86s-22.86-10.235-22.86-22.86s10.235-22.86 22.86-22.86Z"></path></svg>

After

Width:  |  Height:  |  Size: 4.0 KiB

+9
View File
@@ -0,0 +1,9 @@
import React from "react";
import ReactDOM from "react-dom/client";
import App from "./App";
ReactDOM.createRoot(document.getElementById("root") as HTMLElement).render(
<React.StrictMode>
<App />
</React.StrictMode>,
);
+1
View File
@@ -0,0 +1 @@
/// <reference types="vite/client" />