콘텐츠로 이동
안채

안채 설치

안채는 macOS Apple Silicon, Linux x86_64, Windows x64용 판을 제공합니다.

Windows 판은 코드 서명을 붙이기 전인 체험판입니다.

기본 방법은 설치 스크립트입니다. 파일을 직접 내려받아 설치할 수도 있습니다.

설치

섹션 제목: “설치”

macOS나 Linux에서 다음 명령을 실행합니다.

터미널 창
curl -fsSL https://get.dcode-labs.com/install.sh | sh

Windows에서는 PowerShell에서 다음 명령을 실행합니다.

터미널 창
irm https://get.dcode-labs.com/install.ps1 | iex

스크립트는 설치 전에 다음을 확인합니다.

  • 새 판 정보의 서명과 만료 시각
  • 설치 파일의 크기와 SHA-256
  • macOS 앱의 게시자와 공증

하나라도 어긋나면 기존 설치를 건드리지 않고 멈춥니다. 설치된 판보다 낮은 판으로는 내려가지 않습니다.

설치 위치

섹션 제목: “설치 위치”
시스템 위치 권한
macOS /Applications, 쓸 수 없으면 ~/Applications 불필요
Linux /opt/anchae sudo

Windows는 %LOCALAPPDATA%\Programs\Anchae 폴더에 설치합니다. 관리자 권한은 필요 없습니다.

Linux 배포판이 비특권 사용자 namespace를 막아 두었으면 스크립트가 chrome-sandbox 파일에 SUID를 설정합니다.

환경 변수

섹션 제목: “환경 변수”

환경 변수는 파이프 뒤, sh 앞에 붙입니다.

터미널 창
curl -fsSL https://get.dcode-labs.com/install.sh | ANCHAE_CHANNEL=beta sh
변수 설명
ANCHAE_CHANNEL 채널. stable(기본) 또는 beta
ANCHAE_INSTALL_DIR 설치 폴더. macOS 전용. 기본은 이미 설치된 폴더, 없으면 /Applications, 쓸 수 없으면 ~/Applications
ANCHAE_ORIGIN https 미러 주소. 서명 키는 그대로 확인
ANCHAE_ALLOW_DOWNGRADE 1이면 낮은 판도 허용

Windows에서는 같은 PowerShell 창에서 변수를 먼저 정한 뒤 설치 명령을 실행합니다.

터미널 창
$env:ANCHAE_CHANNEL = 'beta'
irm https://get.dcode-labs.com/install.ps1 | iex

/Applications 폴더와 ~/Applications 폴더에 모두 설치본이 있으면 스크립트가 멈춥니다. 갱신할 폴더는 ANCHAE_INSTALL_DIR 환경 변수로 지정합니다.

직접 내려받기

섹션 제목: “직접 내려받기”

시스템에 맞는 파일은 받기 페이지에서 내려받습니다. 체크섬 파일은 https://get.dcode-labs.com/anchae/stable/sums/<판>-<BUILD>/SHA256SUMS 주소에 있습니다.

대상 파일
macOS Apple Silicon anchae-<판>-<BUILD>-macos-arm64.dmg
Linux x86_64 anchae-<판>-<BUILD>-linux-x64.tar.xz
Windows x64 anchae-<판>-<BUILD>-windows-x64-setup.exe
체크섬 SHA256SUMS

내려받은 파일의 체크섬을 SHA256SUMS 파일과 대조합니다.

Windows는 내려받은 설치 파일을 실행합니다. Windows의 PC 보호 창이 뜨면 추가 정보를 누른 뒤 실행을 누릅니다. 코드 서명을 붙이기 전이라 뜨는 안내입니다.

Linux는 묶음을 푼 폴더에서 다음 명령을 실행합니다.

터미널 창
sudo ./install.sh

Ubuntu 24.04 기본 설정처럼 비특권 사용자 namespace를 막아 둔 배포판이면 다음 명령을 실행합니다.

터미널 창
sudo ./install.sh --setuid-sandbox

확인

섹션 제목: “확인”

다음 명령으로 설치된 판을 확인합니다.

터미널 창
anchae --version

판과 BUILD 번호가 한 줄로 나옵니다. 명령을 찾지 못하면 터미널을 다시 열고 PATH 환경 변수를 확인합니다. macOS 설치 스크립트는 ~/.local/bin 폴더에 명령을 만듭니다.

macOS에서 dmg 파일을 직접 받아 설치했다면 명령이 만들어지지 않습니다. 앱 안의 실행 파일을 전체 경로로 실행합니다. update, channel 명령도 같은 경로로 실행합니다.

터미널 창
/Applications/anchae.app/Contents/MacOS/anchae --version

앱은 다음과 같이 엽니다.

  • macOS: 설치 스크립트가 끝에 출력한 open 명령. 기본 위치는 open /Applications/anchae.app
  • Linux: 앱 메뉴의 Anchae
  • Windows: 시작 메뉴의 Anchae

업데이트

섹션 제목: “업데이트”

앱이 시작 5분 뒤와 그 뒤 24시간마다 업데이트 서버에서 새 판을 확인해 알려 줍니다. 설정의 정보 탭에서 업데이트 방식을 끔으로 바꾸면 연결하지 않습니다. 보내는 값은 통신과 개인정보 쪽에 있습니다.

Windows에서는 설치 명령을 다시 실행해도 새 판으로 업데이트됩니다.

명령으로도 업데이트할 수 있습니다.

터미널 창
anchae update

베타 채널로 바꿉니다.

터미널 창
anchae channel set beta

안정 채널로 돌아갑니다.

터미널 창
anchae channel set stable

제거

섹션 제목: “제거”

macOS는 설치한 폴더의 anchae.app 앱을 지웁니다. 기본 위치는 /Applications 또는 ~/Applications 폴더입니다. 설치 스크립트로 설치했다면 ~/.local/bin/anchae 파일도 지웁니다.

Linux는 다음 명령을 실행합니다.

터미널 창
sudo /opt/anchae/install.sh --uninstall

Windows는 설정의 앱 목록에서 Anchae를 제거합니다.

사용자 데이터는 남습니다. Windows는 %LOCALAPPDATA%\DcodeLabs\Anchae, macOS는 ~/Library/Application Support/DcodeLabs/Anchae, Linux는 ~/.config/DcodeLabs/Anchae 폴더에 있습니다.

요구 사항

섹션 제목: “요구 사항”
시스템 조건
macOS 13 이상, Apple Silicon
Linux x86_64, glibc 2.34 이상. Ubuntu 22.04, Debian 12 이상. musl 미지원
Windows x64. Arm64 PC에서는 x64 판이 에뮬레이션으로 실행

Linux에서 실행에 필요한 라이브러리가 빠져 있으면 설치 스크립트가 그 이름을 알려 줍니다. 최소 설치한 시스템에는 배포판별로 다음 패키지가 필요합니다.

배포판 설치할 패키지
Ubuntu 24.04 libnss3 libatk-bridge2.0-0t64 libcups2t64 libdrm2 libgbm1 libxkbcommon0 libxcomposite1 libxdamage1 libxfixes3 libxrandr2 libasound2t64 libpango-1.0-0 libcairo2 libdbus-1-3
Ubuntu 22.04, Debian 12 Ubuntu 24.04 목록에서 t64 접미사를 뺀 이름
Fedora nss atk at-spi2-atk cups-libs libdrm mesa-libgbm libxkbcommon libXcomposite libXdamage libXfixes libXrandr alsa-lib pango cairo dbus-libs
Arch nss atk at-spi2-core libcups libdrm mesa libxkbcommon libxcomposite libxdamage libxfixes libxrandr alsa-lib pango cairo dbus

글꼴 설정이 전혀 없는 최소 시스템에서는 앱이 실행되지 않습니다. 이런 시스템에는 글꼴 패키지도 설치합니다.

설치 스크립트에는 curl, awk, openssl, sed, grep 명령이 필요합니다. Linux는 xz 명령도 필요합니다.

snap으로 설치한 curl 명령은 임시 폴더에 쓰지 못해 설치 스크립트가 멈춥니다. 다음 명령으로 바꾼 뒤 다시 실행합니다.

터미널 창
sudo snap remove curl
sudo apt install curl

문제가 생기면

섹션 제목: “문제가 생기면”

설정의 정보 탭에서 문의용으로 복사 단추를 누르면 판과 시스템 정보가 복사됩니다. 이 내용과 증상을 적어 support@dcode-labs.com 주소로 보냅니다.

보안 문제는 공개 저장소에 올리지 말고 security@dcode-labs.com 주소로 보냅니다.