公测版 · 正在获取最新版本…

PVE 小鸡管理面板
公测版

部署在 Proxmox VE 宿主机上的 Web 管理面板：创建与管理 KVM / LXC、NAT 端口映射、网页控制台、资源监控、客户中心与卡密授权，命令行操作变成点几下鼠标。

立即下载查看安装教程

最新版本：- 安装包：- 大小：-

主要功能

一套面板覆盖开鸡、网络、控制台、监控与授权，另带客户自助中心。

小鸡管理

创建 / 开机 / 关机 / 重启 / 删除 KVM 与 LXC，支持模板克隆、配置调整。

网络

NAT 端口映射、独立 IPv4 / IPv6、带宽与流量统计。

控制台

网页 VNC / LXC 终端，无需额外客户端。

监控

CPU / 内存 / 磁盘 / 流量曲线，异常告警。

客户中心

另一台 VPS 上运行的客户自助面板，开通 / 删除小鸡自动同步账号。

授权

卡密激活、机器指纹绑定、到期提醒、防复制，支持面板内一键更新。

计费与支付暂未开放，当前所有功能免费试用；未激活授权为试用模式，KVM + LXC 合计最多 10 台（模板不计入）。

环境要求

不符合以下条件时，安装会明确提示并中止，不会装出半残环境。

项目	要求
系统	Debian 12（bookworm），暂不支持 Debian 13
虚拟化平台	Proxmox VE 8.x（未装 PVE 可由安装向导自动安装）
架构	x86_64
内存 / 磁盘	建议 ≥ 4 GB / ≥ 40 GB（不含小鸡占用）
权限	root（SSH 登录）
KVM 小鸡	宿主机需开启嵌套虚拟化：`ls /dev/kvm` 存在且 `grep -cE 'vmx\|svm' /proc/cpuinfo` 不为 0；不满足时只能开 LXC

若你的机器本身就是 KVM 虚拟机，嵌套虚拟化需要上层服务商开启，无法在系统内自行修改。

安装教程

先把安装包上传到服务器 /root 目录，再按机器现状二选一。

上传安装包

在本地终端执行（把 <服务器IP> 换成母鸡公网 IP）：

scp pve-panel-<版本>.tar.gz root@<服务器IP>:/root/

方式 A：已装好 PVE

mkdir -p /root/pve-install
tar -xzf /root/pve-panel-<版本>.tar.gz -C /root/pve-install
cd /root/pve-install
bash install.sh

安装过程会交互询问：

管理员白名单 IP（必填）：只有这些 IP 能访问面板端口，多个用英文逗号分隔，只支持单个 IPv4/IPv6，不支持域名和网段。
其余项（网卡、存储、端口等）会自动探测，直接回车采用默认值即可。

方式 B：裸 Debian，还没装 PVE

mkdir -p /root/pve-install
tar -xzf /root/pve-panel-<版本>.tar.gz -C /root/pve-install
cd /root/pve-install
(command -v python3 >/dev/null || (apt-get update && apt-get install -y python3)) \
  && python3 webinstall.py --service

终端会打印一个带随机串的地址，用浏览器打开：

http://<服务器IP>:8888/<随机串>/

请先在云厂商安全组放行 8888/tcp，否则浏览器打不开。

页面会检测 12 项环境，按引导操作：

安装 PVE（阶段 1）

自动装依赖、配置软件源、升级内核。

自动重启

安装完成后服务器自动重启（必须重启，无法取消），浏览器会自动重连。

完成 PVE 安装（阶段 2）

重启后回到向导，点击继续完成 PVE 安装。

安装面板

填写管理员白名单 IP，等待完成。装好后 8888 会自动关闭。

后续重装请 SSH 执行 bash install.sh --upgrade。

访问与首次使用

面板端口只对管理员白名单放行，换网络环境前请先把自己的新 IP 加进白名单。

入口	地址
面板（推荐）	`https://<服务器IP>:8443`（自签证书，提示不安全时选择继续访问）
面板（兼容）	`http://<服务器IP>:5000`
PVE 原生	`https://<服务器IP>:8006`
VNC 隧道	`6080`

PVE 登录账号为 root，认证域选 Linux PAM standard authentication，密码即服务器 root 密码。

授权激活

打开面板，点顶部「授权」按钮，输入卡密并激活；激活成功后显示套餐、到期时间与剩余天数。

场景	行为
未激活	试用模式，最多 10 台小鸡
已激活	不限台数，功能全开
到期后 30 天内	可正常管理，每天弹窗提醒续费，不能新建小鸡
到期超过 30 天	自动关闭全部小鸡并禁止开机，续费后恢复正常
换机器	面板「授权」弹窗点「解绑」，在新机器重新激活即可

授权与机器指纹绑定，卡密复制到其他服务器无法使用。新版面板支持「发现新版本 → 立即更新」，无需重新安装。

日常维护

修改访问白名单：直接编辑服务器上的两个文件，保存后 5~10 秒自动生效，无需重启。

文件	作用
`/opt/pve-panel/admin_ips`	管理员 IP，放行 5000 / 8006 / 6080 / 8443
`/opt/pve-panel/client_ips`	客户中心 IP，放行 6080 / 8443

每行一个 IP，# 开头为注释，不支持网段与域名。

systemctl status pve-panel pve-guard          # 查看服务状态
systemctl restart pve-panel                   # 重启面板
journalctl -u pve-panel -n 100 --no-pager     # 查看最近日志
bash install.sh --upgrade                     # 升级代码并自检修复网络

客户中心对接（可选）

填写地址

面板顶部「客户中心」按钮，填客户中心地址（只填 IP，可带端口，多个用英文逗号分隔）。

生成密钥

点「生成」得到对接密钥，填入客户中心后台。

保存并测试

点「保存」，再点「测试连接」确认。保存后该 IP 会自动加入 client_ips 白名单。

常见问题

公测期间如遇问题，请保留面板「日志」页截图反馈。

开 KVM 报 No accelerator found

宿主机未开启嵌套虚拟化。检查 ls /dev/kvm，若不存在只能使用 LXC，或联系服务商开启嵌套虚拟化。

8888 页面打不开

云厂商安全组未放行 8888/tcp，或安装已完成（面板装好后 8888 会自动关闭，改用 8443）。

8443 打不开，但 8006 正常

你的 IP 不在管理员白名单内。SSH 登录后把当前公网 IP 写入 /opt/pve-panel/admin_ips，等 5~10 秒再试。

Debian 13 能装吗

暂不支持。面板核心模块按 Python 3.11 编译，Debian 13 自带 Python 3.13 无法加载，安装会明确提示并中止，不会装出半残环境。

浏览器提示证书不安全

8443 使用自签证书，属正常现象，点击「继续访问」即可。

面板能管多少台小鸡

已授权不限数量；未授权试用 10 台。

以后升级还要重新安装吗

不用。从 2026-11-13.10 起面板内置一键更新：检测到新版本后点「立即更新」，自动下载、校验、备份替换并重启，失败自动回滚。首次升级到该版本仍需手动安装一次。

安全提示

端口收敛

面板端口仅对白名单开放，请勿把 5000 / 8006 / 8443 直接暴露给全网。

登录加固

定期修改服务器 root 密码，建议改用 SSH 密钥登录并关闭密码登录。

使用官方包

安装包已做核心模块编译保护，请勿使用来源不明的修改版。

漏洞反馈

公测期间如发现安全问题，请私下反馈，不要公开细节。

PVE 小鸡管理面板公测版