first commit

2026-04-26 21:27:00 +07:00
commit 3ce6f0510b
48 changed files with 9700 additions and 0 deletions
@@ -0,0 +1,159 @@
+# IPCam Orange Pi Dashboard — INSTALL
+
+Tài liệu này hướng dẫn triển khai trên Orange Pi (Linux). Mục tiêu: MediaMTX chạy như media server, FastAPI chạy như dashboard backend, React build ra static.
+
+## 1) Yêu cầu
+
+- Orange Pi chạy Debian/Ubuntu
+- MediaMTX đã cài và chạy được
+- Python 3.9+ (khuyến nghị 3.10+)
+- Node.js 20+ (để build frontend)
+
+## 2) MediaMTX cấu hình tối thiểu
+
+Trong file `mediamtx.yml`:
+
+```yaml
+api: yes
+apiAddress: :9997
+
+webrtc: yes
+webrtcAddress: :8889
+
+record: yes
+recordFormat: fmp4
+recordPath: /recordings/%path/%Y-%m-%d_%H-%M-%S-%f
+recordPartDuration: 5m
+```
+
+Trong `paths`, bạn có thể để dashboard tự thêm path bằng API (Settings → Add Camera).
+
+Tạo thư mục recordings:
+
+```bash
+sudo mkdir -p /recordings
+sudo chown -R $USER:$USER /recordings
+```
+
+Mở firewall/cổng (tuỳ hệ thống):
+
+- `8554/tcp` RTSP
+- `8889/tcp` WebRTC HTTP
+- `9997/tcp` MediaMTX Control API
+- `8189/udp` ICE
+
+## 3) Backend FastAPI
+
+### 3.1 Cài dependencies
+
+```bash
+cd IPCam_OrangePi_Dashboard
+python3 -m venv api/.venv
+source api/.venv/bin/activate
+pip install -r api/requirements.txt
+```
+
+### 3.2 Cấu hình
+
+Chạy backend lần đầu sẽ tự tạo `api/data/config.json`.
+
+Bạn có thể chỉnh:
+
+- `mediamtx_api_url` (mặc định `http://127.0.0.1:9997`)
+- `mediamtx_webrtc_url` (mặc định `http://127.0.0.1:8889`)
+- `recordings_dir` (mặc định `/recordings`)
+
+Nếu MediaMTX API có auth, export biến môi trường:
+
+```bash
+export MEDIAMTX_API_USER="..."
+export MEDIAMTX_API_PASS="..."
+```
+
+### 3.3 Chạy backend
+
+```bash
+source api/.venv/bin/activate
+uvicorn api.app.main:app --host 0.0.0.0 --port 8000
+```
+
+## 4) Frontend (build static)
+
+### 4.1 Build
+
+```bash
+cd IPCam_OrangePi_Dashboard
+npm install
+npm run build
+```
+
+Output nằm ở `dist/`.
+
+### 4.2 Serve frontend
+
+Có 2 cách phổ biến:
+
+1) Nginx serve `dist/` và reverse proxy `/api` + `/videos` về backend `:8000`
+2) Dùng Caddy tương tự
+
+Ví dụ Nginx server block tối thiểu:
+
+```nginx
+server {
+  listen 80;
+  server_name _;
+
+  root /opt/ipcam-dashboard/dist;
+  index index.html;
+
+  location / {
+    try_files $uri $uri/ /index.html;
+  }
+
+  location /api/ {
+    proxy_pass http://127.0.0.1:8000;
+  }
+
+  location /videos/ {
+    proxy_pass http://127.0.0.1:8000;
+  }
+}
+```
+
+## 5) Systemd service (khuyến nghị)
+
+### 5.1 Backend service
+
+Tạo file `/etc/systemd/system/ipcam-dashboard.service`:
+
+```ini
+[Unit]
+Description=IPCam Dashboard Backend
+After=network.target
+
+[Service]
+WorkingDirectory=/opt/ipcam-dashboard
+Environment=MEDIAMTX_API_USER=
+Environment=MEDIAMTX_API_PASS=
+ExecStart=/opt/ipcam-dashboard/api/.venv/bin/uvicorn api.app.main:app --host 0.0.0.0 --port 8000
+Restart=always
+RestartSec=2
+
+[Install]
+WantedBy=multi-user.target
+```
+
+Enable:
+
+```bash
+sudo systemctl daemon-reload
+sudo systemctl enable --now ipcam-dashboard
+sudo systemctl status ipcam-dashboard
+```
+
+## 6) Kiểm tra nhanh
+
+- Backend: `curl http://localhost:8000/api/health`
+- MediaMTX API: `curl http://localhost:9997/v3/paths/list`
+- Frontend: mở `http://<orange-pi-ip>/`
+