‘…의 키가 아직 알려지지 않았습니다’ 또는 ‘변경됨’

AnyBucket은 모든 SFTP 서버의 호스트 키를 터미널과 같은 파일인 내 ~/.ssh/known_hosts와 대조합니다. 키가 새롭거나 바뀌었으면 묻습니다.

아직 알려지지 않은 키는 서버에 처음 연결할 때 나타나는 정상적인 경우입니다.

  1. 서버 관리자가 공개한 곳에서 서버의 지문을 찾거나 관리자에게 물어보세요. 직접 운영하는 서버라면 ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub로 지문을 출력할 수 있습니다.
  2. AnyBucket이 보여 주는 지문과 비교하세요.
  3. 일치할 때만 신뢰하세요. AnyBucket이 known_hosts에 추가하므로, 그때부터 터미널도 그 키를 알게 됩니다.

바뀐 키는 서버를 다시 구축하거나 옮긴 뒤라면 예상된 일입니다. 그렇지 않다면 연결하지 마세요. 누군가 나와 서버 사이에 끼어 있을 수 있습니다.

  1. 서버 관리자에게 키가 정말 바뀌었는지 확인하세요.
  2. 터미널에서 이전 키를 제거하세요. ssh-keygen -R example.com(연결할 때 쓰는 호스트 이름이나 주소를 사용하세요).
  3. 다시 연결하고, 위와 같이 새 지문을 확인하세요.

SFTP 키나 점프 호스트가 작동하지 않을 때

AnyBucket은 macOS에 포함된 ssh인 /usr/bin/ssh를 실행합니다. 터미널에서 ssh user@host로 되는 것은 AnyBucket에서도 됩니다. 에이전트, ~/.ssh/config(Host, IdentityFile, ProxyJump), 보안 키까지 그대로입니다.

그러니 먼저 터미널에서 같은 호스트로 시도해 보세요.

  1. 북마크와 같은 사용자 및 호스트 이름으로 ssh user@host를 실행하세요.
  2. 실패하면 ssh -v user@host를 실행해 어떤 키를 제시하고 어디에서 멈추는지 확인하세요.
  3. 터미널에서 문제를 해결하세요. ssh-add로 키를 에이전트에 추가하거나, ~/.ssh/config에서 그 호스트의 IdentityFile을 설정하거나, 배스천 호스트 뒤에 있는 호스트라면 ProxyJump 줄을 추가하세요.
  4. 터미널에서 작동하면 같은 사용자 및 호스트 이름으로 AnyBucket에서 다시 연결하세요.

자세한 내용은 SSH 키와 점프 호스트를 참고하세요.

FTPS가 연결되지 않을 때

AnyBucket은 FTPS의 TLS를 작은 Python 브리지로 처리하므로, FTPS에는 Apple Command Line Tools의 python3이 필요합니다.

  1. 터미널을 열고 python3 --version을 실행하세요.
  2. macOS가 Command Line Tools 설치를 제안하거나 명령을 찾을 수 없다고 나오면, xcode-select --install을 실행하고 안내를 따르세요.
  3. 다시 연결하세요.

자체 서명 인증서인가요? AnyBucket이 신뢰할지 한 번 묻고, 그 북마크에 대한 선택을 기억합니다. 예상하지 못한 인증서라면 신뢰하기 전에 서버 관리자에게 확인하세요.

그래도 연결되지 않나요? 서버가 FTP 포트에서 명시적 TLS를 제공하는지 확인하세요. AnyBucket은 대부분의 방화벽이 허용하는 패시브 모드로 연결합니다.

S3 호환 스토리지에 아무것도 표시되지 않거나 거부될 때

Amazon S3 이외의 스토리지에는 자체 엔드포인트가 필요하며, 많은 곳이 경로 스타일 주소를 기대합니다.

  1. 북마크를 편집하세요(또는 제공업체 전용 타일인 Cloudflare R2, Backblaze B2, Wasabi, DigitalOcean Spaces, Google Cloud Storage를 고르세요).
  2. 그 밖의 스토리지는 S3 호환을 고르고 제공업체가 알려 준 엔드포인트 URL을 설정하세요.
  3. MinIO, LocalStack 및 대부분의 자체 호스팅 스토리지에서는 경로 스타일 주소 지정을 켜세요.
  4. 액세스 키에 버킷 목록을 볼 권한이 있는지 제공업체에 확인하세요.

전송이 멈췄을 때

연결 끊김, 시간 초과, 서버 재시작 같은 일시적인 오류는 1초, 3초, 8초 후에 새 연결로 알아서 다시 시도합니다. 보통은 알아차리지도 못합니다.

그래도 실패하는 전송은 오류와 함께 다음 두 곳의 확인 필요에서 기다립니다.

  • 전송 윈도우(⌥⌘T)
  • 메뉴 막대 패널

오류를 읽고 원인(디스크 공간 부족, 서버의 권한, 만료된 암호)을 해결한 다음 다시 시도를 누르세요. 전송이 이어서 진행됩니다.

AnyBucket을 종료하거나 Mac이 재시동되어도, 중단된 전송은 앱을 다시 열면 돌아옵니다. 대기열은 ~/Library/Application Support/AnyBucket/에 저장됩니다.

알림이 오지 않을 때

  1. 시스템 설정 → 알림을 열고 AnyBucket을 찾아 알림을 허용하세요.
  2. AnyBucket에서 설정 → 알림을 여세요. macOS가 알림을 허용하는지 보여 주며, 일괄 전송 완료, 실패, 연결 끊김, 동기화 완료, 라이선스 문제 등 종류별 스위치가 있습니다.

일괄 전송 완료 알림은 AnyBucket이 백그라운드에 있거나 일괄 전송이 오래 걸렸을 때 표시되므로, 지켜보는 동안 끝나는 짧은 복사에는 알림이 오지 않습니다.

AnyBucket이 라이선스를 다시 물을 때

인터넷에 연결되지 않아도 AnyBucket은 마지막으로 라이선스 확인에 성공한 후 7일 동안 작동합니다. 그 뒤에는 다시 확인하라고 요청합니다.

  1. Mac이 온라인인지 확인한 다음 AnyBucket을 여세요. 다음 확인에서 7일이 갱신됩니다.
  2. Polar가 활성화를 거부했다면, 예를 들어 고객 포털에서 이 Mac을 제거한 경우, AnyBucket → 라이선스 관리… 메뉴를 선택해 비활성화하고 키로 다시 활성화하세요.
  3. 두 Mac이 모두 이미 활성화되어 있다면 먼저 하나를 비활성화하세요. 라이선스 및 업데이트를 참고하세요.

그래도 해결되지 않나요?

support@clevermechanisms.dev로 이메일을 보내 주세요. 모든 메시지를 읽습니다. 빠르게 답을 받으려면 다음을 포함해 주세요.

  • macOS 버전과 AnyBucket 버전(AnyBucket → AnyBucket에 관하여에서 확인)
  • 프로토콜, S3라면 제공업체
  • 무엇을 했는지, 무엇을 기대했는지, 정확한 오류 메시지
  • SFTP라면 터미널에서 ssh user@host가 작동하는지 여부

암호, 시크릿 키, 라이선스 키는 절대 보내지 마세요.