Ai Install Hermes In Incus

راهنمای جامع صفر تا صد: نصب Incus، کانتینر Ubuntu و داشبورد وب Hermes Agent

بخش اول: راه‌اندازی Incus و کانتینر روی سرور اصلی (Host)

۱. نصب پیش‌نیازها و افزودن مخزن رسمی Zabbly:

sudo apt-get update
sudo apt-get install -y curl gpg
sudo mkdir -p /etc/apt/keyrings/
curl -fsSL https://pkgs.zabbly.com/key.asc -o /etc/apt/keyrings/zabbly.asc

sudo sh -c 'cat <<EOF > /etc/apt/sources.list.d/zabbly-incus-stable.sources
Enabled: yes
Types: deb
URIs: https://pkgs.zabbly.com/incus/stable
Suites: $(. /etc/os-release && echo ${VERSION_CODENAME})
Components: main
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/zabbly.asc
EOF'

۲. نصب پکیج‌های Incus و مقداردهی اولیه:

sudo apt-get update
sudo apt-get install -y incus incus-ui-canonical
sudo usermod -aG incus-admin $USER
newgrp incus-admin

incus admin init --auto

۳. ساخت کانتینر Ubuntu 24.04 و ورود به آن:

incus launch images:ubuntu/24.04 incus-ubuntu-hermes
incus list
incus exec incus-ubuntu-hermes -- bash

بخش دوم: تنظیمات و نصب داشبورد داخل کانتینر

۱. به‌روزرسانی و نصب Hermes Agent:

apt update && apt install -y curl git tar xz-utils socat python3 nano
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.bashrc

۲. تولید هش امن رمز عبور (scrypt):

HASH=$(/root/.hermes/bin/uv run python - << 'EOF'
import sys
sys.path.insert(0, '/usr/local/lib/hermes-agent')
from plugins.dashboard_auth.basic import hash_password
print(hash_password("TestPass@2026"))
EOF
)

۳. تنظیم دامنه و احراز هویت در config.yaml:

mkdir -p /root/.hermes
sed -i '/^dashboard:/,$d' /root/.hermes/config.yaml

cat << EOF >> /root/.hermes/config.yaml

dashboard:
  public_url: "http://s5.sovi.ir:9119"
  basic_auth:
    username: "admin"
    password_hash: "$HASH"
EOF

۴. ساخت سرویس systemd داشبورد Hermes:

cat << 'EOF' > /etc/systemd/system/hermes-dashboard.service
[Unit]
Description=Hermes Agent Web Dashboard
After=network.target

[Service]
Type=simple
User=root
WorkingDirectory=/root
Environment="PATH=/usr/local/bin:/root/.hermes/bin:/usr/local/share/uv/bin:/usr/bin:/bin"
ExecStart=/usr/local/bin/hermes dashboard --host 127.0.0.1 --port 9119 --no-open --skip-build
Restart=always
RestartSec=5
StandardOutput=journal
StandardError=journal

[Install]
WantedBy=multi-user.target
EOF

۵. ساخت سرویس فورواردر پورت socat:

cat << 'EOF' > /etc/systemd/system/hermes-proxy.service
[Unit]
Description=Expose Hermes Dashboard to Network
After=hermes-dashboard.service

[Service]
Type=simple
ExecStart=/usr/bin/socat TCP4-LISTEN:9120,fork,reuseaddr TCP4:127.0.0.1:9119
Restart=always
RestartSec=3

[Install]
WantedBy=multi-user.target
EOF

۶. فعال‌سازی و راه‌اندازی سرویس‌ها:

systemctl daemon-reload
systemctl enable --now hermes-dashboard hermes-proxy
exit

بخش سوم: فوروارد پورت روی سرور اصلی (Host)

اتصال پورت به اینترنت از طریق Incus Proxy:

incus config device add incus-ubuntu-hermes hermes-web-port proxy listen=tcp:0.0.0.0:9119 connect=tcp:127.0.0.1:9120
ss -tulpn | grep 9119

بخش چهارم: مشخصات ورود و دستورات مدیریتی

پارامتر	مقدار
آدرس در مرورگر	http://s5.sovi.ir:9119
نام کاربری (Username)	admin
رمز عبور تستی (Password)	TestPass@2026

دستورات کاربردی مدیریت:

عملیات	دستور
ورود به ترمینال کانتینر	incus exec incus-ubuntu-hermes -- bash
مشاهده لاگ زنده	journalctl -u hermes-dashboard -f
ریستارت داشبورد	systemctl restart hermes-dashboard
خاموش / روشن کردن	incus stop incus-ubuntu-hermes / incus start incus-ubuntu-hermes