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
sshzdejmuje izolację Docker — agent dotyka realnych plików. Dlatego bezpieczeństwo robimy inaczej: osobny użytkownikhermes+ 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), albossh(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) 🖥️
- Osobny użytkownik: System Settings → Users & Groups → Add Account → typ Standard (nie admin), nazwa
hermes. - Logowanie SSH: System Settings → General → Sharing → Remote Login = ON; jeśli można, „Allow access for: Only these users" → dodaj tylko
hermes. - Folder roboczy (na koncie
hermes):mkdir -p /Users/hermes/praca
Osobne konto
hermesto 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 pingprzechodzi). - Na Macu jest konto
hermes, Remote Login włączony, folderpracautworzony. - VPS wchodzi na Maca po SSH bez hasła.
-
terminal.backend = ssh, dane Maca w.env. - Test:
hostname/sw_verspokazują Maca, plik powstał wpraca/. - Profile
vps/macdział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.