Repolode
TimInTech

TimInTech/proxmox-manager

基于 Bash 的单文件终端工具,用于管理和监控 Proxmox VE 上的虚拟机与容器。

可替代:Proxmox Datacenter ManagerProxmox VE web interface

Star
92
Fork
4
未关闭 Issue
0
最近提交
23天前

这是什么?

proxmox-manager(命令名 pman)是一个纯 Bash 单文件脚本,直接在 Proxmox VE 节点上管理 QEMU 虚拟机和 LXC 容器。它提供交互式终端界面,展示所有虚拟机和容器的表格,同时支持纯文本和 JSON 输出,便于脚本调用。工具只依赖 Proxmox VE 自带的 qm、pct、pvesh 等命令,无需守护进程或代理。

除了基本的启动、停止、重启,它还支持通过 pct enter 或 qm terminal 进入控制台,借助 QEMU Guest Agent 或 pct exec 查询 IPv4 地址,以及带名称校验的快照创建、回滚和删除。危险操作需要确认,加上 --force 参数后可用于无人值守场景。另外可生成 SPICE .vv 连接文件,并在安装 virt-viewer 时自动启动。

较新的健康检查功能可按虚拟机或容器显示 CPU、内存和磁盘使用情况。配合 cron 运行 --check 命令,仅在问题出现、升级或恢复时通过 ntfy 或邮件发送告警。配置文件 /etc/pmanrc 或 ~/.pmanrc 按数据解析,而非作为 shell 代码执行。

核心功能

  • 01交互式终端表格展示虚拟机和容器的实时状态
  • 02启动、停止、重启操作,支持确认提示和超时设置
  • 03通过 pct enter 或 qm terminal 进入控制台
  • 04快照列表、创建、回滚和删除,并校验快照名称
  • 05生成 SPICE .vv 连接文件,可自动启动 virt-viewer
  • 06健康检查视图,以及通过 ntfy 或邮件发送的 cron 告警

适用场景

  • 在家庭实验室的 Proxmox 节点上通过 SSH 用命令行管理虚拟机和容器
  • 结合 JSON 输出与 jq 编写状态检查脚本
  • 在有风险的改动前创建快照,出问题时回滚
  • 在资源占用过高或客户机意外停止时接收告警

标签

常见问题

proxmox-manager 是什么?
基于 Bash 的单文件终端工具,用于管理和监控 Proxmox VE 上的虚拟机与容器。 proxmox-manager(命令名 pman)是一个纯 Bash 单文件脚本,直接在 Proxmox VE 节点上管理 QEMU 虚拟机和 LXC 容器。它提供交互式终端界面,展示所有虚拟机和容器的表格,同时支持纯文本和 JSON 输出,便于脚本调用。工具只依赖 Proxmox VE 自带的 qm、pct、pvesh 等命令,无需守护进程或代理。
proxmox-manager 可以免费使用吗?用的什么许可证?
proxmox-manager 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
proxmox-manager 还在维护吗?
活跃维护中。proxmox-manager 最近一次提交是在 2026年9月26日。
proxmox-manager 适合用来做什么?
在家庭实验室的 Proxmox 节点上通过 SSH 用命令行管理虚拟机和容器 结合 JSON 输出与 jq 编写状态检查脚本 在有风险的改动前创建快照,出问题时回滚 在资源占用过高或客户机意外停止时接收告警
在哪里获取 proxmox-manager?
源代码和安装说明在 GitHub 上:https://github.com/TimInTech/proxmox-manager

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目