Skip to content
章北海 edited this page Oct 9, 2026 · 5 revisions

ProxCenter Wiki

ProxCenter 是对接 Proxmox VE 8.x / 9.x 的自托管 Web 管理面板,包含虚拟机与 LXC 容器的全生命周期、cloud-init 模板流水线、网络与防火墙、监控大盘、 快照与备份、浏览器内 VNC 控制台、多用户权限与操作审计,另外还有 SSH 防暴力破解、端口与进程 异常检测、安全基线加固。Apache-2.0。

控制台仪表盘

完整功能说明与全部配置项以仓库的 README 为准。 本 wiki 只把「装、配、排错」三件事展开讲,遇到问题先翻 常见报错。

从这里开始

我想…… 看这里
一条命令装上,然后登录改口令 安装与部署
在 PVE 上建 Token、给权限(新手最容易卡在这里) PVE Token 与权限
查某个 .env 变量是干什么的 配置项速查
面板打不开 / 列表全空 / 连不上 PVE 常见报错
给虚拟机或容器里的用户改密码 重置客户机口令

三分钟上手

第一步,在 PVE 节点上建 Token 并授权,别用 root@pam:

pveum user add panel@pve --comment "ProxCenter panel"
pveum user token add panel@pve panel --privsep 0
pveum acl modify / --user panel@pve --roles PVEVMAdmin,PVEDatastoreUser,PVESDNUser,PVEAuditor,PVEVMUser

命令会打印 full-tokenid(形如 panel@pve!panel)和 token 密钥,这两串后面要填进面板。

第二步,在跑面板的机器上一条命令装完:

git clone https://github.com/yjscloud/ProxCenter.git
cd ProxCenter
sudo ./deploy.sh

默认全程不提问,端口 8080、库名 proxcenter_panel、账号 proxcenter,SECRET_KEY 与 数据库口令、管理员口令全部随机生成。装完最后一屏会打印:

   面板地址 : http://<你的机器IP>:8080
   登录账号 : admin
   ★ 初始管理员口令(只显示这一次):
       XXXXXXXXXXXXXXXX

第三步,登录后做两件事:

  1. 右上角用户名 →「个人中心」→ 修改密码,把初始口令改掉;
  2. 「设置 → Proxmox 连接配置」填入 host / Token ID / Token Secret。

相关链接

Clone this wiki locally