Port presets on their own tab of the Ports page

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
bobbanandClaude Sonnet 5.5 committed 2026-10-30 23:52:29 +01:00
1 parent 9be92a5606
commit 7eee807d9e
4 files changed
+20 -5

No files matched your search

+1 -1
View File
@@ -1022,7 +1022,7 @@ host (`ss`), which catches services listening on localhost only — a scan from
elsewhere can't see those, so they'd otherwise look free. Re-run the agent elsewhere can't see those, so they'd otherwise look free. Re-run the agent
install one-liner on a host to pick that up. install one-liner on a host to pick that up.
**Port presets** (Network → Ports). A preset is a named list of ports written once — *Remote access* (SSH, RDP, VNC, WinRM), *Databases* (MySQL, PostgreSQL, Redis, MongoDB …), *Web*, *File sharing*, *Homelab tools* come ready-made, and are ordinary presets you can change or delete. Add your own by typing one port to a line (`3389 RDP`, `53/udp DNS`). A preset does three things: it **names ports** — a port in any preset shows its name (3389 → RDP) on every server's Ports card, in the agent table and in the new-port alert ("a new port is listening — 3389/tcp RDP"), without a label typed for each host, and a name you write yourself always wins; it **checks hosts** — pick any number of servers and see in one table which of the preset's TCP ports are open on each, from a scan from the app (private addresses only, at the server's first known address; what it finds is remembered like any scan); and it **names the open ports on all of them** in one go, keeping names somebody already wrote unless you say to replace them. Note that a port with a name counts as noted, so writing names also quiets the new-port alert for those ports. A scan only looks at TCP; a UDP port in a preset is only given its name. Operators change presets; everyone sees them. **Port presets** (Network → Ports → the *Presets* tab). A preset is a named list of ports written once — *Remote access* (SSH, RDP, VNC, WinRM), *Databases* (MySQL, PostgreSQL, Redis, MongoDB …), *Web*, *File sharing*, *Homelab tools* come ready-made, and are ordinary presets you can change or delete. Add your own by typing one port to a line (`3389 RDP`, `53/udp DNS`). A preset does three things: it **names ports** — a port in any preset shows its name (3389 → RDP) on every server's Ports card, in the agent table and in the new-port alert ("a new port is listening — 3389/tcp RDP"), without a label typed for each host, and a name you write yourself always wins; it **checks hosts** — pick any number of servers and see in one table which of the preset's TCP ports are open on each, from a scan from the app (private addresses only, at the server's first known address; what it finds is remembered like any scan); and it **names the open ports on all of them** in one go, keeping names somebody already wrote unless you say to replace them. Note that a port with a name counts as noted, so writing names also quiets the new-port alert for those ports. A scan only looks at TCP; a UDP port in a preset is only given its name. Operators change presets; everyone sees them.
**Network → Ports** is the cross-server counterpart: one page listing every **Network → Ports** is the cross-server counterpart: one page listing every
port every agent currently reports as listening, across all servers at once port every agent currently reports as listening, across all servers at once
+1 -1
View File
@@ -115,7 +115,7 @@ even further, to admin only:
admin-only (applying an existing tag to a server needs operator). admin-only (applying an existing tag to a server needs operator).
- **Ports**: everyone can see both the agent-reported and manual tables; - **Ports**: everyone can see both the agent-reported and manual tables;
adding, editing, or deleting a manual port opening needs operator. adding, editing, or deleting a manual port opening needs operator.
- **Port presets** (Network → Ports): everyone can see them and the names they give ports; creating, changing and removing one, scanning hosts for one and writing its names onto many hosts' ports need operator. - **Port presets** (Network → Ports → Presets tab): everyone can see them and the names they give ports; creating, changing and removing one, scanning hosts for one and writing its names onto many hosts' ports need operator.
- **Admin Links**: everyone can see and open every server's admin - **Admin Links**: everyone can see and open every server's admin
bookmarks, from that server's own page or the summary page; adding, bookmarks, from that server's own page or the summary page; adding,
editing, or removing one needs operator, from either place. editing, or removing one needs operator, from either place.
+1 -1
View File
@@ -491,7 +491,7 @@ export default function ServerPorts({
<StatusBadges entry={p} /> <StatusBadges entry={p} />
</td> </td>
<td> <td>
{p.label ?? (p.service ? <span className="text-secondary" title="Named by a port preset (Network → Ports)">{p.service}</span> : <span className="text-secondary">—</span>)} {p.label ?? (p.service ? <span className="text-secondary" title="Named by a port preset (Network → Ports → Presets)">{p.service}</span> : <span className="text-secondary">—</span>)}
{p.agent?.process && <div className="text-secondary small">{p.agent.process}</div>} {p.agent?.process && <div className="text-secondary small">{p.agent.process}</div>}
</td> </td>
<td className="text-secondary">{p.comment ?? "—"}</td> <td className="text-secondary">{p.comment ?? "—"}</td>
+17 -2
View File
@@ -1,7 +1,7 @@
import { removeWithUndo } from "../utils/undoable"; import { removeWithUndo } from "../utils/undoable";
import { useEffect, useState, type FormEvent } from "react"; import { useEffect, useState, type FormEvent } from "react";
import TimeAgo from "../components/TimeAgo"; import TimeAgo from "../components/TimeAgo";
import { Link } from "react-router-dom"; import { Link, useSearchParams } from "react-router-dom";
import { import {
api, api,
type AgentPortRow, type AgentPortRow,
@@ -18,6 +18,7 @@ import { downloadCsv } from "../utils/csv";
import { formatAgo } from "../utils/duration"; import { formatAgo } from "../utils/duration";
import { ErrorNotice } from "../components/Notice"; import { ErrorNotice } from "../components/Notice";
import PortPresets from "../components/PortPresets"; import PortPresets from "../components/PortPresets";
import ViewTabs from "../components/ViewTabs";
import { EmptyRow, LoadingRow } from "../components/EmptyState"; import { EmptyRow, LoadingRow } from "../components/EmptyState";
const emptyForm: PortForwardInput = { const emptyForm: PortForwardInput = {
@@ -33,6 +34,8 @@ const emptyForm: PortForwardInput = {
export default function Ports({ user }: { user: CurrentUser }) { export default function Ports({ user }: { user: CurrentUser }) {
const canEdit = user.role === "admin" || user.role === "operator"; const canEdit = user.role === "admin" || user.role === "operator";
const [params] = useSearchParams();
const view = params.get("view") === "presets" ? "presets" : "ports";
const [agentPorts, setAgentPorts] = useState<AgentPortRow[] | null>(null); const [agentPorts, setAgentPorts] = useState<AgentPortRow[] | null>(null);
const [reportingServers, setReportingServers] = useState(0); const [reportingServers, setReportingServers] = useState(0);
@@ -186,8 +189,18 @@ export default function Ports({ user }: { user: CurrentUser }) {
<> <>
<h2 className="page-title mb-3">Ports</h2> <h2 className="page-title mb-3">Ports</h2>
<PortPresets canEdit={canEdit} /> <ViewTabs
label="Ports view"
tabs={[
{ to: "/ports", label: "Ports", active: view === "ports" },
{ to: "/ports?view=presets", label: "Presets", active: view === "presets" },
]}
/>
{view === "presets" && <PortPresets canEdit={canEdit} />}
{view === "ports" && (
<>
<div className="row g-3 mb-3"> <div className="row g-3 mb-3">
<div className="col-12"> <div className="col-12">
<div className="card"> <div className="card">
@@ -432,5 +445,7 @@ export default function Ports({ user }: { user: CurrentUser }) {
</div> </div>
</div> </div>
</> </>
)}
</>
); );
} }