{"id":28289505,"url":"https://github.com/louisyoungx/linux-flask-dashboard","last_synced_at":"2026-05-05T02:38:41.865Z","repository":{"id":217341279,"uuid":"408238959","full_name":"louisyoungx/linux-flask-dashboard","owner":"louisyoungx","description":"Linux light \u0026 highly available Web monitoring dashboard, only 400K","archived":false,"fork":false,"pushed_at":"2021-09-19T21:18:03.000Z","size":204,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-05-22T01:13:14.511Z","etag":null,"topics":["flask","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/louisyoungx.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2021-09-19T21:17:39.000Z","updated_at":"2021-12-11T02:45:01.000Z","dependencies_parsed_at":"2024-01-15T22:01:17.814Z","dependency_job_id":"3253787b-e65c-421e-97ec-b7a0475f4041","html_url":"https://github.com/louisyoungx/linux-flask-dashboard","commit_stats":null,"previous_names":["louisyoungx/linux-flask-dashboard"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/louisyoungx/linux-flask-dashboard","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/louisyoungx%2Flinux-flask-dashboard","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/louisyoungx%2Flinux-flask-dashboard/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/louisyoungx%2Flinux-flask-dashboard/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/louisyoungx%2Flinux-flask-dashboard/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/louisyoungx","download_url":"https://codeload.github.com/louisyoungx/linux-flask-dashboard/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/louisyoungx%2Flinux-flask-dashboard/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259588905,"owners_count":22880866,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["flask","python"],"created_at":"2025-05-22T01:12:23.423Z","updated_at":"2026-05-05T02:38:36.845Z","avatar_url":"https://github.com/louisyoungx.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n  \u003ca href=\"https://gitee.com/louisyoung1/projects\"\u003e\n    \u003cimg src=\"https://portrait.gitee.com/uploads/avatars/user/2529/7589523_louisyoung1_1597595544.png\"/\u003e\n  \u003c/a\u003e\n\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003csub\u003ev1.0\u003c/sub\u003e\u003cbr/\u003e\n  \u003csmall\u003e一个简单 \u0026 轻量的 web 仪表盘 for linux 系统\u003c/small\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003csmall\u003e\n    \u003ca href=\"#\"\u003eDemo\u003c/a\u003e \u0026nbsp;|\u0026nbsp;\n    \u003ca href=\"https://gitee.com/louisyoung1/linux-flask-dashboard/blob/master/README.md\"\u003e\n      文档\n    \u003c/a\u003e \u0026nbsp;|\u0026nbsp;\n    \u003ca href=\"https://gitee.com/louisyoung1/linux-flask-dashboard/blob/master/README.en.md\"\u003e\n      English\n    \u003c/a\u003e\n  \u003c/small\u003e\n\u003c/p\u003e\n\n\n\n\u003cbr/\u003e\n\n## 一、亮点\n* **轻量** ------ 占用在400KB以下\n* **美观** ------ 极简主义，漂亮的仪表盘\n* **简单** ------ 上手简洁\n* **多样** ------ 选择使用 Python, Docker的版本\n\n## 二、安装\n\n### 第一步\n```sh\n## 1. clone the repo\ngit clone https://gitee.com/louisyoung1/linux-flask-dashboard.git\n\n## 2. go to the cloned directory\ncd linux-flask-dashboard\n\n## 3. use pip to install requirements\npython3 -m pip install -r requirements.txt\n\n```\n或者，如果你喜欢手动下载:\n\n```sh\n## 1. Download the .zip \u0026 unzipped dir\ncurl -LOk https://gitee.com/louisyoung1/linux-flask-dashboard/repository/archive/master.zip \u0026\u0026 unzip master.zip\n\n## 2. go to the downloaded directory\ncd linux-flask-dashboard\n\n## 3. use pip to install requirements\npython3 -m pip install -r requirements.txt\n\n##(若第三步CentOS系统安装psutil报错，可尝试 yum -y install python3-devel)\n##(若CentOS启动后打不开页面，请检查firewalld防火墙配置！)\n\n```\n\n### 第二步\n\n详见 Linux Flask Dashboard 支持的版本 :\n\n* [Python](#使用-Python)\n* [Docker](#使用-Docker)\n\n#### 使用 Python\n```sh\n## 1. Start the server (on port 12005 by default; may require sudo).\npython index.py\n\n## 2. Open your browser to visit [http://0.0.0.0:12005]  (on port 12005 by default; may require sudo)\n# 浏览器访问 http://0.0.0.0:12005\n```\n\n#### 使用 Docker\n确保你已经启用了Docker，你可以用一行命令安装Docker\n```sh\n## make sure you have install docker in your server\ncurl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun\n```\n\n##### 方法一（使用源代码创建Docker镜像）\n```sh\n## 1. go to the cloned directory\ncd linux-flask-dashboard\n\n## 2. build docker image\nsudo docker build -t linux-flask-dashboard .\n\n## 3. start docker container\ndocker run -itd -p 12005:12005 --restart=always --name flask-dash-test linux-flask-dashboard:latest\n\n## 2. Open your browser to visit [http://0.0.0.0:12005]  (on port 12005 by default; may require sudo)\n# 浏览器访问 http://0.0.0.0:12005\n```\n\n##### 方法二（从Docker Hub拉取镜像）\n```sh\n## 1. pull from docker hub\ndocker pull louisyoung1/linux-flask-dashboard\n\n## 2. start docker container\ndocker run -itd -p 12005:12005 --restart=always --name flask-dash-test linux-flask-dashboard:latest\n\n## 3. Open your browser to visit [http://0.0.0.0:12005]  (on port 12005 by default; may require sudo)\n# 浏览器访问 http://0.0.0.0:12005\n```\n\n## 三、快速上手\n\n开启服务:\u003cbr\u003e\n`$ python3 main.py`\n\n启用一个代理:\u003cbr\u003e\n`$ python3 main.py -a --register-to [http|https]://[host]:[port] --register-as my-agent-node`\n\n这将在 *代理模式* 下启动服务，并尝试将节点注册到 `--register-to` 选项所指向的主节点。\n代理节点将分别在 `-p/--port` 和 `-b/--bind` 指定的主机和端口上设置RPC服务器，以替代web服务器。\n主psdash节点(提供HTTP服务)将提供一个注册节点列表，可以在这些节点之间进行切换。\n\n可用的命令行参数:\n```\n$ python3 main.py --help\nusage: psdash [-h] [-l path] [-b host] [-p port] [-d] [-a]\n              [--register-to host:port] [--register-as name]\n\npsdash [version] - system information web dashboard\n\noptional arguments:\n  -h, --help            show this help message and exit\n  -l path, --log path   log files to make available for psdash. Patterns (e.g.\n                        /var/log/**/*.log) are supported. This option can be\n                        used multiple times.\n  -b host, --bind host  host to bind to. Defaults to 0.0.0.0 (all interfaces).\n  -p port, --port port  port to listen on. Defaults to 5000.\n  -d, --debug           enables debug mode.\n  -a, --agent           Enables agent mode. This launches a RPC server, using\n                        zerorpc, on given bind host and port.\n  --register-to host:port\n                        The psdash node running in web mode to register this\n                        agent to on start up. e.g 10.0.1.22:5000\n  --register-as name    The name to register as. (This will default to the\n                        node's hostname)\n```\n\n## 四、设置\n\nLinux Flask Dashboard 使用了Flask提供配置。\n环境变量' PSDASH_CONFIG '所指向的配置文件将在启动时读取。\u003cbr\u003e\ne.g: `$ PSDASH_CONFIG=/home/user/config.py psdash`\n\n除了特定的 [Flask内置可选设置](http://flask.pocoo.org/docs/config/#builtin-configuration-values) 之外，Linux Flask Dashboard 也提供了额外的可选设置:\n\n| 名称 | 描述 |\n| ---- | ----------- |\n| `PSDASH_AUTH_USERNAME` | 登录验证的用户名。当这个值和`PSDASH_AUTH_PASSWORD` 同时设置后，访问将需要使用登录验证 |\n| `PSDASH_AUTH_PASSWORD` | 登录验证的密码 |\n| `PSDASH_ALLOWED_REMOTE_ADDRESSES` | 如设置，则只允许使用该ip地址访问。地址之间用逗号分隔，例如: `PSDASH_ALLOWED_REMOTE_ADDRESSES = \"10.0.0.2, 192.29.20.2\"` |\n| `PSDASH_URL_PREFIX` | 这可以用来从非根位置提供服务 例如: `PSDASH_URL_PREFIX = \"/dash\"` 将使服务页从 /dash 启动 |\n| `PSDASH_LOG_LEVEL` | 设置日志级别 (传入 `logging.basicConfig`). *默认设置为 `logging.INFO`*. |\n| `PSDASH_LOG_LEVEL` | 设置日志格式 (传入 `logging.basicConfig`). *默认设置为 `%(levelname)s | %(name)s | %(message)s`*. |\n| `PSDASH_NODES` | 要在启动时注册的代理节点列表(每个节点一个字典)。如： `[{'name': 'mywebnode', 'host': '10.0.0.2', 'port': 5000}]` |\n| `PSDASH_NET_IO_COUNTER_INTERVAL` | 更新用于计算网络流量的计数器的时间间隔(s)。 *默认为3秒*. |\n| `PSDASH_LOGS_INTERVAL` | 重新应用日志模式以确保应用文件系统更改(创建或删除日志文件)的间隔(以秒为单位)。*默认为60 *。|\n| `PSDASH_REGISTER_INTERVAL` | 将代理注册到主机节点的间隔(以秒为单位)。定期进行以便能够确定任何节点是否已经消失以及在什么时候消失。*默认为60 * |\n| `PSDASH_LOGS` | 记录在启动时应用的模式。 例如： `['/var/log/*.log']`. 要使用命令行覆盖这个选项，请使用 `-l/--log` 参数选项。 |\n| `PSDASH_REGISTER_TO` | 在代理模式下运行时，它用于设置将代理节点注册到哪个psdash节点。如 `http://10.0.20.2:5000` |\n| `PSDASH_REGISTER_AS` | 在代理模式下运行时，它用于设置要注册到主机节点的名称，该节点由 `PSDASH_REGISTER_TO`指定. |\n| `PSDASH_HTTPS_KEYFILE` | 用于启用以HTTPS方式启动web服务器的SSL密钥文件的路径。如 `/home/user/private.key`\n| `PSDASH_HTTPS_CERTFILE` | 用于启用以HTTPS方式启动web服务器的SSL证书文件路径。如 `/home/user/certificate.crt`\n| `PSDASH_ENVIRON_WHITELIST` | 如果设置了，则只会显示此列表中的env变量的值。如`['HOME']`\n\n## 五、预览\n\n未完待续······\n\n## 六、技术支持\n\n有技术难题，在 [Louis-House](https://www.louisyoung.work/Contact)有我的联系方式\n\n## 七、安全\n\n**强烈建议 **在安全的环境下安装**[Linux Flask Dashboard](https://gitee.com/louisyoung1/linux-flask-dashboard)**\n\n**[Linux Flask Dashboard](https://gitee.com/louisyoung1/linux-flask-dashboard)** 仅提供简单安全性与身份验证特性。\n\n## 八、许可\n\nThe GPL License (**[GPL-3.0](https://gitee.com/louisyoung1/linux-flask-dashboard/blob/master/LICENSE)**)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flouisyoungx%2Flinux-flask-dashboard","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flouisyoungx%2Flinux-flask-dashboard","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flouisyoungx%2Flinux-flask-dashboard/lists"}