Update README.md
This commit is contained in:
parent
ba1a91d623
commit
8997c55123
68
README.md
68
README.md
|
|
@ -1,31 +1,59 @@
|
|||
🧠 System Overview
|
||||
Frontend (HTML/JS/CSS)
|
||||
|
|
||||
--> /api/getListApp (reads listApp.txt + fetches init from OPNsense)
|
||||
--> /update (applies app_controls to Zenarmor via fetch)
|
||||
# 🧠 System Overview
|
||||
|
||||
Backend (Node.js + Express)
|
||||
|
|
||||
--> Puppeteer for headless login
|
||||
--> Session auto-refresh every 5 minutes
|
||||
--> API forwarding with CSRF token + cookie
|
||||
### Frontend (HTML/JS/CSS)
|
||||
|
||||
📁 Project Structure
|
||||
```
|
||||
└── `/api/getListApp` – reads `listApp.txt` and fetches init data from OPNsense
|
||||
└── `/update` – applies `app_controls` to Zenarmor via `fetch`
|
||||
```
|
||||
|
||||
### Backend (Node.js + Express)
|
||||
|
||||
```
|
||||
└── Uses Puppeteer for headless login
|
||||
└── Session auto-refresh every 5 minutes
|
||||
└── API forwarding with CSRF token + cookie
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
# 📁 Project Structure
|
||||
|
||||
```
|
||||
├── public/
|
||||
│ └── index.html ← Frontend UI
|
||||
├── listApp.txt ← Line-separated JSON data of apps
|
||||
├── server.js ← Express backend + OPNsense bridge
|
||||
├── README.md ← This file
|
||||
└── README.md ← This file
|
||||
```
|
||||
|
||||
🛠️ Setup & Run
|
||||
1. Install dependencies
|
||||
---
|
||||
|
||||
# 🛠️ Setup & Run
|
||||
|
||||
### 1. Install dependencies
|
||||
|
||||
```bash
|
||||
npm install
|
||||
⚠️ If using node-fetch@3+, it requires ESM. The script handles this via dynamic import.
|
||||
```
|
||||
|
||||
2. Start the server
|
||||
> ⚠️ If using `node-fetch@3+`, it requires ESM.
|
||||
> ✅ This script handles it via dynamic import.
|
||||
|
||||
---
|
||||
|
||||
### 2. Start the server
|
||||
|
||||
```bash
|
||||
node server.js
|
||||
Login will be performed immediately, then auto-refresh every 5 minutes.
|
||||
```
|
||||
|
||||
🔐 Config
|
||||
- Change "SERVER_DOMAIN" in public/index.html
|
||||
- Change "OPENSENCE_DOMAIN" in server.js
|
||||
* Login will be performed immediately.
|
||||
* Session will auto-refresh every 5 minutes.
|
||||
|
||||
---
|
||||
|
||||
# 🔐 Config
|
||||
|
||||
* Change `SERVER_DOMAIN` in `public/index.html`
|
||||
* Change `OPENSENSE_DOMAIN` in `server.js`
|
||||
|
|
|
|||
Loading…
Reference in New Issue