frontend

Nano FrontEnd

[版本历史/ChangeLog]

English Version

简介

FrontEnd是Nano项目自带的Web管理门户，对集群进行图形化管理。FrontEnd的服务基于Core模块的API接口实现，独立进行账号管理。

由于涉及网络配置，建议使用专用Installer进行部署，项目最新版本请访问此地址

项目官网

项目全部源代码

Portal/页面源文件

编译

环境要求

• CentOS 7 x86
• Golang 1.20

准备依赖的framework
$git clone https://github.com/project-nano/framework.git

准备编译源代码
$git clone https://github.com/project-nano/frontend.git

编译
$cd frontend
$go build

编译成功在当前目录生成二进制文件frontend

使用

环境要求

• CentOS 7 x86

执行以下指令，启动FrontEnd模块
$./frontend start

也可以使用绝对地址调用或者写入开机启动脚本，比如
$/opt/nano/frontend/frontend start

模块启动后会输出提供形如http://192.168.5.3:5870的Web访问地址，在浏览器中打开即可。

模块运行日志输入在log/frontend.log文件中，用于查错和调试

页面初次启动，会提示创建超级用户账号，初始化之后就能开始对Nano集群进行管理了。

!!! 请注意：FrontEnd没有密码重置功能或者特殊后门，请牢记管理员密码，遗失后将无法访问系统!!!

此外，除了模块启动功能，FrontEnd还支持以下命令参数启动

配置

模块关键配置信息存储在'config/frontend.cfg'

假设FrontEnd模块地址为192.168.1.167，Core模块地址192.168.1.168，示例配置文件如下

{
 "address": "192.168.1.167",
 "port": 5870,
 "service_host": "192.168.1.168",
 "service_port": 5850,
 "api_key": "ThisIsAKeyPlaceHolder_ChangeToYourContent",
 "api_id": "dummyID",
 "web_root": "web_root"
}

目录结构

模块主要目录和文件如下

Introduce

FrontEnd is the web portal that comes with the Nano project, managing clusters via GUI. The service is implemented based on the API interfaces of the Core module, with its own accounts system.

It is recommended to use a dedicated Installer for deployment. For the latest project version, please visit this address.

Official Project Website

Full Source Code of the Project

Portal page source code

Compilation

Requirements

• CentOS 7 x86
• Golang 1.20

Prepare the dependent framework
$git clone https://github.com/project-nano/framework.git

Prepare the source code for compilation
$git clone https://github.com/project-nano/frontend.git

Compile
$cd frontend
$go build

The compiled binary file "frontend" will be generated in the current directory when success.

Usage

Requirements

• CentOS 7 x86

Start module
$./frontend start

Alternatively, you can use an absolute address or write it into a startup script, such as:
$/opt/nano/frontend/frontend start

After the module starts, it will provide a web address that can be accessed via browser, such as http://192.168.5.3:5870.

The module logs are output to file: log/frontend.log

!!! Please note: There is no password recover or backdoor in FrontEnd. Please remember your password carefully, or it will lost forever. !!!

FrontEnd also supports the following commands:

Configuration

The main configuration is stored in file: config/frontend.cfg

Assuming that the FrontEnd module address is 192.168.1.167 and the Core module address is 192.168.1.168, an example configuration file is as follows:

{
 "address": "192.168.1.167",
 "port": 5870,
 "service_host": "192.168.1.168",
 "service_port": 5850,
 "api_key": "ThisIsAKeyPlaceHolder_ChangeToYourContent",
 "api_id": "dummyID",
 "web_root": "web_root"
}

Directory Structure