15分钟配置 Dashy Proxmox 监控：节点与虚拟机状态面板

15分钟配置 Dashy Proxmox 监控节点与虚拟机状态面板【免费下载链接】dashy A self-hostable personal dashboard built for you. Includes status-checking, widgets, themes, icon packs, a UI editor and tons more!项目地址: https://gitcode.com/GitHub_Trending/da/dashy三台 Proxmox 节点各跑十几台虚拟机想看全貌得挨个登录 Web UI 翻列表。Dashy 自带的 Proxmox 监控组件proxmox-listswidget可以直连 Proxmox API把节点和虚拟机的运行状态列出来在线的打绿色圆点。下面按操作顺序走一遍签发令牌、写配置、验证数据回流最后排掉几个最常见的坑。能力边界能显示整个集群的节点列表node留空或单个节点的虚拟机/容器列表node_data取qemu或lxc只展示状态 运行中/在线显示绿点其他状态没有配色CPU、内存这类资源占用曲线它不管需要另配 Glances 或 Netdata 系列 widget必须用 Proxmox API 令牌认证PVEAPIToken格式普通账号密码不可用请求默认走 Dashy 内置 CORS 代理浏览器直连的跨域问题不会挡它落地实施签发只读 API 令牌登录 Proxmox Web UI进入Datacenter → Permissions → API Tokens创建令牌角色只勾只读权限最小化原则别给PVEAdmin。记下三样东西令牌名例如dashy、令牌 UUID、以及userrealm格式的完整用户名如rootpam配置里三样都要。在 conf.yml 中配置 proxmox-lists widget编辑本地部署目录下的 user-data/conf.yml在目标 section 里加一个 widgetsections: - name: 虚拟化平台 icon: fas fa-server widgets: - type: proxmox-lists updateInterval: 30 # 每 30 秒自动刷新2-7200 options: cluster_url: https://pve.your-domain:8006 # 末尾不带 / user_name: rootpam token_name: dashy token_uuid: your-token-uuid node: pve-node-01 # 留空则显示全部节点列表 node_data: qemu # 选了 node 就必填lxc 或 qemu hide_templates: true # 过滤模板虚拟机 title: Proxmox 虚拟机验证数据回流刷新页面列表出现即成功。没出现时先用 curl 直接打 API判断问题在 Proxmox 侧还是 Dashy 侧curl -k -H Authorization: PVEAPITokenrootpam!dashyyour-token-uuid \ https://pve.your-domain:8006/api2/json/nodes/pve-node-01/qemu返回 JSON 数组说明令牌和权限都对401是令牌名或 UUID 写错403是角色缺读权限。调优与扩展连续更新与密钥脱敏updateInterval不设的话只在页面加载时取一次数。conf.yml是明文文件UUID 不想落盘的话换成DASHY_前缀的环境变量代理转发时由服务端替换- type: proxmox-lists useProxy: true options: token_uuid: DASHY_PROXMOX_TOKEN_UUID布局与多节点视图多节点集群直接复制上面那段做模板每个节点一个 widget只改node和title- type: proxmox-lists options: cluster_url: https://pve.your-domain:8006 node: pve-node-02 # 与主节点相比仅此处和标题不同 node_data: qemu title: 备用节点 VMs参数速查参数作用默认值node留空显示节点列表填节点名显示其 VM/容器空node_data指定节点时必填qemu或lxc空hide_templates过滤模板虚拟机falseupdateInterval自动刷新间隔秒0 为不自动刷新0timeout请求超时毫秒2500title_as_link标题是否链接到 cluster_urlfalsefooter_as_link页脚同上false排障白屏并提示 CORS 错误组件默认走内置代理services/endpoints/cors-proxy.js还报错一般是 Dashy 主机到节点 8006 不通。在 Dashy 主机上测curl -k -o /dev/null -s -w %{http_code} https://pve.your-domain:8006返回 200/401 说明网络通000 或超时就是防火墙挡了Proxmox 节点上执行ufw allow 8006/tcp。开发模式正常、生产模式 500典型原因是 Node 运行时不信任 Proxmox 的自签名 CA。把 CA 证书拷到 Dashy 主机后export NODE_EXTRA_CA_CERTS/path/to/proxmox-ca.pem重启 Dashy 容器或进程。请求超时虚拟机数量多时列表接口会变慢。⚠️ 先确认 API 本身响应速度再调大超时毫秒- type: proxmox-lists timeout: 8000收束到这里Proxmox 节点与虚拟机的状态已经和其他自托管服务放在同一块屏上且令牌是只读权限。想继续深挖可以从 widgets 文档 看全部参数从 Proxmox 组件源码 看请求细节conf.yml 示例 里有一份完整配置可参考。令牌 UUID 等同长期 API 凭据别写进公开截图或共享的配置备份里怀疑泄露时直接在 Proxmox 端删掉重发。【免费下载链接】dashy A self-hostable personal dashboard built for you. Includes status-checking, widgets, themes, icon packs, a UI editor and tons more!项目地址: https://gitcode.com/GitHub_Trending/da/dashy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考