scp 와 sftp 로 파일 옮기기
목표
scp 와 sftp 로 파일을 올리고 내리고, 타임스탬프를 보존하고, 체크섬으로 무결성을 확인합니다. 마지막에는 야간 업로드 작업 셋이 서로 다른 이유로 실패한 사건을 오류 줄과 실제 적용 설정으로 갈라 고칩니다.
왜 중요한가
전송이 "끝났다" 는 것과 "제대로 갔다" 는 것은 다른 말입니다. 실무에서는 항상 체크섬으로 확인합니다. scp 의 포트 옵션이 대문자 -P 라는 사실은 사소해 보이지만, ssh 는 소문자가 포트라서 실제로 자주 틀립니다. 소문자 -p 는 타임스탬프 보존이라 조용히 다른 일을 하고 넘어갑니다. 그리고 scp·sftp·rsync 는 모두 ssh 위에서 돕니다 — 그래서 전송이 실패하는 이유도 대개 전송 도구가 아니라 그 아래 층(원격 셸이 찍는 한 줄, 바뀐 호스트 키, 먼저 맞은 설정 블록)에 있습니다. 옵션을 덧대 증상을 지우면 원인은 다음 사람에게 남습니다.
이 실습에서 127.0.0.1:2222 는 다른 서버라고 생각하세요. 앞 실습에서 만든 /root/.ssh/id_labhub 키를 그대로 씁니다(없으면 1단계 정답지가 만들어 둡니다).
단계
/root/xfer/src디렉터리를 만들고 그 안에a.txt(1KB 이상),b.txt(1KB 이상),c.bin(10KB 이상) 세 파일을 만드세요.- 원격의
/root/xfer/dst/디렉터리를 만들고a.txt를 그리로 올리세요. /root/xfer/src디렉터리 전체를 원격의/root/xfer/tree/아래로 재귀 복사하세요. 결과적으로/root/xfer/tree/src/b.txt가 존재해야 합니다.- 원격의
/root/xfer/dst/a.txt를 로컬/root/xfer/back/으로 내려받으세요. /root/xfer/batch.txt에 sftp 배치 명령을 적고 실행하세요. 배치는/root/xfer/src/c.bin을 원격/root/xfer/dst/로 올려야 합니다. 실행 로그를/root/xfer/sftp.log로 저장하세요.b.txt를 타임스탬프를 보존한 채 원격/root/xfer/dst/로 복사하고, 원본과 사본의 mtime(초 단위)을 각각 한 줄씩/root/xfer/mtime.txt에 적으세요. 두 값이 같아야 합니다./root/xfer/src의 세 파일에 대한 sha256 매니페스트를 만들고,/root/xfer/dst와/root/xfer/tree/src에 도착한 파일들의 해시가 일치하는지 검증해 결과를/root/xfer/verify.txt로 저장하세요.- 사건 —
incident ss-upload-fail. 배치 계정 uploader 의 업로드 작업 셋(reports·images·backup)이 모두 실패합니다. 작업 스크립트·서버 설정은 그대로 두고, 호스트 키 확인도 끄지 않은 채 셋을 다시 성공하게 한 뒤, 작업마다 원인 코드와 증거 한 줄을/root/incident/ss-upload-fail/report.txt에 적으세요.
참고
- 원격 표기는
사용자@호스트:경로입니다. 콜론을 빠뜨리면 scp 는 조용히 로컬 복사를 합니다. - ssh 는 뒤에 명령을 붙이면 셸을 열지 않고 그 명령만 원격에서 돌립니다 — 원격 디렉터리를 미리 만들 때 씁니다.
- sftp 배치 파일에는 셸 명령이 아니라 sftp 자신의 명령(cd·put·get·bye 등)을 한 줄에 하나씩 적습니다. 한 줄이라도 실패하면 거기서 멈춥니다.
- 흔한 실수 1: 2번에서 소문자
-p를 포트로 쓰는 것. 포트가 22 로 가고 2222 는 파일 이름으로 읽힙니다. - 흔한 실수 2: 3번에서 대상 경로가 없으면 디렉터리 깊이가 달라집니다. 요구된 최종 경로를 확인하세요.
- 8번의 작업은 root 가 아니라 uploader 로 돕니다.
runuser -u uploader -- <명령>으로 같은 계정의 설정·known_hosts 를 보세요. - 사건 도구:
incident list로 낼 수 있는 사건을,incident show <이름>으로 티켓을 다시 봅니다. 같은 사건을 다시 내면 처음 고장 상태로 돌아갑니다. - 보고서
/root/incident/<이름>/report.txt— 대상마다이름: 원인코드한 줄, 그리고evidence: <관찰한 출력 한 줄>. 증거는 형식 예시가 아니라 직접 본 줄이어야 합니다.
전송할 파일 준비
/root/xfer/src 디렉터리를 만들고 그 안에 a.txt(1KB 이상), b.txt(1KB 이상), c.bin(10KB 이상) 세 파일을 만드세요.
크기가 다른 파일 세 개면 충분합니다. head 나 dd 로 만들어도 되고 base64 로 채워도 됩니다.
파일 올리기
원격의 /root/xfer/dst/ 디렉터리를 만들고 a.txt 를 그리로 올리세요.
포트 지정은 대문자 옵션입니다. 소문자는 뜻이 완전히 다르니 주의하세요.
디렉터리 통째로 올리기
/root/xfer/src 디렉터리 전체를 원격의 /root/xfer/tree/ 아래로 재귀 복사하세요. 결과적으로 /root/xfer/tree/src/b.txt 가 존재해야 합니다.
디렉터리를 보내려면 재귀 옵션이 필요합니다. 대상 경로가 없으면 미리 만들어 두세요.
내려받기
원격의 /root/xfer/dst/a.txt 를 로컬 /root/xfer/back/ 으로 내려받으세요.
원격 경로를 앞에, 로컬 경로를 뒤에 씁니다. 원격 표기는 사용자@호스트:경로 형식입니다.
sftp 배치 실행
/root/xfer/batch.txt 에 sftp 배치 명령을 적고 실행하세요. 배치는 /root/xfer/src/c.bin 을 원격 /root/xfer/dst/ 로 올려야 합니다. 실행 로그를 /root/xfer/sftp.log 로 저장하세요.
sftp 에는 명령 목록을 파일에서 읽는 옵션이 있습니다. 배치 파일에는 한 줄에 명령 하나씩 씁니다.
타임스탬프 보존
b.txt 를 타임스탬프를 보존한 채 원격 /root/xfer/dst/ 로 복사하고, 원본과 사본의 mtime(초 단위)을 각각 한 줄씩 /root/xfer/mtime.txt 에 적으세요. 두 값이 같아야 합니다.
보존 옵션은 소문자입니다. stat 으로 mtime 을 비교해 확인하세요.
무결성 검증
/root/xfer/src 의 세 파일에 대한 sha256 매니페스트를 만들고, /root/xfer/dst 와 /root/xfer/tree/src 에 도착한 파일들의 해시가 일치하는지 검증해 결과를 /root/xfer/verify.txt 로 저장하세요.
sha256sum 으로 매니페스트를 만들고 -c 로 검사합니다. 원본과 사본이 같은 이름을 가지도록 경로를 맞추면 편합니다.
사건 — 야간 업로드 셋이 모두 실패
incident ss-upload-fail 을 실행하면 티켓이 나옵니다. 배치 계정 uploader 가 서버 셋에 파일을 올리는 작업 셋(reports·images·backup)이 모두 실패합니다. 셋이 다시 성공하게 고치세요. 작업 스크립트·sftp 배치 파일(/srv/ss-upload/jobs/)과 서버 셋의 sshd 설정은 바꾸면 안 되고, 호스트 키 확인을 끄는 것도 안 됩니다. /root/incident/ss-upload-fail/report.txt 에 작업마다 reports: <코드> 처럼 한 줄씩과 evidence: <관찰한 출력 한 줄> 을 적으세요. 코드 후보: config-precedence(ssh 설정에서 앞선 블록의 값이 이긴다) · host-key-changed(known_hosts 의 호스트 키가 서버의 지금 키와 다르다) · key-permissions(개인 키 권한이 느슨해 클라이언트가 키를 버린다) · rc-output(원격 셸의 시작 파일이 출력해 전송 프로토콜이 깨진다) · wrong-port(엉뚱한 포트로 붙는다).
방향: 셋 다 「실패」 지만 오류 줄이 다르고, 고장 난 층도 다릅니다 — 받는 서버의 계정, 클라이언트가 서버를 믿는 근거, 클라이언트의 설정. 작업은 root 가 아니라 uploader 로 돌므로 같은 계정으로 재현해야 같은 설정·같은 known_hosts 를 봅니다. 도구: 작업 기록, 같은 계정으로 돌리는 ssh(runuser), 실제 적용값을 보여 주는 ssh -G, 서버가 내미는 키를 받아 지문으로 바꾸는 두 키 도구, 서버별 로그. 구체: sftp 가 「메시지가 너무 길다」 며 무엇을 확인하라고 덧붙이는지, 명령 하나만 보낸 비대화형 세션에 무엇이 찍히는지, 호스트 키 경고에 찍힌 지문과 인프라팀 목록의 지문, backup 에 실제로 적용되는 사용자 이름과 그 값을 먼저 정한 블록을 보세요.