SmartSFTP 사용 매뉴얼

1. 설치

요구 사항: Windows 10/11 또는 Windows Server 2016 이상(64bit). 추가 런타임 설치는 필요 없습니다.

설치 관리자로 설치 (권장)

1. SmartSFTP-Setup-1.2.0.exe 를 내려받아 실행합니다. (관리자 권한 필요)
2. 사용권 계약에 동의하고 설치 옵션을 선택합니다. (방화벽 규칙 · 트레이 자동 실행 · 바탕화면 바로가기)
3. SFTP 포트를 지정합니다. (기본 2222) 웹 관리 UI 관리자 비밀번호는 이 단계에서 함께 설정하거나 나중에 지정할 수 있습니다.
4. 설치를 마치면 서비스가 등록·시작되고 트레이 아이콘이 실행됩니다.

설치 관리자가 자동으로 처리하는 항목:

• 프로그램 파일 설치 (C:\Program Files\SmartSFTP\)
• 기본 설정 생성 및 지정한 포트 적용
• Windows 서비스 "SmartSFTP Server" 등록 + 시작 (부팅 시 자동 시작)
• 방화벽 인바운드 허용 규칙 추가 (선택 시)
• 로그온 시 트레이 아이콘 자동 실행 등록 (선택 시)

설치 후에는 사용자만 추가하면 바로 사용할 수 있습니다.

smartsftp.exe useradd user1 --password 비밀번호

압축본으로 수동 설치

설치 관리자를 쓸 수 없는 환경에서는 zip을 해제하고 아래 명령을 순서대로 실행합니다. (관리자 권한 명령 프롬프트)

smartsftp.exe config init          :: 기본 설정 파일 생성
smartsftp.exe useradd user1 --password 비밀번호
smartsftp.exe install              :: Windows 서비스 등록 (자동 시작)
smartsftp.exe start                :: 서비스 시작

설정·데이터는 C:\ProgramData\SmartSFTP\ 에 저장되므로 실행 파일 폴더를 옮겨도 설정은 유지됩니다.

2. 라이선스

라이선스 키를 등록하지 않으면 최초 설치일로부터 30일간 평가판으로 동작합니다. 평가 기간이 끝나면 신규 SFTP 접속이 거부되며, 이미 연결된 세션은 유지됩니다. 서비스 자체는 계속 실행되므로 키를 등록하면 즉시 정상 운영으로 돌아옵니다.

smartsftp.exe license show
smartsftp.exe license set SFTP1-xxxxx.yyyyy

:: 등록 후 서비스 재시작
smartsftp.exe stop
smartsftp.exe start

라이선스는 오프라인 서명 검증 방식으로, 인증을 위한 외부 통신이 전혀 없습니다. 폐쇄망에서도 그대로 동작합니다. 라이선스 상태는 트레이 아이콘 메뉴의 "라이선스 정보"에서도 확인할 수 있습니다.

3. 트레이 아이콘

알림 영역(작업 표시줄 오른쪽)의 아이콘으로 서비스 상태를 확인하고 제어합니다. 설치 시 "트레이 자동 실행"을 선택했다면 로그온할 때 자동으로 실행되며, 수동 실행은 smartsftp-tray.exe 입니다.

아이콘 색상

아이콘에 마우스를 올리면 상태·수신 주소·라이선스 상태가 툴팁으로 표시됩니다. 상태는 3초마다 자동 갱신됩니다.

조작

4. 초기 설정

포트 변경

smartsftp.exe config set listen_addr 0.0.0.0:50000
smartsftp.exe stop
smartsftp.exe start

호스트키

최초 실행 시 ed25519·RSA 4096 호스트키가 자동 생성됩니다. 지문 확인:

smartsftp.exe config hostkeys

호스트키 파일(C:\ProgramData\SmartSFTP\host_ed25519, host_rsa)을 삭제하지 않는 한 키는 유지됩니다. 키가 바뀌면 모든 클라이언트에서 접속 경고가 발생하므로 서버 이전 시에는 키 파일을 함께 복사하세요.

5. 사용자 관리

사용자명은 영문자·숫자로 시작하고 . _ - 를 포함해 최대 64자입니다.

사용자 변경은 서비스 재시작 없이 즉시 반영됩니다. 각 사용자는 자신의 홈 디렉터리 밖으로 이동할 수 없습니다.

6. 서비스 운영

서비스는 부팅 시 자동 시작하며, 비정상 종료 시 5초·15초 간격으로 자동 재시작합니다.

7. 웹 관리 UI

1. 관리자 비밀번호 설정: smartsftp.exe config set webui.admin_hash 관리자비밀번호 (bcrypt 해시로 저장됨)
2. smartsftp-gui.exe 실행 → 브라우저에서 http://127.0.0.1:8443 접속 (기본 계정 admin)

웹 UI에서 사용자 추가·수정·삭제, 권한·허용 IP 설정, 서비스 시작·중지, 호스트키 지문 확인을 처리할 수 있습니다.

8. 설정 레퍼런스

설정 파일: C:\ProgramData\SmartSFTP\smartsftp.json · 현재 값 확인: smartsftp.exe config show

config set 으로 바꿀 수 있는 항목: listen_addr, webui.listen_addr, webui.admin_user, webui.admin_hash. 그 외 항목은 설정 파일을 직접 수정한 뒤 서비스를 재시작하세요. 계정별 허용 IP(ip_whitelist)와 세부 권한은 웹 UI에서 설정합니다.

9. 클라이언트 접속

표준 SFTP 클라이언트(WinSCP, FileZilla, OpenSSH sftp 등)로 접속합니다.

최초 접속 시 표시되는 호스트키 지문을 config hostkeys 결과와 대조해 승인하세요.

10. 로그·모니터링

• 파일 로그: C:\ProgramData\SmartSFTP\logs\smartsftp.log — 접속·인증·파일 작업이 JSON 한 줄씩 기록됩니다. 크기 상한 초과 시 smartsftp.log.old 로 순환됩니다.
• 이벤트로그: 이벤트 뷰어 → Windows 로그 → 응용 프로그램, 원본 SmartSFTP — 서비스 시작·중지·오류가 기록됩니다.
• 서비스 상태: smartsftp.exe status 또는 services.msc 의 SmartSFTP Server.

:: 로그 예시 — 인증 성공과 파일 업로드
{"time":"...","level":"INFO","msg":"auth success","user":"user1","ip":"10.0.0.5"}
{"time":"...","level":"INFO","msg":"file write","user":"user1","path":"/report.xlsx"}

11. 문제 해결

12. 제거

설치 관리자로 설치한 경우 설정 → 앱 → 설치된 앱에서 SmartSFTP를 제거합니다. 트레이 종료, 서비스 중지·해제, 방화벽 규칙 삭제, 자동 실행 등록 해제가 자동으로 처리됩니다.

수동 설치한 경우 아래 명령으로 서비스를 해제한 뒤 실행 파일 폴더를 삭제합니다.

smartsftp.exe stop
smartsftp.exe uninstall

어느 방식이든 설정·사용자 데이터는 보존됩니다. 완전히 지우려면 C:\ProgramData\SmartSFTP\ 폴더를 삭제하세요. 사용자 홈 디렉터리를 다른 위치로 지정했다면 해당 파일은 남습니다.