homeio

Publik
Fork dari doctor-io/homeio
Branch: main
Commit terakhir: 958d74616 Oktober 2026
1import "server-only";
2
3import { listContainers } from "@/lib/server/modules/docker/stats";
4import { listContainerCustomizations } from "@/lib/server/modules/docker/container-customizations";
5import { listInstalledStacksFromDb } from "@/lib/server/modules/apps/stacks-repository";
6import { logServerAction } from "@/lib/server/logging/logger";
7import { homeioComponentOf } from "@/lib/server/modules/integrations/cloudflared-connectors";
8import {
9  parseDockerStatusLine,
10  summarizeContainers,
11} from "@/lib/shared/app-condition";
12import type { UnmanagedContainer } from "@/lib/shared/contracts/docker";
13
14const COMPOSE_PROJECT_LABEL = "com.docker.compose.project";
15
16export type { UnmanagedContainer };
17
18function toContainerName(names: string[] | undefined, id: string) {
19  const first = names?.[0]?.trim() ?? "";
20  // Docker prefixes container names with a slash.
21  const stripped = first.startsWith("/") ? first.slice(1) : first;
22  return stripped.length > 0 ? stripped : id.slice(0, 12);
23}
24
25/**
26 * Containers running on this host that Homeio did not deploy.
27 *
28 * Homeio drives its own apps through `docker compose -p <stackName>`, so a
29 * container whose compose project matches a known stack is ours. Everything
30 * else was started by something else -- CasaOS, Portainer, a bare `docker run`
31 * -- and is surfaced read-only for now. Homeio's own components, such as the
32 * Cloudflare connector, are neither: they live in Settings.
33 */
34export async function listUnmanagedContainers(): Promise<UnmanagedContainer[]> {
35  const [containers, stacks, customizations] = await Promise.all([
36    listContainers(),
37    listInstalledStacksFromDb().catch((error) => {
38      logServerAction({
39        level: "warn",
40        layer: "service",
41        action: "docker.unmanaged-containers",
42        status: "error",
43        message: "Could not read installed stacks; treating all containers as unmanaged",
44        error,
45      });
46      return [];
47    }),
48    listContainerCustomizations(),
49  ]);
50
51  const managedProjects = new Set(stacks.map((stack) => stack.stackName));
52
53  return containers
54    .filter((container) => {
55      if (homeioComponentOf(container)) return false;
56      const project = container.Labels?.[COMPOSE_PROJECT_LABEL];
57      return !project || !managedProjects.has(project);
58    })
59    .map((container) => {
60      const name = toContainerName(container.Names, container.Id);
61      const customization = customizations.get(name);
62      return {
63        id: container.Id,
64        name,
65        image: container.Image ?? "",
66        state: container.State ?? "unknown",
67        status: container.Status ?? "",
68        condition: summarizeContainers([
69          { state: container.State ?? "unknown", ...parseDockerStatusLine(container.Status ?? "") },
70        ]),
71        composeProject: container.Labels?.[COMPOSE_PROJECT_LABEL] ?? null,
72        displayName: customization?.displayName ?? null,
73        iconUrl: customization?.iconUrl ?? null,
74        dashboardUrl: customization?.dashboardUrl ?? null,
75      };
76    })
77    .sort((left, right) => left.name.localeCompare(right.name));
78}
79