참조
고급 설치
다운로드의 서명 확인, 소스에서 Ferret 빌드, 이전 버전 받기, 업데이트 방식을 다룹니다. Ferret을 설치하는 데는 이 중 어느 것도 필요하지 않습니다.
#모든 다운로드
파일은 GitHub Releases가 아니라 Cloudflare R2에서 제공되며, 최근 10개 버전만 보관됩니다. 다운로드 페이지에 그 모든 버전이 나열되어 있습니다.
| OS | 파일 |
|---|---|
| macOS (Apple silicon / Intel) | Ferret-<version>-mac-arm64.dmg, Ferret-<version>-mac-x64.dmg |
| Windows (x64 / arm64) | Ferret-<version>-win-x64.exe, Ferret-<version>-win-arm64.exe(설치 프로그램) |
| Linux (x64) | Ferret-<version>-linux-x86_64.AppImage, Ferret-<version>-linux-amd64.deb |
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 SHA256ssh-keygen이 Good "ferret-release" signature
를 출력하지 않거나 해시가 목록에 없으면 중단하세요. Ferret의 업데이트 확인도 앱에 내장된 키로 같은 확인을 하며, 서명이 일치하지 않는 버전은 안내하지 않습니다. macOS에서는 spctl -a -vv /Applications/Ferret.app으로 Developer ID 서명과 공증도 확인할 수 있습니다. 0.3.0까지의 릴리스는 releases/<version>/manifest.json의 해시와 비교하세요.
#이전 macOS 버전
0.2.0 build 2 이하 버전의 경우: macOS가 개발자를 확인할 수 없다고 표시하면 대화 상자를 닫고 시스템 설정 → 개인정보 보호 및 보안을 열어 Ferret 메시지 옆의 그래도 열기를 클릭한 뒤 열기로 확인합니다. 앱이 "손상되었다"고 표시되면 격리 속성을 제거합니다.
xattr -dr com.apple.quarantine /Applications/Ferret.app#소스에서 빌드
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을 가져와 버전을 비교하고, 해당 버전의 SHA256SUMS 서명을 앱에 내장된 릴리스 키로 확인합니다. 새 버전이 있으면 다운로드를 클릭하세요. Ferret이 사용하는 컴퓨터용 설치 프로그램을 내려받고, 그 SHA-256이 서명된 SHA256SUMS와 일치하는지 확인한 뒤, 다운로드 폴더에 저장하고 그 위치를 보여 줍니다. 다운로드 페이지도 파일을 저장하기 전에 브라우저에서 같은 확인을 합니다. 클릭하기 전에는 아무것도 확인하지 않으며, 자동으로 설치되는 것도 없습니다.