10

Rozdział 10 z 11

Praca na plikach Maca — bezpieczny dostęp agenta do komputera

Szkic

Główny cel: agent z VPS realnie pracuje na plikach w folderze na Twoim komputerze — przez prywatny, szyfrowany tunel. Osobny użytkownik, jeden folder, zatwierdzanie poleceń. Rozdział w trakcie wdrażania na żywo.

Czego się nauczysz

  • Prywatne połączenie (Tailscale)
  • Osobny użytkownik + jeden folder roboczy na Macu
  • Backend SSH — praca na plikach Maca
  • Profile: tryb „mac" (ssh) i „vps" (docker)

Rozdział 10: Praca na plikach Maca — bezpieczny dostęp agenta do komputera

🟡 Rozdział w trakcie wdrażania (In progress). Opisuje docelową konfigurację, którą właśnie uruchamiamy i testujemy na żywo — doprecyzujemy go realnymi zrzutami i komendami, gdy przejdzie w całości.

To główny cel całej układanki: żeby jeden Hermes z VPS realnie pracował na plikach w folderze na Twoim komputerze, a nie tylko na serwerze. Agent dostaje „ręce" na Macu przez prywatny, szyfrowany tunel. Na Macu NIE instalujemy drugiego agenta — komputer tylko wykonuje polecenia przysłane z VPS.

Po tym rozdziale agent z VPS czyta i zmienia pliki w jednym, wybranym folderze na Twoim komputerze — bezpiecznie.


Co budujemy

Ty (Telegram / panel / aplikacja)
        │
        ▼
HERMES na VPS  ── Tailscale + SSH ──►  MAC: użytkownik `hermes`, folder /Users/hermes/praca
 (mózg, pamięć)                         (ręce: realne pliki, bez drugiego agenta)

Zasady tego trybu:

  • Backend ssh zdejmuje izolację Docker — agent dotyka realnych plików. Dlatego bezpieczeństwo robimy inaczej: osobny użytkownik hermes + jeden folder + zatwierdzanie poleceń.
  • Mac musi być włączony i nieuśpiony, z działającym Tailscale.
  • Backend jest jeden naraz — albo docker (praca na VPS), albo ssh (praca na Macu). Dlatego na końcu zrobimy profile, żeby wygodnie przełączać.

⚠️ Dajesz agentowi AI realny dostęp do części komputera. Trzymaj zatwierdzanie poleceń włączone, ogranicz go do osobnego konta i jednego folderu.


Krok 1 — Bezpieczne połączenie (Tailscale) 🖥️📱

Tailscale to darmowa prywatna sieć: po instalacji VPS i Mac widzą się po stałych adresach 100.x.y.z, bez otwierania portów.

Na Macu: zainstaluj Tailscale (tailscale.com/download/mac), zaloguj się, sprawdź adres:

/Applications/Tailscale.app/Contents/MacOS/Tailscale ip -4      # → TAILSCALE_IP_MACA

Na VPS:

curl -fsSL https://tailscale.com/install.sh | sh
tailscale up           # otwórz podany link i zaloguj TYM SAMYM kontem co na Macu
tailscale ping TAILSCALE_IP_MACA   # ma przejść

Krok 2 — Przygotowanie Maca (osobny użytkownik + folder) 🖥️

  1. Osobny użytkownik: System Settings → Users & Groups → Add Account → typ Standard (nie admin), nazwa hermes.
  2. Logowanie SSH: System Settings → General → Sharing → Remote Login = ON; jeśli można, „Allow access for: Only these users" → dodaj tylko hermes.
  3. Folder roboczy (na koncie hermes):
    mkdir -p /Users/hermes/praca
    

Osobne konto hermes to Twoja główna granica: agent nie ma prawa czytać plików z Twojego głównego konta.


Krok 3 — Klucz SSH z VPS na Maca 🖥️

Na VPS wygeneruj klucz i pokaż część publiczną:

ssh-keygen -t ed25519 -f ~/.ssh/hermes_mac -N ""
cat ~/.ssh/hermes_mac.pub

Dodaj klucz publiczny na Macu do konta hermes:

ssh-copy-id -i ~/.ssh/hermes_mac.pub hermes@TAILSCALE_IP_MACA

Test (z VPS, ma wpuścić bez hasła):

ssh -i ~/.ssh/hermes_mac hermes@TAILSCALE_IP_MACA   # whoami → hermes; potem exit

Krok 4 — Przełącz agenta na backend SSH 🖥️

Na VPS:

hermes config set terminal.backend ssh

Dopisz dane Maca do /root/.hermes/.env:

TERMINAL_SSH_HOST=TAILSCALE_IP_MACA
TERMINAL_SSH_USER=hermes
TERMINAL_SSH_KEY=~/.ssh/hermes_mac
TERMINAL_SSH_PORT=22

Uruchom agenta (w klatce) i na starcie poproś: „od teraz pracuj w katalogu /Users/hermes/praca".


Krok 5 — Test: agent naprawdę pracuje na Macu ✅

W czacie:

Wykonaj: hostname oraz sw_vers. Potem utwórz plik /Users/hermes/praca/test-hermes.txt
z treścią "działa z VPS". Pokaż wynik.

Po zatwierdzeniu:

  • hostname → nazwa Twojego Maca, sw_vers → macOS (nie Linux),
  • na Macu, na koncie hermes, pojawia się praca/test-hermes.txt.

To dowód, że agent z VPS realnie pracuje na plikach Maca. 🎯


Krok 6 — Profile: tryb „mac" i tryb „vps"

Żeby nie przestawiać backendu ręcznie za każdym razem, zrobimy dwa profile:

  • vps → terminal.backend docker (izolowana praca na serwerze),
  • mac → terminal.backend ssh (praca na folderze Maca).

Przełączasz się komendą, zależnie od tego, co robisz. Dokładne komendy profili potwierdzimy na żywo (hermes profile --help / hermes -p <profil> …), żeby pasowały do Twojej wersji.


Stałe zasady bezpieczeństwa

  • ✅ Agent działa jako hermes — bez dostępu do Twoich prywatnych plików.
  • ✅ Zatwierdzanie poleceń włączone — zawsze.
  • ✅ Połączenie tylko przez Tailscale — zero portów do internetu.
  • ✅ Gdy nie pracujesz na Macu — wróć do profilu vps (docker), żeby agent nie szukał wyłączonego komputera.

Weryfikacja rozdziału

  • Tailscale działa na VPS i Macu (tailscale ping przechodzi).
  • Na Macu jest konto hermes, Remote Login włączony, folder praca utworzony.
  • VPS wchodzi na Maca po SSH bez hasła.
  • terminal.backend = ssh, dane Maca w .env.
  • Test: hostname/sw_vers pokazują Maca, plik powstał w praca/.
  • Profile vps/mac działają i przełączają tryb.

Podsumowanie

  • ✅ Jeden Hermes z VPS pracuje na wybranym folderze Twojego Maca przez prywatny tunel.
  • ✅ Bezpieczeństwo: osobne konto + jeden folder + zatwierdzanie (zamiast piaskownicy Docker).
  • ✅ Umiesz wrócić do trybu izolowanego (vps), gdy nie pracujesz lokalnie.

Dalej: Rozdział 11 — Całkowite usunięcie i sprzątanie.

Narzędzia / paczki

Tailscale SSH hermes config set terminal.backend ssh hermes profile

Spis treści