Przejdź do treści
Biblioteka skilli
DevOps i chmura · Automatyzacja

vps-deploy

/vps-deploy

Wdraża małą aplikację na osobistym VPS jako usługę systemd dostępną tylko przez Tailscale, z podglądem i archiwizacją gotowych prac.

Repozytorium
stash ↗
Licencja
MIT
Ostatnia zmiana repozytorium
08.11.2026

Ocena i bezpieczeństwo

90/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść25 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
4
Skrypty
1
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 08.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 1 skrypt w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: examples/server.js

Co robi i kiedy

Wdraża małą aplikację na osobistym VPS jako usługę systemd dostępną tylko przez Tailscale, z podglądem i archiwizacją gotowych prac.

Wyzwalacze z opisu

deploy ke vpspasang di vpsjalankan sebagai servicehost thiss security posture without the owner
Oryginalny opis (EN)

Deploy a small app on a personal VPS the house way: a systemd service, bound only to the Tailscale interface, a preview port for review from a phone, and archiving of finished work to mounted cloud storage. Use when the user wants to deploy, host, or expose a project on their VPS, or says "deploy ke vps", "pasang di vps", "jalankan sebagai service", "host this". Do NOT use for production multi-tenant hosting or for changing the server's security posture without the owner's explicit go-ahead.

Jak działa

  1. The pattern
  2. Verification checklist (every deploy, in order)
  3. Change discipline
Sekcje z nagłówków SKILL.md, w oryginale · 60 linii, 487 słów
Podgląd SKILL.md
---
name: vps-deploy
description: Deploy a small app on a personal VPS the house way: a systemd service, bound only to the Tailscale interface, a preview port for review from a phone, and archiving of finished work to mounted cloud storage. Use when the user wants to deploy, host, or expose a project on their VPS, or says "deploy ke vps", "pasang di vps", "jalankan sebagai service", "host this". Do NOT use for production multi-tenant hosting or for changing the server's security posture without the owner's explicit go-ahead.
license: MIT
---

# VPS Deploy

A personal VPS earns its keep when deploying a project takes ten
minutes and undoing it takes one command. This is the deployment
pattern behind a dozen small services on one such server (dashboards,
previews, simulators), and its rules exist because each was broken
once: a service bound to the public internet by default, a process
that died with the SSH session, a preview nobody could open from a
phone.

## The pattern

1. **A folder per project** under one workspace root on the server.
   Nothing deploys from a home directory or a temp path.
2. **A systemd unit per app**, so the process is supervised,
   restarts on failure, starts on boot, and survives the shell that
   launched it. Template: `assets/app.service` in this folder.
   Long-running agent or build jobs follow the same rule: launch
   them as transient units, never as a bare backgrounded process
   (those die silently, about a minute in, with a clean log).
3. **Bind to the tailnet address only.** The service listens on the
   server's Tailscale IP, never on 0.0.0.0, unless the owner has
   explicitly decided this one is public. Private by construction
   beats private by firewall rule, because the rule can be lost and
   the bind cannot.
4. **One port per app, recorded.** Pick the next free port in the
   owner's range, write it in the project notes, and hand the owner
   the full URL (tailnet IP plus port) for review. The owner reviews
   from their phone over Tailscale; screenshots from the agent's
   browser are not the review.
5. **Disk is temporary, archive is permanent.** Server SSD space is
   a desk, not a warehouse. Finished or paused projects are archived
   to the mounted cloud storage and removed from the server; the
   archive location is written in the project notes before deletion.

## Verification checklist (every deploy, in order)

- The unit is active (`systemctl is-active <name>`) after a deliberate
  restart, not just after the first start.
- The app answers on its tailnet URL with the expected content, from
  a fresh request.
- The app does NOT answer on the server's public IP. Check it; do not
  assume the bind took.
- Logs show a clean start with no permission or path errors.
- The handover to the owner is the URL, the port, the unit name, and
  the one command that stops it.

## Change discipline

- Explain any change to the server itself (new packages, new cron
  entries, firewall or SSH changes) and get the owner's go-ahead
  before applying it. A sound idea installed unasked is still an
  unasked install; this rule exists because it happened once and the
  work had to be removed and verified gone.
- Secrets live in the service's environment file with owner-only
  permissions, never in the unit, the repo, or the chat.
- Removing a service is the full reverse: stop, disable, delete the
  unit, reload systemd, confirm the port no longer answers.
Pliki w paczce (4)
  • SKILL.md 3 KB
  • assets/app.service 1 KB
  • examples/PROOF.md 1 KB
  • examples/server.js 1 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · Edzard9/stash90MIT
wrongstack/wrongstack90MIT

Migawka bazy z 13.11.2026 · wersja paczki 8d9e918cf497 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100vps-deploy-golden-path
    Wdraża aplikację Node na VPS z właściwą kolejnością budowania, kontrolami zdrowia i wartownikiem, a także audytuje istniejące skrypty wdrożeniowe pod kątem brakujących zabezpieczeń.
  • 100claude-rc-vps-setup
    Konfiguruje Claude Code Remote Control na serwerze VPS z Linuxem, by działało całą dobę i przetrwało restart, przez jednostkę systemd i sesję tmux.
  • 96vps-provisioning
    Zakłada i utwardza nowy serwer VPS: użytkowników, dostęp, zapory i aktualizacje.
  • 100sc-sync
    Synchronizuje rsync-iem pliki z gitignore między VPS a lokalnym komputerem przez Tailscale, zawsze najpierw na sucho, a kopiowanie dopiero z flagą --apply.
  • 100host-connect
    Pomaga podłączyć własny VPS lub inną maszynę do pracy agentów albo naprawić brakujący host w team_host.
  • 100vps-panel-3xui
    Automatycznie instaluje, przywraca lub migruje panel 3x-ui na serwerze VPS przez SSH i sprawdza jego działanie.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.