Có hai cách cài Hermes Agent với Docker: chạy cả Hermes trong container từ image chính thức nousresearch/hermes-agent, hoặc cài Hermes trên VPS rồi đặt terminal.backend: docker để mọi lệnh agent chạy trong container cô lập. Bài này hướng dẫn chi tiết cách thứ hai theo từng bước có ảnh, và tóm tắt lệnh cho cách thứ nhất.
Để vận hành Hermes Agent an toàn, Docker giúp cách ly tiến trình và giới hạn quyền truy cập vào hệ thống máy chủ. Bài thuộc nhóm hướng dẫn cài đặt và sử dụng Hermes Agent trên VPS. Cùng Tino tìm hiểu cách cài đặt Hermes Agent trên Docker qua bài viết dưới đây nhé!
Cập nhật 10/2026: Hermes Agent hiện có image Docker chính thức nousresearch/hermes-agent, được xếp vào nhóm hỗ trợ chính (Tier 1) trên trang Platform Support. Bản Hermes hiện hành: v0.22.5 (23/10/2026).
Vai trò của Docker trong Hermes Agent
Docker tham gia vào Hermes Agent theo hai vai: làm nơi chạy toàn bộ Hermes (image chính thức), hoặc làm terminal backend, tức môi trường sandbox để Hermes thực thi lệnh terminal trong container thay vì chạy thẳng trên hệ thống chính. Hai vai khác nhau ở chỗ tiến trình Hermes và file API key nằm trong hay ngoài container.
Trước khi bắt tay vào cài đặt, cần nắm rõ kiến trúc để không bị nhầm lẫn trong quá trình cấu hình. Phần dưới đây nói về vai terminal backend.
Không dùng Docker backend (mặc định):
Bạn nhắn tin → Hermes nhận lệnh → Hermes chạy lệnh terminal TRỰC TIẾP trên VPS.
Cách này hoạt động bình thường nhưng tiềm ẩn rủi ro: nếu Hermes thực thi nhầm một lệnh nguy hiểm, hậu quả tác động thẳng lên hệ thống.
Khi dùng Docker backend:
Bạn nhắn tin → Hermes nhận lệnh → Hermes chuyển lệnh vào container sandbox bằng docker exec → Lệnh chạy trong container → Hermes lấy kết quả.
Với cấu hình Docker backend, lệnh terminal, thao tác file và execute_code của Hermes đều chạy bên trong container. Nếu lệnh gây ra sự cố, phần bị ảnh hưởng là container, không phải hệ điều hành của VPS.
Cập nhật 10/2026: theo tài liệu Docker Backend, Hermes tạo một container chạy lâu dài và dùng lại cho mọi lệnh, mọi phiên và subagent, không tạo rồi xoá container sau từng lệnh. Muốn mỗi phiên một container mới, đặt container_persistent: false như trong bài thiết lập Docker sandbox cho Hermes Agent.
Cách cài đặt Hermes Agent trên Docker (Docker làm terminal backend)
Cài Hermes Agent với Docker backend gồm sáu bước: cài Hermes trên VPS, cài Docker Engine, đặt Docker làm terminal backend, cấu hình model AI, nối kênh nhắn tin và kiểm tra lệnh có chạy trong container không. Bước 3 là bước cốt lõi, chỉ một dòng lệnh.
Yêu cầu trước khi bắt đầu
- VPS chạy Ubuntu 22.04 hoặc 24.04 với quyền sudo.
- Tối thiểu 2GB RAM, khuyến nghị 4GB khi dùng Docker backend song song.
- Kết nối SSH đang hoạt động (cách kết nối VPS).
- API key của nhà cung cấp mô hình AI (Anthropic, OpenAI, OpenRouter, Google AI Studio hoặc tương tự).
Mức RAM ở trên là kinh nghiệm thực tế. Chi tiết theo từng kiểu dùng: cấu hình tối thiểu để chạy Hermes Agent.
Bước 1 — Cài đặt Hermes Agent
Nếu chưa có Hermes trên VPS, cài trước bằng lệnh một dòng:
sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git wget build-essential
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.bashrcCập nhật 10/2026: ảnh dưới chụp lệnh cũ tải script từ raw.githubusercontent.com (vẫn chạy được); trang Installation hiện dùng địa chỉ hermes-agent.nousresearch.com/install.sh.
Kiểm tra cài thành công:
hermes --versionSau khi cài Hermes, bạn sẽ được yêu cầu cấu hình. Thực hiện cấu hình theo hướng dẫn từ bài viết: Cách cài đặt và sử dụng Hermes Agent trên VPS từ A đến Z.
Hoặc bạn có thể nhấn Ctrl + C để bỏ qua bước cấu hình và tiến hành cài Docker.
Trong trường hợp VPS đã có Hermes rồi, bạn sẽ tiến thẳng vào bước cài Docker.
Bước 2 — Cài đặt Docker trên VPS
Thêm repository chính thức của Docker (theo hướng dẫn cài Docker Engine trên Ubuntu):
sudo apt update
sudo apt install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
sudo tee /etc/apt/sources.list.d/docker.sources <<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
EOFCập nhật 10/2026: ảnh dưới chụp cách thêm khoá docker.gpg và file docker.list kiểu cũ, vẫn dùng được. Tài liệu Docker hiện dùng khoá docker.asc và file docker.sources như khối lệnh trên.
Cài Docker Engine:
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-pluginKhởi động Docker và bật tự khởi động:
sudo systemctl start docker
sudo systemctl enable dockerThêm user hiện tại vào group Docker để chạy lệnh Docker không cần sudo:
sudo usermod -aG docker $USER
newgrp dockerLưu ý an toàn: theo tài liệu Docker, nhóm docker có quyền tương đương root trên máy. Chỉ thêm tài khoản bạn tin cậy vào nhóm này; nếu đang chạy bằng root như ảnh thì có thể bỏ qua lệnh trên.
Kiểm tra Docker đã hoạt động:
docker --version
docker run hello-worldNếu thấy thông báo Hello from Docker! là Docker đã sẵn sàng.
Bước 3 — Cấu hình Docker làm terminal backend cho Hermes
Đây là bước cốt lõi của toàn bộ bài hướng dẫn. Chỉ cần một lệnh:
hermes config set terminal.backend docker
Vậy là xong, Hermes sẽ dùng Docker để thực thi lệnh terminal từ lần chạy tiếp theo. Nếu gateway đang chạy, khởi động lại bằng hermes gateway restart.
Bước 4 — Cấu hình mô hình AI (nếu chưa làm)
Nếu ở bước 1 bạn bỏ qua bước cấu hình AI thì giờ hãy dùng lệnh sau:
hermes modelMàn hình điều khiển sẽ hiển thị danh sách các nhà cung cấp dịch vụ. Hãy sử dụng phím mũi tên để di chuyển và nhấn chọn Provider bạn có API Key.
Tino sẽ sử dụng Google AI Studio để làm ví dụ. Muốn đổi sau này, xem cách đổi model LLM cho Hermes Agent.
Khi hệ thống yêu cầu cấu hình khóa bảo mật, hãy dán chuỗi API Key của Google vào dòng GOOGLE_API_KEY. Tại phần Base URL, bạn chỉ cần nhấn phím Enter để giữ nguyên đường dẫn mặc định.
Cuối cùng, hệ thống sẽ yêu cầu chọn mô hình xử lý. Các mô hình khác nhau sẽ cho tốc độ xử lý khác nhau:
Bước 5 — Thiết lập cổng kết nối kênh nhắn tin (tùy chọn bổ sung)
Nếu bạn có nhu cầu sử dụng Hermes Agent qua các kênh nhắn tin như Telegram, hãy nhập lệnh sau để bắt đầu cấu hình:
hermes gateway setup
Sử dụng phím mũi tên để di chuyển và chọn Telegram trong danh sách các nền tảng hỗ trợ.
- Mở ứng dụng Telegram trên thiết bị cá nhân, tìm kiếm tài khoản @BotFather và gửi lệnh /newbot để tạo một bot mới. Sau khi hoàn tất các bước đặt tên, BotFather sẽ cung cấp một đoạn mã bảo mật gọi là Bot token. Chi tiết: cách lấy API token Telegram.
- Chuyển sang tìm kiếm tài khoản @userinfobot trên Telegram để lấy dải số User ID cá nhân.
Quay lại cửa sổ dòng lệnh của máy chủ, dán mã Bot token vào.
Tại mục Allowed user IDs, hãy điền dải số User ID vừa lấy được.
Nhấn Enter để đặt User ID làm Home channel. Mọi thông báo hệ thống hoặc các báo cáo định kỳ sẽ được gửi thẳng vào tin nhắn riêng.
Gõ y và nhấn Enter để tiếp tục.
Chọn Done.
Tiếp theo, gõ y và nhấn Enter.
Sau đó, chọn cài đặt gateway dưới dạng dịch vụ nền User service và đồng ý kích hoạt tính năng Linger.
Linger giúp tiến trình nhắn tin luôn trực tuyến 24/7, ngay cả khi người quản trị đóng kết nối SSH với máy chủ.
Gõ y và nhấn Enter ở bước cuối cùng để khởi động dịch vụ ngay lập tức.
Bước 6 — Kiểm tra Docker backend hoạt động
Khởi động Hermes và thực hiện một tác vụ yêu cầu chạy lệnh terminal:
hermes
Thử yêu cầu:
❯ Kiểm tra dung lượng ổ đĩa hiện tại và liệt kê 5 thư mục lớn nhất.
Khi Docker backend hoạt động đúng, lần gọi lệnh đầu tiên Hermes khởi tạo container (dòng “preparing terminal”), chạy lệnh rồi trả về kết quả. Lần đầu mất thêm một ít thời gian; các lệnh sau dùng lại container nên nhanh hơn.
Để xác nhận lệnh thực sự đang chạy trong Docker, bạn mở một tab SSH khác và nhập lệnh:
watch docker ps
(Mẹo: Sử dụng lệnh watch -n 2 docker ps để hệ thống tự động làm mới kết quả mỗi 2 giây.) Container mang tên bắt đầu bằng hermes- và chạy lệnh sleep infinity để giữ sống giữa các lần gọi.
Chạy toàn bộ Hermes Agent bằng Docker image chính thức
Chạy Hermes Agent bằng image chính thức nghĩa là cả agent và gateway nằm trong container nousresearch/hermes-agent, còn dữ liệu (config, API key, phiên chat, kỹ năng) nằm ở thư mục ~/.hermes trên VPS, được mount vào /opt/data. Các lệnh dưới đây lấy từ tài liệu Hermes Docker Setup.
Lần đầu, chạy trình thiết lập để nhập API key và kênh nhắn tin:
mkdir -p ~/.hermes
docker run -it --rm \
-v ~/.hermes:/opt/data \
nousresearch/hermes-agent setupSau đó chạy gateway nền, tự khởi động lại khi VPS reboot:
docker run -d \
--name hermes \
--restart unless-stopped \
-v ~/.hermes:/opt/data \
nousresearch/hermes-agent gateway runMở phiên chat trong terminal với cùng thư mục dữ liệu:
docker run -it --rm -v ~/.hermes:/opt/data nousresearch/hermes-agentCập nhật Hermes chạy bằng image (lệnh hermes update không dùng cho bản Docker):
docker pull nousresearch/hermes-agent:latest
docker rm -f hermes
docker run -d --name hermes --restart unless-stopped \
-v ~/.hermes:/opt/data nousresearch/hermes-agent gateway run- Tài liệu khuyến nghị cho container tối thiểu 1GB RAM và 1 nhân CPU, nên có 2–4GB RAM và 2 nhân; công cụ duyệt web cần ít nhất 2GB.
- Cổng 8642 (API server) và 9119 (dashboard) chỉ cần mở khi dùng tới. Nếu mở, đặt sau Tailscale hoặc reverse proxy có xác thực thay vì để lộ ra Internet.
- Dán lệnh qua SSH thay vì console web của nhà cung cấp VPS: tài liệu Hermes ghi nhận một số console web gõ sai ký tự “:” và “@”, làm hỏng tham số
-v.
Lưu ý an toàn: cách chạy cả Hermes trong container không tự cô lập lệnh terminal khỏi dữ liệu của agent: lệnh agent chạy cùng container có file .env. Khi agent được phép chạy lệnh trên nội dung không tin cậy, vẫn nên kết hợp với sandbox như mục thiết lập Docker sandbox.
Khi nào không nên dùng Docker với Hermes Agent?
Không nên dùng Docker với Hermes Agent khi VPS chỉ có 1GB RAM, khi bạn cần agent thao tác trực tiếp lên phần mềm của chính VPS (cài gói hệ thống, sửa cấu hình Nginx), hoặc khi chưa quen quản trị Docker. Docker thêm một lớp phải cập nhật và theo dõi.
- VPS 1GB RAM: Docker daemon, container sandbox và Hermes cùng chạy dễ chạm giới hạn bộ nhớ, nhất là khi bật công cụ duyệt web.
- Agent cần quản trị chính VPS: lệnh trong sandbox không thấy dịch vụ của host, nên các tác vụ kiểu “kiểm tra Nginx” sẽ trả kết quả của container.
- Chỉ chat, không cho agent chạy lệnh: có thể tắt công cụ terminal bằng
hermes toolsthay vì dựng thêm Docker.
Không rành kỹ thuật vẫn có thể triển khai Hermes Agent
Nếu mục tiêu của bạn là dùng Hermes Agent càng sớm càng tốt, VPS cài sẵn Hermes Agent giúp bỏ qua bước cài môi trường từ VPS trống. Gói cài sẵn vẫn cho quyền root, nên bạn bật được Docker backend bằng lệnh ở Bước 3 sau khi nhận máy. Lợi ích chính:
- Không mất thời gian cài đặt môi trường từ VPS trống.
- Hạn chế lỗi cấu hình trong giai đoạn triển khai ban đầu.
- Phù hợp cho người làm nội dung, marketer, developer hoặc doanh nghiệp muốn thử AI Agent thực tế.
Muốn chạy Hermes Agent 24/7 mà không tự cài? VPS Hermes Agent của Tino cài sẵn Hermes Agent trên VPS NVMe đặt tại Việt Nam; bạn vẫn có quyền root để cấu hình. Xem cấu hình và giá trên trang sản phẩm. Nếu dùng trong 30 ngày mà không hài lòng, bạn được hoàn 100% (xem điều kiện).
Kết luận
Nếu Hermes chạy trên VPS kèm gateway Telegram, bật Docker backend là bước nâng cấp bảo mật đáng làm: lệnh của agent chạy trong container, VPS chỉ chịu ảnh hưởng qua những thư mục bạn chủ động chia sẻ. Nếu muốn đóng gói cả Hermes, dùng image chính thức và cập nhật bằng cách kéo image mới.
Các bài viết liên quan:
- Cấu hình tối thiểu để chạy Hermes Agent
- Cách thiết lập Docker sandbox cho Hermes Agent
- Hướng dẫn sử dụng Hermes Agent cơ bản
- Hướng dẫn cách thêm skill cho Hermes Agent
- Cách cài đặt Hermes Agent trên máy tính Windows
- Hướng dẫn gỡ cài đặt Hermes Agent trên VPS
- Cách ly sandbox cho AI Agent trên VPS
Những câu hỏi thường gặp
Nếu lệnh terminal chạy trong Docker gây ra lỗi nghiêm trọng, VPS có bị ảnh hưởng không?
Thường là không. Lệnh xoá nhầm file hay làm hỏng môi trường chỉ tác động bên trong container, vì Hermes chạy container với --cap-drop ALL, no-new-privileges và giới hạn số tiến trình. Ngoại lệ là những thư mục bạn mount vào qua docker_volumes hoặc docker_mount_cwd_to_workspace: thay đổi ở đó ghi thẳng xuống VPS. Không mount thư mục hệ thống và không đưa Docker socket vào container.
VPS cần bao nhiêu RAM để chạy Hermes Agent kết hợp với Docker?
Tài liệu Hermes khuyến nghị container chạy Hermes tối thiểu 1GB RAM, nên có 2–4GB; công cụ duyệt web cần ít nhất 2GB. Với Docker backend, khoá container_memory giới hạn RAM của sandbox (mặc định 5120 MB theo tài liệu Security). VPS 2GB chạy được việc nhẹ; 4GB thoải mái hơn khi bật duyệt web hoặc chạy nhiều tác vụ.
