Skonfiguruj zdalny executor

Zainstaluj, sparuj i zarządzaj komputerem, który współpracuje z agentami Nessie.

Executor łączy komputer, którym zarządzasz, z Nessie. Zainstaluj go na koncie systemowym, którego pliki i programy ma używać. Nie potrzebujesz Node.js ani kopii źródeł.

macOS

CLI wymaga macOS 15 lub nowszego na procesorach Apple Silicon:

brew install unlikeotherai/tap/nessie-executor

Dla pełnej aplikacji desktopowej Nessie albo samodzielnego executora z lokalnym oknem uprawnień:

brew install --cask unlikeotherai/tap/nessie
brew install --cask unlikeotherai/tap/nessie-executor-app

Wybierz interfejs, którego chcesz używać. Uruchamiaj jednego nadzorcę dla każdego parowania. W aplikacji executora Ustawienia → Otwórz Nessie Executor po zalogowaniu steruje automatycznym uruchamianiem.

Debian i Ubuntu

Użyj podpisanego repozytorium APT na architekturze x86_64 Debian 12+ lub Ubuntu 22.04+:

sudo apt-get update
sudo apt-get install -y curl ca-certificates
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://packages.nessie.works/nessie-executor.asc | sudo tee /etc/apt/keyrings/nessie-executor.asc >/dev/null
echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/nessie-executor.asc] https://packages.nessie.works/apt stable main" | sudo tee /etc/apt/sources.list.d/nessie-executor.list >/dev/null
sudo apt-get update
sudo apt-get install nessie-executor

Fedora, Rocky Linux i AlmaLinux

Użyj podpisanego repozytorium RPM na architekturze x86_64 Fedora lub Rocky Linux / AlmaLinux 9+:

sudo curl -fsSL https://packages.nessie.works/nessie-executor.repo -o /etc/yum.repos.d/nessie-executor.repo
sudo dnf install nessie-executor

Usługi działające w tle w Linuksie wymagają systemd. Pakiety zawierają środowisko uruchomieniowe; APT lub DNF instaluje Git i tmux jako zależności.

Executor dla Windows

Zainstaluj podpisany samodzielny executor przez WinGet:

winget install --exact --id UnlikeOtherAI.NessieExecutor

Otwórz Nessie Executor z menu Start lub z zasobnika. Nowe połączenia z zespołami działają na koncie Windows, na którym jesteś zalogowany. Instalator dostarcza też niezależnego nadzorcę usługi działającej na koncie usługowym. Interaktywne programy terminalowe działają tylko w połączeniu z sesją użytkownika, gdzie dostępne są ich dane logowania.

Sparuj zespół

Uruchom CLI na swoim zwykłym koncie, bez sudo:

nessie-executor login --api nessie --workspace "/path/to/work"

Dla własnego serwera Nessie zastąp nessie jego adresem API HTTPS. Dodaj zespół w desktopowym executorze uruchamia ten sam proces.

Skopiuj ośmiocyfrowy kod wyświetlony na komputerze.
W Nessie otwórz Admin › Komputery › Dodaj komputer. Wklej kod, wybierz organizację, zespół i zakres dostępu, a następnie sprawdź odcisk palca.
Potwierdź na komputerze zgłoszoną organizację i zespół.
Sprawdź, czy executor jest online, przejrzyj jego możliwości w Nessie i przyznaj dostęp zamierzonym agentom.

Kody wygasają po dziesięciu minutach i działają jeden raz. Powtórz login lub Dodaj zespół, aby sparować kolejny zespół. Każde połączenie ma własny klucz maszyny, foldery, reguły poleceń i usługę startową.

nessie-executor teams
nessie-executor permissions --executor <executor-id>
nessie-executor permissions --executor <executor-id> --allow-all --deny "git push *"
nessie-executor permissions --executor <executor-id> --allow "git *,pnpm *"

Wszystkie polecenia są domyślnie dozwolone, z zastrzeżeniem strukturalnych kontroli bezpieczeństwa; lokalna lista zablokowanych wygrywa z listą dozwolonych. Uprawnienia do folderów i poleceń są przechowywane wyłącznie na tym komputerze i nie mogą być zmieniane przez Nessie. Nessie kontroluje, które osoby i agenci mogą korzystać z połączenia w obrębie zespołu. Przed zmianą uprawnień zatrzymaj lokalnego demona, a potem uruchom go ponownie.

Agenci mogą też uruchamiać Codex, Gemini, Claude, powłokę lub dowolny inny zainstalowany program w interaktywnym terminalu na tym komputerze, o ile pozwalają na to te reguły poleceń; nic innego nie jest skonfigurowane. Takie programy muszą być już zainstalowane i zalogowane na tym samym koncie, a macOS i Linux wymagają tmux. Program terminalowy ma dostęp konta systemowego, a jego folder nie jest piaskownicą. Uruchamianie w piaskownicy (command.run) wymaga osobno środowiska gościa.

Uruchamianie, status i aktualizacje

Interaktywne login włącza automatyczne uruchamianie po potwierdzeniu parowania. Na macOS agent launchd uruchamia ten zespół, gdy się zalogujesz. W Linuksie usługa użytkownika systemd oraz włączona opcja lingering utrzymują połączenie po wylogowaniu i restarcie.

nessie-executor status
nessie-executor enable <executor-id>
nessie-executor disable <executor-id>

disable zatrzymuje usługę bez usuwania jej parowania i uprawnień. Dla sesji na pierwszym planie najpierw wyłącz jej usługę, a następnie użyj nessie-executor daemon --executor <executor-id>. Parowania utworzone z jawnym --state-dir działają pod nadzorem na pierwszym planie.

Dzienniki CLI na Macu znajdują się w ~/Library/Logs/NessieExecutor/<executor-id>.log. Dzienniki Linuksa są dostępne przez journalctl --user -u nessie-executor@<executor-id>.

Aktualizuj za pomocą menedżera pakietów:

brew upgrade nessie-executor
sudo apt-get update && sudo apt-get install --only-upgrade nessie-executor
sudo dnf upgrade nessie-executor

W Windows użyj winget upgrade --exact --id UnlikeOtherAI.NessieExecutor. Po aktualizacji uruchom ponownie każdą usługę CLI poleceniami disable, a następnie enable. Klucze parowania CLI i lokalne uprawnienia znajdują się w ~/.local/state/nessie-executor/. Aplikacje desktopowe przechowują stan w katalogu danych aplikacji na koncie użytkownika. Oba leżą poza zainstalowanym pakietem, więc aktualizacje je zachowują.

Aby usunąć oprogramowanie, wyłącz każdą usługę CLI albo wyłącz ustawienie logowania w aplikacji i zamknij ją, a następnie odinstaluj tym samym menedżerem pakietów. Odinstalowanie zachowuje stan parowania. W Nessie Rozłącz lub Usuń executor, aby cofnąć dostęp; samo usunięcie plików lokalnych nie usuwa rekordu serwera.

Szczegóły lokalnej konfiguracji znajdziesz w lokalnych ustawieniach.