설치

#다운로드

다운로드 페이지에서 사용하는 OS와 CPU에 맞는 파일을 받습니다. 파일은 GitHub Releases가 아니라 Cloudflare R2에서 제공되며, 최근 10개 버전만 보관됩니다.

0.1.x까지의 릴리스는 예전 이름인 MOVIE-ADE-<version>-…로 공개되었습니다. Ferret-… 이름은 0.2.0부터 사용합니다.

#다운로드 검증(서명된 SHA256SUMS)

모든 릴리스에는 SHA256SUMS 파일과 그 서명 SHA256SUMS.sig가 있습니다. 서명은 다운로드 서버와 분리해 보관하는 Ferret 릴리스 키로 만들기 때문에, 다운로드 서버의 설치 프로그램이 바뀌더라도 유효한 서명이 함께 따라올 수는 없습니다. 공개 키는 다운로드 서버에서 가져오지 않습니다. 저장소(build/release-signing/allowed_signers (새 탭에서 열림))에서 받거나 여기서 복사하세요.

[email protected] ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIEpXERU8ST0MEOIMbzoL4zShkjIrMB4++NL3xBohKAS9

지문은 SHA256:c7dvwwJQyY9qSstkmrO8JoVZ90DCaFZBAzjqV04N8zQ입니다. 같은 파일이 GitHub의 각 릴리스에도 첨부되어 있습니다. ssh-keygen(macOS, Windows 10 이상, Linux에 포함)으로 서명을 확인한 뒤, 내려받은 파일의 해시를 서명된 목록과 비교합니다.

# the download server (currently the R2 public URL; it may move to a custom domain)
BASE=https://pub-588d93b3e875464f98d6cf98dc711a0c.r2.dev
VERSION=$(curl -s $BASE/latest.json | jq -r .version)
curl -sO $BASE/releases/$VERSION/SHA256SUMS
curl -sO $BASE/releases/$VERSION/SHA256SUMS.sig

# save the public key above as allowed_signers, then:
ssh-keygen -Y verify -f allowed_signers -I [email protected] -n ferret-release -s SHA256SUMS.sig < SHA256SUMS
# → Good "ferret-release" signature for [email protected] …

# macOS
shasum -a 256 -c SHA256SUMS --ignore-missing
# Linux
sha256sum -c SHA256SUMS --ignore-missing

# Windows (PowerShell): compare with the line for your file in SHA256SUMS
Get-FileHash .\Ferret-<version>-win-x64.exe -Algorithm SHA256

ssh-keygen이 Good "ferret-release" signature를 출력하지 않거나 해시가 목록에 없으면 중단하세요. Ferret의 업데이트 확인도 앱에 내장된 키로 같은 확인을 하며, 서명이 일치하지 않는 버전은 안내하지 않습니다. macOS에서는 spctl -a -vv /Applications/Ferret.app으로 Developer ID 서명과 공증도 확인할 수 있습니다. Windows와 Linux 설치 프로그램은 아직 Microsoft나 Linux 배포판의 코드 서명을 받지 않았습니다. 0.3.0까지의 릴리스는 서명을 시작하기 전에 공개되어, releases/<version>/manifest.json에 서명되지 않은 해시만 있습니다.

#macOS

1. .dmg를 열고 Ferret.app을 /Applications로 드래그합니다.
2. 앱을 실행합니다. Developer ID로 서명되고 Apple의 공증을 받았으므로(티켓이 스테이플되어 있음) 경고 없이 열립니다.

서명을 직접 확인하려면:

spctl -a -vv /Applications/Ferret.app
# accepted
# source=Notarized Developer ID

이전 버전(0.2.0 build 2 이하)만 서명되지 않았습니다. 이 버전에서는 macOS가 개발자를 확인할 수 없다고 표시합니다. 대화 상자를 닫고 시스템 설정 → 개인정보 보호 및 보안을 열어 Ferret 메시지 옆의 그래도 열기를 클릭한 뒤 열기로 확인합니다. 앱이 "손상되었다"고 표시되면 격리 속성을 제거합니다.

xattr -dr com.apple.quarantine /Applications/Ferret.app

#Windows

1. Ferret-<version>-win-<arch>.exe를 실행합니다.
2. SmartScreen에 "Windows의 PC 보호" 화면이 나타나면 추가 정보를 클릭한 다음 실행을 클릭합니다.
3. 설치 폴더를 선택합니다. 설치 프로그램이 바탕 화면 바로 가기를 만듭니다.

#Linux

AppImage:

chmod +x Ferret-<version>-linux-x86_64.AppImage
./Ferret-<version>-linux-x86_64.AppImage

Debian / Ubuntu:

sudo apt install ./Ferret-<version>-linux-amd64.deb

deb는 ferret 패키지와 명령을 설치합니다.

Ubuntu 23.10 이상에서는 AppArmor가 Electron 샌드박스가 사용하는 사용자 네임스페이스를 제한하기 때문에, AppImage가 실행 시 샌드박스 오류로 멈출 수 있습니다. 대신 .deb를 설치하세요. 샌드박스 도우미를 설정해 줍니다.

#소스에서 빌드

Node.js 20 이상(CI와 로컬 개발은 22 사용), pnpm, git이 필요합니다.

git clone https://github.com/JapanMarketing-Dev/ferret.git
cd ferret
pnpm install          # postinstall prepares node-pty for Electron
pnpm dev              # run in development mode

설치 프로그램을 패키징하려면 다음을 실행합니다(출력은 dist/release/, 설정은 electron-builder.config.cjs). Linux 빌드는 Linux에서만 실행됩니다.

pnpm dist:mac     # dmg (arm64, x64)
pnpm dist:win     # NSIS installers (x64, arm64)
pnpm dist:linux   # AppImage + deb (x64)

build:<os>:dev 스크립트는 압축하지 않은 앱만(--dir) 만들므로 로컬 테스트에 더 빠릅니다.

Windows에서 pnpm install은 다시 빌드하지 않고 node-pty에 포함된 미리 빌드된 바이너리를 사용합니다(다시 빌드하려면 Visual Studio C++ 빌드 도구가 필요합니다). 강제로 다시 빌드하려면 ADE_FORCE_NATIVE_REBUILD=1을 설정하세요.

터미널에 node-pty를 불러올 수 없다고 표시되면 pnpm rebuild:native를 실행하세요.

#업데이트

Ferret은 자동으로 업데이트되지 않습니다. 푸터에서 업데이트를 열고 업데이트 확인을 클릭하세요. 다운로드 서버(R2)에서 latest.json을 가져와 버전을 비교하고, 다운로드 페이지로 연결합니다. 0.4.0부터는 해당 버전의 SHA256SUMS 서명도 앱에 내장된 릴리스 키로 확인하며, 서명을 검증할 수 없는 버전은 안내하지 않습니다. 클릭하기 전에는 아무것도 확인하지 않으며, 자동으로 설치되는 것도 없습니다.