Back to Details

proxmox

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

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)

Proxmox host (requires 2FA - password then OTP)

ssh proxmox
ssh proxmox

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

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

All containers with status, IPs

ssh proxmox "pct list"
ssh proxmox "pct list"

All VMs

All VMs

ssh proxmox "qm list"
ssh proxmox "qm list"

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

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

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

Container config (shows IP, mounts, resources)

Container config (shows IP, mounts, resources)

ssh proxmox "pct config <CTID>"
ssh proxmox "pct config <CTID>"

VM config

VM config

ssh proxmox "qm config <VMID>"
undefined
ssh proxmox "qm config <VMID>"
undefined

Network Discovery

网络发现

bash
undefined
bash
undefined

Find container IP

Find container IP

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

What's listening in a container

What's listening in a container

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

Host network config

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

Storage pools

ssh proxmox "pvesm status"
ssh proxmox "pvesm status"

Storage config

Storage config

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

NFS mounts

NFS mounts

ssh proxmox "mount | grep nfs"
ssh proxmox "mount | grep nfs"

Disk usage

Disk usage

ssh proxmox "df -h"
undefined
ssh proxmox "df -h"
undefined

Container Management

容器管理

bash
undefined
bash
undefined

Start/stop/restart

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>"
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

Enter container shell

ssh proxmox "pct enter <CTID>"
ssh proxmox "pct enter <CTID>"

Run command in container

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

List systemd services in container

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

Check specific service

Check specific service

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

Service logs

Service logs

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

Follow logs live

Follow logs live

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

All recent logs in container

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

Overview

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

Quick health

Quick health

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

ZFS status

ZFS status

ssh proxmox "zpool status"
ssh proxmox "zpool status"

Host logs

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

Backup job config

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

List backups in storage

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?

1. Container running?

ssh proxmox "pct status <CTID>"
ssh proxmox "pct status <CTID>"

2. Service running?

2. Service running?

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

3. Logs

3. Logs

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

4. Port listening?

4. Port listening?

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

5. Restart

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

Find tailscale container

ssh proxmox "pct list" | grep -i tail
ssh proxmox "pct list" | grep -i tail

Check status (replace CTID)

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
如果需要无法通过命令动态获取的静态参考信息，请阅读此文件。