# Hui-Hui

**Repository Path**: Luna-CY/hui-hui

## Basic Information

- **Project Name**: Hui-Hui
- **Description**: 此项目主要目标是为个人服务器提供一个包含基础监控、站点管理、工具集、第三方应用安装的控制台。通过此项目可以节省服务器的配置成本，提高效率和易用性，避免繁琐的终端操作命令和步骤
- **Primary Language**: Go
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: https://gitee.com/Luna-CY/hui-hui
- **GVP Project**: No

## Statistics

- **Stars**: 9
- **Forks**: 2
- **Created**: 2023-05-30
- **Last Updated**: 2025-09-01

## Categories & Tags

**Categories**: nms

**Tags**: None

## README

# Hui Hui

灰灰我家的小蓝猫，不过本项目不是为了养猫

## 简介

此项目主要目标是为个人服务器提供一个包含基础监控、站点管理、工具集、第三方应用安装的控制台。通过此项目可以节省服务器的配置成本，提高效率和易用性，避免繁琐的终端操作命令和步骤

## 详细介绍

### 仪表板
仪表板提供了对基础资源的监控，目前功能比较少，再考虑后续扩展此部分的功能，实现一些如远程登录用户监控、资源折线图、服务器事件等

![仪表板](https://gitee.com/Luna-CY/hui-hui/raw/develop/resources/screenshot-20230620-093341.png)

### 站点配置

支持对此服务器上的站点进行配置，站点配置通过内置的Caddy服务来进行反向代理，目前不支持更换为Nginx等其他反向代理服务器

当前仅支持简单的路由配置，后续会扩展支持更多的反向代理配置参数以及传输层配置等

![站点配置](https://gitee.com/Luna-CY/hui-hui/raw/develop/resources/screenshot-20230620-093542.png)

![站点配置](https://gitee.com/Luna-CY/hui-hui/raw/develop/resources/screenshot-20230725-132704.png)

### 应用列表

应用安装支持安装一些第三方应用，当前预置了V2ray与Trilium两款应用，后续根据反馈可以考虑增加更多应用

![应用列表](https://gitee.com/Luna-CY/hui-hui/raw/develop/resources/screenshot-20230725-104838.png)

### 工具箱

工具箱提供一些轻量应用或能力，当前已支持：

- 资源管理器，对服务器上指定目录的文件管理器
- 下载器，可以通过服务器下载网络文件并保存到服务器，之后可以选择从服务器下载到本地

![工具箱-资源管理器](https://gitee.com/Luna-CY/hui-hui/raw/develop/resources/screenshot-20230725-132422.png)

![工具箱-文件下载器](https://gitee.com/Luna-CY/hui-hui/raw/develop/resources/screenshot-20230725-105103.png)

## 安装前的准备

- 一个域名，这对HuiHui的安全来说是必须的
- 证书，这是可选地，如果你有HTTPS证书可以直接使用，否则HuiHui通过Caddy可以直接为域名申请证书，如需使用自定义证书初始化可通过命令`/opt/huihui/hui-hui init --help`获取帮助

## 安装

使用提供的在线安装脚本、下载编译好的二进制包或者克隆此仓库进行手动编译

### 在线安装脚本

`/bin/bash -c "$(curl -fsSL https://gitee.com/Luna-CY/hui-hui/raw/master/install.sh)"`，安装完成后执行`/opt/huihui/hui-hui init --hostname {YOUR_HOST}`初始化本地环境

### 二进制包

下载二进制包到本地，将其解压到目录`/opt/huihui`下，注意此目录是固定的，不支持修改。解压完成后执行命令`/opt/huihui/hui-hui init --hostname {YOUR_HOST}`进行环境初始化

初始化的过程会安装`Caddy`服务并生成默认的访问密码，注意此密码仅打印在终端，没有任何其他渠道可以获取。如果你不小心清空了终端输出那么可以重新初始化来获取

获取密码后打开域名，在系统设置中可以进行密码更改

### 手动编译

`make build && make package`，执行完成后将打包的`hui-hui.tar.gz`上传到服务器，后续步骤参考二进制包的安装方式

### 启动

执行`/opt/huihui/hui-hui init`初始化环境后，会自动创建`systemd`的配置文件到`/etc/systemd/system/hui-hui.service`，可以通过`systemctl`来启动服务

## 依赖

此项目依赖linux系统的`systemd`服务