3分钟上手Linux-Dash：从安装到自定义监控的极简指南

3分钟上手Linux-Dash：从安装到自定义监控的极简指南

【免费下载链接】linux-dash 项目地址: https://gitcode.com/gh_mirrors/lin/linux-dash

你是否还在为Linux服务器监控工具配置繁琐而头疼？面对命令行参数、环境变量和配置文件感到无从下手？本文将用最直观的方式，带你完成Linux-Dash从安装到高级自定义的全过程。读完本文，你将能够：

• 3分钟内启动基础监控服务
• 灵活修改端口与访问地址
• 自定义监控目标主机
• 配置环境变量实现部署自动化
• 理解核心配置文件的工作原理

快速启动：一行命令运行Linux-Dash

Linux-Dash提供了多语言后端支持，包括Node.js、Python、Go和PHP。以最常用的Node.js版本为例，只需两条命令即可启动服务：

# 安装依赖
npm install
# 启动服务
node app/server/index.js

默认情况下，服务会运行在0.0.0.0:80地址。通过修改app/server/index.js文件中的第9-10行代码，可自定义监听地址和端口：

var host = args.host || process.env.LINUX_DASH_SERVER_HOST || '0.0.0.0'
var port = args.port || process.env.LINUX_DASH_SERVER_PORT || 80

端口与主机配置：三种自定义方式

1. 命令行参数（临时生效）

启动服务时直接指定参数：

node app/server/index.js --host 192.168.1.100 --port 3000

2. 环境变量（会话级别）

设置环境变量后启动：

export LINUX_DASH_SERVER_HOST=192.168.1.100
export LINUX_DASH_SERVER_PORT=3000
node app/server/index.js

3. 源码修改（永久生效）

直接编辑app/server/index.js文件，修改默认值：

var host = args.host || process.env.LINUX_DASH_SERVER_HOST || '192.168.1.100'
var port = args.port || process.env.LINUX_DASH_SERVER_PORT || 3000

监控目标配置：自定义主机监控列表

Linux-Dash默认监控app/server/config/ping_hosts文件中定义的主机列表：

1: google.com
2: yahoo.com
3: twitter.com

要添加自定义监控目标，只需编辑此文件，按照序号: 主机名/IP格式添加新条目：

4: 192.168.1.1
5: example.com

环境变量全解析：自动化部署必备

除了主机和端口，Linux-Dash还支持通过环境变量配置其他关键参数：

环境变量	作用	默认值
LINUX_DASH_SERVER_HOST	监听地址	0.0.0.0
LINUX_DASH_SERVER_PORT	监听端口	80
NODE_ENV	运行环境	production

在生产环境部署时，建议通过环境变量注入配置，避免硬编码敏感信息。

核心配置文件解析

1. 主配置文件：app/server/index.js

• 定义服务启动参数
• 处理HTTP请求与WebSocket连接
• 调用系统监控脚本linux_json_api.sh

2. 主机监控配置：app/server/config/ping_hosts

• 存储需要监控的远程主机列表
• 每行一个监控目标，格式为序号: 主机名

3. 系统信息采集脚本：app/server/linux_json_api.sh

• 执行系统命令获取硬件与软件信息
• 输出JSON格式数据供前端展示

常见问题解决

端口占用问题

若启动时提示"EADDRINUSE: address already in use"，使用以下命令查找占用进程：

netstat -tulpn | grep 80

结束占用进程或更换端口号。

权限不足问题

绑定1024以下端口需要root权限，或使用端口转发：

# 使用root权限启动
sudo node app/server/index.js
# 或使用iptables转发
sudo iptables -t nat -A PREROUTING -p tcp --dport 80 -j REDIRECT --to-port 3000

部署架构图

通过以上配置，Linux-Dash可灵活适应不同的监控场景和部署需求。更多高级功能可参考项目README.md和源码中的src/js/plugins/目录下的插件实现。

【免费下载链接】linux-dash 项目地址: https://gitcode.com/gh_mirrors/lin/linux-dash