Triển khai MediaMTX RTSP · HLS · WebRTC
Thiết lập máy chủ stream media thời gian thực đa giao thức cho camera.
Bối cảnh & Lý do triển khai
Camera IP (Dahua, Hikvision) xuất stream RTSP — giao thức mà browser không đọc được trực tiếp. MediaMTX là RTSP broker: nhận stream từ camera, tái phân phối sang HLS/WebRTC cho trình duyệt xem không cần plugin, đồng thời ghi hình và cung cấp REST API quản lý.
| Mục | Nội dung |
|---|---|
| Ứng dụng trong DN | Camera CCTV management, live stream viewer trên web, ghi hình tự động theo lịch, integration với VMS |
| Tác dụng chính | RTSP → HLS/WebRTC transcoding, recording với auto-delete (lab 48 giờ, tối đa 7 ngày khi đủ đĩa), REST API, Prometheus metrics |
| Nếu không triển khai | Xem camera chỉ qua ứng dụng native (iVMS, SmartPSS), không có web viewer, không ghi hình tập trung |
| Các service phụ thuộc vào đây | Dự án camera giao thông, hệ thống CCTV nội bộ; Prometheus scrape metrics streaming |
Ngày cập nhật: 2026-10-15
Người thực hiện: hoatv
Môi trường: HOATRANLABS – PVE 9.2.20
Danh sách máy chủ & IP liên quan
Bảng dưới liệt kê các máy chủ mà bài này tạo hoặc kết nối tới. Địa chỉ, VMID, VLAN và node lấy từ bảng quy hoạch chung của lab, dùng thống nhất cho cả bộ bài lab.
| Máy chủ | IP | VLAN · Node | Vai trò trong bài này |
|---|---|---|---|
| mediamtx (MediaMTX RTSP) · VM241 | 10.11.65.41 | 65 (SRV) · node1 | Máy chủ của bài — MediaMTX chạy bằng Docker Compose (image bluenviron/mediamtx:1.21.2-ffmpeg, network host); RTSP :8554, HLS :8888, WebRTC :8889, SRT :8890, API :9997, metrics :9998. |
| node1 (Proxmox VE) | 10.11.45.210 | 45 (MGMT) · cluster HOATRANHUB | Node Proxmox chứa VM241; tạo VM Ubuntu Server 24.04 LTS (2 vCPU, 2 GB RAM, scsi0 20 GB trên SSD vm-ceph), tùy chọn scsi1 60 GB trên HDD vm-bulk cho recordings hoặc LXC CT241 (mục 13.2). |
| pihole (Pi-hole DNS) · VM247 | 10.11.45.53 | 45 (MGMT) · node3 | DNS của VM (phải chạy trước); thêm bản ghi mediamtx.hoatranlabs.local qua Admin UI (bài 12). |
| step-ca (step-CA PKI) · VM242 | 10.11.25.42 | 25 (SEC) · node1 | Cấp certificate tùy chọn cho MediaMTX bằng step ca certificate (mục 3.2) để bật TLS (bài 13). |
| prometheus (Prometheus + Alertmanager) · VM235 | 10.11.45.35 | 45 (MGMT) · node2 | Scrape node_exporter :9100 và metrics MediaMTX :9998 qua job thêm vào prometheus.yml; Alertmanager :9093 nhận cảnh báo đầy đĩa (bài 15). |
| pbs01 (PBS Primary) · VM101 | 10.11.45.17 | 45 (MGMT) · node4 | Đích backup file-level: pbs-backup.sh và systemd timer 03:00 đẩy /opt/mediamtx lên pbs01 bằng token vm-backup@pbs!mediamtx, namespace vm-mediamtx (bài 04). |
| FortiGate (firewall) | 10.100.100.1 | Quản trị 10.100.100.0/24 · thiết bị mạng | Policy Allow-MediaMTX-View mở TCP 8554, 8888, 8889 và UDP 8189 (WebRTC ICE), 8000–8001 (RTP/RTCP) từ VLAN 45 sang VLAN 65; policy riêng cho Prometheus scrape 9100/9998. |
| grafana (Grafana + Uptime Kuma + Gotify) · VM236 | 10.11.45.36 | 45 (MGMT) · node2 | Dựng dashboard Grafana với truy vấn PromQL cho metric paths của MediaMTX, băng thông và dung lượng recordings (Phần 11, bài 15). |
Gateway của mỗi VLAN là địa chỉ .1. Tên DNS nội bộ do Pi-hole phân giải (bài 12). Tên in đậm là hostname; FQDN = hostname + .hoatranlabs.local. Camera IP Dahua/Hikvision (dải 192.168.100.x trong ví dụ) nằm ngoài quy hoạch lab nên không liệt kê.
Tổng Quan
MediaMTX (tên cũ: rtsp-simple-server) là media server đa giao thức mã nguồn mở, hỗ trợ đồng thời RTSP, RTMP, HLS, WebRTC và SRT. Trong HOATRANLABS, MediaMTX chạy bằng Docker (image chính thức bluenviron/mediamtx, ghim tag, Docker Compose) trên VM241 và đóng vai trò:
- RTSP proxy/re-streamer: Nhận stream từ camera IP (Dahua, Hikvision, v.v.) và phân phối lại
- Recording server: Ghi hình liên tục theo lịch, lưu file
.mp4với cơ chế xóa tự động theo thời gian - WebRTC endpoint: Cho phép xem camera trực tiếp qua browser mà không cần plugin
- HLS server: Stream tương thích với mọi thiết bị (mobile, smart TV, v.v.)
Kiến trúc luồng dữ liệu:
Camera IP (RTSP) ──► MediaMTX (Docker, VM241) ──┬─► RTSP → VLC / ffplay
├─► HLS → Browser / Mobile
├─► WebRTC → Browser (no plugin)
└─► Record → /var/lib/mediamtx/recordings/
Thông tin VM:
| Thuộc tính | Giá trị |
|---|---|
| VMID | 241 |
| Hostname | mediamtx |
| Node | node1 (10.11.45.210) |
| IP | 10.11.65.41/24 |
| Gateway | 10.11.65.1 |
| DNS | 10.11.45.53 (Pi-hole) |
| VLAN | VLAN_SRV (tag 65) |
| vCPU | 2 |
| RAM | 2 GB |
| Disk | 20 GB OS (scsi0, SSD vm-ceph) + tùy chọn 60 GB recordings (scsi1, HDD vm-bulk) — xem lưu ý disk bên dưới và Phần 1 (mục 1.2) |
| OS | Ubuntu Server 24.04 LTS (Noble Numbat) |
| Cách chạy | Docker Engine + Compose plugin; 1 container mediamtx, network_mode: host, thư mục dự án /opt/mediamtx |
| Ports | 8554/RTSP, 8000–8001/UDP (RTP/RTCP), 8888/HLS, 8889/WebRTC, 8189/UDP (WebRTC ICE), 8890/SRT (UDP), 9997/API, 9998/metrics (Prometheus), 9100/node_exporter |
-ffmpeg nặng khoảng 84 MB nén trên Docker Hub, giải nén lớn hơn). Nếu bật recording liên tục, cần attach thêm volume lưu trữ hoặc mount NFS/Ceph pool riêng. Tính toán: 1 camera H.264 1080p ≈ 1-2 GB/giờ (cách tính dung lượng và retention ở mục 1.2).
create-lab-vms.sh thì scsi0 = 20 GB trên SSD vm-ceph, đĩa dữ liệu scsi1 = 60 GB trên HDD vm-bulk, mount tại /var/lib/mediamtx/recordings (mục 1.2); các số này khớp vms.csv và chỉ là trần danh nghĩa (thin provisioning), môi trường thật cần đĩa lớn hơn nhiều (bài từng ghi 100 GB trở lên). Vì 60 GB chỉ đủ khoảng 48 giờ cho một luồng ≈ 1 GB/giờ, retention của lab là recordDeleteAfter: 48h thay cho 168h (7 ngày) trong cấu hình mẫu.
Phương án triển khai (ưu tiên Docker, rồi LXC; quyết định 2026-10-15):
| Phương án | Chọn khi | Ưu / nhược | Trong bài |
|---|---|---|---|
| Docker Engine + Compose trên VM241 (khuyến nghị) | Mặc định: MediaMTX có image chính thức bluenviron/mediamtx | Ưu: ghim tag, nâng cấp và rollback bằng cách đổi tag; chạy user không root, rootfs chỉ đọc, bỏ hết capability; biến thể -ffmpeg có sẵn ffmpeg cho runOnDemand và shell/wget cho healthcheck; cấu hình và recordings là bind mount rõ ràng nên PBS in-VM sao lưu được. Nhược: thêm lớp Docker; cổng publish ở chế độ bridge đi vòng UFW nên bài dùng network_mode: host (mục 4.1) | Phần 2–4 và các phần sau |
| LXC không đặc quyền (CT241) + binary + systemd | Muốn nhẹ hơn VM (dùng chung kernel của node1, ít RAM và đĩa) vì MediaMTX chỉ là một binary Go | Ưu: nhẹ, vzdump container thẳng vào pbs-primary. Nhược: Docker không chạy trong LXC (Proxmox không khuyến nghị) nên phải dùng binary; không live-migrate; tự cập nhật binary; chưa chạy thử trên máy thật | Mục 13.2 |
| VM241 + binary + systemd (cách cũ của bài) | Muốn ít lớp nhất hoặc không dùng Docker | Ưu: dễ debug bằng journalctl. Nhược: tự quản lý user, unit, binary, checksum; nâng cấp thủ công | Mục 13.1 |
Cách chuyển đổi: file mediamtx.yml dùng được nguyên cho cả ba phương án (chỉ đổi đường dẫn file chứng chỉ TLS), và thư mục recordings giữ cố định /var/lib/mediamtx/recordings ở cả host lẫn container. Chuyển Docker sang binary: docker compose down, cài binary theo mục 13.1 và dùng lại /opt/mediamtx/config/mediamtx.yml. Chuyển VM sang LXC: sao lưu cấu hình (Phần 12), tắt rồi xóa VM241, tạo CT241 theo mục 13.2 và chép cấu hình (cùng recordings nếu cần) vào; VM và CT dùng chung không gian VMID cũng như IP 10.11.65.41 nên không chạy song song.
Phiên bản phần mềm sử dụng (đã xác minh 2026-10-15):
| Thành phần | Phiên bản | Ghi chú |
|---|---|---|
| Ubuntu Server | 24.04.5 LTS (ISO ubuntu-24.04.5-live-server-amd64.iso) | Hỗ trợ chuẩn tới 04/2029; kernel 6.8, systemd 255, netplan 1.0, Python 3.12 (chỉ dùng python3 -m json.tool, không cần pip). |
| Docker Engine | 29.9.1 (docker-ce 5:29.9.1-1~ubuntu.24.04~noble) | Repo chính thức download.docker.com/linux/ubuntu noble stable, cài giống bài 22. Kiểm 2026-10-15 trên pool noble: docker-ce_29.9.1 đăng 2026-10-14. |
| Docker Compose plugin | 5.6.0 | Lệnh docker compose; kiểm cùng nguồn (đăng 2026-10-02). Gói docker-buildx-plugin 0.38.0 cài kèm theo bộ gói chuẩn, bài này không dùng. |
| MediaMTX (image Docker) | bluenviron/mediamtx:1.21.2-ffmpeg (Docker Hub, đăng 2026-10-08, có linux/amd64) | Bản không ffmpeg bluenviron/mediamtx:1.21.2 (nền scratch, không có shell nên không healthcheck được trong container). Bản trước của bài này ghim 1.11.3. Nâng lên 1.21.2 vì 1.11.3 nằm trong dải bị ảnh hưởng của GHSA-w334-5mp5-h897 (CSRF trên Control API dẫn tới chạy lệnh từ xa, mức Critical, CVSS 9.6, ảnh hưởng >= 1.0.0, < 1.21.1, vá ở 1.21.1; công bố 2026-10-08); GitHub còn liệt kê nhiều advisory khác (từ chối dịch vụ, CORS, so sánh thông tin xác thực) được vá trong các bản 1.19.x đến 1.21.2. Các khóa cấu hình của bài vẫn hợp lệ ở 1.21.2; tên endpoint API và tên metric có đổi (mục 6, 10.2, 11). |
ffmpeg trong image -ffmpeg | Gói apk ffmpeg trên Alpine 3.24 (theo docker/ffmpeg.Dockerfile tại tag v1.21.2) | Dùng cho path test (mục 3.1). Số phiên bản ffmpeg chưa xác minh, cần kiểm lại bằng docker exec mediamtx ffmpeg -version. |
| ffmpeg trên VM (tùy chọn) | 6.1.1 (gói noble ffmpeg 7:6.1.1-3ubuntu5, universe) | Chỉ để chạy ffprobe/ffplay kiểm tra từ VM (Phần 5, mục 10.1); MediaMTX không cần. |
| MediaMTX binary (phương án thay thế) | 1.21.2, mediamtx_v1.21.2_linux_amd64.tar.gz | Mục 13.1 và 13.2. |
| node_exporter | 1.12.1 | Cổng 9100, cài bằng tarball + systemd trên host (Phần 8); agent chạy trên host, không đóng container. |
| step-cli (tùy chọn, mục 3.2) | 0.31.0 | Cài bằng step-cli_0.31.0-1_amd64.deb; cặp CLI 0.31.0 với step-ca 0.27.4 của bài 13 cần kiểm lại trên máy thật. |
| proxmox-backup-client | proxmox-backup-client-static 4.x (repo pbs-client, suite trixie) | Sao lưu file cấu hình lên pbs01 (mục 12.2). Bản tĩnh, không phụ thuộc glibc của noble; chạy trên Ubuntu 24.04 cần kiểm lại trên máy thật. |
Tạo VM241 trên Proxmox
Tạo VM trên Proxmox trên node1 · Tùy chọn: Thêm volume lưu recordings · Cài đặt Ubuntu Server 24.04
1.1 Tạo VM trên Proxmox trên node1
Cách 1: Web UI Proxmox (GUI)
- VM ID:
241 - Name:
mediamtx - Bỏ tick Start after created
- Storage:
local(hoặc nơi chứa ISO) - ISO Image:
ubuntu-24.04.5-live-server-amd64.iso - Guest OS Type:
Linux, Version:6.x - 2.6 Kernel
- Machine:
q35 - SCSI Controller:
VirtIO SCSI single - BIOS:
SeaBIOS - Qemu Agent: ☑
- Bus/Device:
SCSI 0, Storage:vm-ceph - Disk size:
20 GiB, Cache:Write back, Discard: ☑
- Sockets:
1, Cores:2, Type:x86-64-v2-AES
- Memory (MiB):
2048
- Bridge:
vmbr0, VLAN Tag:65, Model:VirtIO (paravirtualized), Firewall: ☐
Cách 2: CLI (qm create)
qm create 241 --name mediamtx \
--memory 2048 \
--cores 2 \
--net0 virtio,bridge=vmbr0,tag=65 \
--scsi0 vm-ceph:20 \
--scsihw virtio-scsi-pci \
--ide2 local:iso/ubuntu-24.04.5-live-server-amd64.iso,media=cdrom \
--boot "order=ide2;scsi0" \
--ostype l26 \
--agent enabled=1 \
--onboot 1
1.2 Tùy chọn: Thêm volume lưu recordings
Nếu cần ghi hình, thêm đĩa dữ liệu scsi1 60 GB trên HDD vm-bulk (ghi tuần tự, hợp ổ quay; muốn giữ lâu hơn thì nới đĩa, xem phần tính dung lượng bên dưới). Đĩa này sẽ được mount vào /var/lib/mediamtx/recordings và container MediaMTX ghi vào đúng đường dẫn đó (bind mount ở Phần 4), nên dữ liệu ghi hình nằm ngoài đĩa OS và ngoài /var/lib/docker:
# Trên node1: thêm disk thứ hai vào pool HDD vm-bulk (60 GB cho recordings; dựng bằng create-lab-vms.sh thì đã có sẵn); backup=0 để job vzdump bỏ qua disk này (Phần 12)
# Chưa có pool vm-bulk (bài 07 mục 8.5): tạm thay vm-bulk bằng vm-ceph
qm set 241 --scsi1 vm-bulk:60,backup=0,discard=on
# Trong VM241, sau khi cài Ubuntu: kiểm tra tên disk mới (lsblk; scsi1 thường là /dev/sdb, mkfs xóa sạch đĩa được chọn), format và mount theo UUID
lsblk -f
mkfs.ext4 -m 0 -L mtx-rec /dev/sdb
mkdir -p /var/lib/mediamtx/recordings
echo "UUID=$(blkid -s UUID -o value /dev/sdb) /var/lib/mediamtx/recordings ext4 defaults,noatime,nofail 0 2" >> /etc/fstab
systemctl daemon-reload
mount -a
findmnt /var/lib/mediamtx/recordings
Tính dung lượng và retention: dung lượng cần ≈ bitrate × thời gian giữ × số camera ghi hình liên tục. Với ước tính 1-2 GB/giờ cho mỗi camera H.264 1080p, giữ 7 ngày (recordDeleteAfter: 168h) cần khoảng 170-340 GB cho MỖI camera (168 giờ × 1-2 GB), còn đĩa 60 GB của lab chỉ chứa được khoảng 30-60 giờ của một camera. Cách tính cho lab: số giờ giữ tối đa ≈ 48 GB (80% của 60 GB) ÷ (số camera ghi hình × GB/giờ), nên bài đặt recordDeleteAfter: 48h (Phần 3) cho 1 luồng ghi ≈ 1 GB/giờ; ghi cả 3 path record: yes (cam-entrance, cam-parking, live) thì chỉ giữ được khoảng 16 giờ. Muốn giữ lâu hơn, chọn một trong ba cách: tăng đĩa (qm resize 241 scsi1 +100G, sau đó resize2fs /dev/sdb trong VM; kiểm pvesm status xem vm-bulk còn chỗ thật, vùng an toàn của cả pool chỉ khoảng 200 GB dùng chung với Harbor, Nexus, S3…), rút ngắn recordDeleteAfter, hoặc ghi sub stream/giảm bitrate trên camera. Các con số chỉ là ước tính, hãy đo thực tế bằng du -sh sau vài giờ ghi hình.
1.3 Cài đặt Ubuntu Server 24.04
Các tùy chọn quan trọng khi cài:
- Hostname:
mediamtx - IP tĩnh:
10.11.65.41/24 - Gateway:
10.11.65.1 - DNS:
10.11.45.53(Pi-hole, phải chạy trước)
Trên Ubuntu 24.04, trình cài đặt ghi cấu hình mạng vào /etc/netplan/50-cloud-init.yaml (cần kiểm lại trên máy thật). Tên NIC thường là ens18 hoặc enp6s18 (xem bằng ip -br link); thay đúng tên vào file dưới đây (và vào truy vấn PromQL device="ens18" ở Phần 11 nếu khác):
# /etc/netplan/50-cloud-init.yaml
network:
version: 2
ethernets:
ens18:
addresses:
- 10.11.65.41/24
routes:
- to: default
via: 10.11.65.1
nameservers:
addresses:
- 10.11.45.53
- 8.8.8.8
search:
- hoatranlabs.local
chmod 600 /etc/netplan/50-cloud-init.yaml # netplan 1.0 cảnh báo nếu file cấu hình cho phép người khác đọc
netplan apply
apt update && apt upgrade -y # needrestart có thể hiện hộp thoại: nhấn Enter
Nếu VM được tạo từ cloud image (cloud-init) thay vì ISO, cloud-init có thể ghi đè file netplan ở lần khởi động sau; tạo /etc/cloud/cloud.cfg.d/99-disable-network-config.cfg với nội dung network: {config: disabled} để giữ cấu hình trên.
Cài Docker Engine và Chuẩn Bị Thư Mục
Cài Docker Engine và Compose plugin · Tạo user, thư mục và file .env
MediaMTX chạy bằng Docker theo quy tắc ưu tiên Docker của series: image chính thức bluenviron/mediamtx có sẵn, nâng cấp và quay lui chỉ cần đổi tag. Phần này cài Docker Engine cùng Compose plugin từ repo chính thức (cùng đoạn cài với bài 22), sau đó tạo user và thư mục cho dự án. Phương án binary + systemd và LXC vẫn có ở Phần 13.
2.1 Cài Docker Engine và Compose plugin
Dùng repo Docker chính thức cho Ubuntu 24.04 (suite noble, dạng deb822 docker.sources + Signed-By, không dùng apt-key). Chạy bằng quyền root (sudo -i).
# Cập nhật hệ thống
# (Ubuntu 24.04: needrestart có thể hiện hộp thoại chọn dịch vụ cần khởi động lại; đặt biến này để tự xử lý)
export NEEDRESTART_MODE=a
apt update && apt upgrade -y
# Gỡ gói Docker không chính thức nếu có (docker.io, docker-compose-v2, podman-docker... của Ubuntu)
for pkg in docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc; do
apt-get remove -y "$pkg" 2>/dev/null || true
done
# Cài Docker CE từ repo chính thức (suite noble)
apt install -y ca-certificates curl
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
tee /etc/apt/sources.list.d/docker.sources > /dev/null << EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF
apt update
apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
# qemu-guest-agent (cho snapshot/fsfreeze khi vzdump) và ffmpeg trên VM (tùy chọn, chỉ để chạy ffprobe/ffplay kiểm tra ở Phần 5 và 10.1)
apt install -y qemu-guest-agent ffmpeg
systemctl enable --now qemu-guest-agent
# Xác nhận (kiểm 2026-10-15 trên repo noble: docker-ce 29.9.1, Compose plugin 5.6.0, Buildx 0.38.0)
docker --version && docker compose version
Suites: được shell thay bằng noble nhờ heredoc không đặt nháy (<< EOF); mở /etc/apt/sources.list.d/docker.sources kiểm tra lại trước khi apt update. Container MediaMTX dùng network_mode: host nên Docker không tạo luật firewall nào cho nó và luật ufw ở mục 9.2 có hiệu lực thật (xem lý do và cảnh báo về cổng publish ở mục 4.1 và 4.3). Docker rootful, không dùng rootless nên các giới hạn user namespace không đặc quyền của AppArmor trên 24.04 không áp dụng.
2.2 Tạo user, thư mục và file .env
Container chạy bằng UID/GID của user hệ thống mediamtx (không root). Cấu hình, chứng chỉ và file Compose nằm trong /opt/mediamtx; dữ liệu ghi hình giữ đường dẫn /var/lib/mediamtx/recordings (đúng điểm mount của disk ở mục 1.2) và được bind mount vào container với cùng đường dẫn đó, nhờ vậy mediamtx.yml, node_exporter và PromQL không phải đổi đường dẫn giữa các phương án triển khai.
useradd --system --no-create-home --shell /usr/sbin/nologin mediamtx
mkdir -p /opt/mediamtx/config /opt/mediamtx/certs
mkdir -p /var/lib/mediamtx/recordings # đã có sẵn nếu disk ở mục 1.2 đã mount
chown root:mediamtx /opt/mediamtx/config /opt/mediamtx/certs
chmod 750 /opt/mediamtx/config /opt/mediamtx/certs
chown -R mediamtx:mediamtx /var/lib/mediamtx
# UID/GID của user mediamtx để Compose chạy container không root; .env chỉ chứa hai số này, không chứa mật khẩu
cat > /opt/mediamtx/.env << EOF
MTX_UID=$(id -u mediamtx)
MTX_GID=$(id -g mediamtx)
EOF
chmod 600 /opt/mediamtx/.env
Bố cục thư mục của bài:
| Đường dẫn trên VM241 | Nội dung |
|---|---|
/opt/mediamtx/docker-compose.yml | File Compose (mục 4.1), container mediamtx |
/opt/mediamtx/.env | MTX_UID, MTX_GID của user mediamtx (quyền 600) |
/opt/mediamtx/config/mediamtx.yml | Cấu hình MediaMTX (mục 3.1), mount chỉ đọc vào /config; quyền 640 root:mediamtx vì chứa mật khẩu camera |
/opt/mediamtx/certs/ | Chứng chỉ TLS từ step-CA (mục 3.2, tùy chọn), mount chỉ đọc vào /certs |
/var/lib/mediamtx/recordings | Bản ghi .mp4, cùng đường dẫn ở host và trong container |
Cấu Hình MediaMTX
File cấu hình chính · Cấu hình TLS/HTTPS cho API (tùy chọn)
3.1 File cấu hình chính
Tạo file /opt/mediamtx/config/mediamtx.yml (container đọc file này tại /config/mediamtx.yml). Nội dung giữ nguyên cấu hình cũ của bài, chỉ khác phần log: trong container chỉ ghi ra stdout để Docker thu log (docker compose logs), không ghi file log trong container (rootfs chỉ đọc).
# /opt/mediamtx/config/mediamtx.yml
# ============================================================
# Logging
# ============================================================
logLevel: info
logDestinations: [stdout] # Docker thu stdout; xem bằng: docker compose logs -f mediamtx
# ============================================================
# API (REST API để quản lý streams)
# ============================================================
api: yes
apiAddress: 0.0.0.0:9997
# ============================================================
# Metrics (Prometheus endpoint)
# ============================================================
metrics: yes
metricsAddress: 0.0.0.0:9998
# ============================================================
# Giao thức và ports
# ============================================================
rtspAddress: :8554
rtspsAddress: :8322 # RTSP over TLS
rtmpAddress: :1935
rtmpsAddress: :1936
hlsAddress: :8888
webrtcAddress: :8889
srtAddress: :8890
# ============================================================
# HLS configuration
# ============================================================
hlsAlwaysRemux: no
hlsVariant: lowLatency # lowLatency | mpegts | fmp4
hlsSegmentCount: 7
hlsSegmentDuration: 1s
hlsPartDuration: 200ms
# ============================================================
# WebRTC configuration
# ============================================================
webrtcICEServers2:
- url: stun:stun.l.google.com:19302
# ============================================================
# Authentication (đặt thành http để tích hợp external auth)
# ============================================================
authMethod: internal # internal | http | jwt (không có giá trị "none")
authInternalUsers:
# Xem/publish không cần mật khẩu (giống cấu hình mặc định của MediaMTX)
- user: any
pass:
ips: []
permissions:
- action: publish
- action: read
- action: playback
# API (:9997) và metrics (:9998): mặc định chỉ cho localhost, nên phải liệt kê thêm
# chính VM241 và VLAN 45 (gồm Prometheus 10.11.45.35) thì mới gọi/scrape từ xa được
- user: any
pass:
ips: ['127.0.0.1', '::1', '10.11.65.41', '10.11.45.0/24']
permissions:
- action: api
- action: metrics
# authMethod: http
# authHTTPAddress: https://authentik.hoatranlabs.local:9443/api/v1/mediamtx/auth
# ============================================================
# Recording defaults cho tất cả paths
# ============================================================
pathDefaults:
record: no # Mặc định tắt, bật per-camera bên dưới
recordPath: /var/lib/mediamtx/recordings/%path/%Y-%m-%d_%H-%M-%S-%f
recordFormat: fmp4
recordSegmentDuration: 1h
recordDeleteAfter: 48h # Lab (đĩa recordings 60 GB): giữ 48 giờ; môi trường thật đặt 168h (7 ngày) và cấp đĩa lớn hơn (mục 1.2)
# ============================================================
# Camera paths
# ============================================================
paths:
# ---------------------------------------------------------
# Camera cổng ra vào — Dahua IPC
# URL format: rtsp://user:pass@ip/cam/realmonitor?channel=X&subtype=Y
# channel=1: camera thứ nhất, subtype=0: main stream, subtype=1: sub stream
# Mật khẩu có ký tự @ phải mã hóa thành %40 trong URL (xem mục 10.1)
# ---------------------------------------------------------
cam-entrance:
source: rtsp://admin:Cam%[email protected]:554/cam/realmonitor?channel=1&subtype=0
runOnDemand: ""
runOnDemandRestart: yes
runOnDemandCloseAfter: 10s
record: yes # Bật recording cho camera này
# ---------------------------------------------------------
# Camera bãi đỗ xe — Hikvision DS-2CD
# URL format: rtsp://user:pass@ip/h264/ch<N>/main/av_stream
# ---------------------------------------------------------
cam-parking:
source: rtsp://admin:Hik%[email protected]:554/h264/ch1/main/av_stream
runOnDemand: ""
runOnDemandRestart: yes
record: yes
# ---------------------------------------------------------
# Camera hành lang — sub stream (độ phân giải thấp, tiết kiệm bandwidth)
# ---------------------------------------------------------
cam-hallway-sub:
source: rtsp://admin:Cam%[email protected]:554/cam/realmonitor?channel=1&subtype=1
runOnDemand: ""
runOnDemandRestart: yes
record: no # Sub stream không ghi hình
# ---------------------------------------------------------
# Stream publisher — camera đẩy vào MediaMTX (không pull từ camera)
# Camera tự push RTSP hoặc RTMP về địa chỉ này
# ---------------------------------------------------------
live:
source: publisher
record: yes
# ---------------------------------------------------------
# Test stream — ffmpeg tạo test pattern
# Xóa trong production
# ---------------------------------------------------------
test:
# ffmpeg có sẵn trong image bluenviron/mediamtx:1.21.2-ffmpeg; ffmpeg chạy khi có người xem và tự publish vào path này
runOnDemand: "ffmpeg -re -f lavfi -i testsrc=size=1280x720:rate=25 -f lavfi -i sine=frequency=1000 -vcodec libx264 -preset ultrafast -tune zerolatency -acodec aac -f rtsp rtsp://localhost:$RTSP_PORT/$MTX_PATH"
runOnDemandRestart: yes
File này chứa mật khẩu camera nên chỉ cho user mediamtx đọc và không đưa vào Git hay file Compose:
chown root:mediamtx /opt/mediamtx/config/mediamtx.yml
chmod 640 /opt/mediamtx/config/mediamtx.yml
3.2 Cấu hình TLS/HTTPS cho API (tùy chọn)
Nếu đã có step-CA (VM242), lấy certificate cho MediaMTX. Chứng chỉ nằm trên host ở /opt/mediamtx/certs/ và được mount chỉ đọc vào container tại /certs (mục 4.1):
# Cài step-cli nếu VM241 chưa có (gói .deb chính thức của Smallstep, 0.31.0)
wget -O /tmp/step-cli.deb https://github.com/smallstep/cli/releases/download/v0.31.0/step-cli_0.31.0-1_amd64.deb
dpkg -i /tmp/step-cli.deb
# Trên VM241 (host), lấy cert từ step-CA
step ca certificate mediamtx.hoatranlabs.local \
/opt/mediamtx/certs/server.crt \
/opt/mediamtx/certs/server.key \
--ca-url https://step-ca.hoatranlabs.local:9000 \
--root /usr/local/share/ca-certificates/hoatranlabs-root.crt
chown mediamtx:mediamtx /opt/mediamtx/certs/server.crt /opt/mediamtx/certs/server.key
Thêm vào mediamtx.yml (rtspsAddress đã khai báo ở mục 3.1; MediaMTX dùng cặp khóa riêng cho từng dịch vụ, không có serverCert/serverKey chung). Đường dẫn là đường dẫn TRONG container:
rtspEncryption: optional # no | optional | strict — optional: giữ RTSP :8554 và thêm RTSPS :8322
rtspServerCert: /certs/server.crt
rtspServerKey: /certs/server.key
# Tương tự cho các dịch vụ khác: apiEncryption / apiServerCert / apiServerKey (API :9997 chuyển sang https://),
# hlsEncryption / hlsServerCert / hlsServerKey, webrtcEncryption / webrtcServerCert / webrtcServerKey
Hai lưu ý khi chạy trong container: (1) nếu bật apiEncryption, lệnh healthcheck ở mục 4.1 (wget http://127.0.0.1:9997/...) phải đổi sang https:// và tin root CA trong container, hoặc đổi healthcheck sang cổng khác; (2) chứng chỉ từ step-CA có thời hạn mặc định 2160 giờ (90 ngày, bài 13). Sau mỗi lần gia hạn (timer step ca renew theo mẫu bài 13 Bước 11 và bài 22) phải chạy docker compose restart mediamtx trong /opt/mediamtx; việc MediaMTX có tự nạp lại file chứng chỉ mới khi hot reload hay không cần kiểm lại trên máy thật.
Docker Compose
Tạo docker-compose.yml · Khởi chạy và kiểm tra · Phương án thay thế: bridge + ánh xạ cổng và việc UFW bị đi vòng
4.1 Tạo docker-compose.yml
Chọn network_mode: host. MediaMTX mở nhiều cổng TCP và UDP (RTSP 8554, RTP/RTCP 8000-8001, RTMP 1935, HLS 8888, WebRTC 8889 và ICE UDP 8189, SRT 8890, API 9997, metrics 9998). Tài liệu MediaMTX (mediamtx.org/docs/kickoff/install) nêu rằng mạng của Docker có thể thay IP và cổng nguồn của gói UDP đến, và đề xuất --network=host để tránh; bảng dưới so sánh với cách ánh xạ cổng (bridge):
| Tiêu chí | network_mode: host (dùng trong bài) | Bridge + ports: (mục 4.3) |
|---|---|---|
| WebRTC / ICE | MediaMTX thấy IP thật của VM (10.11.65.41) và đưa vào danh sách ICE; UDP 8189 đi thẳng | Container chỉ thấy IP bridge nội bộ, bắt buộc đặt webrtcAdditionalHosts (hoặc biến môi trường MTX_WEBRTCADDITIONALHOSTS) bằng IP mà client dùng, và publish 8189:8189/udp |
| RTSP qua UDP (8000-8001) | Giữ nguyên IP/cổng nguồn của gói UDP | Dễ hỏng do Docker đổi IP/cổng nguồn; tài liệu khuyên tắt UDP bằng MTX_RTSPTRANSPORTS=tcp |
authInternalUsers theo IP (API, metrics) | Thấy IP nguồn thật (127.0.0.1, 10.11.45.35...) nên danh sách IP ở mục 3.1 đúng nguyên văn | Lệnh curl từ chính VM tới cổng đã publish có thể bị NAT thành IP gateway của bridge (cần kiểm lại trên máy thật) |
| UFW | Docker không tạo luật firewall nào cho mạng host (tài liệu Docker: "No rules are created for ipvlan, macvlan or host networking"), nên luật ufw ở mục 9.2 có hiệu lực | Cổng publish đi qua bảng nat/FORWARD và bỏ qua ufw allow/deny (tài liệu Docker: Docker và ufw không tương thích) |
| Cô lập mạng | Container dùng chung stack mạng với VM; trùng cổng với dịch vụ khác trên VM sẽ lỗi | Cô lập tốt hơn, đổi được cổng phía host |
Dựng file Compose (/opt/mediamtx/docker-compose.yml). Không khai báo khóa version: (Compose v2 coi là lỗi thời):
# /opt/mediamtx/docker-compose.yml
services:
mediamtx:
# Ghim tag, không dùng :latest hay :1. Bản không ffmpeg: bluenviron/mediamtx:1.21.2
# (nền scratch, không có shell/wget nên bỏ khối healthcheck và xóa path "test" trong mediamtx.yml)
image: bluenviron/mediamtx:1.21.2-ffmpeg
container_name: mediamtx
restart: unless-stopped
network_mode: host # không dùng "ports:"; xem bảng so sánh ở trên
user: "${MTX_UID}:${MTX_GID}" # user hệ thống mediamtx (file .env), không chạy root
command: ["/config/mediamtx.yml"] # ENTRYPOINT của image là /mediamtx; tham số là đường dẫn file cấu hình
read_only: true # rootfs chỉ đọc; MediaMTX chỉ ghi vào thư mục recordings
tmpfs:
- /tmp:size=64m
cap_drop:
- ALL # các cổng đều > 1024 nên không cần capability nào
security_opt:
- no-new-privileges:true
ulimits:
nofile:
soft: 65535 # thay LimitNOFILE=65535 của unit systemd cũ
hard: 65535
volumes:
- /opt/mediamtx/config:/config:ro # mount THƯ MỤC, không mount lẻ một file
- /opt/mediamtx/certs:/certs:ro # chứng chỉ TLS (mục 3.2)
- /var/lib/mediamtx/recordings:/var/lib/mediamtx/recordings # cùng đường dẫn host và container
healthcheck:
test: ["CMD", "wget", "-q", "-O", "/dev/null", "http://127.0.0.1:9997/v3/paths/list"]
interval: 30s
timeout: 5s
retries: 3
start_period: 20s
logging:
driver: json-file
options:
max-size: "10m" # giới hạn log của container: 5 file x 10 MB
max-file: "5"
Giải thích các lựa chọn chính:
- Image:
bluenviron/mediamtx:1.21.2-ffmpegcó sẵn ffmpeg chorunOnDemand(pathtestở mục 3.1) và nền Alpine nên cóshvàwget(busybox) cho healthcheck. Bảnbluenviron/mediamtx:1.21.2nhỏ hơn nhiều (khoảng 29 MB nén, so với khoảng 84 MB) nhưng nềnscratchnên không có shell, không có ffmpeg, và không thể đặt healthcheck bên trong container. Cả hai đều chạy root nếu không đặtuser:(Dockerfile của MediaMTX không khai báoUSER), vì vậy dònguser:ở trên là bắt buộc để chạy không root. - Cấu hình: file nằm ở
/config/mediamtx.ymltrong container. Mount thư mụcconfigthay vì mount một file lẻ vì MediaMTX theo dõi thư mục chứa file cấu hình để hot reload, còn mount một file thì editor thay inode (vim,sed -i) sẽ không hiện vào container. - Healthcheck: gọi
GET /v3/paths/listtrên API qua127.0.0.1, địa chỉ đã nằm trong danh sách IP củaauthInternalUsers(mục 3.1).docker compose pssẽ hiệnhealthykhi API trả lời. Cần kiểm lại trên máy thật vìwgetở đây là bản busybox của Alpine. - Dữ liệu ghi hình: bind mount, không phải named volume, vì đường dẫn trùng
/var/lib/mediamtx/recordingslà điểm mount của disk riêng (mục 1.2) cũng là mountpoint mà node_exporter (Phần 8, 11) và cron dọn dẹp (Phần 7) làm việc. Thư mục này thuộcmediamtx:mediamtx, đúng UID/GID của container. - Log: MediaMTX ghi ra
stdout(mục 3.1), Docker xoay vòng theomax-size/max-file; không còn/var/log/mediamtx. - Mức kiểm chứng: cú pháp YAML của file Compose đã được phân tích, các giá trị (tag, ENTRYPOINT, cổng, khóa cấu hình) đối chiếu với Docker Hub, Dockerfile và mã nguồn MediaMTX v1.21.2. Chưa chạy thử trên máy thật: healthcheck bằng
wget,read_onlycùngcap_dropkhi ffmpeg chạy bằngrunOnDemand, và quyền ghi vào recordings của UIDmediamtxcần kiểm lại trên VM241.
4.2 Khởi chạy và kiểm tra
cd /opt/mediamtx
# 1) Kéo image
docker compose pull
# 2) Kiểm tra cú pháp cấu hình (container dùng một lần, không mở cổng nào; in "configuration file is valid" nếu hợp lệ)
docker compose run --rm mediamtx --validate-conf=/config/mediamtx.yml
# 3) Khởi động
docker compose up -d
# 4) Trạng thái (cột STATUS phải là "Up ... (healthy)" sau khoảng 20-30 giây) và log
docker compose ps
docker compose logs --tail=30 mediamtx
# Xem log theo thời gian thực
docker compose logs -f mediamtx
# Kiểm tra các port đang lắng nghe trên host (host network nên thấy trực tiếp)
ss -tlnup | grep -E '8554|8000|8001|8888|8889|8189|8890|9997|9998'
# Test API
curl -s http://10.11.65.41:9997/v3/paths/list | python3 -m json.tool
Vận hành hằng ngày:
| Việc | Lệnh (chạy trong /opt/mediamtx) |
|---|---|
| Xem log | docker compose logs -f mediamtx |
| Kiểm tra cấu hình trước khi áp dụng | docker compose run --rm mediamtx --validate-conf=/config/mediamtx.yml |
| Áp dụng cấu hình sau khi sửa | docker compose restart mediamtx (MediaMTX còn tự hot reload khi file đổi, nhưng restart là cách chắc chắn nhất) |
| Xem trạng thái health | docker compose ps hoặc docker inspect --format '{{.State.Health.Status}}' mediamtx |
Vào container (chỉ bản -ffmpeg) | docker exec -it mediamtx sh |
| Dừng và gỡ container (dữ liệu giữ nguyên) | docker compose down |
--validate-conf trước khi lưu cấu hình mới vào /opt/mediamtx/config. Theo mã nguồn MediaMTX v1.21.2, khi hot reload gặp file lỗi thì tiến trình ghi lỗi rồi thoát; với restart: unless-stopped container sẽ khởi động lại và lặp lại lỗi cho tới khi file cấu hình được sửa đúng.
4.3 Phương án thay thế: bridge + ánh xạ cổng và việc UFW bị đi vòng
Chỉ dùng khi cần cô lập mạng hoặc đổi cổng phía host. Trong docker-compose.yml, bỏ dòng network_mode: host, thêm biến môi trường và danh sách cổng (bản đầy đủ cổng theo cấu hình ở mục 3.1; không cần 8000-8001 vì RTSP chỉ chạy TCP):
environment:
MTX_RTSPTRANSPORTS: tcp # theo tài liệu MediaMTX: Docker có thể đổi IP/cổng nguồn của UDP
MTX_WEBRTCADDITIONALHOSTS: 10.11.65.41 # IP mà client dùng để kết nối WebRTC
ports:
- "8554:8554"
- "1935:1935"
- "8888:8888"
- "8889:8889"
- "8189:8189/udp"
- "8890:8890/udp"
- "9997:9997"
- "9998:9998"
Cảnh báo về UFW: ở chế độ bridge, các cổng trên đây được Docker mở bằng luật DNAT trong bảng nat, gói tin bị chuyển hướng trước khi tới chuỗi INPUT mà ufw quản lý, nên mọi luật ufw allow/deny ở mục 9.2 KHÔNG còn tác dụng với những cổng này (tài liệu Docker: "Docker and ufw"). Có hai cách xử lý đúng: (a) giữ network_mode: host như bài, hoặc (b) lọc ở FortiGate (mục 9.3) và/hoặc thêm luật vào chuỗi DOCKER-USER. Luật trong DOCKER-USER được xét sau khi gói tin đã qua DNAT, nên phải dùng module conntrack (--ctorigdstport) mới khớp được cổng gốc mà client gọi tới. Ví dụ giới hạn API và metrics (thay ens18 bằng tên NIC thật; mỗi lệnh -I chèn lên đầu chuỗi nên lệnh chạy sau nằm trước, luật ESTABLISHED,RELATED phải chạy cuối cùng để đứng đầu):
iptables -I DOCKER-USER -i ens18 -p tcp -m conntrack --ctorigdstport 9997 ! -s 10.11.45.0/24 -j DROP
iptables -I DOCKER-USER -i ens18 -p tcp -m conntrack --ctorigdstport 9998 ! -s 10.11.45.35 -j DROP
iptables -I DOCKER-USER -m conntrack --ctstate ESTABLISHED,RELATED -j ACCEPT
Các luật iptables này mất khi khởi động lại VM nếu không lưu lại (ví dụ bằng iptables-persistent); cách lưu bền vững cùng việc luật chạy đúng với Docker 29 và backend iptables-nft trên Ubuntu 24.04 cần kiểm lại trên máy thật. Nếu dùng chế độ này, bỏ cổng UDP 8000-8001 khỏi policy FortiGate vì RTSP không còn chạy qua UDP.
4.4 Nâng cấp image
Nâng cấp = đổi tag trong file Compose, kéo image mới và tạo lại container. Cấu hình và bản ghi nằm ngoài container nên không bị ảnh hưởng.
cd /opt/mediamtx
# 1) Đọc release notes và security advisories của bản mới: https://github.com/bluenviron/mediamtx/releases
# 2) Sao lưu cấu hình hiện tại (Phần 12), rồi đổi tag. Ví dụ lên 1.21.3 (số ví dụ, thay bằng bản thật):
sed -i 's#bluenviron/mediamtx:1.21.2-ffmpeg#bluenviron/mediamtx:1.21.3-ffmpeg#' docker-compose.yml
docker compose pull
docker compose run --rm mediamtx --validate-conf=/config/mediamtx.yml # kiểm cấu hình với chính image mới
docker compose up -d
docker compose ps && docker compose logs --tail=20 mediamtx
# 3) Quay lui nếu có lỗi: trả tag cũ trong docker-compose.yml rồi chạy lại
docker compose up -d
# 4) Sau khi chắc chắn, dọn image cũ
docker image prune -f
Khi nâng qua nhiều bản, đối chiếu cả tên endpoint API và tên metric (đã đổi ở 1.21, mục 6 và 11) vì các thay đổi này có thể phá dashboard hay script cũ.
Xem Stream
Xem qua RTSP (VLC / ffplay) · Xem qua HLS (Browser) · Xem qua WebRTC (Browser — không cần plugin)
5.1 Xem qua RTSP (VLC / ffplay)
# VLC — main stream
vlc rtsp://10.11.65.41:8554/cam-entrance
# ffplay — độ trễ thấp hơn
ffplay -fflags nobuffer -flags low_delay -framedrop \
rtsp://10.11.65.41:8554/cam-entrance
# ffmpeg — re-stream hoặc test
ffmpeg -i rtsp://10.11.65.41:8554/cam-entrance \
-c copy -f segment -segment_time 60 \
/tmp/clip_%03d.mp4
5.2 Xem qua HLS (Browser)
# Dán URL vào browser hoặc media player hỗ trợ HLS
http://10.11.65.41:8888/cam-entrance/index.m3u8
# Test bằng VLC
vlc http://10.11.65.41:8888/cam-entrance/index.m3u8
5.3 Xem qua WebRTC (Browser — không cần plugin)
# Truy cập URL sau trong Chrome/Firefox
http://10.11.65.41:8889/cam-entrance
MediaMTX cung cấp sẵn trang WebRTC player đơn giản tại đường dẫn trên.
5.4 Xem qua SRT
ffplay srt://10.11.65.41:8890?streamid=read:cam-entrance
Quản Lý Streams qua API
BASE_URL="http://10.11.65.41:9997/v3"
# Liệt kê tất cả paths đang active
curl -s "${BASE_URL}/paths/list" | python3 -m json.tool
# Xem chi tiết một path
curl -s "${BASE_URL}/paths/get/cam-entrance" | python3 -m json.tool
# Liệt kê RTSP sessions (từ MediaMTX 1.21 tên endpoint là rtsp/sessions; tên cũ rtspsessions vẫn còn được phục vụ)
curl -s "${BASE_URL}/rtsp/sessions/list" | python3 -m json.tool
# Kick publisher/reader (force disconnect): <id> là id của session lấy từ rtsp/sessions/list
curl -s -X POST "${BASE_URL}/rtsp/sessions/kick/<id>"
# Xem recordings
curl -s "${BASE_URL}/recordings/list" | python3 -m json.tool
curl -s "${BASE_URL}/recordings/get/cam-entrance" | python3 -m json.tool
# Xóa một segment recording cụ thể: start = giá trị "start" của segment trong recordings/get
# (từ 1.21 tên endpoint là recordings/segments/delete; tên cũ recordings/deletesegment vẫn còn được phục vụ)
curl -s -X DELETE "${BASE_URL}/recordings/segments/delete?path=cam-entrance&start=<start>"
Quản Lý Disk Recordings
Cron job dọn dẹp recordings cũ · Cảnh báo khi disk gần đầy
7.1 Cron job dọn dẹp recordings cũ
MediaMTX có cơ chế recordDeleteAfter tích hợp sẵn (trong mediamtx.yml, tiến trình trong container tự xóa segment cũ trên thư mục bind mount). Tuy nhiên cần thêm cron job chạy trên host để xử lý edge case (segment mồ côi sau khi container bị dừng đột ngột, hay recordDeleteAfter bị tắt). Retention của hai cơ chế phải khớp nhau: 48h = 2 ngày trong lab (đĩa 60 GB; 168h = 7 ngày ở môi trường thật thì đổi -mtime +2 bên dưới thành -mtime +7). Thư mục recordings thuộc mediamtx:mediamtx, cron chạy bằng root nên xóa được.
cat > /etc/cron.daily/mediamtx-cleanup << 'EOF'
#!/bin/bash
# Xóa recordings cũ hơn 2 ngày (khớp recordDeleteAfter: 48h của lab)
RECORDINGS_DIR="/var/lib/mediamtx/recordings"
# Xóa files cũ
DELETED=$(find "$RECORDINGS_DIR" -type f -name "*.mp4" -mtime +2 -print -delete | wc -l)
# Xóa thư mục rỗng (không xóa chính thư mục gốc, là điểm mount của disk)
find "$RECORDINGS_DIR" -mindepth 1 -type d -empty -delete 2>/dev/null
# Log vào journal (xem bằng: journalctl -t mediamtx-cleanup)
DISK_USAGE=$(du -sh "$RECORDINGS_DIR" 2>/dev/null | cut -f1)
logger -t mediamtx-cleanup "Deleted: ${DELETED} files | Disk usage: ${DISK_USAGE}"
EOF
chmod +x /etc/cron.daily/mediamtx-cleanup
7.2 Cảnh báo khi disk gần đầy
cat > /etc/cron.hourly/mediamtx-disk-alert << 'EOF'
#!/bin/bash
THRESHOLD=85 # % sử dụng
RECORDINGS_PARTITION=$(df /var/lib/mediamtx/recordings | tail -1 | awk '{print $5}' | tr -d '%')
if [ "$RECORDINGS_PARTITION" -gt "$THRESHOLD" ]; then
# Dự phòng: đẩy cảnh báo vào Alertmanager (container `alertmanager` trên VM235, cổng 9093 — bài 15)
echo "ALERT: MediaMTX recordings disk ${RECORDINGS_PARTITION}% full on $(hostname)" | \
mail -s "Disk Alert: mediamtx" [email protected] 2>/dev/null || \
curl -s -X POST http://prometheus.hoatranlabs.local:9093/api/v2/alerts \
-H 'Content-Type: application/json' \
-d "[{\"labels\":{\"alertname\":\"MediaMTXDiskFull\",\"severity\":\"warning\",\"instance\":\"10.11.65.41:9100\"}}]"
fi
EOF
chmod +x /etc/cron.hourly/mediamtx-disk-alert
Cài node_exporter (Prometheus Monitoring)
Thêm target vào Prometheus (VM235)
node_exporter là agent theo dõi chính VM241 (CPU, RAM, đĩa, mạng), nên cài trực tiếp trên host bằng binary + systemd, không đóng container (quy tắc agent chạy trên host của series). Nó đọc được số liệu đĩa của /var/lib/mediamtx/recordings vì container ghi vào thư mục bind mount đó. Metrics riêng của MediaMTX (cổng 9998) do chính container MediaMTX phục vụ nhờ network_mode: host, không cần exporter nào khác.
NODE_EXPORTER_VERSION="1.12.1"
cd /tmp
wget https://github.com/prometheus/node_exporter/releases/download/v${NODE_EXPORTER_VERSION}/node_exporter-${NODE_EXPORTER_VERSION}.linux-amd64.tar.gz
tar xzf node_exporter-${NODE_EXPORTER_VERSION}.linux-amd64.tar.gz
mv node_exporter-${NODE_EXPORTER_VERSION}.linux-amd64/node_exporter /usr/local/bin/
chmod +x /usr/local/bin/node_exporter
rm -rf node_exporter-*
useradd --system --no-create-home node_exporter
cat > /etc/systemd/system/node_exporter.service << 'EOF'
[Unit]
Description=Prometheus Node Exporter
After=network.target
[Service]
Type=simple
User=node_exporter
ExecStart=/usr/local/bin/node_exporter \
--collector.filesystem.mount-points-exclude="^/(dev|proc|sys|run|var/lib/docker/.+)($|/)"
[Install]
WantedBy=multi-user.target
EOF
systemctl enable --now node_exporter
curl -s http://10.11.65.41:9100/metrics | head -5
Biểu thức loại trừ có thêm var/lib/docker/.+ (mặc định của node_exporter cũng loại trừ đường dẫn này) để các mount của Docker không làm rối metric node_filesystem_*. Dòng mountpoint="/var/lib/mediamtx/recordings" ở Phần 11 chỉ xuất hiện nếu thư mục này là một mount riêng (disk ở mục 1.2); nếu ghi chung vào đĩa OS thì dùng mountpoint="/".
8.1 Thêm target vào Prometheus (VM235)
# Thêm vào /opt/prometheus/prometheus.yml trên VM235
# Không đặt nhãn instance thủ công: giống các job trong bài 15, instance mặc định = IP:cổng
# (10.11.65.41:9100 và 10.11.65.41:9998) — các truy vấn PromQL ở Phần 11 dựa trên nhãn này.
# Nếu bài 15 đã liệt kê 10.11.65.41:9100 trong job vlan-srv-vms thì có thể bỏ job mediamtx-node, chỉ cần mediamtx-metrics.
- job_name: 'mediamtx-node'
static_configs:
- targets: ['10.11.65.41:9100']
labels:
service: 'media'
- job_name: 'mediamtx-metrics'
static_configs:
- targets: ['10.11.65.41:9998']
labels:
service: 'media'
Container Prometheus của bài 15 đã bật --web.enable-lifecycle, nên nạp lại cấu hình không cần restart. Cổng 9998 do container MediaMTX mở trực tiếp trên IP của VM241 (host network), nên Prometheus scrape đúng như với một exporter thường:
# Chạy trên VM235 hoặc máy nào trong VLAN 45 đều được; sau đó vào Status → Targets kiểm tra hai job ở trạng thái UP
curl -X POST http://10.11.45.35:9090/-/reload
DNS và Firewall
Thêm DNS record trong Pi-hole · UFW trên VM241 · FortiGate — policy từ VLAN_MGMT và thiết bị xem đến VLAN_SRV
9.1 Thêm DNS record trong Pi-hole
Pi-hole Admin (http://10.11.45.53/admin) → Settings → Local DNS Records:
mediamtx.hoatranlabs.local → 10.11.65.41
9.2 UFW trên VM241
Vì container dùng network_mode: host (mục 4.1), Docker không tạo luật firewall cho nó và các luật ufw dưới đây lọc đúng lưu lượng tới MediaMTX. Cổng publish của một container ở chế độ bridge thì đi vòng qua ufw (xem mục 4.3), nên đừng đổi sang bridge mà vẫn tin vào các luật này.
ufw allow ssh
ufw allow 8554/tcp # RTSP
ufw allow 8000:8001/udp # RTP/RTCP (RTSP truyền bằng UDP)
ufw allow 8888/tcp # HLS
ufw allow 8889/tcp # WebRTC
ufw allow 8189/udp # WebRTC UDP (ICE, webrtcLocalUDPAddress)
ufw allow 8890/udp # SRT (SRT chạy trên UDP)
ufw allow from 10.11.45.0/24 to any port 9997 proto tcp # API — chỉ VLAN 45 (khớp danh sách IP của authInternalUsers, mục 3.1)
ufw allow from 10.11.45.35 to any port 9998 proto tcp # Prometheus metrics (MediaMTX) — chỉ Prometheus VM235
ufw allow from 10.11.45.35 to any port 9100 proto tcp # node_exporter — chỉ Prometheus VM235 (giống bài 15)
ufw enable
ufw status verbose
Cổng RTMP 1935, RTSPS 8322 và RTMPS 1936 đã khai báo trong mediamtx.yml nhưng bài này không mở: chỉ thêm ufw allow 1935/tcp (camera đẩy RTMP vào path live) hoặc ufw allow 8322/tcp (sau khi bật TLS ở mục 3.2) khi thực sự dùng, kèm service tương ứng ở FortiGate (mục 9.3).
9.3 FortiGate — policy từ VLAN_MGMT và thiết bị xem đến VLAN_SRV
# Service custom cho người xem, khớp các cổng UFW ở mục 9.2:
# TCP 8554/8888/8889 và UDP 8189 (WebRTC ICE), 8000-8001 (RTP/RTCP khi RTSP truyền bằng UDP)
config firewall service custom
edit "RTSP_8554"
set tcp-portrange 8554
next
edit "RTP_RTCP_8000_8001"
set udp-portrange 8000-8001
next
edit "HLS_8888"
set tcp-portrange 8888
next
edit "WebRTC_8889"
set tcp-portrange 8889
next
edit "WebRTC_ICE_8189"
set udp-portrange 8189
next
end
config firewall policy
edit 0
set name "Allow-MediaMTX-View"
set srcintf "vlan45"
set dstintf "vlan65"
set srcaddr "all"
set dstaddr "10.11.65.41"
set service "RTSP_8554" "RTP_RTCP_8000_8001" "HLS_8888" "WebRTC_8889" "WebRTC_ICE_8189"
set action accept
set logtraffic all
next
end
# Cho Prometheus (VM235, 10.11.45.35) scrape node_exporter và metrics của MediaMTX
config firewall service custom
edit "NodeExporter_9100"
set tcp-portrange 9100
next
edit "MediaMTX_Metrics_9998"
set tcp-portrange 9998
next
end
config firewall policy
edit 0
set name "Allow-Prometheus-Scrape-MediaMTX"
set srcintf "vlan45"
set dstintf "vlan65"
set srcaddr "10.11.45.35"
set dstaddr "10.11.65.41"
set service "NodeExporter_9100" "MediaMTX_Metrics_9998"
set action accept
set logtraffic all
next
end
Xử Lý Sự Cố
Camera không kết nối được — RTSP authentication · Disk đầy do recordings · Stream lag / độ trễ cao
10.1 Camera không kết nối được — RTSP authentication
# Test kết nối RTSP thủ công
ffprobe -v error -show_streams \
"rtsp://admin:[email protected]:554/cam/realmonitor?channel=1&subtype=0"
# Nếu lỗi 401 Unauthorized:
# → Kiểm tra lại username/password trong mediamtx.yml
# → Một số camera cần encode ký tự đặc biệt trong URL:
# @ → %40 : → %3A ? → %3F
# Xem MediaMTX log để debug (container mediamtx, chạy trong /opt/mediamtx)
docker compose -f /opt/mediamtx/docker-compose.yml logs -f mediamtx | grep -i "cam-entrance\|error\|warn"
# Test URL RTSP không qua MediaMTX
ffplay -fflags nobuffer \
"rtsp://admin:[email protected]:554/cam/realmonitor?channel=1&subtype=0"
10.2 Disk đầy do recordings
# Xem disk usage
df -h /var/lib/mediamtx/recordings
# Xem thư mục lớn nhất
du -sh /var/lib/mediamtx/recordings/* | sort -rh | head -10
# Dọn nhanh recordings cũ hơn 1 ngày (retention của lab là 48 giờ)
find /var/lib/mediamtx/recordings -name "*.mp4" -mmin +1440 -delete
# Tắt recording tạm thời qua API (từ 1.21 endpoint là path-defaults; tên cũ pathdefaults vẫn còn được phục vụ)
# Các path đã đặt record: yes riêng (cam-entrance, cam-parking, live) cần patch từng path: /v3/config/paths/patch/<tên path>
curl -X PATCH http://10.11.65.41:9997/v3/config/path-defaults/patch \
-H 'Content-Type: application/json' \
-d '{"record": false}'
10.3 Stream lag / độ trễ cao
# Kiểm tra network latency đến camera
ping 192.168.100.10
# Xem packet loss qua mtr
mtr --report 192.168.100.10
# Giảm latency HLS — đổi sang lowLatency variant trong config
# hlsVariant: lowLatency
# hlsSegmentDuration: 500ms
# hlsPartDuration: 100ms
# Dùng WebRTC thay HLS cho độ trễ thấp nhất (<500ms)
10.4 WebRTC không kết nối được qua NAT
Với network_mode: host MediaMTX tự lấy IP của các interface trên VM241 và gửi cho client, nên xem WebRTC trong LAN thường không cần cấu hình thêm. Chỉ cần các khóa dưới đây khi client ở ngoài NAT, hoặc khi chạy chế độ bridge (mục 4.3), lúc đó container chỉ thấy IP bridge nội bộ và webrtcAdditionalHosts (hay biến môi trường MTX_WEBRTCADDITIONALHOSTS) là bắt buộc. Nếu VM có thêm interface của Docker (docker0, br-*) và ICE chậm vì ứng viên thừa, có thể đặt webrtcIPsFromInterfaces: no cùng với webrtcAdditionalHosts liệt kê đúng IP cần dùng (khóa này mặc định true, cần kiểm lại trên máy thật).
# Nếu client ở ngoài NAT cần xem WebRTC, thêm TURN server vào config
# /opt/mediamtx/config/mediamtx.yml (sau khi sửa: --validate-conf rồi docker compose restart mediamtx, mục 4.2)
webrtcAdditionalHosts: # tên cũ webrtcICEHostNAT1To1IPs đã deprecated
- 10.11.65.41 # IP internal
# - <PUBLIC_IP> # Nếu cần expose ra ngoài
webrtcICEServers2:
- url: stun:stun.l.google.com:19302
# Thêm TURN server nếu cần:
# - url: turn:coturn.hoatranlabs.local:3478
# username: mediamtx
# password: TurnPass123
10.5 MediaMTX không start
cd /opt/mediamtx
# Trạng thái container, log gần nhất, số lần restart và kết quả healthcheck
docker compose ps
docker compose logs --tail=50 mediamtx
docker inspect --format 'health={{.State.Health.Status}} exit={{.State.ExitCode}} restarts={{.RestartCount}}' mediamtx
docker inspect --format '{{json .State.Health}}' mediamtx
# Kiểm tra syntax config bằng cờ --validate-conf của MediaMTX (có trong mã nguồn v1.21.2): in "configuration file is valid"
# khi hợp lệ, hoặc dòng "ERR: ..." kèm mã thoát 1 khi sai khóa/giá trị
docker compose run --rm mediamtx --validate-conf=/config/mediamtx.yml
# Port conflict (host network: cổng của MediaMTX tranh với tiến trình khác trên VM)
ss -tlnup | grep -E '8554|8888|8889'
| Triệu chứng | Nguyên nhân thường gặp | Cách xử lý |
|---|---|---|
docker compose ps hiện Restarting, log có dòng ERR: về cấu hình | mediamtx.yml sai khóa hoặc giá trị; hot reload gặp file lỗi cũng làm tiến trình thoát | Chạy --validate-conf, sửa file, docker compose restart mediamtx |
permission denied khi ghi recordings, hoặc không thấy file .mp4 mới | Thư mục không thuộc UID/GID của mediamtx, hoặc disk recordings chưa mount nên ghi nhầm vào đĩa OS | chown -R mediamtx:mediamtx /var/lib/mediamtx và findmnt /var/lib/mediamtx/recordings |
read-only file system trong log | Rootfs chỉ đọc; chỉ /tmp (tmpfs) và thư mục recordings ghi được | Đọc log để biết đường dẫn bị ghi và chuyển nó vào recordings hoặc /tmp |
bind: address already in use | Một tiến trình khác trên VM đã giữ cổng | Chạy ss -tlnup (lệnh ở trên), tìm tiến trình giữ cổng rồi dừng nó |
unhealthy dù xem stream bình thường | API bật TLS nên healthcheck http:// thất bại, hoặc dùng image không ffmpeg (không có wget) | Xem .State.Health ở trên; chỉnh khối healthcheck ở mục 4.1 |
Lỗi invalid user hoặc user rỗng khi docker compose up | Thiếu /opt/mediamtx/.env hoặc chạy lệnh ngoài thư mục dự án | Tạo lại .env theo mục 2.2 |
Tích Hợp Grafana Dashboard
MediaMTX expose metrics Prometheus tại :9998. Tạo Grafana dashboard cơ bản:
# Verify metrics endpoint
curl -s http://10.11.65.41:9998/metrics | grep -E '^(paths|rtsp_sessions|hls_muxers|webrtc_sessions)'
# Các metric quan trọng của MediaMTX 1.21.2 (không có tiền tố mediamtx_; theo https://mediamtx.org/docs/features/metrics):
# paths{name,state} — mỗi path một dòng, state="ready" là path đang có stream
# paths_inbound_bytes{name,state} — byte nhận từ camera/publisher (counter; ở 1.11.3 tên là paths_bytes_received)
# paths_outbound_bytes{name,state} — byte gửi cho người xem (counter; ở 1.11.3 tên là paths_bytes_sent)
# rtsp_sessions{id,path,state} — mỗi RTSP session một dòng (tương tự: hls_muxers{name}, webrtc_sessions{id,path,state})
# Tên metric lấy từ tài liệu MediaMTX hiện hành; cần kiểm lại trên máy thật bằng curl .../metrics
# Dung lượng recordings, RAM, CPU: MediaMTX không xuất, dùng node_exporter (các truy vấn bên dưới)
Tạo panel Grafana với query:
# Số streams đang active
count(paths{instance="10.11.65.41:9998", state="ready"}) or vector(0)
# Bandwidth tổng (bytes/s)
rate(node_network_receive_bytes_total{instance="10.11.65.41:9100", device="ens18"}[5m])
# Disk usage recordings
100 - (node_filesystem_avail_bytes{instance="10.11.65.41:9100", mountpoint="/var/lib/mediamtx/recordings"} /
node_filesystem_size_bytes{instance="10.11.65.41:9100", mountpoint="/var/lib/mediamtx/recordings"} * 100)
Backup Cấu Hình
Bản sao cấu hình cục bộ · Sao lưu file lên PBS (proxmox-backup-client trong VM) · Backup toàn bộ VM (vzdump)
Ba lớp theo quy ước backup của lab (bài 04 mục 5.7): bản sao cấu hình cục bộ để quay lui nhanh (12.1), proxmox-backup-client trong VM đẩy /opt/mediamtx lên pbs01 (12.2), và job vzdump của PVE cho cả VM (12.3). MediaMTX không có cơ sở dữ liệu; mọi thứ cần giữ là thư mục /opt/mediamtx (file Compose, .env, config/, certs/). Image Docker không cần sao lưu vì kéo lại được từ Docker Hub theo tag đã ghim. Bản ghi (recordings) giữ 7 ngày và rất lớn nên không nằm trong ba lớp này.
12.1 Bản sao cấu hình cục bộ
mkdir -p /opt/scripts
cat > /opt/scripts/mediamtx-backup.sh << 'EOF'
#!/bin/bash
# /opt/scripts/mediamtx-backup.sh
BACKUP_DIR="/opt/mediamtx-backups"
DATE=$(date +%Y%m%d_%H%M%S)
mkdir -p "$BACKUP_DIR"
chmod 700 "$BACKUP_DIR"
# Backup file Compose, .env, cấu hình và chứng chỉ (chứa mật khẩu camera và khóa riêng TLS nên chỉ root đọc được)
tar czf "${BACKUP_DIR}/mediamtx_config_${DATE}.tar.gz" -C /opt/mediamtx docker-compose.yml .env config certs
chmod 600 "${BACKUP_DIR}/mediamtx_config_${DATE}.tar.gz"
# Giữ 30 bản config backup
ls -t "${BACKUP_DIR}"/*.tar.gz | tail -n +31 | xargs -r rm
echo "Backup: ${BACKUP_DIR}/mediamtx_config_${DATE}.tar.gz"
EOF
chmod +x /opt/scripts/mediamtx-backup.sh
echo "0 4 * * * root /opt/scripts/mediamtx-backup.sh" > /etc/cron.d/mediamtx-backup
12.2 Sao lưu file lên PBS (proxmox-backup-client trong VM)
Chuẩn bị trên pbs01 theo bài 04 mục 5.7: API token vm-backup@pbs!mediamtx, namespace vm-mediamtx trong datastore syno-primary, quyền DatastoreBackup tại /datastore/syno-primary/vm-mediamtx cho cả user lẫn token. Trên VM241 cài client bản tĩnh từ client-only repository của Proxmox (suite trixie, khóa đặt trong /usr/share/keyrings, khai báo kiểu deb822 với Signed-By, không dùng apt-key; cùng cách cài với các bài Ubuntu khác trong series):
curl -fsSL https://enterprise.proxmox.com/debian/proxmox-archive-keyring-trixie.gpg \
-o /usr/share/keyrings/proxmox-archive-keyring.gpg
cat > /etc/apt/sources.list.d/pbs-client.sources << 'EOF'
Types: deb
URIs: http://download.proxmox.com/debian/pbs-client
Suites: trixie
Components: main
Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg
EOF
apt update && apt install -y proxmox-backup-client-static
proxmox-backup-client version # việc chạy trên Ubuntu 24.04 cần kiểm lại trên máy thật
# File biến môi trường chứa secret của token (chỉ root đọc); thay <TOKEN_SECRET> bằng secret thật
cat > /root/.pbs-mediamtx.env << 'EOF'
PBS_REPOSITORY='vm-backup@[email protected]:syno-primary'
PBS_PASSWORD='<TOKEN_SECRET>'
PBS_FINGERPRINT='XX:YY:...'
EOF
chmod 600 /root/.pbs-mediamtx.env
Script và systemd timer chạy hằng ngày (chỉ sao lưu /opt/mediamtx, không sao lưu recordings; không cần dừng container vì không có cơ sở dữ liệu đang mở):
cat > /usr/local/bin/pbs-backup.sh << 'EOF'
#!/bin/bash
# Backup file-level theo quy ước lab (bài 04 mục 5.7): auth-id vm-backup@pbs!mediamtx, namespace vm-mediamtx
set -euo pipefail
set -a; . /root/.pbs-mediamtx.env; set +a # nạp PBS_REPOSITORY, PBS_PASSWORD, PBS_FINGERPRINT
proxmox-backup-client backup \
"mediamtx-opt.pxar:/opt/mediamtx" \
--ns vm-mediamtx
EOF
chmod 700 /usr/local/bin/pbs-backup.sh
cat > /etc/systemd/system/pbs-backup.service << 'EOF'
[Unit]
Description=Proxmox Backup Client (MediaMTX config)
[Service]
Type=oneshot
ExecStart=/usr/local/bin/pbs-backup.sh
EOF
cat > /etc/systemd/system/pbs-backup.timer << 'EOF'
[Unit]
Description=Daily PBS Backup (MediaMTX config)
[Timer]
OnCalendar=03:00
Persistent=true
[Install]
WantedBy=timers.target
EOF
systemctl daemon-reload
systemctl enable --now pbs-backup.timer
systemctl list-timers pbs-backup
systemctl start pbs-backup.service # chạy thử một lần, rồi kiểm tra bằng lệnh bên dưới
Khôi phục cấu hình vào VM mới (sau khi đã cài Docker theo Phần 2 và tạo user mediamtx):
set -a; . /root/.pbs-mediamtx.env; set +a
proxmox-backup-client snapshot list --ns vm-mediamtx
proxmox-backup-client restore host/mediamtx/<THOI_GIAN_SNAPSHOT> mediamtx-opt.pxar /opt/mediamtx --ns vm-mediamtx
cd /opt/mediamtx && docker compose up -d
12.3 Backup toàn bộ VM (vzdump)
Backup toàn bộ VM: hai lớp trên chỉ sao lưu file cấu hình. Để PBS có snapshot cả VM241, thêm VM241 vào job vzdump trên PVE (Datacenter → Backup → Add, storage pbs-primary — xem bài 04 mục 6). Đĩa OS 20 GB đã chứa Docker Engine và image nên khôi phục VM xong, container tự chạy lại nhờ restart: unless-stopped. Nếu đã gắn disk 60 GB cho recordings, bỏ tick Backup ở disk đó (hoặc đặt backup=0 cho disk, như lệnh ở mục 1.2) để job không sao lưu dữ liệu ghi hình dung lượng lớn.
Phương án thay thế — binary + systemd và LXC không đặc quyền
Binary + systemd trên VM241 (cách cũ của bài) · LXC không đặc quyền (CT241) + binary + systemd
Hai phương án này dùng chính file mediamtx.yml của mục 3.1 (đã chỉ ghi log ra stdout, nên log nằm trong journalctl -u mediamtx); chỉ khác nơi đặt file, đường dẫn chứng chỉ và cách vận hành. Các Phần 5-9 và 11 giữ nguyên; trong Phần 10 thay các lệnh docker compose ... bằng journalctl -u mediamtx, systemctl status mediamtx và mediamtx --validate-conf=... như bên dưới.
13.1 Binary + systemd trên VM241 (cách cũ của bài)
MEDIAMTX_VERSION="1.21.2" # cùng bản với image Docker; bản 1.11.3 trước đây dính GHSA-w334-5mp5-h897 (Critical)
cd /tmp
wget https://github.com/bluenviron/mediamtx/releases/download/v${MEDIAMTX_VERSION}/mediamtx_v${MEDIAMTX_VERSION}_linux_amd64.tar.gz
# Kiểm tra checksum theo file checksums.sha256 của bản phát hành
wget https://github.com/bluenviron/mediamtx/releases/download/v${MEDIAMTX_VERSION}/checksums.sha256
sha256sum -c --ignore-missing checksums.sha256
tar xzf mediamtx_v${MEDIAMTX_VERSION}_linux_amd64.tar.gz mediamtx
install -m 0755 mediamtx /usr/local/bin/mediamtx
mediamtx --version
useradd --system --no-create-home --shell /usr/sbin/nologin mediamtx # bỏ qua nếu user đã có
mkdir -p /etc/mediamtx /var/lib/mediamtx/recordings
chown -R mediamtx:mediamtx /var/lib/mediamtx
# Đặt cấu hình mục 3.1 vào /etc/mediamtx/mediamtx.yml. Nếu bật TLS (mục 3.2): lấy cert vào /etc/mediamtx/server.crt|key
# và đổi đường dẫn rtspServerCert/rtspServerKey (/certs/... trong container) thành /etc/mediamtx/server.crt|key
chown root:mediamtx /etc/mediamtx/mediamtx.yml && chmod 640 /etc/mediamtx/mediamtx.yml
mediamtx --validate-conf=/etc/mediamtx/mediamtx.yml
# apt install -y ffmpeg # chỉ khi giữ path "test" (runOnDemand gọi ffmpeg trên host)
cat > /etc/systemd/system/mediamtx.service << 'EOF'
[Unit]
Description=MediaMTX Media Server
Documentation=https://github.com/bluenviron/mediamtx
After=network-online.target
Wants=network-online.target
[Service]
Type=simple
User=mediamtx
Group=mediamtx
ExecStart=/usr/local/bin/mediamtx /etc/mediamtx/mediamtx.yml
Restart=on-failure
RestartSec=5s
StandardOutput=journal
StandardError=journal
# Resource limits
LimitNOFILE=65535
LimitNPROC=4096
# Security hardening
NoNewPrivileges=true
PrivateTmp=true
ProtectSystem=strict
ReadWritePaths=/var/lib/mediamtx
[Install]
WantedBy=multi-user.target
EOF
systemctl daemon-reload
systemctl enable --now mediamtx
systemctl status mediamtx
journalctl -u mediamtx -f
Khác biệt so với Docker: nâng cấp bằng cách thay binary rồi systemctl restart mediamtx (tự kiểm checksum như trên); log xem bằng journalctl -u mediamtx; sửa cấu hình xong chạy mediamtx --validate-conf=/etc/mediamtx/mediamtx.yml rồi systemctl restart mediamtx; backup 12.1 và 12.2 đổi /opt/mediamtx thành /etc/mediamtx cùng /etc/systemd/system/mediamtx.service. UFW luôn có hiệu lực vì không có Docker.
13.2 LXC không đặc quyền (CT241) + binary + systemd
Chọn khi muốn tiết kiệm RAM và đĩa so với VM. Container giữ nguyên VMID 241, hostname mediamtx, IP 10.11.65.41, VLAN 65 và node1, chạy cùng binary và cấu hình như mục 13.1. Docker KHÔNG cài trong container này (Proxmox không khuyến nghị Docker trong LXC). Cách này chưa chạy thử trên máy thật, cần kiểm lại. Trước hết kiểm tra storage vm-ceph cho phép chứa container (cột Content phải có rootdir; nếu thiếu, vào Datacenter → Storage → vm-ceph → Edit → Content và chọn thêm Container):
# Trên node1
pvesm status --content rootdir
Tải template Ubuntu 24.04 rồi tạo container (tên template lấy từ pveam available; theo bài 18, bản đã kiểm 2026-10-15 là 24.04-2). VMID 241 đang được VM241 dùng nên chỉ chạy lệnh pct create sau khi đã tắt và xóa VM241:
pveam update
pveam available --section system | grep ubuntu-24.04
pveam download local ubuntu-24.04-standard_24.04-2_amd64.tar.zst
pct create 241 local:vztmpl/ubuntu-24.04-standard_24.04-2_amd64.tar.zst \
--hostname mediamtx \
--ostype ubuntu \
--unprivileged 1 \
--features nesting=0 \
--cores 2 \
--memory 2048 \
--swap 512 \
--rootfs vm-ceph:20 \
--mp0 vm-bulk:60,mp=/var/lib/mediamtx/recordings,backup=0 \
--net0 name=eth0,bridge=vmbr0,tag=65,ip=10.11.65.41/24,gw=10.11.65.1 \
--nameserver 10.11.45.53 \
--searchdomain hoatranlabs.local \
--onboot 1
pct start 241
pct enter 241
Trong container, tạo user chuẩn của lab rồi làm tiếp từ mục 13.1 (chạy bằng root hoặc sudo), sau đó cài node_exporter theo Phần 8:
apt update && apt install -y sudo openssh-server ca-certificates curl wget
adduser --gecos "" sysadmin
usermod -aG sudo sysadmin
Khác biệt so với VM cần nhớ:
- Không có ISO và trình cài đặt, không có Qemu Agent. Tên NIC là
eth0(đổidevice="ens18"ở Phần 11 thànheth0). Phần 1.2 (disk thứ hai,mkfs, fstab) được thay bằng tùy chọn--mp0: PVE tự tạo và định dạng volume 60 GB (trên HDDvm-bulk) rồi mount vào/var/lib/mediamtx/recordings,backup=0để vzdump bỏ qua. - Unit systemd có
PrivateTmpvàProtectSystem=strictdùng mount namespace; trong container không đặc quyền vớinesting=0có thể báo lỗistatus=226/NAMESPACE. Khi đó xóa hai dòng này khỏi unit, hoặc bậtpct set 241 --features nesting=1(tài liệu Proxmox: tùy chọn này cũng dùng để systemd cô lập dịch vụ). Cần kiểm lại trên máy thật. - Backup: job vzdump chọn ID
241như VM, sao lưu container vào cùng storagepbs-primary(chế độ Snapshot, cần kiểm lại với rootfs trênvm-ceph). Không bắt buộc chạyproxmox-backup-clienttrong container; bản sao cấu hình 12.1 (đổi đường dẫn) vẫn dùng được. -
ufwtrong container không đặc quyền cần kiểm lại trên máy thật; nếu không dùng được, đặt cùng các quy tắc ở tab Firewall của container trong Proxmox. - LXC không live-migrate: khi HA chuyển sang node khác, container khởi động lại thay vì di chuyển nóng.
Checklist Triển Khai
- VM241 tạo thành công trên node1, IP 10.11.65.41, VLAN tag 65
- Ubuntu Server 24.04 LTS cài xong, IP tĩnh đúng
- DNS test:
ping mediamtx.hoatranlabs.localresolve đúng 10.11.65.41 - Docker Engine 29.x và Compose plugin đã cài từ repo
noblecủa Docker (docker compose versionOK) - User
mediamtxtạo xong,/opt/mediamtx/.env(quyền 600) cóMTX_UID/MTX_GID, thư mục recordings thuộcmediamtx -
/opt/mediamtx/config/mediamtx.ymlđã cấu hình đúng các camera paths (quyền 640root:mediamtx) và qua--validate-conf -
/opt/mediamtx/docker-compose.ymlghim tagbluenviron/mediamtx:1.21.2-ffmpeg,network_mode: host, user không root -
docker compose ps: containermediamtxở trạng tháiUp (healthy);docker compose logs mediamtxkhông có lỗi - Kiểm tra ports: 8554, 8000-8001, 8888, 8889, 8189, 8890, 9997, 9998 đang listen (
ss -tlnup) - API test:
curl http://10.11.65.41:9997/v3/paths/listtrả về JSON - Ít nhất một camera kết nối được (xem stream qua VLC)
- HLS test: stream qua browser
http://10.11.65.41:8888/<path>/index.m3u8 - WebRTC test:
http://10.11.65.41:8889/<path>mở trên Chrome - DNS record
mediamtx.hoatranlabs.local→10.11.65.41đã thêm vào Pi-hole - UFW rules cấu hình xong (host network nên UFW có hiệu lực; không dùng chế độ bridge nếu chưa xử lý
DOCKER-USER) - FortiGate policy cho phép VLAN_MGMT → VLAN_SRV đúng ports (TCP 8554/8888/8889, UDP 8189 và 8000–8001 cho người xem; 9100/9998 cho Prometheus 10.11.45.35)
- node_exporter cài và chạy tại :9100
- Prometheus target thêm xong, metrics nhận được
- Disk cleanup cron job đã cài
- Disk alert script đã cài
- Backup config cronjob đã cài (
/etc/cron.d/mediamtx-backup) -
proxmox-backup-clientchạy được: timerpbs-backupđẩy/opt/mediamtxlên namespacevm-mediamtx(tokenvm-backup@pbs!mediamtx, bài 04 mục 5.7) - VM241 nằm trong job backup PVE →
pbs-primary(bài 04 mục 6), disk recordings đã loại khỏi job - Đã ghi lại quy trình nâng cấp image (mục 4.4) và biết cách quay lui bằng tag cũ
Tài Liệu Tham Khảo
- MediaMTX GitHub: https://github.com/bluenviron/mediamtx
- MediaMTX cài đặt và Docker (biến thể image,
--network=host,MTX_WEBRTCADDITIONALHOSTS): https://mediamtx.org/docs/kickoff/install - MediaMTX cấu hình, biến môi trường
MTX_*, hot reload và--validate-conf: https://mediamtx.org/docs/other/configuration - Image Docker: https://hub.docker.com/r/bluenviron/mediamtx và Dockerfile tại https://github.com/bluenviron/mediamtx/tree/v1.21.2/docker
- Docker Engine cho Ubuntu: https://docs.docker.com/engine/install/ubuntu/
- Docker, bộ lọc gói tin và ufw: https://docs.docker.com/engine/network/packet-filtering-firewalls/ ; chuỗi DOCKER-USER: https://docs.docker.com/engine/network/firewall-iptables/
- Proxmox
pct(LXC): https://pve.proxmox.com/pve-docs/pct.1.html - MediaMTX Configuration Reference: https://github.com/bluenviron/mediamtx/blob/main/mediamtx.yml
- MediaMTX security advisories (GHSA-w334-5mp5-h897 và các advisory khác): https://github.com/bluenviron/mediamtx/security/advisories
- MediaMTX metrics: https://mediamtx.org/docs/features/metrics
- Dahua RTSP URL format:
rtsp://<user>:<pass>@<ip>/cam/realmonitor?channel=<N>&subtype=<0|1> - Hikvision RTSP URL format:
rtsp://<user>:<pass>@<ip>/h264/ch<N>/main/av_stream - Prometheus node_exporter: https://github.com/prometheus/node_exporter