Hệ thống giám sát năng lượng tự triển khai cho phép bạn giữ máy chủ giám sát và dữ liệu điện năng trong tầm kiểm soát của mình. Thay vì gửi mọi chỉ số lên cloud công cộng, công tơ điện sẽ tải dữ liệu đến một container Docker chạy trên máy chủ cục bộ, NAS, Raspberry Pi hoặc router tương thích.
IAMMETER-Docker cung cấp máy chủ giám sát năng lượng cục bộ sẵn sàng hoạt động cho hệ thống tiêu thụ điện và điện mặt trời (PV). Máy chủ này có thể thu thập dữ liệu đo, hiển thị dữ liệu thời gian thực và dữ liệu lịch sử, cung cấp API và tùy chọn hoạt động như một datalogger ngoại tuyến.
IAMMETER energy meter
│
│ Wi-Fi / local network
▼
IAMMETER-Docker
│
├── Local web dashboard
├── Historical energy data
├── REST API
├── MQTT
├── CSV datalogger
└── Optional forwarding
IAMMETER-Docker là một lựa chọn tự triển khai thiết thực, nhưng nó không tái tạo đầy đủ mọi tính năng và báo cáo của IAMMETER-Cloud. Nếu bạn vẫn đang cân nhắc kiến trúc, hãy so sánh các phương án trên trang giải pháp giám sát năng lượng tự triển khai.
🎬 Xem video hướng dẫn IAMMETER-Docker
IAMMETER-Docker phù hợp khi bạn muốn:
Các trường hợp lắp đặt điển hình gồm:
Nếu bạn chỉ cần đọc trực tiếp chỉ số từ công tơ cho Home Assistant, Node-RED, PLC hoặc phần mềm tùy chỉnh, việc triển khai một máy chủ đầy đủ có thể là không cần thiết. Hãy xem các phương án tích hợp cục bộ và tự triển khai trước khi lựa chọn.
Trước khi triển khai, hãy chuẩn bị:
5050 khả dụng cho ứng dụng web và API;1883 nếu sử dụng dịch vụ MQTT tích hợp;Máy chủ Docker và công tơ phải có thể kết nối với nhau qua mạng cục bộ. Với chế độ hoạt động ngoại tuyến, không cần kết nối Internet sau khi đã cài đặt image và các phần mềm cần thiết.
Bản phát hành hiện tại trên Docker Hub là IAMMETER-Docker V2.4.
Tạo thư mục làm việc và chạy container với bộ nhớ lưu trữ lâu dài:
docker run -d \
--name myiammeter \
--restart always \
-p 5050:5050 \
-p 1883:1883 \
-e TZ=Etc/UTC \
-v "$PWD/data:/app/data" \
iammeter/iammeter
Hãy đổi TZ=Etc/UTC thành múi giờ chính xác của địa điểm giám sát. Báo cáo năng lượng phụ thuộc vào ngày và giờ địa phương, vì vậy hãy thiết lập điều này trước khi thu thập dữ liệu thực tế.
Tạo tệp compose.yaml:
services:
iammeter:
image: iammeter/iammeter
container_name: myiammeter
restart: always
ports:
- "5050:5050"
- "1883:1883"
environment:
TZ: Etc/UTC
volumes:
- ./data:/app/data
Khởi động dịch vụ:
docker compose up -d
Kiểm tra trạng thái:
docker compose ps
docker compose logs --tail=100 iammeter
Mở địa chỉ sau từ trình duyệt trên cùng mạng:
http://<docker-host-ip>:5050
Thông tin đăng nhập mặc định:
Username: testuser
Password: 123456
Hãy đổi mật khẩu mặc định ngay lập tức. Không mở trực tiếp cổng
5050hoặc1883ra Internet công cộng nếu không có tường lửa phù hợp, xác thực và thiết kế mạng an toàn.

Sau khi đăng nhập:

Việc gán kênh chính xác đặc biệt quan trọng với giám sát điện mặt trời. Hệ thống cần biết phép đo nào đại diện cho lưới, inverter hay phụ tải trước khi có thể hiển thị kết quả dòng năng lượng có ý nghĩa.
Công tơ IAMMETER có thể tải dữ liệu trực tiếp lên máy chủ Docker cục bộ.
Trong WebUI của công tơ, hãy cấu hình tải lên HTTP của bên thứ ba và dùng địa chỉ máy chủ Docker:
<docker-host-ip>:5050/api/v1/sensor/uploadsensor
IP của máy chủ Docker phải truy cập được từ mạng Wi-Fi của công tơ. Hãy dùng đúng SN của công tơ đã được thêm vào IAMMETER-Docker.

Sau khi lưu cấu hình công tơ:
IAMMETER-Docker có thể tùy chọn chuyển tiếp dữ liệu công tơ tới IAMMETER-Cloud. Chỉ bật chuyển tiếp khi bạn muốn có cả lưu trữ cục bộ và các dịch vụ của IAMMETER-Cloud.

Với một hệ thống ngoại tuyến hoặc độc lập với cloud, hãy để tính năng chuyển tiếp lên cloud ở trạng thái tắt.
IAMMETER-Docker cũng có thể nhận dữ liệu năng lượng được hỗ trợ thông qua REST API. Điều này hữu ích cho các trình mô phỏng, gateway hoặc ứng dụng của khách hàng không dùng công tơ IAMMETER.
Hãy tạo một công tơ với SN tùy chỉnh, sau đó dùng chính SN đó trong mỗi yêu cầu API.
Tài liệu API tương tác có sẵn trên máy chủ cục bộ:
http://<docker-host-ip>:5050/docs


Hãy thử nghiệm API trên một công tơ không dùng cho vận hành thật trước. Giữ SN, số pha, thứ tự trường và đơn vị nhất quán để dữ liệu lịch sử vẫn sử dụng được.
IAMMETER-Docker V2.4 có thể lưu dữ liệu ra CSV khi thư mục datalogger được gắn (mount). Điều này hữu ích cho một hệ thống điện mặt trời từ xa, nhà máy hoặc phòng thiết bị không có kết nối Internet ổn định.
docker run -d \
--name myiammeter \
--restart always \
-p 5050:5050 \
-p 1883:1883 \
-e TZ=Etc/UTC \
-v "$PWD/data:/app/data" \
-v "$PWD/datalogger:/app/datalogger" \
iammeter/iammeter
Với Docker Compose, hãy thêm volume này:
volumes:
- ./data:/app/data
- ./datalogger:/app/datalogger
Mở trang datalogger tại:
http://<docker-host-ip>:5050/datalogger
Trang datalogger ban đầu dùng:
Username: admin
Password: admin
Hãy đổi mật khẩu này trong quá trình triển khai. Để biết quy trình đầy đủ trên router và xuất CSV, xem Datalogger năng lượng ngoại tuyến với IAMMETER-Docker.
Cổng 1883 được dùng bởi dịch vụ MQTT của IAMMETER-Docker. Một công tơ hoặc ứng dụng khác có thể gửi dữ liệu đo được hỗ trợ tới IAMMETER-Docker, và các MQTT client có thể đăng ký nhận giá trị thời gian thực.
IAMMETER-Docker cũng hỗ trợ các tính năng như:
Những tính năng này được cố ý tách khỏi quy trình triển khai cơ bản. Hãy cấu hình và kiểm thử container cốt lõi trước, sau đó tiếp tục với hướng dẫn nâng cao về IAMMETER-Docker.
Volume /app/data chứa dữ liệu ứng dụng lâu dài. Hãy sao lưu thư mục tương ứng trên máy chủ một cách thường xuyên.
Một quy trình cơ bản an toàn gồm:
data đã được gắn sang bộ nhớ sao lưu;datalogger khi tính năng ghi log CSV được bật;Đừng coi hệ thống tệp của container là bộ nhớ vĩnh viễn. Nếu /app/data không được gắn, việc xóa container có thể xóa luôn cơ sở dữ liệu giám sát.
Trước khi nâng cấp, hãy sao lưu thư mục dữ liệu lâu dài.
Với Docker Compose:
docker compose pull
docker compose up -d
docker compose logs --tail=100 iammeter
Với container được tạo bằng docker run:
docker pull iammeter/iammeter
docker stop myiammeter
docker rm myiammeter
Sau đó lặp lại lệnh docker run ban đầu. Việc xóa container chỉ an toàn khi dữ liệu ứng dụng đã được lưu trong một thư mục trên máy chủ được gắn đúng và đã sao lưu.
docker ps hoặc docker compose ps.5050 trên máy chủ có đang bị chiếm dụng không.localhost làm địa chỉ máy chủ trong công tơ; nó trỏ tới chính công tơ chứ không phải máy chủ Docker./app/data đã được gắn vào một thư mục lâu dài trên máy chủ.| Phương án | Phù hợp nhất với | Vị trí dữ liệu | Công sức thiết lập | Đánh đổi chính |
|---|---|---|---|---|
| IAMMETER-Docker | Máy chủ giám sát cục bộ làm sẵn | Máy chủ Docker của bạn | Thấp đến trung bình | Ít tính năng cloud được quản lý hơn |
| IAMMETER-Cloud | Giám sát, báo cáo và truy cập từ xa làm sẵn | IAMMETER-Cloud | Thấp | Dùng dịch vụ cloud được lưu trữ sẵn |
| Home Assistant / Node-RED | Thực thể nhà thông minh và tự động hóa tùy chỉnh | Nền tảng của riêng bạn | Trung bình | Bạn tự thiết kế bảng điều khiển và luồng công việc |
| Máy chủ tùy chỉnh | Sản phẩm, EMS hoặc đường ống dữ liệu chuyên biệt | Hạ tầng của bạn | Cao | Bạn tự phát triển và bảo trì hệ thống |
Tiếp tục với:
/app/data được gắn vào bộ nhớ lưu trữ lâu dài.5050 và 1883 không bị mở ra Internet một cách không cần thiết.Cập nhật lần cuối: 17 tháng 7, 2026.
Đồng hồ năng lượng Wi-Fi ba pha (WEM3080T)
Đồng hồ năng lượng Wi-Fi một pha (WEM3080)
Đồng hồ năng lượng Wi-Fi ba pha (WEM3046T)
Đồng hồ năng lượng Wi-Fi ba pha (WEM3050T)