TT Lab
블로그 시작하기
배우기 러닝패스 코스

SSH 와 파일 전송

scp 와 sftp 로 파일 옮기기

TT Lab 에서 이어서 보기

목표

scp 와 sftp 로 파일을 올리고 내리고, 타임스탬프를 보존하고, 체크섬으로 무결성을 확인합니다. 마지막에는 야간 업로드 작업 셋이 서로 다른 이유로 실패한 사건을 오류 줄과 실제 적용 설정으로 갈라 고칩니다.

왜 중요한가

전송이 "끝났다" 는 것과 "제대로 갔다" 는 것은 다른 말입니다. 실무에서는 항상 체크섬으로 확인합니다. scp 의 포트 옵션이 대문자 -P 라는 사실은 사소해 보이지만, ssh 는 소문자가 포트라서 실제로 자주 틀립니다. 소문자 -p 는 타임스탬프 보존이라 조용히 다른 일을 하고 넘어갑니다. 그리고 scp·sftp·rsync 는 모두 ssh 위에서 돕니다 — 그래서 전송이 실패하는 이유도 대개 전송 도구가 아니라 그 아래 층(원격 셸이 찍는 한 줄, 바뀐 호스트 키, 먼저 맞은 설정 블록)에 있습니다. 옵션을 덧대 증상을 지우면 원인은 다음 사람에게 남습니다.

이 실습에서 127.0.0.1:2222 는 다른 서버라고 생각하세요. 앞 실습에서 만든 /root/.ssh/id_labhub 키를 그대로 씁니다(없으면 1단계 정답지가 만들어 둡니다).

단계

  1. /root/xfer/src 디렉터리를 만들고 그 안에 a.txt(1KB 이상), b.txt(1KB 이상), c.bin(10KB 이상) 세 파일을 만드세요.
  2. 원격의 /root/xfer/dst/ 디렉터리를 만들고 a.txt 를 그리로 올리세요.
  3. /root/xfer/src 디렉터리 전체를 원격의 /root/xfer/tree/ 아래로 재귀 복사하세요. 결과적으로 /root/xfer/tree/src/b.txt 가 존재해야 합니다.
  4. 원격의 /root/xfer/dst/a.txt 를 로컬 /root/xfer/back/ 으로 내려받으세요.
  5. /root/xfer/batch.txt 에 sftp 배치 명령을 적고 실행하세요. 배치는 /root/xfer/src/c.bin 을 원격 /root/xfer/dst/ 로 올려야 합니다. 실행 로그를 /root/xfer/sftp.log 로 저장하세요.
  6. b.txt 를 타임스탬프를 보존한 채 원격 /root/xfer/dst/ 로 복사하고, 원본과 사본의 mtime(초 단위)을 각각 한 줄씩 /root/xfer/mtime.txt 에 적으세요. 두 값이 같아야 합니다.
  7. /root/xfer/src 의 세 파일에 대한 sha256 매니페스트를 만들고, /root/xfer/dst 와 /root/xfer/tree/src 에 도착한 파일들의 해시가 일치하는지 검증해 결과를 /root/xfer/verify.txt 로 저장하세요.
  8. 사건 — incident ss-upload-fail. 배치 계정 uploader 의 업로드 작업 셋(reports·images·backup)이 모두 실패합니다. 작업 스크립트·서버 설정은 그대로 두고, 호스트 키 확인도 끄지 않은 채 셋을 다시 성공하게 한 뒤, 작업마다 원인 코드와 증거 한 줄을 /root/incident/ss-upload-fail/report.txt 에 적으세요.

참고

전송할 파일 준비

/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 에 실제로 적용되는 사용자 이름과 그 값을 먼저 정한 블록을 보세요.