SSH SFTP FTP 차이: 서버 접속과 파일 전송 기준 잡기

TaskFlow는 작업을 관리하는 예제 앱입니다. 이 선택 실습에서는 앱을 배포하고 서버·설정·운영 결과를 확인합니다.

Runbook은 작업 순서와 확인 항목을 적어 두는 문서입니다. 이번 단계에서는 이 파일만 추가합니다.

선택 실습: 할 일 앱에 적용하기

TaskFlow는 이 블로그에서 단계별로 만드는 할 일 앱입니다. 연재를 따라가는 분은 서버 접속·파일 전송 전후에 확인할 내용을 docs/server-access-runbook.md에 정리합니다.

SSH와 SFTP의 차이만 찾으셨다면 여기까지 읽어도 됩니다. 앱 실행·전체 코드·테스트 서버 실습이 필요할 때 아래 자료를 펼쳐보세요.

전체 프로젝트 시작·실행과 체크포인트

이 글부터 시작하는 전체 프로젝트

시작 ZIP — deploy-step-02-artifact-strategy-full-20260928을 새 폴더에 풀고, 이번 단계 완료 ZIP은 다른 폴더에 풀어 비교합니다. ZIP 안에서 package.json이 있는 프로젝트 폴더가 실행 루트입니다.

출발점은 Next.js 누적 TaskFlow와 같은 38단계 소스입니다. 홈·로그인·개인 작업 화면, 작업 추가·완료·삭제, Route Handler와 캐시 예제, 버전을 고정한 package-lock.json을 포함합니다. 이전 글의 코드를 모으지 않아도 됩니다.

이전 체크포인트

deploy-step-02-artifact-strategy에서 시작해 deploy-step-03-server-access로 이어집니다.

변경 파일과 실행 순서

이번 변경은 docs/server-access-runbook.md 추가입니다. 기존 docs/deployment-plan.md와 앱 파일은 유지합니다.

1. Node.js 24와 npm을 사용해 실행 루트에서 npm ci를 실행합니다.
2. 아래 runbook 전체 내용 또는 완료 ZIP의 같은 파일을 대조해 적용합니다.
3. npm run typecheck와 npm run build를 실행합니다. 오류가 있으면 첫 오류의 파일·명령을 기록하고 해결한 뒤 진행합니다.
4. npm run setup-auth로 일회용 로컬 학습 계정을 설정하고 npm run dev를 실행합니다. 생성된 .env.local과 입력 값은 공유하지 않습니다.

예상 동작: 홈과 로그인 화면은 공개됩니다. 로그인 전 /tasks는 로그인 화면으로 이동하고 /api/tasks는 401을 반환합니다. 로그인 후 작업 추가·완료·삭제를 확인합니다. /cache-lab의 별도 캐시 실습에는 npm run cache-api가 필요합니다.

저장 범위: 작업은 단일 Node 프로세스 메모리에 저장되며 인증은 학습용 계정 예제입니다. 서버 재시작·서버리스 인스턴스 사이의 데이터 유지는 보장하지 않습니다. 로컬 실행 확인과 실제 운영 서비스 구축을 구분합니다.

완료 체크포인트

deploy-step-03-server-access. 다음 글에는 이번 전체 완료 ZIP을 시작본으로 가져갑니다.

서버 접속 메모와 참고 파일

Runbook은 작업 순서와 확인 항목을 적어 두는 문서입니다. 이번 단계에서는 이 파일만 추가합니다. 배포 계획과 README는 참고용이며, 실행 앱은 전체 완료 ZIP에 있습니다.

서버 접속 메모와 참고 문서 3개 보기

# Server Access Runbook


## Connection
- host: 저장하지 않음
- user: 환경별 문서에서 별도 관리
- authentication: SSH key 우선
- private key: 저장소에 포함 금지


## Before upload
1. 대상 서버 확인
2. 현재 경로 확인
3. 배포 대상 경로 확인
4. 기존 파일 상태 확인


## After upload
1. 파일 존재 확인
2. owner / permission 확인
3. 서비스가 실제 경로를 읽는지 확인
4. HTTP 결과 확인


## Never commit
- private key
- password
- access token
- production secret

# TaskFlow Deployment Plan


## Build
- package manager: npm
- install: npm ci
- build: npm run build


## Primary deployment
- platform: Vercel
- environment: Production


## Alternative deployment
- Firebase Hosting: static output일 때 검토
- Firebase App Hosting: server runtime이 필요할 때 검토


## Verification
- Production URL 응답
- 주요 화면 확인
- 환경변수 확인
- 주요 route 확인
- 현재 commit 확인
- rollback 가능 여부 확인

## Runtime decision


- static-only: no
- server runtime required: yes
- reasons:
  - Route Handler
  - server-side environment variables


## Primary
Vercel Production


## Firebase alternative
App Hosting 우선 검토


## Static variant
정적 결과물로 분리할 경우 Firebase Hosting 검토

# 배포·서버 03 — deploy-step-03-server-access

이 ZIP은 배포 준비·운영 문서와 해당 회차 설정/코드 조각을 누적한 적용 자료입니다. 실행 앱 전체는 포함하지 않습니다. 기존 deploy-step-00-build-ready 프로젝트에 해당 파일을 검토하여 적용하세요. 이 ZIP 루트에서 npm ci/build를 실행하는 구조가 아닙니다.

이 자료에는 실제 배포·DNS 변경·SSH 접속·메일/알림·롤백 결과가 없습니다. 운영 작업은 독자가 본인 환경과 권한을 확인한 후 수행해야 합니다. 문서의 확인 항목은 수행할 체크리스트이며 이미 통과했다는 기록이 아닙니다.

테스트 서버가 있을 때의 실습·결과·복구 기준

전제: 자신이 관리하는 테스트 서버의 승인된 계정·경로와 신뢰할 수 있는 호스트 키 지문이 있을 때만 원격 실습을 합니다. 관리형 Vercel 배포에는 SSH 접속이 필요하지 않습니다. 비밀번호·개인키 원문은 문서와 저장소에 남기지 않습니다.

1. 명령 실행(SSH)과 파일 전송(SFTP)의 목적을 나눕니다. runbook 또는 별도 환경 문서에 호스트 별칭·계정 역할·승인된 원격 디렉터리·검증 파일 이름을 정리합니다. 실제 호스트 값과 인증 정보는 공개 저장소에 남기지 않습니다.
2. 별도 신뢰 경로로 호스트 키 지문을 확인한 뒤 SSH 접속과 SFTP의 pwd·ls를 각각 확인합니다.
3. 원격 경로와 쓰기 권한을 확인한 후 승인된 테스트 파일 하나만 전송합니다. 운영 파일 덮어쓰기는 이 연습에 포함하지 않습니다.
4. 전송 전후 파일 목록·크기를 대조하고, 복구가 필요하면 승인된 경로의 해당 테스트 파일만 정리하며 변경 이력을 기록합니다.

실패 판정: SSH 접속이 성공해도 SFTP 쓰기는 실패할 수 있습니다. Permission denied는 인증 단계인지 파일 권한 단계인지 나누고, No such file은 현재 경로와 대상 경로를 대조합니다. 호스트 키가 예상과 다르면 접속을 중단하고 관리자가 지문을 재확인해야 합니다.

검증 상태: 이 글의 TaskFlow 운영 서버 접속·파일 전송은 미확인입니다. 위 항목은 수행 기준이며, 이미 성공했다는 기록이 아닙니다.

문서·설정 체크포인트 다운로드