【开源】OneFrog：一款服务器运维管理面板，通过 ai bot 自动管理、需求维护、服务搭建。

写在前面，本人非科班出身，设计肯定会有不合理的地方。本项目只是提供一个工具，需自行接入 ai api 使用，支持自定义模块拓展，搭建自己的专属模块，所有本项目不仅仅局限于服务器管理运维，也可作为一个 ai 助手使用，如何用看你自己想如何使用。

最简单的例子，你可以直接告诉他帮我跑一下 NQ、TQ，他会自动运行并给你结果。

项目开源，使用与安装见后文。

欢迎加入 TG 交流群，与我交流与反馈问题。

💬 Telegram 交流群：https://t.me/+pKQYEaxzidU4ZjZh

为什么做这个

手里的 VPS 一多，日常运维就成了重复劳动：这台磁盘快满了吗？那台 nginx 怎么又 502 了？哪台机器下个月到期？每次都要开终端、登 SSH、敲一堆命令，再自己翻输出。

所以我做了 OneFrog。把服务器通过 SSH 接进来，直接用中文告诉它你想干什么，AI 会去服务器上执行命令，把结果整理成人话告诉你。危险操作它不会擅自动手，会先停下来问你。

每一步执行了什么命令、返回了什么输出，都能在对话里展开看，不是黑箱。

核心功能

对话式运维，过程全透明

• 主控 Bot 理解需求、拆分任务，执行 Bot 通过 SSH 在你选中的服务器上跑命令
• 每条命令和原始输出都能展开查看，AI 的回复支持 Markdown 格式
• 需要你拿主意时，AI 会弹出选项卡片，点一下就能回答，不用打字
• 可以建多个 Bot 分工，每个 Bot 单独指定模型

智能命令审批：该问才问，不烦人

这是我最花心思的部分。让 AI 在服务器上执行命令，最怕它乱来。

• 查看类命令（查磁盘、看日志、看进程）直接执行，不打扰你
• 删文件、停服务、改防火墙、改 SSH、下载脚本直接运行这类操作，会弹出确认卡片，写明要做什么、为什么做、风险在哪
• 双重判断：服务端规则 + AI 自评风险，取更严的那个，AI 没法 “说服” 系统放行危险命令
• 从服务器输出、文件、附件里来的命令一律要你确认，防止 AI 被日志或网页里藏的指令带偏
• 5 分钟没人确认就自动当作拒绝
• 开不开由你决定：首次登录选 “智能审批” 或“关闭审批”，之后随时可改

服务器探针

• 轻量只读采集脚本，只用 Python 标准库，不装多余依赖
• CPU、内存、磁盘、网络流量实时图表
• 三网（电信 / 联通 / 移动）延迟和丢包监测，线路质量一目了然

密钥保险箱

• 密码、Token 存进保险箱后，AI 只能看到名字，看不到值
• 命令里写 {{secret:名称}}，执行时才在服务端替换成真实值
• 命令输出里如果出现明文，会自动打码

资产与订阅记账

• 记录 VPS、域名的价格和续费周期
• 自动算出每月花费和剩余价值，快到期时提醒

🔌 模型随便接

• 支持任意 OpenAI Chat Completions 兼容接口，DeepSeek、通义、自建中转都可以
• 主控、执行、审批可以分别用不同模型：便宜的干杂活，好的做判断
• 自带 Token 用量统计

适配手机，支持 iOS 添加到主屏幕

• 界面随屏幕宽度自适应，手机上侧边栏变成抽屉菜单，对话、审批、探针、保险箱都能正常用

• iPhone 用 Safari 打开面板，点 分享 → 添加到主屏幕，就能像 App 一样从桌面图标打开，独立窗口运行

• 躺在床上收到告警，拿起手机就能让 AI 去查

• 躺在床上收到告警，拿起手机就能让 AI 去查

上图为 iOS 添加到主屏幕后的效果示意图：画面是真实截图，状态栏为后期加上。

上图为 iOS 添加到主屏幕后的效果示意图：画面是真实截图，状态栏为后期加上。

安全设计

• SSH 主机指纹校验：首次连接需要你确认指纹（会标明 ed25519 等类型），指纹一旦变化就拒绝连接，不会自动覆盖
• 首次登录强制修改默认用户名和密码
• 密钥、对话、登录会话全部加密存储到硬盘，重启、升级都不会丢
• 容器内以非 root 用户运行，启用了 CSP、CSRF 校验、WebSocket 来源校验和登录失败限流
• 有新版本时面板顶部提示（只读检查，不会自动安装，可以关闭）

安装：一行命令

支持 x86_64 / arm64 的 Linux 服务器，需要已安装 curl，用 root 执行：

curl -fsSL https://raw.githubusercontent.com/llc370219/onefrog/main/install.sh | sudo bash

• 没装 Docker 的话，脚本会提示并自动安装
• 直接拉取预构建镜像，服务器上不需要 Go、Node
• 装完终端会打印面板地址、用户名和随机初始密码，实测 1 核 1G 的小鸡大约一分钟装好
• 升级：重新运行同一条命令，账号和数据都会保留

正式使用建议：

1. 放在 HTTPS 反向代理后面，安装时加上 OF_BIND_ADDR=127.0.0.1
2. 给 OneFrog 一个权限受限的 SSH 用户，不要直接给 root
3. 开启智能审批

开源

• GitHub：https://github.com/llc370219/onefrog
• 协议：AGPL-3.0
• 发现安全问题请通过 GitHub 的 Security 页面私下报告

刚发布不久，肯定还有不完善的地方，欢迎试用、提 issue 和 PR。觉得有用的话点个 Star 🌟，这是我持续更新的最大动力！