linux-dash README

The project's README from github.com/tariqbuilds/linux-dash. As one markdown file: README.md.

v2.0
A simple & low-overhead web dashboard for linux systems

Demo  |  Docs

linux-dash Gitter chat


Features

Installation

Step 1

## 1. clone the repo
git clone --depth 1 https://github.com/afaqurk/linux-dash.git

## 2. go to the cloned directory
cd linux-dash/app/server

OR, if you prefer to download manually:

## 1. Download the .zip
curl -LOk https://github.com/afaqurk/linux-dash/archive/master.zip && unzip master.zip

## 2. navigate to downloaded & unzipped dir
cd linux-dash-master/app/server

Step 2

See instructions for preferred server linux-dash server (all included):

If Using Node.js

## install dependencies
npm install --production

## start linux-dash (on port 80 by default; may require sudo)
## You may change this with the `LINUX_DASH_SERVER_PORT` environment variable (eg. `LINUX_DASH_SERVER_PORT=8080 node server`)
## or provide a --port flag to the command below
## Additionally, the server will listen on every network interface (`0.0.0.0`).
## You may change this with the `LINUX_DASH_SERVER_HOST` environment variable (eg. `LINUX_DASH_SERVER_HOST=127.0.0.1 node server`)
## or provide a --host flag to the command below
node index.js

If Using Go

## start the server (on port 80 by default; may require sudo)
go run index.go

To build a binary, run go build && ./server -h. See @tehbilly's notes here for binary usage options

If Using Python

# Start the server (on port 80 by default; may require sudo).
python index.py

If Using PHP

  1. Make sure you have the exec, shell_exec, and escapeshellarg functions enabled
  2. Point your web server to app/ directory under linux-dash
  3. Restart your web server (Apache, nginx, etc.)

Support

For general help, please use the Gitter chat room.

Security

It is strongly recommended that all linux-dash installations be protected via a security measure of your choice.

Linux Dash does not provide any security or authentication features.

linux-dash (tariqbuilds/linux-dash)

Searching Database…

10.6K ·GitHub
Linux-dash
这是什么？Linux Dash 是一个简洁、低开销的 Linux 服务器网页仪表盘：只需在浏览器里打开一个小页面，就能实时查看它所在服务器的各项运行状态。
这是云服务，还是需要我自己部署？需要自己部署——项目自带服务器脚本，你在 Linux 机器上运行其中一个，然后在浏览器里打开仪表盘页面即可。
怎么把它跑起来？下载项目，针对你选用的技术栈启动一个自带的服务器脚本，然后打开仪表盘地址。README 把它称为开箱即用的安装方式。
必须用 Node.js 吗，还是用别的也行？四种技术栈任选其一都可以——Node.js（推荐）、Go、Python 或 PHP——对应的服务器脚本都已包含在内，机器上已经有什么就用什么。
它有登录或访问控制功能吗？没有。README 强烈建议你在它前面加上自己的安全措施，因为 Linux Dash 本身不带任何身份验证功能。
它对服务器的负担大吗？非常轻量——去掉 .git 后整个项目在磁盘上不到 400KB，低开销本身就是它的主打特性之一。
能在 Apache 这类普通 PHP 主机上运行吗？可以——把你的 Web 服务器（Apache 或 nginx）指向 app/ 目录，确保 exec、shell_exec 和 escapeshellarg 函数已启用，然后重启 Web 服务器。README 里链接了一篇介绍 PHP + Apache 部署方式的 Digital Ocean 教程。
仪表盘是实时更新的吗？是的——Node.js 服务器基于 express 和 websockets 构建，数据会实时推送到浏览器，不需要手动刷新。
能在我的 Mac 或 Windows 服务器上运行吗？不能——它是为 Linux 系统设计的；请把它部署在 Linux 机器上，然后用任何有浏览器的设备打开仪表盘。
What are similar projects?dockge, omnyssh, walle-web, Checkmate, antigravity_phone_chat, Crucix, Profile-Toolkit-for-FSLogix, wekan
Which topics is it in?server-monitoring, express, websocket, sysadmin, real-time, dashboard, monitoring, ui, web-app, gui, free, tool
Creator
tariqbuilds
Size
4.6 MB
Stars
10.6K
Updated
CommitMar 22Release2.0May 14
Age
13y
Commits · 90 Days