휴대전화에서 Hermes 에이전트 접속하는 방법
VPS에서 실행 중인 Hermes 에이전트를 휴대전화로 제어하는 세 가지 방법을 안내합니다. Tailscale 메시 네트워크, 리버스 프록시, SSH 연결 설정을 통해 안전하게 접근하고 기기 분실 시 권한을 회수하는 방법을 확인하십시오.
휴대전화에서 Hermes 에이전트에 접속하는 세 가지 방법
휴대전화에서 Hermes 에이전트에 접속하려면 웹 대시보드를 사용해야 하며, 핵심은 대시보드 앞단에 무엇을 배치할지 결정하는 것입니다. 첫 번째 방법은 사설 메시 네트워크를 사용하는 것으로, 대시보드가 Tailscale 주소에서만 대기하며 인터넷으로 노출되는 포트가 없습니다. 두 번째 방법은 TLS(transport layer security)와 로그인 절차가 적용된 리버스 프록시 뒤에 공개 엔드포인트를 두는 방식이며, 이때 로그인은 서버 터미널을 보호하는 유일한 수단이 됩니다. 세 번째 방법은 터미널 앱에서 SSH(secure shell)를 사용하는 것으로, 설정이 가장 간편하고 가장 높은 수준의 접근 권한을 제공합니다.
이 가이드는 자체 VPS에서 Hermes 에이전트 실행하기가 완료된 시점부터 시작합니다. 에이전트가 설치되어 명령줄에서 응답하는 상태이며, 이제 이를 휴대전화에서 사용하고자 하는 상황입니다.
아래 명령어는 2026년 8월 3일에 릴리스 노트 v0.20.0으로 게시된 태그 v2026.8.3를 기준으로 작성되었습니다. Hermes는 릴리스가 잦으므로 main을 따르는 대신 특정 태그에 버전을 고정하십시오. 설치 프로그램은 커밋을 인자로 받습니다:
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/v2026.8.3/scripts/install.sh | bash -s -- --commit 3c27eb6234bf
hermes --version이 고정 버전(pin)을 위해 해당 태그의 설치 프로그램을 사용하십시오. 현재 설치 프로그램은 새로운 PM 의존성 시스템을 요구합니다. hermes --version은 실제로 설치된 항목을 출력합니다. 이 페이지의 어떤 플래그를 신뢰하기 전에 해당 태그와 비교해 보십시오.
저장소가 제공하는 것과 제공하지 않는 것
Hermes 저장소에는 iOS나 Android 앱이 포함되어 있지 않습니다. 기본 클라이언트는 macOS, Windows, Linux용 Electron 애플리케이션인 hermes desktop(별칭 hermes gui)입니다. 이 클라이언트는 로컬 에이전트 대신 원격 에이전트에 연결할 수 있습니다. 설정의 Gateway 항목에서 원격 URL을 http://<server-address>:9119로 지정하거나, 실행 전에 HERMES_DESKTOP_REMOTE_URL=http://<server-address>:9119를 내보내기(export)하십시오. 이 방법으로 두 번째 노트북을 연결할 수 있지만, 휴대폰에서는 사용할 수 없습니다.
휴대폰에서 사용하는 인터페이스는 브라우저 기반의 hermes dashboard입니다. 이 인터페이스는 설정, 세션, cron 작업, 스킬, 로그, 메시징 플랫폼을 관리하며 터미널을 내장하고 있습니다. 서버는 PTY(pseudo-terminal) 뒤에서 hermes --tui을 생성하고 그 출력을 페이지로 스트리밍합니다. 화면이 좁은 경우 세션 전환기가 슬라이드 오버 패널로 접히므로 휴대폰에서도 레이아웃이 유지됩니다.
최신 릴리스에서는 hermes webapp을 통해 브라우저에서 데스크톱 작업 공간을 제공하기도 합니다. 이는 별도의 포트와 공개 URL 설정을 사용하는 독립적인 게이트웨이 인터페이스이며, 아래 지침은 대시보드를 기준으로 설명합니다.
기본적으로 대시보드는 127.0.0.1:9119에서 수신 대기하며 서버 자체에서 브라우저 탭을 엽니다. 이는 헤드리스 VPS(가상 사설 서버)에서는 유용하지 않습니다. 브라우저 없이 시작하여 소켓을 확인하십시오.
hermes dashboard --no-open
ss -lntp | grep 9119127.0.0.1:9119에서 수신 대기 중인 서비스는 서버 내부에서만 접근할 수 있습니다. 0.0.0.0:9119에서 수신 대기 중인 서비스는 공용 네트워크를 포함하여 해당 장비가 연결된 모든 네트워크에서 접근할 수 있습니다. 이 한 줄의 설정이 노출 범위를 결정하므로, 추측하지 말고 직접 확인하십시오.
옵션 1: Tailscale을 이용한 프라이빗 메시
특별한 이유가 없다면 이 방식을 선택하십시오. Tailscale은 WireGuard 기반의 메시 VPN(가상 사설망)입니다. 등록된 모든 기기는 고유한 주소를 할당받으며, 직접 연결되거나 암호화된 릴레이를 통해 서로 통신합니다. 스마트폰을 같은 메시에 연결하면 대시보드를 외부 포트에 노출할 필요가 전혀 없습니다.
서버에서 다음을 수행합니다:
curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up
tailscale ip -4스마트폰에 Tailscale 앱을 설치하고 동일한 계정으로 로그인하십시오. 서버에서 tailscale status를 실행하면 기기 이름이 목록에 나타납니다. 이제 tailscale ip -4이 출력한 주소에 대시보드를 바인딩하십시오:
hermes dashboard --host 100.101.102.103 --port 9119 --no-open0.0.0.0가 아닌 메시 주소에 바인딩하면, 소켓은 해당 메시 IP로 들어오는 연결만 수락합니다. 공인 IP 주소를 포트 스캔해도 9119 포트에서는 아무것도 응답하지 않는데, 해당 주소로 수신 대기 중인 프로세스가 없기 때문입니다. 하지만 이것이 소켓을 Tailscale 인터페이스에만 고정하는 것은 아닙니다. Linux 커널 문서에 명시된 대로, IP 주소는 특정 인터페이스가 아닌 호스트 전체에 귀속됩니다. 동일한 제공자 네트워크 내의 기기가 공인 인터페이스로 100.101.102.103를 목적지로 하는 패킷을 보내면 대시보드에 도달할 수 있습니다. 인터페이스를 강제로 제한하려면 ufw의 기본 수신 거부 정책을 유지하고 sudo ufw allow in on tailscale0 to any port 9119 proto tcp을 사용하여 메시 인터페이스에서만 포트를 허용하십시오. ss -lntp | grep 9119을 사용하여 수신 대기 상태를 다시 확인하십시오.
바인딩 주소는 인증 방식도 결정하며, 많은 사용자가 이 부분을 놓칩니다. v2026.8.3에서 대시보드가 127.0.0.1에 바인딩되면 public_url이 설정되어 있어도 로그인 과정을 거치지 않습니다. 다른 주소에서는 인증 관문이 필수이며, 제공자가 설정되지 않은 상태라면 서버는 시작을 거부합니다. 프로젝트에서는 이를 'failing closed'라고 부릅니다. 처음 실행할 때 대화형 모드로 실행하면 즉시 사용자 이름과 비밀번호를 설정할 수 있으며, 이는 ~/.hermes/config.yaml의 dashboard.basic_auth에 저장됩니다. 프로젝트의 공식 예제처럼 ~/.hermes/.env을 통해 동일한 제공자를 설정할 수도 있습니다:
HERMES_DASHBOARD_BASIC_AUTH_USERNAME=you
HERMES_DASHBOARD_BASIC_AUTH_PASSWORD_HASH=scrypt$16384$8$1$...
HERMES_DASHBOARD_BASIC_AUTH_SECRET=a-long-random-string프로젝트 대시보드 문서에서 사용하는 openssl rand -base64 32 명령어로 비밀 값을 생성하십시오(설정 주석에는 base64 또는 16진수 형식의 32바이트 이상 난수를 권장합니다). 생성 후에는 이 값을 변경하지 마십시오. 이 값은 비밀번호 제공자의 세션 토큰을 서명하는 데 사용되므로, 변경 시 해당 제공자를 사용하는 모든 기기의 로그인이 해제됩니다. 같은 파일에 모델 API 키도 저장되므로 chmod 600 ~/.hermes/.env를 사용하여 파일을 비공개로 유지하십시오.
신뢰하기 전에 메시 내의 다른 기기에서 인증 관문을 확인하십시오:
curl -s http://100.101.102.103:9119/api/status | jq '.auth_required, .auth_providers'true 다음에 ["basic"]이 출력되면 관문이 활성화되어 있고 비밀번호 제공자가 응답하고 있는 것입니다. 프로젝트 문서에서는 이 제공자에 대해 신뢰할 수 있는 네트워크나 VPN 환경을 위한 것이며, 공인 인터넷에 노출된 대시보드에는 적합하지 않다고 명시하고 있습니다. 메시 환경은 바로 이러한 조건에 부합합니다.
Tailnet 내부에서 HTTPS를 사용하려면, 아래의 Tailscale Serve 설정 시 Host 및 WebSocket Origin 검사에서 public_url을 지원하는 최신 릴리스가 필요합니다. v2026.8.3 핀에서는 작동하지 않습니다. 루프백 바인딩은 public_url 설정과 관계없이 루프백 호스트 이름만 수락하기 때문입니다. 해당 핀에서는 위에서 설명한 직접 메시 IP 방식을 유지하십시오. 업그레이드 후 검사를 확인했다면, Serve는 루프백 주소로 프록시를 전달하므로 이 설정을 위해서는 대시보드를 메시 주소가 아닌 127.0.0.1에서 시작하십시오:
sudo tailscale serve --bg localhost:9119
sudo tailscale serve status현재 Hermes 대시보드 문서에 따르면 tailscale serve status가 출력하는 HTTPS origin을 공인 URL로 사용해야 합니다:
dashboard:
public_url: "https://vps.tail1234.ts.net"이 줄이 없으면 대시보드는 Host 헤더의 MagicDNS 이름을 거부합니다. 해당 이름은 루프백 호스트가 아니므로, 백엔드가 루프백에서 수신 대기 중이라도 인증 관문이 계속 활성화됩니다. Tailscale은 기기의 MagicDNS 이름으로 발급된 인증서를 사용하여 TLS를 종료하므로, 브라우저 경고가 사라지고 세션 쿠키에 Secure 플래그가 설정됩니다. 먼저 Tailscale 관리 콘솔의 DNS 페이지에서 MagicDNS와 HTTPS 인증서를 활성화하십시오. 이때 기기 이름과 Tailnet DNS 이름이 공개된 인증서 투명성 로그(certificate transparency ledger)에 게시되어 누구나 읽을 수 있다는 안내 문구를 확인하십시오.
이 방식의 실질적인 비용은 조정 서버(coordination server) 의존성입니다. 스마트폰과 VPS 간의 트래픽은 Tailscale DERP 릴레이를 통과할 때를 포함하여 종단 간 암호화되지만, 어떤 기기가 메시에 포함될지 결정하는 계정은 사용자의 하드웨어에 있지 않습니다. 이것이 우려된다면 Headscale, 자체 호스팅 Tailscale 제어 서버를 사용하여 제어 평면을 직접 운영하고, tailscale up --login-server https://headscale.example.com를 사용하여 클라이언트를 해당 서버로 지정하십시오. 메시를 사용하지 않고 피어를 직접 설정하려면 일반 WireGuard와 Tailscale 비교 문서를 참조하여 포기해야 하는 기능들을 확인하십시오.
옵션 2: 공개 HTTPS 엔드포인트와 그 안에 숨겨진 함정
메시(mesh)를 사용할 수 없는 경우가 있습니다. 업무용 전화기에는 VPN 클라이언트를 설치하지 못할 수도 있습니다. 이럴 때는 대시보드를 리버스 프록시 뒤에 배치합니다. 이 루프백 HTTPS 설정 역시 위에서 설명한 최신 공개 호스트네임 지원이 필요합니다. public_url은 v2026.8.3에서 이 설정을 작동하게 하지 않습니다. 대시보드를 루프백에 유지하고 Caddy가 인증서를 관리하게 하십시오.
hermes.example.com {
reverse_proxy 127.0.0.1:9119
}Caddy는 인증서를 스스로 가져와 갱신하며, reverse_proxy은 추가 지시어 없이도 WebSocket 업그레이드를 통과시킵니다. 이는 대시보드에 내장된 터미널에 필요한 기능입니다. nginx를 사용한다면 Upgrade 및 Connection 헤더를 직접 추가해야 하며, nginx에서 Certbot으로 Let's Encrypt 인증서 발급하기 문서가 해당 작업의 TLS 부분을 다룹니다. Hermes에게 공개 이름을 알려주어 로그인 콜백이 올바른 호스트를 가리키도록 하십시오.
dashboard:
public_url: "https://hermes.example.com"이제 함정에 대해 설명하겠습니다. 인증 게이트는 요청이 들어온 주소가 아니라 바인드 주소(bind address)를 기준으로 작동합니다. 현재 릴리스에서는 백엔드가 루프백에 있더라도 dashboard.public_url(또는 HERMES_DASHBOARD_PUBLIC_URL)이 루프백이 아닌 호스트를 가리키면 게이트가 활성화됩니다. 따라서 위 설정을 적용하면 게이트가 작동하며, 인증 제공자가 설정될 때까지 대시보드는 시작을 거부합니다. public_url을 설정하지 않으면 게이트는 꺼진 상태로 유지되지만, 프록시만으로는 접근 제어를 결정할 수 없습니다. 대시보드는 Host 헤더도 확인합니다. 이 루프백 설정에서 현재 릴리스는 루프백 이름과 public_url가 선언한 호스트만 허용하며, 그 외의 요청에는 400 오류로 응답합니다. 고정된 v2026.8.3은 루프백 이름만 허용하며 public_url은 확인하지 않습니다. Caddy는 브라우저의 Host을 변경하지 않고 전달하므로, public_url가 없는 위 블록은 서비스되지 않고 거부됩니다. 위험한 점은 Host을 백엔드 주소로 다시 쓰는 프록시입니다. nginx는 기본적으로 정확히 그렇게 동작하며, proxy_set_header Host를 직접 설정하지 않으면 proxy_pass 대상을 전송합니다. 이러한 요청은 검사를 통과하여 로그인 절차 없이 대시보드에 도달하게 됩니다. 터미널의 WebSocket은 Origin 검사를 추가합니다. 고정 설정에서 HTTP 또는 HTTPS Origin 헤더가 존재할 경우, 반드시 바인드된 호스트를 가리켜야 합니다. 이는 공개 호스트네임으로 접속하는 브라우저는 차단하지만, Origin를 전혀 보내지 않는 스크립트는 통과시킬 수 있습니다. 어떤 설정을 했든, 실제로 무엇이 공개되었는지 확인하십시오.
curl -s https://hermes.example.com/api/status | jq '.auth_required'만약 결과가 false으로 출력된다면, 인터넷 어디서든 URL 하나로 서버의 터미널에 접근할 수 있는 상태입니다. 익스플로잇이 사용된 것도 아니며 로그에도 아무런 경고가 남지 않습니다. 대신 요청이 400 오류로 실패한다면 Host 검사가 이를 거부한 것입니다. 공개 호스트네임 지원이 포함된 릴리스라면, 검사를 우회하기 위해 헤더를 재작성하지 말고 public_url과 로그인 제공자를 설정하여 문제를 해결하십시오. v2026.8.3에서는 직접 메시 IP 경로를 사용하거나 먼저 업그레이드하십시오. 대시보드가 외부에 노출되는 것을 막는 두 가지 해결책이 있으며, 최소한 하나는 적용해야 합니다. 프록시에서 인증을 처리하도록 하거나, Authentik을 자체 호스팅 SSO 제공자로 사용하여 포워드 인증(forward auth)을 구성하거나, 대시보드 자체의 OIDC(OpenID Connect) 제공자를 설정하십시오.
HERMES_DASHBOARD_OIDC_ISSUER=https://auth.example.com/application/o/hermes/
HERMES_DASHBOARD_OIDC_CLIENT_ID=hermes-dashboard
HERMES_DASHBOARD_OIDC_SCOPES="openid profile email"올바르게 설정하더라도 이 옵션에는 낮출 수 없는 위험 수준이 존재합니다. 공개 로그인 페이지는 누구나 접근하여 공격할 수 있는 페이지이며, 그 뒤에는 VPS의 셸이 있습니다. 사용자 이름과 비밀번호만으로는 보호가 취약하므로, 문서에서는 공개 바인딩 시 OAuth나 OIDC 사용을 권장합니다. 로그인 시도에 속도 제한(rate limit)을 걸고, ufw를 프록시 포트와 SSH를 제외한 모든 포트에 대해 닫아두며, 주기적으로 접근 로그를 확인하십시오.
옵션 3: 모바일 터미널에서 SSH 및 mosh 사용하기
가장 노력이 적게 드는 방법입니다. 휴대폰에 터미널 앱을 설치하고 SSH 키를 불러온 뒤, 에이전트의 텍스트 인터페이스를 직접 사용합니다.
ssh you@vps.example.com
tmux new -A -s phone
hermes --tuitmux new -A -s phone은 phone라는 세션에 연결하며, 세션이 없으면 새로 생성합니다. 따라서 연결이 끊겨도 에이전트는 계속 실행되며, 다음에 접속할 때 동일한 지점으로 돌아올 수 있습니다. 이 패턴은 휴대폰으로 Claude Code 제어하기에서 사용하는 방식과 동일합니다.
모바일 네트워크에서 일반 SSH를 사용하면 휴대폰의 IP 주소가 바뀌거나 절전 모드로 전환될 때마다 연결이 끊기므로 불편합니다. Mosh는 이 문제를 해결합니다. Mosh는 UDP(user datagram protocol) 위에서 동작하며 바이트 스트림 대신 터미널 상태를 동기화하므로, Wi-Fi에서 셀룰러 네트워크로 이동해도 세션이 유지됩니다.
sudo apt install -y mosh
sudo ufw allow 60000:61000/udp휴대폰에서 mosh you@vps.example.com를 실행하십시오. Mosh는 기존 SSH 로그인 세션 위에서 mosh-server을 시작한 뒤, 세션을 60000에서 61000 사이의 UDP 포트로 전환합니다. 이 때문에 해당 범위의 포트를 개방해야 합니다. 각 세션은 하나의 포트만 사용하므로, 동시 접속 세션이 적은 서버라면 60000에서 60010과 같이 더 좁은 범위를 개방해도 충분합니다.
보안 측면의 대가는 명확합니다. SSH 세션은 곧 셸이며, 셸은 해당 계정이 수행할 수 있는 모든 권한을 가집니다. 따라서 잠금 해제된 휴대폰을 분실했을 때 에이전트의 승인 프롬프트가 파일에 대한 마지막 방어선이 됩니다. 이 용도로는 전용 비루트(non-root) 계정을 사용하고 키 기반 인증만 허용하십시오. 휴대폰에 키를 저장하기 전에 VPS의 SSH 보안 강화를 먼저 수행하시기 바랍니다.
모바일 네트워크에서 발생하는 문제
네 가지 현상이 발생하며, 이 중 설정으로 해결할 수 있는 버그는 없습니다.
대시보드가 사용자가 보지 않는 사이에 로그아웃시킵니다. 로그아웃 시점은 로그인 제공자에 따라 다릅니다. 사용자 이름과 비밀번호 제공자는 기본적으로 12시간 동안 유효한 액세스 토큰을 발행하며, 이는 session_ttl_seconds의 dashboard.basic_auth 설정으로 제어됩니다. 하지만 이 값은 대시보드가 백그라운드에서 새로고침되는 주기일 뿐, 로그인 유지 시간과는 무관합니다. 새로고침이 발생할 때마다 30일짜리 리프레시 토큰이 새로 생성되므로, 비밀번호 로그인은 새로고침 없이 30일이 지나기 전까지 유지됩니다. HERMES_DASHBOARD_BASIC_AUTH_SECRET나 dashboard.basic_auth.secret을 통해 안정적인 서명 비밀값이 설정되지 않은 경우, 백엔드가 재시작되면 Hermes가 실행될 때마다 새로운 서명 키를 생성하므로 세션이 종료됩니다. Nous Portal OAuth 제공자는 15분의 TTL(생존 시간)을 가진 액세스 토큰을 발행하며, 사용할 때마다 갱신되는 리프레시 토큰을 통해 백그라운드에서 이를 연장합니다. 따라서 액세스 토큰이 만료되었다고 해서 바로 /login로 돌아가는 것은 아닙니다. 세션이 종료되는 원인은 리프레시 세션이 끊기기 때문입니다. v0.21.3 이전 릴리스(태그 v2026.9.14, 2026년 9월 14일 배포)에서는 백그라운드에서 돌아온 휴대폰이 여러 요청을 동시에 보내면서 방금 교체된 리프레시 토큰을 재사용하는 경우가 있었습니다. 이로 인해 제공자의 재사용 탐지 기능이 작동하여 전체 세션이 취소되었고, 작성 중이던 내용이 사라진 채 로그인 화면으로 돌아가게 되었습니다. v0.21.3에서는 이러한 요청들이 하나의 리프레시를 공유하도록 개선되었으며, Nous Portal 측에서도 리프레시 세션이 교체될 때마다 30일의 유효 기간이 연장되도록 변경되었습니다(단, 30일간 활동이 없으면 세션은 종료됩니다). 이 페이지 상단의 v2026.8.3 핀 버전을 계속 사용한다면 가끔 강제 로그인이 발생할 수 있습니다. 이는 고장 난 것이 아니므로 다시 로그인하십시오.
내장 터미널은 기본적으로 백그라운드 탭에서 유지되지 않습니다. 대시보드의 터미널 연결은 PTY 뒤에서 TUI(텍스트 사용자 인터페이스)를 생성하며, 탭이 닫히면 이를 깔끔하게 정리하고 다시 열 때 새로운 세션을 생성합니다. 모바일 브라우저는 메모리 확보를 위해 백그라운드 탭을 삭제하므로, 다른 앱으로 오랫동안 전환하면 터미널 세션이 종료됩니다. 채팅 기록은 서버에 저장되고 hermes sessions list에서 확인할 수 있으므로 안전합니다. 고정된 서버는 첨부 토큰을 사용하는 선택적 keep-alive 연결을 지원하며, 이를 통해 분리된 PTY를 30분 동안 유지할 수 있습니다. 세션 유지가 반드시 필요하다면 SSH 위에서 tmux를 사용하십시오.
유휴 연결이 조용히 끊깁니다. 모바일 통신사는 NAT(네트워크 주소 변환) 테이블 항목을 확보하기 위해 유휴 TCP 연결을 끊으며, 화면이 꺼지면 휴대폰은 네트워크 서비스를 거의 중단합니다. 한동안 통신이 없던 WebSocket은 잠금을 해제할 때 이미 끊겨 있는 경우가 많으며, 페이지는 사용자가 화면을 터치한 후에야 다시 연결됩니다. 이것이 휴대폰에서 SSH보다 mosh가 더 쾌적하게 느껴지는 이유입니다. mosh는 연결을 잃을 일이 없기 때문입니다.
알림을 푸시하는 기능이 없습니다. 대시보드나 SSH 세션 모두 휴대폰을 깨울 수 없습니다. 기기에 Hermes 앱이 설치되어 있지 않으므로 플랫폼의 푸시 서비스로 연결되는 경로가 없습니다. 에이전트 작업이 길게 실행되어 완료되더라도, 다음에 직접 확인할 때까지는 결과를 알 수 없습니다.
알림은 메시징 게이트웨이를 통해 전달됩니다
마지막 문제에 대한 해결책은 게이트웨이입니다. 이는 에이전트에 도달하는 완전히 다른 방식입니다. hermes gateway은 에이전트를 Telegram, Discord, Slack, WhatsApp, Signal 및 이메일을 포함한 메시징 플랫폼에 연결합니다. 사용자는 이미 휴대폰에서 푸시 채널을 보유하고, 백그라운드 전송을 처리하며, 네트워크 끊김 현상을 대응하는 앱 내에서 에이전트와 대화하게 됩니다.
hermes gateway setup
hermes gateway install
hermes gateway statushermes gateway install는 게이트웨이를 systemd 서비스로 등록하므로 재부팅 후에도 서비스가 복구됩니다. 설치 프로그램의 게이트웨이 단계에서 해당 단계를 실행할 수 있지만, 설치 프로그램의 어떤 항목도 hermes dashboard을 위한 유닛을 생성하지 않으므로 대시보드는 재시작 후 자동으로 다시 실행되지 않습니다. 의존하는 각 구성 요소에 대해 유닛 파일을 작성하십시오. VPS에서 systemd 서비스 및 타이머 작성하기에서 파일 작성 방법을 다룹니다.
예약된 작업은 대화 과정 없이 동일한 방식으로 결과를 푸시할 수 있습니다.
hermes send -t telegram -s "Backup report" -f /home/you/report.txt여기서 권한 부여는 기본적으로 거부(deny by default) 상태입니다. 허용 목록이나 승인된 페어링이 없고 GATEWAY_ALLOW_ALL_USERS이 설정되지 않은 경우 모든 사용자의 접근이 거부되며, 이것이 올바른 시작점입니다. ~/.hermes/.env에 원하는 계정 이름을 지정하십시오.
TELEGRAM_ALLOWED_USERS=123456789
GATEWAY_ALLOWED_USERS=123456789또는 숫자 ID를 붙여넣는 대신 코드 기반 페어링을 사용하십시오. 이는 채팅 방식의 DM 플랫폼에서 기본값으로 설정되어 있으며, ~/.hermes/config.yaml 내에서 unauthorized_dm_behavior: pair을 사용하여 명시적으로 설정할 수 있습니다. 에이전트에 메시지를 보내는 알 수 없는 계정은 8자리 코드를 받게 되며, 사용자가 승인하기 전까지는 아무 일도 일어나지 않습니다.
hermes pairing list
hermes pairing approve telegram ABC12DEF
hermes pairing revoke telegram 123456789코드는 1시간 후에 만료되며, 사용자는 10분마다 코드를 요청할 수 있고, 5회 실패 시 해당 계정은 잠깁니다.
도난당한 휴대폰의 피해 범위 제한하기
에이전트에 접근할 수 있는 휴대폰은 서버에서 명령을 실행할 수 있는 휴대폰과 같으며, 휴대폰은 분실될 수 있습니다. 휴대폰을 습득한 사람이 무엇을 할 수 있을지 지금 결정하십시오.
승인 기능을 켜두십시오. approvals.mode는 기본적으로 smart으로 설정되어 있으며, 보조 모델이 위험을 판단하여 낮은 위험도의 명령만 자동으로 승인합니다. 이를 off로 설정하는 것은 모든 명령을 --yolo로 실행하는 것과 같으며, HERMES_YOLO_MODE=1는 환경 변수를 통해 이를 수행합니다. 해당 상태의 에이전트와 통신하는 휴대폰을 휴대하지 마십시오. 잠든 사이에 예약된 작업이 스스로 승인되지 않도록 approvals.cron_mode: deny을 설정하십시오.
approvals:
mode: smart
cron_mode: deny에이전트가 손상시킬 수 있는 범위를 최소화하십시오. terminal.backend: docker은 짧은 목록을 제외한 모든 Linux capabilities를 제거하고 no-new-privileges를 설정하며 프로세스 수를 제한하는 컨테이너 내부에서 명령을 실행하므로, 컨테이너가 프롬프트 대신 경계 역할을 하게 됩니다. terminal.cwd은 작업 디렉터리를 고정합니다. HERMES_WRITE_SAFE_ROOT는 write_file 및 patch을 지정한 디렉터리로 제한하며, 해당 디렉터리 외부로의 쓰기 작업은 승인 여부와 관계없이 차단됩니다.
export HERMES_WRITE_SAFE_ROOT=/home/you/projects:/home/you/.hermesHermes는 이미 ~/.ssh, ~/.aws, ~/.kube, /etc/sudoers 및 ~/.hermes/.env과 같은 자체 비밀 저장소에 대한 쓰기를 차단합니다. 디스크의 다른 곳에 있는 프로젝트 .env 파일은 읽기가 차단되지만 쓰기는 가능합니다. 또한 승인 설정과 관계없이 파괴적인 명령 목록에 대해서는 무조건 거부합니다. 이를 계획의 전부가 아닌 최소한의 안전장치로 간주하십시오. 에이전트는 root가 아닌 일반 사용자로 실행하십시오. 방치된 상태로 실행되는 모든 코딩 에이전트에도 동일한 논리가 적용되며, VPS에서 안전하게 Claude Code 실행하기에서 이를 더 자세히 다룹니다.
필요하기 전에 취소 절차를 미리 기록해 두십시오. Tailscale 관리 콘솔에서 장치를 제거하면 즉시 메시 네트워크 접근이 차단됩니다. HERMES_DASHBOARD_BASIC_AUTH_SECRET을 변경하고 재시작하면 해당 값이 제공자의 세션 토큰에 서명하므로 모든 장치의 비밀번호 제공자 대시보드 세션이 무효화됩니다. ~/.ssh/authorized_keys에서 휴대폰의 공개 키를 삭제하면 해당 키를 사용한 새로운 SSH 로그인이 차단됩니다. 기존 SSH 및 mosh 세션은 별도로 종료하십시오. hermes pairing revoke telegram <user-id>는 메시징 계정을 제거합니다. 장치에 제공자 키를 읽을 수 있는 정보가 있었다면 hermes auth logout <provider>으로 해당 키를 폐기하고 상위 서비스에서 새 키를 발급받으십시오.
결과를 가정하지 말고 직접 확인하십시오. 다음은 자신의 서버에서 실행할 명령이며, 출력 내용은 설정에 따라 달라집니다.
tailscale status
hermes pairing list
hermes logs gateway -n 100
hermes status --deep로그는 ~/.hermes/logs/ 아래에 저장됩니다. 사고 발생 후 로그를 읽고, 사고가 없을 때도 가끔 확인하십시오.
FAQ
Hermes 공식 모바일 앱이 iOS나 Android용으로 출시되어 있습니까?
아니요. Hermes 저장소는 명령줄 인터페이스, 웹 대시보드, 그리고 macOS, Windows, Linux용 Electron 데스크톱 클라이언트를 제공합니다. 공식 iOS 또는 Android 빌드는 없습니다. 휴대폰에서는 브라우저를 통해 웹 대시보드를 사용하거나, SSH 클라이언트, 또는 hermes gateway을 통해 연결된 메시징 플랫폼을 사용하십시오. 서드 파티 모바일 클라이언트가 존재하기는 하지만, 이는 사용자의 에이전트 자격 증명을 보유하는 외부 코드이므로 설치하기 전에 소스 코드를 확인하십시오.
휴대폰에서 Hermes 대시보드가 자꾸 로그아웃되는 이유는 무엇입니까?
로그인 제공자에 따라 다릅니다. Nous Portal OAuth 제공자는 15분의 TTL을 가진 액세스 토큰을 발급하며, 순환되는 리프레시 토큰을 통해 백그라운드에서 토큰을 갱신합니다. 따라서 액세스 토큰이 만료되었다고 해서 바로 /login로 이동하지는 않습니다. v0.21.3(태그 v2026.9.14) 이전 릴리스에서는 휴대폰이 백그라운드에서 복귀할 때 여러 요청을 동시에 보내면서 방금 순환된 리프레시 토큰을 재사용하게 되어 세션 전체가 취소되고 로그인이 강제되는 문제가 있었습니다. v0.21.3에서 이 문제가 해결되었으며, 30일 동안 유휴 상태인 리프레시 세션은 여전히 만료됩니다. 사용자 이름 및 비밀번호 제공자는 기본적으로 12시간짜리 액세스 토큰을 사용하며, 이는 session_ttl_seconds에 의해 설정됩니다. 이 설정은 대시보드가 백그라운드에서 얼마나 자주 새로고침되는지만 제어합니다. 이 토큰은 새로고침할 때마다 재발급되는 30일짜리 리프레시 토큰을 통해 갱신되므로, 비밀번호 로그인이 12시간 후에 종료되지는 않습니다. 해당 제공자를 사용할 때는 HERMES_DASHBOARD_BASIC_AUTH_SECRET를 안정적인 임의의 값으로 설정하십시오. 이 변수나 dashboard.basic_auth.secret에 안정적인 비밀값이 없으면 Hermes는 시작할 때마다 새로운 서명 키를 생성하며, 재시작할 때마다 로그아웃됩니다.
Hermes 대시보드를 공용 인터넷에 안전하게 노출할 수 있습니까?
직접 검증한 인증을 거친 경우에만 가능합니다. 인증 게이트는 바인딩 주소에 따라 활성화되며, 최신 릴리스에서는 dashboard.public_url가 루프백이 아닌 호스트를 가리킬 때도 활성화됩니다. 따라서 공용 URL 설정 없이 127.0.0.1에 바인딩된 대시보드는 로그인을 요구하지 않습니다. v2026.8.3 핀에서 public_url을 설정해도 루프백 인증 게이트가 작동하지 않으며, Host 및 WebSocket Origin 검사를 통해 공용 호스트 이름을 허용하지도 않습니다. HTTPS 프록시 설정을 따르기 전에 직접 메시 IP 경로를 사용하거나 공용 호스트 이름 지원이 포함된 릴리스로 업그레이드하십시오. Host 검사는 공용 호스트 이름을 전달하는 프록시는 차단하지만, nginx가 기본적으로 수행하는 것처럼 Host를 백엔드 주소로 재작성하는 프록시는 차단하지 않습니다. curl -s https://your-host/api/status | jq '.auth_required'을 실행하여 결과를 확인하십시오. 프로젝트 문서에서 비밀번호 제공자는 신뢰할 수 있는 네트워크 및 VPN용이라고 명시하고 있으므로, 사용자 이름과 비밀번호보다는 OAuth나 OIDC를 사용하십시오. 프라이빗 메시를 사용하면 이 문제를 완전히 피할 수 있으며, 이것이 더 권장되는 기본 설정입니다.
Tailscale 계정이 필요한가요, 아니면 제어 평면을 직접 호스팅할 수 있나요?
직접 호스팅할 수 있습니다. Headscale은 Tailscale 조정 서버의 오픈 소스 구현체이며, 공식 Tailscale 클라이언트는 tailscale up --login-server https://headscale.example.com을 통해 여기에 연결됩니다. 이 경우 메시 참여가 허용된 장치 목록을 직접 관리하게 됩니다. 단, 서버를 직접 운영하고 백업해야 하며, 서버가 다운되면 장치를 등록하거나 재인증할 수 없습니다.
에이전트가 작업을 완료했을 때 휴대폰으로 알림을 받으려면 어떻게 해야 합니까?
메시징 게이트웨이를 사용하십시오. 대시보드와 SSH에는 휴대폰을 깨울 방법이 없는데, 이는 장치에 푸시를 수신할 Hermes 앱이 없기 때문입니다. hermes gateway setup를 사용하여 에이전트를 Telegram, Signal, Discord 또는 기타 지원되는 플랫폼에 연결한 다음, 해당 플랫폼의 앱을 통해 알림을 받으십시오. cron 작업을 통해 hermes send -t telegram -s "Job done" -f /path/to/report.txt으로 단일 메시지를 보낼 수도 있으며, 이는 모델을 호출하지 않고도 전달됩니다.