Kokoro

Kokoro 是一款用于管理多台 VPS 的主控面板与轻量探针工具。它采用 Hub（主控）与 Agent（探针）的架构：Hub 部署在主机上，负责节点管理、任务下发和结果展示；Agent 安装在子机上，定期上报状态并执行 Hub 下发的固定任务。

核心监控与任务下发

面板能够汇总各 VPS 的在线状态、硬件信息、网络流量和延迟，并支持节点分组与筛选。首页总览直观展示服务器总数、在线与离线数量，并通过点阵地球将拥有节点的国家或地区整片点亮。

在任务管理方面，用户可通过任务队列向节点下发硬件跑分、IP 质量与解锁检测、网络测速以及三网回程检测。所有任务的进度、历史结果和原始输出均可在面板中查看。出于安全考虑，Agent 仅接受预先定义的结构化指令，不会执行 Hub 下发的任意 Shell 命令或脚本。

运维辅助与数据迁移

针对 VPS 常见的内存不足问题，Kokoro 支持远程为节点增加 SWAP。该操作仅支持增加不支持减少，且交换文件会放置在系统惯例位置（如 /swapfile），不会占用 Kokoro 自身的目录，也不会被备份或卸载操作带走。

面板提供加密备份与导入恢复功能，方便将主控迁移至新 VPS。若使用同域名，新面板会直接接管；若更换新域名，只需在旧面板输入新域名，即可通知各子机探针自动完成切换。

交互功能与主题系统

为了便于节点信息的展示与交流，Kokoro 内置了互动模块。用户可以为节点点赞或踩，并留下购买留言与评论（系统限制每节点每 IP 在 5 分钟内最多 2 条，正文限 100 字，联系方式限 20 字）。站长可以为每台节点撰写 Markdown 格式的介绍文章，游客也可通过“我想买它”功能直接向站长发送消息。

主题系统支持高自由度定制。用户可以一键获取他人使用的主题。同时，系统提供包含详细创作说明的主题范例，用户可将其交由 AI 辅助生成符合特定视觉效果的新主题。面板目前内置 6 种主题。

提醒机制与常规特性

节点到期提醒默认提前 7 天触发，支持通过 Telegram 或 Webhook 推送。站内消息系统会保存购买留言与到期提醒备份，支持标记已读、分页查看和批量删除。

其他常规功能包括：三网分省探测（详情页可查看）、三网延迟支持 IPv4 或 IPv6 探测（适配 IPv6 only 节点）、面板可视化更新、一键更新所有 Agent 探针，以及累计访问数统计。

部署方式与技术细节

Kokoro 的主控和探针均使用 Go 语言编写，前端采用 HTML、CSS 和原生 JavaScript，数据库使用 SQLite。当前版本单个程序体积约 22 MB，面板和探针共用同一份二进制文件。部署时无需在目标机器上安装 Go 或 Node.js 环境。

主控安装面向 Debian 或 Ubuntu 的 systemd 环境，需要 root 权限。安装前需将域名解析到主控服务器并放行 80 和 443 端口。可通过以下脚本一键安装：

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

若需指定域名，可使用：

curl -fsSL https://raw.githubusercontent.com/Vincentkeio/kokoro/main/scripts/install-hub.sh | sudo sh -s -- --domain panel.example.com

安装完成后，进入后台即可为子机生成专属的 Agent 安装命令。在服务器终端输入 kokoro 可随时打开管理菜单。

为控制长期运行产生的数据量，Kokoro 的监控历史采用分层降采样策略保存。系统会按时间跨度读取不同粒度的数据，并定期清理过期记录，从而有效解耦磁盘占用与采集频率。