hub / github.com/LeoKon3/MizuPanel
github.com/LeoKon3/MizuPanel @v0.1.1
Chat with this repo
1,829 symbols
5,467 edges
182 files
109 documented · 6%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README
MizuPanel
轻量级自托管运维面板，用一个干净的控制台管理主机、Docker、告警和 Kubernetes 资源。
中文 · English
Server + Dashboard + Agent 架构。Agent 主动连接 Server，上报指标并承载允许的运维操作；适合个人服务器、家庭实验室、小型主机集群和轻量 Kubernetes 管理。
|
|
|
|
功能介绍
| 主机监控 节点状态、CPU、内存、磁盘、网络、负载、历史趋势。 | 主机运维 进程、Docker 容器、容器日志、文件管理、Web 终端、Agent 管理。 | 告警中心 指标规则、持续时间判断、活跃告警、历史告警、手动收敛。 |
| Kubernetes 管理 集群接入、资源概览、Namespace、Node、Pod、Workload、Service、Ingress。 | K8s 诊断 Pod 日志、Events、Describe、YAML 查看与编辑、资源操作。 | 资源创建 Deployment、Pod、Service、Ingress、ConfigMap、Secret、PVC、Job、CronJob。 |
Release 包部署运行
优先使用 GitHub Release 里的预构建包。按 Server 所在机器架构下载：
# x86_64 / amd64
curl -LO https://github.com/LeoKon3/MizuPanel/releases/latest/download/mizupanel-linux-amd64.tar.gz
# ARM64 / aarch64
curl -LO https://github.com/LeoKon3/MizuPanel/releases/latest/download/mizupanel-linux-arm64.tar.gz
如果你从源码本地构建，也可以执行：
# x86_64 / amd64
make package-linux-amd64
# ARM64 / aarch64
make package-linux-arm64
解压发布包并准备本机配置：
tar -xzf mizupanel-linux-amd64.tar.gz
cd mizupanel-linux-amd64
cp server.example.yaml server.yaml
如果 Agent 会从其他机器访问面板，建议先在 server.yaml 里设置面板地址：
server:
listen: ":8080"
public_url: "http://你的服务器IP:8080"
启动 Server：
./mizupanel-server -config server.yaml
打开 http://你的服务器IP:8080，进入 Dashboard 后点击 添加服务器，复制 Linux 或 Windows Agent 安装命令到目标主机执行。
发布包内已经包含 Web 静态资源、安装脚本和 Agent 下载文件。Docker、MySQL、管理员认证、systemd 托管和 Token 模型等细节请看 配置部署文档，更多界面可以查看 完整截图。
特别感谢 Linux.do 社区的反馈、讨论和启发。
Extension points exported contracts — how you extend this code
KubectlHandler (Interface)(no doc) [6 implementers]
internal/agent/ws/client.go
AgentHub (Interface)
AgentHub Agent 通信接口 [2 implementers]
internal/server/k8s/service.go
ContainerLogsModalProps (Interface)
(no doc)
web/src/components/ContainerLogsModal.tsx
TerminalHandler (Interface)
(no doc) [4 implementers]
internal/agent/ws/client.go
TerminalHub (Interface)
(no doc) [3 implementers]
internal/server/api/routes.go
K8sPodLogsModalProps (Interface)
(no doc)
web/src/components/K8sPodLogsModal.tsx
ContainerExecHandler (Interface)
(no doc) [4 implementers]
internal/agent/ws/client.go
NodeOperations (Interface)
(no doc) [2 implementers]
internal/server/api/routes.go
Core symbols most depended-on inside this repo
writeErrorcalled by 169
internal/server/api/routes.go
ServeHTTP
called by 100
internal/server/agenthub/hub.go
Get
called by 67
internal/server/store/nodes.go
NewNodeStore
called by 65
internal/server/store/nodes.go
NewMetricStore
called by 59
internal/server/store/metrics.go
writeJSON
called by 51
internal/server/api/routes.go
Upsert
called by 44
internal/server/store/nodes.go
NewHandler
called by 32
internal/server/app/app.go
Shape
Languages
Go76%
TypeScript24%
Modules by API surface
internal/server/agenthub/hub.go113 symbols
internal/protocol/messages.go92 symbols
internal/server/api/routes.go84 symbols
web/src/pages/NodeDetail.tsx66 symbols
internal/agent/ws/client.go63 symbols
internal/agent/kubectl/client.go61 symbols
internal/server/api/nodes_test.go54 symbols
internal/server/app/app_test.go47 symbols
web/src/api/client.ts42 symbols
internal/server/k8s/service.go33 symbols
internal/agent/docker/collector.go33 symbols
internal/server/app/app.go32 symbols
Datastores touched
(mysql)Database · 1 repos
For agents
$ claude mcp add MizuPanel \
-- python -m otcore.mcp_server <graph>