【开源探针】Kokoro探针测试版

Kokoro 探针测试版

项目地址：https://github.com/Vincentkeio/kokoro

Kokoro 是一款用于管理多台 VPS 的主控面板与轻量 Agent。面板集中查看小鸡状态，也支持测试、互动和主题分享。

特色功能

• 运行测试并查看结果：从面板下发测试任务，结果回报后显示在对应的小鸡卡片上。
• 远程调整 SWAP：为小鸡增加 SWAP 容量。
• 社区互动：小鸡可以发布文章、评论，也可以点赞或点踩。
• 主题分享：一键获取别人分享的主题。
• 求购留言：点击小鸡卡片上的「我想买鸡」，即可向站长发送求购留言。

安装方式

1. 安装面板主机

在 Debian 或 Ubuntu 主机上执行：

curl -fsSL https://raw.githubusercontent.com/Vincentkeio/kokoro/main/scripts/install-hub.sh \
  | sudo sh

2. 安装 Agent

登录 Kokoro 面板，进入后台的「系统设置」，复制 Agent 安装命令。然后登录要纳入管理的小鸡，以 root 身份粘贴并执行该命令。安装完成后，Agent 会自动连接面板并上报状态。

安全与资源占用

• Hub 与 Agent 均使用 Go 编写；Hub 页面资源随程序打包，无需额外安装前端运行环境。
• Agent 只执行白名单里预定义的任务，不接受 Hub 下发的任意 Shell 命令、脚本地址或自定义执行参数。下载的程序和安装资源会校验 SHA-256。
• 管理员密码使用带随机盐的 PBKDF2-HMAC-SHA256 保存。Agent 默认通过 HTTPS 通信；Hub 服务以专用系统用户运行，并由 systemd 限制可写目录。
• Agent 需要 root 权限采集主机信息及执行 SWAP 等管理操作；其 systemd 服务启用文件系统隔离，并限制常驻服务的可写范围。

发布二进制的磁盘占用约为：Hub 16.5 MiB；每台 Agent **16.5 MiB（amd64）**或 15.5 MiB（arm64）。Hub 为子机分发程序还需保存两种架构的 Agent 文件，Hub 与两份 Agent 二进制合计约 48.5 MiB；不含数据库、Caddy、系统依赖及运行数据。大小会随版本变化。