Guía de uso

명령줄과 고급 관리

Por ahora este capítulo solo está disponible en coreano.

준비와 안전한 확인

0.2.18 Windows ZIP에는 tastessh-cli.exe와 별칭 tssh.exe가 포함됩니다. 다른 OS는 배포 파일 구성과 실행 권한을 확인합니다. 명령을 실행할 터미널과 해당 서버·파일 접근 권한을 준비하세요. 아래 예시의 sample-server·example.invalid·demo는 설명용 값이며 자신의 허가된 대상으로 바꿉니다.

tastessh-cli --version
tastessh-cli --help
tastessh-cli connect --help

명령줄 도움말의 위치 인수와 옵션이 기준입니다. 전역 --data-file은 별도 Vault JSON 경로를 지정합니다. 실제 자료 경로를 잘못 지정하지 마세요. --debug의 출력에는 경로·접속 관련 정보가 포함될 수 있으므로 공개하기 전 검토합니다. 비밀번호·개인 키·토큰을 명령줄, 셸 기록, 예시 파일에 넣지 않습니다.

호스트·그룹·볼트

hosts·groups·vaults로 현재 자료를 확인합니다.
host-add로 호스트를 만들고 password-set 또는 host-auth/identity 관리로 인증을 준비합니다.
connect로 연결합니다. 새 서버 키는 관리자가 확인한 지문과 일치할 때만 --accept-new를 사용합니다. 변경된 키 오류를 무조건 신뢰로 우회하지 않습니다.
끝낼 때 원격 작업 상태를 확인하고 세션을 종료합니다.

tastessh-cli host-add sample-server example.invalid --username demo
tastessh-cli password-set sample-server
tastessh-cli connect sample-server

기대 결과는 저장 목록과 연결 터미널입니다. 실패하면 선택한 자료 파일·인증·호스트 키·방화벽·서버 정책을 확인합니다.

명령 묶음	제공하는 관리 기능
vaults, vault-add, vault-edit, vault-remove	볼트 목록·생성·이름 변경·확인 후 삭제
groups, group-add, group-edit, group-remove	그룹 생성·부모 그룹·사용자·포트·태그 관리
group-startup, group-sftp-path, group-identity	그룹 기본 시작 디렉터리/명령·SFTP 경로·인증 항목
group-chain, group-proxy, group-terminal-defaults	연결 체인·프록시 상속·터미널 기본값
tags, tag-add, tag-edit, tag-remove	태그 관리
hosts, recents, host-add, host-edit, host-remove	호스트 목록·검색·최근 연결·생성·편집·삭제
host-favorite, host-appearance, host-organize	즐겨찾기·색/아이콘·그룹/태그 정리
host-terminal-defaults, host-startup, host-sftp-path	호스트 터미널 표시·시작 동작·SFTP 기본 경로
host-chain, host-proxy, host-auth	점프 체인·프록시·인증 변경

시작 명령은 연결 직후 실행될 수 있으므로 운영 서버에 등록하기 전에 안전한 대상으로 확인합니다. 상속 해제·기본값 제거·교체 옵션은 각각 --help에서 확인합니다. 볼트 삭제·호스트 삭제가 서버 파일 삭제와 같은 작업은 아닙니다.

인증 항목과 비밀값

명령	용도
identities	등록된 인증 항목 확인
identity-add-password, identity-add-agent, identity-add-certificate	비밀번호·에이전트·SSH 인증서 항목
identity-generate-key, identity-import-key	관리 키 생성·기존 개인 키 가져오기
identity-install-key	허가된 대상에 공개 키 설치
identity-remove	인증 항목 제거
identity-passphrase-set/delete, identity-password-set/delete	항목 패스프레이즈·비밀번호 저장/제거
password-set/delete	호스트 비밀번호 저장/제거
proxy-password-set/delete, group-proxy-password-set/delete	호스트/그룹 프록시 비밀번호
agent-identities	SSH 에이전트의 키 목록

슬래시로 적은 set/delete는 각각 별도 명령입니다. 실제 실행 이름은 도움말에서 확인합니다. 공개 키 설치는 서버의 authorized_keys 등 인증 상태를 변경할 수 있습니다. 권한·대상과 기존 자료 보관을 확인하고 실행하세요. 비밀값 제거는 OS 저장소 접근이 필요하며 다른 호스트에 미치는 영향도 확인합니다.

연결 종류

connect: SSH 연결·인증·PTY·명령 실행 관련 옵션을 제공합니다.
mosh: SSH로 시작한 뒤 Mosh 클라이언트/서버와 UDP 연결을 사용합니다. 클라이언트와 서버의 mosh 준비, UDP 방화벽 정책, prediction 등 옵션을 확인합니다. SSH 연결 성공만으로 Mosh 지원이 준비된 것은 아닙니다.
telnet: 평문 연결이며 --confirm-plaintext의 명시적 확인이 필요합니다. 자격 증명이나 업무 데이터를 보내지 말고 승인된 격리 장비에서만 사용합니다. SSH와 같은 암호화를 제공하지 않습니다.
serial-ports·serial: 포트 열거와 장치 통신 설정입니다. 실제 장비 설정·권한·점유를 먼저 확인합니다.
local: 로컬 셸 실행입니다. OS에 설치된 셸·작업 폴더와 실행 인수를 확인합니다.
forward: <HOST> <KIND>와 바인딩·목적지 옵션으로 로컬·원격·동적 포워딩을 실행합니다. 목적지 및 바인딩 공개 범위를 확인하고 작업 후 종료합니다.

고급 엔진이 있다고 해서 같은 이름의 데스크톱 버튼이 모두 있는 것은 아닙니다.

SFTP 명령

형식은 tastessh-cli sftp <HOST> <COMMAND>입니다. 사용 권한, 방향, 현재 원격·로컬 경로를 준비합니다.

하위 명령	기능·주의
list	원격 목록, 숨김 파일 표시 옵션
get, put	다운로드·업로드, 충돌·재귀·SHA-256 검증 옵션
copy	원격 복사, 목적지 호스트 및 재귀 옵션
discard-upload, discard-download	재개 전송의 잔여 자료 정리; 대상·토큰 확인
mkdir, rename	폴더 생성·이름/경로 변경
read-link, symlink	링크 읽기·만들기; 대상 존재·권한 확인
remove, remove-dir	파일·폴더 직접 삭제; 휴지통/복구 보장 없음
chmod	원격 권한 변경; 숫자 모드·접근 정책 확인

get/put의 --resumable은 재개용 기록을 만들며 --resume은 기존 토큰을 지정합니다. 토큰·자료 파일·대상 경로를 보관하고 같은 전송인지 확인합니다. 실패했다고 새 전송을 무조건 시작하거나 잔여 임시 파일을 임의로 지우지 않습니다. --overwrite와 --keep-both 중 의도한 정책을 선택하고 --verify-sha256 적용 여부를 확인합니다. 기대 결과는 완료 상태 및 대상·해시 확인이며, 종료 코드를 무시하지 않습니다.

스니펫·로그·동기화·자료 이동

snippets: list/add/show/edit/remove, render 및 package-list/add/edit/remove. 렌더링 결과와 변수 값을 먼저 확인한 뒤 사용합니다. 비밀값은 본문에 저장하지 않습니다.
logs: status/enable/disable/list/show/review/export/remove/clear. 기록 동의·보관 정책, 호스트/내용/삭제 범위를 확인합니다. remove/clear는 되돌릴 수 없는 자료 제거일 수 있습니다.
sync: init/status/push/pull. 같은 대상과 패스프레이즈를 준비하고 상태를 확인합니다. overwrite-remote/local은 확인 없이 사용하지 않습니다.
export: native/open-ssh/csv. 호스트 자료가 포함될 수 있으므로 출력 파일 접근을 제한합니다. --overwrite는 기존 보관본을 대체할 수 있습니다.
import: native/open-ssh/csv/putty/putty-registry/moba-xterm/secure-crt/secure-crt-directory. 외부 파일 형식과 출처를 검토합니다. 지원되는 미리 보기와 --apply·--skip-existing 옵션을 확인하고 중복·교체 정책을 결정합니다. putty-registry는 Windows 환경 의존입니다. native --replace는 기존 자료를 교체할 수 있습니다.
diagnostics: status/configure/preview/send/flush. 보고 동의·미리 보기·수집처와 자동 보고를 구분합니다. 보내기/flush는 실제 전송이므로 내용을 검토하고 실행합니다.

기대 결과는 도움말에 정의된 목록·내보낸 파일·적용 요약·전송 상태입니다. 실패 시 원본을 보존하고 해당 명령의 도움말·종료 코드·권한·충돌 안내를 확인합니다. 명령 이름 목록 확인은 서버 접속이나 기능 전체의 실제 실행 검증을 뜻하지 않습니다.

Guía de uso

명령줄과 고급 관리

Por ahora este capítulo solo está disponible en coreano.

준비와 안전한 확인

tastessh-cli --version
tastessh-cli --help
tastessh-cli connect --help

호스트·그룹·볼트

hosts·groups·vaults로 현재 자료를 확인합니다.
host-add로 호스트를 만들고 password-set 또는 host-auth/identity 관리로 인증을 준비합니다.
connect로 연결합니다. 새 서버 키는 관리자가 확인한 지문과 일치할 때만 --accept-new를 사용합니다. 변경된 키 오류를 무조건 신뢰로 우회하지 않습니다.
끝낼 때 원격 작업 상태를 확인하고 세션을 종료합니다.

tastessh-cli host-add sample-server example.invalid --username demo
tastessh-cli password-set sample-server
tastessh-cli connect sample-server

기대 결과는 저장 목록과 연결 터미널입니다. 실패하면 선택한 자료 파일·인증·호스트 키·방화벽·서버 정책을 확인합니다.

명령 묶음	제공하는 관리 기능
vaults, vault-add, vault-edit, vault-remove	볼트 목록·생성·이름 변경·확인 후 삭제
groups, group-add, group-edit, group-remove	그룹 생성·부모 그룹·사용자·포트·태그 관리
group-startup, group-sftp-path, group-identity	그룹 기본 시작 디렉터리/명령·SFTP 경로·인증 항목
group-chain, group-proxy, group-terminal-defaults	연결 체인·프록시 상속·터미널 기본값
tags, tag-add, tag-edit, tag-remove	태그 관리
hosts, recents, host-add, host-edit, host-remove	호스트 목록·검색·최근 연결·생성·편집·삭제
host-favorite, host-appearance, host-organize	즐겨찾기·색/아이콘·그룹/태그 정리
host-terminal-defaults, host-startup, host-sftp-path	호스트 터미널 표시·시작 동작·SFTP 기본 경로
host-chain, host-proxy, host-auth	점프 체인·프록시·인증 변경

인증 항목과 비밀값

명령	용도
identities	등록된 인증 항목 확인
identity-add-password, identity-add-agent, identity-add-certificate	비밀번호·에이전트·SSH 인증서 항목
identity-generate-key, identity-import-key	관리 키 생성·기존 개인 키 가져오기
identity-install-key	허가된 대상에 공개 키 설치
identity-remove	인증 항목 제거
identity-passphrase-set/delete, identity-password-set/delete	항목 패스프레이즈·비밀번호 저장/제거
password-set/delete	호스트 비밀번호 저장/제거
proxy-password-set/delete, group-proxy-password-set/delete	호스트/그룹 프록시 비밀번호
agent-identities	SSH 에이전트의 키 목록

연결 종류

connect: SSH 연결·인증·PTY·명령 실행 관련 옵션을 제공합니다.
mosh: SSH로 시작한 뒤 Mosh 클라이언트/서버와 UDP 연결을 사용합니다. 클라이언트와 서버의 mosh 준비, UDP 방화벽 정책, prediction 등 옵션을 확인합니다. SSH 연결 성공만으로 Mosh 지원이 준비된 것은 아닙니다.
telnet: 평문 연결이며 --confirm-plaintext의 명시적 확인이 필요합니다. 자격 증명이나 업무 데이터를 보내지 말고 승인된 격리 장비에서만 사용합니다. SSH와 같은 암호화를 제공하지 않습니다.
serial-ports·serial: 포트 열거와 장치 통신 설정입니다. 실제 장비 설정·권한·점유를 먼저 확인합니다.
local: 로컬 셸 실행입니다. OS에 설치된 셸·작업 폴더와 실행 인수를 확인합니다.
forward: <HOST> <KIND>와 바인딩·목적지 옵션으로 로컬·원격·동적 포워딩을 실행합니다. 목적지 및 바인딩 공개 범위를 확인하고 작업 후 종료합니다.

고급 엔진이 있다고 해서 같은 이름의 데스크톱 버튼이 모두 있는 것은 아닙니다.

SFTP 명령

형식은 tastessh-cli sftp <HOST> <COMMAND>입니다. 사용 권한, 방향, 현재 원격·로컬 경로를 준비합니다.

하위 명령	기능·주의
list	원격 목록, 숨김 파일 표시 옵션
get, put	다운로드·업로드, 충돌·재귀·SHA-256 검증 옵션
copy	원격 복사, 목적지 호스트 및 재귀 옵션
discard-upload, discard-download	재개 전송의 잔여 자료 정리; 대상·토큰 확인
mkdir, rename	폴더 생성·이름/경로 변경
read-link, symlink	링크 읽기·만들기; 대상 존재·권한 확인
remove, remove-dir	파일·폴더 직접 삭제; 휴지통/복구 보장 없음
chmod	원격 권한 변경; 숫자 모드·접근 정책 확인

스니펫·로그·동기화·자료 이동

snippets: list/add/show/edit/remove, render 및 package-list/add/edit/remove. 렌더링 결과와 변수 값을 먼저 확인한 뒤 사용합니다. 비밀값은 본문에 저장하지 않습니다.
logs: status/enable/disable/list/show/review/export/remove/clear. 기록 동의·보관 정책, 호스트/내용/삭제 범위를 확인합니다. remove/clear는 되돌릴 수 없는 자료 제거일 수 있습니다.
sync: init/status/push/pull. 같은 대상과 패스프레이즈를 준비하고 상태를 확인합니다. overwrite-remote/local은 확인 없이 사용하지 않습니다.
export: native/open-ssh/csv. 호스트 자료가 포함될 수 있으므로 출력 파일 접근을 제한합니다. --overwrite는 기존 보관본을 대체할 수 있습니다.
import: native/open-ssh/csv/putty/putty-registry/moba-xterm/secure-crt/secure-crt-directory. 외부 파일 형식과 출처를 검토합니다. 지원되는 미리 보기와 --apply·--skip-existing 옵션을 확인하고 중복·교체 정책을 결정합니다. putty-registry는 Windows 환경 의존입니다. native --replace는 기존 자료를 교체할 수 있습니다.
diagnostics: status/configure/preview/send/flush. 보고 동의·미리 보기·수집처와 자동 보고를 구분합니다. 보내기/flush는 실제 전송이므로 내용을 검토하고 실행합니다.