文件
linux_controller/readme.md
T

54 行
1.8 KiB
Markdown
原始文件 Blame 文件历史

此文件含有模棱两可的 Unicode 字符
此文件含有可能会与其他字符混淆的 Unicode 字符。 如果您是想特意这样的,可以安全地忽略该警告。 使用 Escape 按钮显示他们。
# linux_controller
基于 Flask + Paramiko 的 Linux 服务器批量监控与开关机控制面板(PC / 移动端自适应)。
## 功能
- 定时(60 秒)通过 SSH 采集各服务器 `top` 指标:CPU / 内存 / 负载 / 任务状态等
- Web 页面展示服务器状态,支持远程关机 / 重启(带二次确认弹窗)
## 快速开始
### 1. 配置服务器列表
复制 `.env.example` 为 `.env`,填写 `SERVERS_JSON`(JSON 数组,包含 name / ip / username / password)。
`.env` 已被 `.gitignore` 忽略,**切勿提交真实凭据**。
### 2. 本地运行
```bash
pip install -r requirements.txt
```
Linux / macOS:
```bash
export SERVERS_JSON='[{"name":"demo","ip":"192.168.1.10","username":"root","password":"your-password"}]'
python app.py
```
Windows PowerShell:
```powershell
$env:SERVERS_JSON='[{"name":"demo","ip":"192.168.1.10","username":"root","password":"your-password"}]'
python app.py
```
### 3. Docker 运行
在项目根目录 `.env` 文件中配置 `SERVERS_JSON` 后:
```bash
docker compose up -d --build
```
访问 `http://<主机IP>:8090/`(PC 端)、`http://<主机IP>:8090/m`(移动端)。
## 安全建议(部署前必读)
- **切勿将服务直接暴露在公网**:本应用未内置登录认证与 CSRF 防护,任何能访问到它的人都可以远程关机 / 重启受控服务器。请仅部署在内网,并通过防火墙、VPN 或反向代理(BasicAuth 等)做访问控制。
- 服务器凭据一律通过环境变量注入,不要写回代码或提交到仓库。
- 代码中 `AutoAddPolicy()` 会自动接受未知主机指纹,存在中间人风险;对安全要求较高的环境请改为 `RejectPolicy` 并预置 known_hosts。
- 建议 SSH 使用密钥认证代替密码认证。
- 生产环境保持 `FLASK_DEBUG` 关闭(默认已关闭)。