# 哪吒监控 v1.0 alpha 捐赠给社区

Original: <https://lifelonglearn.ing/nezha-v1-alpha>

Author: [奶爸](https://lifelonglearn.ing/users/3b04650c-8231-499b-8ef0-381fc4d7efb0)

Published: 2024-11-23T03:57:23Z

Updated: 2026-09-27T06:57:43Z

Version: 1

从 10 月 19 号写下第一行重构代码到现在，历经不到 2 个月时间，哪吒监控进入到内部测试阶段，v1 相较 v0 有很多优化，丢了历史包袱轻装上阵。

v1 开发过程中间有过停滞，有些人加入又离开，也有些人话说完就失联了，同样有些人一直在但是没有参与开发。这些都无可厚非，他们与我一样都没有从中获得什么利益。但是从 v0 到 v1 仍然有很多朋友切实的在为爱发电。

4 年前我一腔热血开始了这个项目，从 **监控** 到 **报警** 到 **计划任务** 到 **webssh** 到 **内网穿透** 一点一点做了些 **实用** 又 **有趣** 的功能。4 年后激情退却只是做了点开荒的工作，大部分工作都不是由我贡献，我退下来了还有人接棒，这个社区会继续壮大发展下去。我已将这个项目和它的收获的 7k star 捐赠给社区转移到 nezhahq 组织账户去掉我的个人标签，大家给贡献者们点点 follow，给他们的项目点点 star。

## v0 用户须知

v1 版本跟 v0 版本不兼容，不能无缝升级，现存用户需要做下面两个操作避免 v1 发布后自动更新导致功能异常。

* 将你的 docker-compose.yml 中的 nezha docker 版本 tag 从 latest 改为固定在 **v0.20.13**
* 将你的全部 agent 禁用自动更新或更新到 **v0.20.5** *(一个 v0 的 final 版本)*

v1 版本在内测结束开始公测时会替换掉原本的发布渠道，所以在此之前请完成上面操作

## v1 和 v0 主要区别

**前后端分离** 是 v1 和 v0 的一大区别，v0 版本我是用了一直用的 Semantic-UI 做的 Go 模板，那时我其他小项目有做前后端分离，但是哪吒监控因为懒就采用了模板方案，这是一个非常大的弊端，不利于定制。虽然可以切换模板，但还局限性还是很大。v1 版本完全改成前后端分离并且将前台和后台分成两个前端项目方便用户只定制前台模板，后台工作比较多，前台基本接一下 3、5 个 API 就搞定了。

*可以预见的是 v1 的主题一定会全面开花，定制前台主题非常简单，只有几个 API。*

**自动添加 Agent / 一机多装** v0 版本需要手动创建后安装，很多几十几百台的大户都提到希望能够自动添加，前段时间也有人 PR 了添加 Agent 的 API 来实现这个需求。但是在 v1 中 agent 安装时只需要一个固定的 dashboard 密钥，不需要一机一码手动修改，启动后会自动创建到 dashboard。

**本地账户** v0 版本因为省事只用 oauth2 登录，有 oauth2 供应商为我们保障安全就没有做本地账户，5 年来没有一例因为哪吒面板被黑的事件😎。v1 版本使用本地账户，通过一个简易的内置 WAF 来防范暴力破解（需要配置 Real IP header），安全性未降，便利性提升。

**gRPC / Web** 端口合并，因为在最初版本没有做合并已经散歩的很广了，不好再变，所以一直等到不兼容的 v1 到来才有机会重构这部分设计。

## v0 核心贡献者

（排序不分先后）

* [cantoblanco](https://lifelonglearn.ing/r/go?url=aHR0cHM6Ly9naXRodWIuY29tL2NhbnRvYmxhbmNv) *aka 白歌* wiki 主要贡献者，nezha.wiki 持有人。
* [AkkiaS7](https://lifelonglearn.ing/r/go?url=aHR0cHM6Ly9naXRodWIuY29tL0Fra2lhUzc=) 做了 V0 API 及很多其他小特性，group SPAM AI 守护神。
* [nap0o](https://lifelonglearn.ing/r/go?url=aHR0cHM6Ly9naXRodWIuY29tL25hcDBv) *aka 德🐔社* 做了server-status 官方主题并且积极更新聆听社区声音。
* [uubulb](https://lifelonglearn.ing/r/go?url=aHR0cHM6Ly9naXRodWIuY29tL3V1YnVsYg==) *aka Uub* 做了 Web文件管理器及很多其他小特性和很多 agent、script 相关的工作。
* [Erope](https://lifelonglearn.ing/r/go?url=aHR0cHM6Ly9naXRodWIuY29tL0Vyb3Bl) *aka 火柴* 做了早期很多 script 工作及其他dashboard开发，group rank bot。
* [dysf888](https://lifelonglearn.ing/r/go?url=aHR0cHM6Ly9naXRodWIuY29tL2R5c2Y4ODg=) *aka 黑歌* 做了一些 dashboard 开发，得意之作 [fake-nezha-agent](https://lifelonglearn.ing/r/go?url=aHR0cHM6Ly9naXRodWIuY29tL2R5c2Y4ODgvZmFrZS1uZXpoYS1hZ2VudA==)。
* [JackieSung](https://lifelonglearn.ing/r/go?url=aHR0cHM6Ly9naXRodWIuY29tL0phY2tpZVN1bmc0ZXY=) 第一个社区真正自己设计开发的主题 ​*DayNight*​。
* 还有很多 [Contributors](https://lifelonglearn.ing/r/go?url=aHR0cHM6Ly9naXRodWIuY29tL25lemhhaHEvbmV6aGEvZ3JhcGhzL2NvbnRyaWJ1dG9ycw==) 没有一一列举

## v1 核心贡献者

（排序不分先后）

* [uubulb](https://lifelonglearn.ing/r/go?url=aHR0cHM6Ly9naXRodWIuY29tL3V1YnVsYg==) *aka Uub* 做了几乎 v1 API、管理后台前端的所有工作。
* [hamster1963](https://lifelonglearn.ing/r/go?url=aHR0cHM6Ly9naXRodWIuY29tL2hhbXN0ZXIxOTYz) *aka 仓鼠​* 将自己的 v0 的用户前端 port 到了 v1 作为 v1 官方默认前端。
* [AkkiaS7](https://lifelonglearn.ing/r/go?url=aHR0cHM6Ly9naXRodWIuY29tL0Fra2lhUzc=) alpha 内测阶段 agent 二进制提供、教程引导。
* [Colinwood](https://lifelonglearn.ing/r/go?url=aHR0cHM6Ly9naXRodWIuY29tL0NvbGlud29vZDEx) 管理后台前端 i18n。
* [cantoblanco](https://lifelonglearn.ing/r/go?url=aHR0cHM6Ly9naXRodWIuY29tL2NhbnRvYmxhbmNv) *aka 白歌* v1 wiki 主要贡献者。

很多人说哪吒监控有这样那样的问题，在有限资源下做选择、做出这些功能、拿到 7k star 已经证明我优秀的产品经理的属性 🤡 。如果资源宽裕情况下，想法还有很多，v1 只是其中一个。

> 为什么一直没做历史记录？
>
> 因为感觉 sqlite 做这个有点普通，如果用专业时序数据库那干脆全套用时序数据库得了，完全没必要用哪吒，哪吒监控主打一个轻量
>
> 如果那天心血来潮要自己做一个简易tsdb或爆改一个embedded tsdb，历史记录应该就上线了

这几年因为哪吒监控还结识了一个线下朋友 Frank，来自台湾，线下一起喝咖啡聊了半天，遗憾是没一起吃饭，联系还没断，等去上海会约一下。akkia 和 火柴也面基过，因为我已经不在那个城市就没能一起。

开源不易，希望大家用的开心～
