Tài liệu › Agent

Cài trên Linux

Một lệnh cài agent làm dịch vụ systemd: tải file chạy, nhập token, service install.

Cài

curl -fLo certman-agent https://console.mettacert.com/downloads/certman-agent-linux-amd64 && chmod +x certman-agent
read -rsp 'Agent token: ' CERTMAN_AGENT_TOKEN && export CERTMAN_AGENT_TOKEN && echo
sudo -E ./certman-agent service install -server https://console.mettacert.com \
  -allow-dirs /etc/certman,/etc/nginx/ssl \
  -allow-cmds "nginx -t;systemctl reload nginx" \
  -allow-hosts "*.congty.local"

service install chép file chạy vào /usr/local/bin/certman-agent, ghi /etc/certman/agent.json (token và các giới hạn, quyền 600), tạo dịch vụ systemd certman-agent, bật và chạy ngay. Agent tự chạy lại khi khởi động máy và tự khởi động lại nếu lỗi. Trong khoảng 1 phút agent kết nối và hiện trên trang Agent.

Bản phát hành có chữ ký: lệnh trong hộp thoại Đăng ký agent tải kèm file .sig và kiểm tra bằng ssh-keygen -Y verify trước khi cài.

Dịch vụ systemd

sudo systemctl status certman-agent
sudo journalctl -u certman-agent -f
sudo certman-agent service uninstall      # gỡ dịch vụ, giữ cấu hình và khóa

Không muốn chạy lệnh cài tự động (máy không có systemd, hoặc muốn tự quản lý unit): chạy certman-agent -server … -token … một lần để kiểm tra, rồi tạo unit theo mẫu deploy/certman-agent.service với ExecStart=/usr/local/bin/certman-agent -config /etc/certman/agent.json. Chạy thẳng ở terminal thì agent chỉ sống tới khi bạn đóng phiên hoặc bấm Ctrl+C.

Đổi giới hạn (-allow-dirs, -allow-hosts, -allow-cmds): sửa /etc/certman/agent.json rồi sudo systemctl restart certman-agent, hoặc chạy lại service install với tham số mới.

Kiểm tra

Trang agent trên dashboard hiện trạng thái trong khoảng 1 phút. Agent ghi log ra stdout (journal); mức chi tiết tăng bằng -debug.

Cập nhật 11/10/2026Bài này có hữu ích?