one-box-serverlisted
Install: claude install-skill Stophyuk/solutionzip-skills
# 서버 한 대 스킬
앱마다 호스팅 프로젝트와 DB 프로젝트를 따로 두는 대신, VPS 한 대에 Caddy 하나와 앱별 compose 묶음을 올린다. 운영 스크립트는 `/srv/ops` 한 곳에, 앱은 `/srv/<app>/` 아래에 모두 같은 꼴로 둔다. `templates/`는 실제로 앱 여러 개를 돌리던 구성을 일반화한 것이다.
## 맞는지 먼저 본다
- **맞다**: 트래픽이 작은 앱이 여럿이고, 앱 수만큼 붙는 요금이 부담이다. 경보 메일(디스크 · 인증서 · 백업 · 크론)을 받고 서버에 들어가 손댈 사람이 있다.
- **안 맞다**: 무중단 · 여러 리전이 필요하다. 서버를 볼 사람이 없다. 이 템플릿에 없는 기능(Realtime · Edge Functions · 호스팅 쪽 대시보드)에 기대고 있다. 앱 하나가 서버를 거의 다 쓴다.
- 애매하면 지금 쓰는 서비스 목록 · 앱 수 · 대략의 방문 수를 묻고, 위 기준에 비춰 한 줄로 답한 뒤 진행한다.
## 구성
| 템플릿 | 서버 위치 | 하는 일 |
|---|---|---|
| `bin/dc` | `/usr/local/bin/dc` | `dc <app> <compose 인자>` — 프로젝트 이름 · 폴더 · env 파일 · compose 파일을 늘 같게 |
| `edge/` | `/srv/edge` | Caddy 하나가 모든 호스트의 TLS와 라우팅을 맡는다 |
| `ops/` | `/srv/ops/ops` | 준비 · 키 · DB · env 합치기 · 마이그레이션 · 크론 · 경보 · 감시 · 백업 · 복구 연습 · 되돌리기 |
| `app/` | 각 앱 저장소의 `deploy/`(Dockerfile은 뿌리) | 앱 compose · `deploy.sh` · `env-push.sh` · `env.fixed.example` · `db/*.sql` |
`bin/` · `edge/` · `ops/`는 비공개 ops 저장소 하나로 만들어 서버의 `/srv/ops`에 받는다. 앱 하나 = `ops/apps.conf` 한 줄(이름 · deploy 폴더 · 포트). 서버 전체 설정은 `ops/ops.conf`(시간대 · 배포 사용자 · 백업 버킷).
## 처음 세우기 — 한 단계씩 확인하고 넘어간다
1. **값부터 정해 사용자에게 보여 준다**: 올릴 앱 목록, 앱마다 호스트 이름 · 포트 · DB 터널 포트, 백업 버킷, 경보 받을 주소, ssh 별칭. 템플릿의 `app1` · `example.com` · `myserver` · `<...>`를 이 값으로 바꾼다. 확인을 받고 파일을 만든다.
2. **서버 준비**: `sudo install -d -o ubuntu -g ubuntu /srv && git clone <ops 저장소> /srv/ops` → `sudo bash /srv/ops/ops/prep.sh` → 재부팅 한 번. 스왑 · Docker · 방화벽 · 자동 보안 업데이트 · 시간대 · 폴더가 깔린다.
3. **앱마다** (앱 저장소에 `app/` 템플릿을