서버 마련·설치
🖥️WinSCP 등 SSH 툴 사용법
서버에 접속하는 두 통로 — 명령을 입력하는 SSH(PuTTY·터미널)와 파일을 주고받는 SFTP(WinSCP) — 를 툴 선택부터 로그인·전송·문제 해결까지 안내합니다.
마지막 업데이트 2026-07-06
이 시스템을 설치·관리하려면 서버 컴퓨터에 접속할 수 있어야 합니다. 접속에는 두 가지가 있습니다 — 명령을 입력하는 SSH(PuTTY·터미널), 파일을 주고받는 SFTP(WinSCP).
목차
- SSH·SFTP 가 뭔가
- 어떤 툴을 쓰나
- 접속 정보 입력·로그인
- WinSCP 로 파일 주고받기
- PuTTY 로 명령창 접속
- 맥·리눅스 터미널
- 서버에서 nano 로 편집
- 자주 하는 작업
- 문제 해결
SSH·SFTP 가 뭔가 — 명령용 / 파일용
“내 PC 에서 멀리 있는 서버를 다루는” 두 가지 통로입니다.
| 도구 | 하는 일 |
|---|---|
| PuTTY / 터미널 (SSH) | 서버에 접속해 명령을 입력 |
| WinSCP (SFTP) | 내 PC 와 서버 사이에 파일을 끌어다 옮김 |
둘은 같은 문(포트 22)으로 들어가고 접속 정보도 같습니다. “명령용 / 파일용” 구분만 기억하면 이후에 어느 도구를 쓸지 헷갈리지 않습니다.
어떤 툴을 쓰나
운영체제와 목적에 따라 고르면 됩니다. 전부 무료입니다.
| 툴 | 플랫폼 | 용도 | 내려받기 |
|---|---|---|---|
| WinSCP | 윈도우 | 파일 주고받기(SFTP) — 그래픽으로 드래그 | winscp.net |
| PuTTY | 윈도우 | 명령창(SSH) | putty.org |
| Termius | 윈도우·맥 | 명령창+파일 올인원(초보 친화) | termius.com |
| 터미널 | 맥·리눅스 | 기본 내장 — ssh·scp 명령 | 내장(설치 불필요) |
추천 조합
윈도우: 파일은 WinSCP, 명령은 PuTTY. 맥: 터미널 하나로 둘 다.
접속 정보 입력하고 로그인
어느 툴이든 이 네 가지를 넣습니다.
| 항목 | 예시 | 설명 |
|---|---|---|
| 호스트(주소) | example.com 또는 203.0.113.10 | 서버의 도메인 또는 IP |
| 포트 | 22 | SSH 기본 포트 |
| 사용자 이름 | root · ubuntu 등 | 서버 로그인 계정 |
| 인증 방법 | 비밀번호 또는 키 | 보안상 키 권장 |
비밀번호가 화면에 안 보이는 건 정상입니다
터미널·PuTTY 에서 비밀번호를 입력하면 글자도, 점도 나타나지 않습니다. 고장이 아니라 보안 기능입니다. 정확히 입력하고 Enter 를 누르세요.
PuTTY 에서 붙여넣기는 마우스 오른쪽 버튼입니다(Ctrl+V 아님).
처음 접속하면 뜨는 보안 경고 창
서버에 처음 접속하면 “이 서버의 지문을 신뢰하시겠습니까?” 같은 경고가 뜹니다. 내가 방금 만든 내 서버가 맞다면 [예 / Accept].
비밀번호보다 “키”로 로그인하길 권장
키 방식은 훨씬 안전하고 매번 비밀번호를 넣을 필요가 없습니다.
WinSCP 로 파일 올리고 내리기 (윈도우)
왼쪽이 내 PC, 오른쪽이 서버. 원하는 쪽으로 드래그하면 전송됩니다.
- 1설치 — winscp.net 에서 내려받아 설치.
- 2새 사이트 — 실행하면 로그인 창. 파일 프로토콜은 SFTP.
- 3정보 입력 — 호스트, 포트(22), 사용자 이름. 비밀번호 또는 키.
- 4저장 & 로그인 — [저장] 하면 다음부터 두 번 클릭.
- 5파일 옮기기 — 파일을 드래그하면 업로드/다운로드.
권한 오류(Permission denied)가 날 때
/opt·/etc 같은 시스템 폴더는 관리자만 쓸 수 있어 바로 올리면 거부됩니다. 홈 폴더에 올린 뒤, PuTTY 에서 sudo mv 로 옮기는 게 안전합니다.
처음 접속 시 “호스트 키를 신뢰하겠냐”는 창이 뜨면 본인 서버가 맞을 때 [예].
PuTTY 로 명령창 접속 (윈도우)
서버에 명령을 입력하는 검은 창을 엽니다.
- 1설치 — putty.org 에서 내려받기.
- 2주소·포트 — Host Name 에 서버 주소, Port 에 22, Connection type SSH.
- 3(키 방식) 개인 키 지정 — Connection → SSH → Auth → Credentials 에서 .ppk 지정.
- 4Open — 사용자 이름을 입력하면 서버 명령창이 열립니다.
- 5세션 저장 — Saved Sessions 에 이름을 적고 [Save].
PuTTY 는 .pem 키를 바로 못 읽습니다. PuTTYgen 으로 .pem → .ppk 로 변환하면 됩니다.
맥 · 리눅스 터미널로 접속
따로 설치할 것 없이 내장 ssh·scp 명령을 씁니다.
명령창(SSH) 접속 — 예시 주소
- ssh ubuntu@example.com
- 포트가 22 가 아니면: ssh -p 2222 ubuntu@example.com
- 키 파일로 접속: ssh -i ~/.ssh/my-key ubuntu@example.com
파일 주고받기(scp)
- scp ./logo.png ubuntu@example.com:/home/ubuntu/
- scp ubuntu@example.com:/home/ubuntu/backup.sql ./
맥은 터미널(응용 프로그램 → 유틸리티)만 열면 바로 됩니다.
서버에서 파일을 직접 편집할 때 (nano)
설정 파일을 고칠 때 nano 편집기를 자주 씁니다.
- 저장 — Ctrl+O → 파일명이 뜨면 Enter
- 종료 — Ctrl+X
- 저장하지 않고 나가기 — Ctrl+X → 저장할지 물으면 N
서버의 설정 파일을 고칠 때는 먼저 원본을 내려받아 보관하는 습관을 들이세요.
운영에서 자주 하는 작업
접속이 되면 실제로 이런 일들을 합니다.
| 하고 싶은 일 | 어떤 통로 | 예시 |
|---|---|---|
| 설정 파일(.env) 고치기 | SSH 또는 SFTP | nano backend/.env |
| 로그 보기 | SSH(명령창) | docker compose logs -f backend |
| 서비스 재시작 | SSH | docker compose restart |
| 이미지·파일 올리기 | SFTP(WinSCP) | 드래그로 업로드 |
| 백업 파일 내려받기 | SFTP 또는 scp | 서버의 .sql 을 내 PC 로 |
문제 해결
| 증상 | 원인 · 해결 |
|---|---|
| 비밀번호 입력이 화면에 안 보임 | 정상(보안 기능). 그대로 입력하고 Enter |
| Connection timed out | 주소·포트 오류 또는 방화벽. 22번 포트 허용 확인 |
| Permission denied(로그인) | 사용자·비밀번호·키 불일치 |
| WinSCP 파일 업로드 Permission denied | 시스템 폴더 직접 업로드 불가 — 홈 폴더에 올린 뒤 sudo mv |
| nano 에서 못 빠져나옴 | 저장 Ctrl+O→Enter, 종료 Ctrl+X |
| PuTTY 가 키를 못 읽음 | .pem 은 PuTTYgen 으로 .ppk 변환 |