【免费下载链接】pro.webssh.net
iOS / iPadOS / macOS SSH Client
本文介绍如何用iPhone管理Proxmox:借助WebSSH这款iOS/iPadOS/macOS SSH客户端,通过SSH直接连接Proxmox VE服务器,在家也能启停虚拟机、进入LXC容器、检查集群状态,甚至不暴露任何端口就能安全打开8006 Web管理界面。全程不需要在服务器上安装任何东西——因为Proxmox默认就开启了SSH。
为什么SSH是管理Proxmox的最佳入口 🚪
很多家庭实验室玩家习惯用浏览器打开Proxmox的Web界面,但它在局域网外访问时需要额外配置,直接暴露8006端口又有安全隐患。
而Proxmox VE与多数系统不同:SSH默认开启,root密码登录开箱即用。安装完成后,用root账号就能立刻连上节点,执行qm(虚拟机)、pct(容器)、pvecm(集群)等全套管理命令。
这意味着只要SSH端口可达,你的虚拟化集群就尽在掌握——这正是官方Proxmox连接指南的核心思路。
第一步:在WebSSH中添加Proxmox连接(2分钟完成)
- 打开WebSSH,点 + 新建连接
- 填写参数:
- 名称:
Proxmox - pve1(起个醒目的名字) - 主机:节点的IP或域名,如
192.168.1.10 - 端口:
22 - 用户名:
root
- 名称:
- 认证方式先选密码,保存后点击连接
首次连接会要求确认主机指纹,确认后就能看到熟悉的 root@pve:~# 提示符。
💡 为什么用root? Proxmox的管理命令基本都要求root权限,节点Shell就是为root设计的。如果你习惯普通用户+sudo,也可以照常用。
进阶:用密钥替代密码 🔐
经常连接的设备,密钥认证比密码更快也更安全:
- WebSSH设置页 → SSH Keys → + → 生成 ED25519 密钥
- 用密码登录一次,把公钥追加到节点的
/root/.ssh/authorized_keys - 把连接的认证方式改为该密钥
密钥对创建细节可参考创建或导入公私钥对文档。密钥验证成功后,建议把/etc/ssh/sshd_config中的root登录收紧为PermitRootLogin prohibit-password——先测通密钥再改配置,避免把自己锁在门外。
常用命令:VM、容器与集群体检
Web UI的日常操作,CLI全都有对应命令,手机上最常用的几条:
| 场景 | 命令 | 作用 |
|---|---|---|
| 查看所有虚拟机 | qm list | 列出全部VM及运行状态 |
| 启动 / 关机 | qm start 100、qm shutdown 100 | 干净关机,qm stop是强制断电 |
| 进入容器 | pct enter 101 | 直接钻进LXC容器里的Shell |
| 查看版本 | pveversion | 一行看清Proxmox版本与内核 |
| 集群状态 | pvecm status | 节点成员、仲裁(quorum)情况 |
| 存储状态 | pvesm status | 各数据空间使用情况 |
其中 pct enter 是手机上真正的杀手锏:一条命令就进入任意容器,无需为每个容器单独配置SSH。
把这些命令存成一键Snippets ⚡
在手机上敲VMID很痛苦?WebSSH的Snippets功能可以把命令存成快捷片段,点一下就执行。仓库内置了一整套Proxmox片段,例如:
- snippets/proxmox/vm-list.sh — 查看本机全部QEMU虚拟机
- snippets/proxmox/ct-list.sh — 查看全部LXC容器
- snippets/proxmox/cluster-status.sh — 集群仲裁与投票
- snippets/proxmox/recent-tasks.sh — 最近20条任务及失败任务过滤
配合标签关联连接,这些片段只会出现在你的Proxmox节点上,不会混进其他服务器的片段列表。
更简单:开启原生Proxmox仪表板 📊
日常运维其实连命令都不用敲。WebSSH内置原生Proxmox仪表板(PROXMOX-OVER-SSH),完全跑在SSH通道之上:底层驱动节点的pvesh接口,不需要暴露8006端口、不需要创建API Token、服务器端零安装——SSH能通,仪表板就能用。
开启方法:
- 编辑你的Proxmox连接
- 进入 Roles(角色) 区块
- 启用 PROXMOX-OVER-SSH 角色(想保留终端就同时保留SSH角色)
- 保存
之后点击连接,就能在终端和Proxmox仪表板之间切换。仪表板提供:
- 节点总览:状态、CPU、内存、磁盘仪表与运行时间
- VM与容器列表:实时CPU/内存占用,支持搜索过滤
- 生命周期操作:启动、关机、重启、挂起、恢复(破坏性操作有确认)
- 统计图表:CPU、内存、网络、磁盘I/O,支持触摸滑动查看
- 快照:浏览快照树、创建、回滚、删除
- 备份:触发
vzdump备份、管理备份归档 - 迁移:把虚拟机在线迁移到另一节点
- 集群健康:仲裁、HA资源、各节点待更新的安全补丁
屏幕约每10秒自动刷新,盯着一次迁移或备份跑到完成非常直观。只读视图人人可用,涉及状态变更的操作(启停、快照、备份、迁移)需要PRO版本,详见定价说明。
⚠️ 注意:仪表板连接的是节点(Hypervisor)本身,不要连到某台虚拟机或容器——
pvesh只存在于节点上。
SSH隧道打开8006 Web界面(不暴露端口)🔒
仪表板没覆盖到的功能(从零创建VM、防火墙设置、noVNC控制台)仍需要完整Web UI。好消息是:用WebSSH的本地端口转发,一条隧道就能安全访问,全程只有SSH端口暴露:
- 进入 Tunnel 标签页,点 +
- 填入与SSH连接相同的主机和凭据
- 端口转发填写:
8006:127.0.0.1:8006 - 启动隧道,在Safari打开
https://127.0.0.1:8006(接受自签名证书提示)
全程端到端加密,适合远程访问家庭实验室。更多局域网穿透思路可参考通过SSH隧道远程访问HomeLab。
状态栏:抬眼即见的集群健康度 📡
WebSSH的终端状态栏支持自定义脚本。仓库内置了两个Proxmox专用组件:
- statebar/proxmox/cluster-quorum.js — 显示集群仲裁状态
- statebar/proxmox/running-guests.js — 显示运行中的虚拟机/容器数量
配合自定义状态栏API,你可以在终端顶部常驻显示集群健康信息,一抬眼就知道Proxmox是否安好。
常见问题排查 🩺
端口22拒绝连接? SSH在Proxmox上默认开启,多半是连错了IP(连到了VM而不是节点),或被防火墙拦截。检查Web UI中 Datacenter → Firewall 和节点防火墙规则。
qm/pct: command not found? 你大概率连进了某台虚拟机或容器,而不是Proxmox节点本身——这些命令只存在于Hypervisor上。看看提示符里的主机名就能确认。
加固后提示 Permission denied (publickey)? 说明改PermitRootLogin时密钥还没生效。检查/root/.ssh/authorized_keys权限是否为600、目录700;被锁死时可用物理控制台或Web UI的Shell修复。
切换App后会话断开? iOS会挂起后台App。长时间任务(迁移、备份)放进tmux里跑,回来tmux attach重新接入即可,教程见tmux会话管理。
延伸玩法 ✨
- 多节点集群:用文件夹整理连接和标签分组管理
- 节点在跳板机后面:把可达主机设为Jump Host(跳板),SSH与Proxmox仪表板都会自动经过它
- 关机过的节点:WebSSH支持Wake on LAN远程唤醒
- 免订阅:WebSSH为一次性买断,免费版本可以先用一个保存的连接体验全部基础功能
从此,家庭实验室的虚拟化运维不再依赖台式机——一部iPhone,就是你的Proxmox指挥中心。
【免费下载链接】pro.webssh.net
iOS / iPadOS / macOS SSH Client
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考






