Proxmox Home Lab Manager

Proxmox家庭实验室管理器

Sysadmin skill for managing Proxmox VE home lab infrastructure.

用于管理Proxmox VE家庭实验室基础设施的系统管理技能。

Connection

连接方式

bash

undefined

bash

undefined

Proxmox host (requires 2FA - password then OTP)

ssh proxmox

Synology NAS (see ~/.ssh/config for Host entry)

ssh nas

undefined

ssh nas

undefined

Discovery Commands

发现命令

List All Infrastructure

列出所有基础设施

bash

undefined

bash

undefined

All containers with status, IPs

ssh proxmox "pct list"

All VMs

ssh proxmox "qm list"

Detailed resource usage (CPU, memory, disk) for everything

ssh proxmox "pvesh get /cluster/resources --type vm --output-format json" | jq

Container config (shows IP, mounts, resources)

ssh proxmox "pct config <CTID>"

VM config

ssh proxmox "qm config <VMID>"

undefined

ssh proxmox "qm config <VMID>"

undefined

Network Discovery

网络发现

bash

undefined

bash

undefined

Find container IP

ssh proxmox "pct exec <CTID> -- ip -4 addr show eth0"

What's listening in a container

ssh proxmox "pct exec <CTID> -- ss -tlnp"

Host network config

ssh proxmox "cat /etc/network/interfaces"

undefined

ssh proxmox "cat /etc/network/interfaces"

undefined

Storage Discovery

存储发现

bash

undefined

bash

undefined

Storage pools

ssh proxmox "pvesm status"

Storage config

ssh proxmox "cat /etc/pve/storage.cfg"

NFS mounts

ssh proxmox "mount | grep nfs"

Disk usage

ssh proxmox "df -h"

undefined

ssh proxmox "df -h"

undefined

Container Management

容器管理

bash

undefined

bash

undefined

Start/stop/restart

ssh proxmox "pct start <CTID>" ssh proxmox "pct shutdown <CTID>" # graceful ssh proxmox "pct stop <CTID>" # force ssh proxmox "pct reboot <CTID>"

Enter container shell

ssh proxmox "pct enter <CTID>"

Run command in container

ssh proxmox "pct exec <CTID> -- <command>"

undefined

ssh proxmox "pct exec <CTID> -- <command>"

undefined

VM Management

VM管理

bash

ssh proxmox "qm start <VMID>"
ssh proxmox "qm shutdown <VMID>"
ssh proxmox "qm stop <VMID>"        # force
ssh proxmox "qm reboot <VMID>"
ssh proxmox "qm status <VMID>"

bash

ssh proxmox "qm start <VMID>"
ssh proxmox "qm shutdown <VMID>"
ssh proxmox "qm stop <VMID>"        # force
ssh proxmox "qm reboot <VMID>"
ssh proxmox "qm status <VMID>"

Service Debugging

服务调试

Find and Check Services

查找并检查服务

bash

undefined

bash

undefined

List systemd services in container

ssh proxmox "pct exec <CTID> -- systemctl list-units --type=service --state=running"

Check specific service

ssh proxmox "pct exec <CTID> -- systemctl status <service>"

Service logs

ssh proxmox "pct exec <CTID> -- journalctl -u <service> -n 100 --no-pager"

Follow logs live

ssh proxmox "pct exec <CTID> -- journalctl -u <service> -f"

All recent logs in container

ssh proxmox "pct exec <CTID> -- journalctl -n 100 --no-pager"

undefined

ssh proxmox "pct exec <CTID> -- journalctl -n 100 --no-pager"

undefined

Common Service Names

常见服务名称

Most containers run a single main service. Discover with:

bash

ssh proxmox "pct exec <CTID> -- systemctl list-units --type=service --state=running" | grep -v systemd

Typical patterns:

jellyfin

,

AdGuardHome

,

caddy

,

sonarr

,

radarr

,

sabnzbd

,

tailscaled

大多数容器运行单个主服务。可通过以下命令发现：

bash

ssh proxmox "pct exec <CTID> -- systemctl list-units --type=service --state=running" | grep -v systemd

典型示例：

jellyfin

,

AdGuardHome

,

caddy

,

sonarr

,

radarr

,

sabnzbd

,

tailscaled

Host Health

主机健康状态

bash

undefined

bash

undefined

Overview

ssh proxmox "pvesh get /nodes/pve/status"

Quick health

ssh proxmox "uptime && free -h && df -h /"

ZFS status

ssh proxmox "zpool status"

Host logs

ssh proxmox "journalctl -n 100 --no-pager"

undefined

ssh proxmox "journalctl -n 100 --no-pager"

undefined

Backups

备份

bash

undefined

bash

undefined

Backup job config

ssh proxmox "cat /etc/pve/jobs.cfg"

List backups in storage

ssh proxmox "pvesm list <storage-name> --content backup"

undefined

ssh proxmox "pvesm list <storage-name> --content backup"

undefined

Troubleshooting

故障排除

Container Won't Start

容器无法启动

bash

ssh proxmox "pct config <CTID>"                    # check config
ssh proxmox "df -h"                                 # disk space
ssh proxmox "ls /var/lock/pve-manager/pve-config/" # stale locks

bash

ssh proxmox "pct config <CTID>"                    # check config
ssh proxmox "df -h"                                 # disk space
ssh proxmox "ls /var/lock/pve-manager/pve-config/" # stale locks

Service Not Responding

服务无响应

bash

undefined

bash

undefined

1. Container running?

ssh proxmox "pct status <CTID>"

2. Service running?

ssh proxmox "pct exec <CTID> -- systemctl status <service>"

3. Logs

ssh proxmox "pct exec <CTID> -- journalctl -u <service> -n 100 --no-pager"

4. Port listening?

ssh proxmox "pct exec <CTID> -- ss -tlnp"

5. Restart

ssh proxmox "pct exec <CTID> -- systemctl restart <service>"

undefined

ssh proxmox "pct exec <CTID> -- systemctl restart <service>"

undefined

NFS Mount Issues

NFS挂载问题

bash

ssh proxmox "mount | grep nfs"           # current mounts
ssh proxmox "cat /etc/fstab | grep nfs"  # configured mounts
ssh proxmox "mount -a"                   # remount all

bash

ssh proxmox "mount | grep nfs"           # current mounts
ssh proxmox "cat /etc/fstab | grep nfs"  # configured mounts
ssh proxmox "mount -a"                   # remount all

Tailscale (if present)

Tailscale（如果已部署）

bash

undefined

bash

undefined

Find tailscale container

ssh proxmox "pct list" | grep -i tail

Check status (replace CTID)

ssh proxmox "pct exec <CTID> -- tailscale status"

undefined

ssh proxmox "pct exec <CTID> -- tailscale status"

undefined

Documentation Reference

文档参考

Detailed infrastructure docs (IPs, service configs, setup history) are in:

~/obsidian/Notes/PROXMOX_SETUP.md

Read this file if you need static reference info not discoverable via commands.

详细的基础设施文档（IP、服务配置、搭建历史）位于：

~/obsidian/Notes/PROXMOX_SETUP.md

如果需要无法通过命令动态获取的静态参考信息，请阅读此文件。

proxmox

Original

Translation

Proxmox Home Lab Manager

Proxmox家庭实验室管理器

Connection

连接方式

Proxmox host (requires 2FA - password then OTP)

Proxmox host (requires 2FA - password then OTP)

Synology NAS (see ~/.ssh/config for Host entry)

Synology NAS (see ~/.ssh/config for Host entry)

Discovery Commands

发现命令

List All Infrastructure

列出所有基础设施

All containers with status, IPs

All containers with status, IPs

All VMs

All VMs

Detailed resource usage (CPU, memory, disk) for everything

Detailed resource usage (CPU, memory, disk) for everything

Container config (shows IP, mounts, resources)

Container config (shows IP, mounts, resources)

VM config

VM config

Network Discovery

网络发现

Find container IP

Find container IP

What's listening in a container

What's listening in a container

Host network config

Host network config

Storage Discovery

存储发现

Storage pools

Storage pools

Storage config

Storage config

NFS mounts

NFS mounts

Disk usage

Disk usage

Container Management

容器管理

Start/stop/restart

Start/stop/restart

Enter container shell

Enter container shell

Run command in container

Run command in container

VM Management

VM管理

Service Debugging

服务调试

Find and Check Services

查找并检查服务

List systemd services in container

List systemd services in container

Check specific service

Check specific service

Service logs

Service logs

Follow logs live

Follow logs live

All recent logs in container

All recent logs in container

Common Service Names

常见服务名称

Host Health

主机健康状态

Overview

Overview

Quick health

Quick health

ZFS status

ZFS status

Host logs

Host logs

Backups