← 문서로 돌아가기
Linux 설치 가이드
이 가이드는 Linux 시스템에 Sokuji를 설치하는 방법을 안내합니다. Sokuji는 Debian/Ubuntu 기반 배포판용 .deb 패키지와 범용 호환성을 위한 AppImage로 제공됩니다.
Linux용 다운로드시스템 요구 사항
- Ubuntu 20.04 이상, Debian 10 이상 또는 동등한 배포판
- 64비트 프로세서
- 최소 4GB RAM (8GB 권장)
- 100MB 사용 가능한 디스크 공간
- 오디오 지원을 위한 PulseAudio 또는 PipeWire
- AI 서비스를 위한 인터넷 연결
설치 단계
단계 1: Sokuji 다운로드
공식 GitHub 릴리스 페이지를 방문하여 Linux용 Sokuji 최신 버전을 다운로드하세요.
사용 가능한 패키지
- .deb 패키지 - Debian/Ubuntu 기반 배포판용
- .AppImage - 모든 Linux 배포판을 위한 범용 패키지
- .rpm 패키지 - Fedora/RHEL 기반 배포판용 (사용 가능한 경우)
단계 2: .deb 패키지 설치 (Ubuntu/Debian)
Ubuntu, Debian 또는 그 파생 버전을 사용하는 경우 .deb 패키지를 권장합니다.
방법 1: GUI 사용
- 파일 관리자를 열고 다운로드 폴더로 이동
sokuji_*.deb파일을 더블 클릭- 열린 소프트웨어 센터에서 "설치"를 클릭
- 요청 시 비밀번호 입력
방법 2: 터미널 사용
터미널을 열고 다음 명령을 실행:
cd ~/Downloads
sudo dpkg -i sokuji_*.debsudo apt-get install -f단계 3: AppImage 설치 (범용)
AppImage는 모든 Linux 배포판에서 작동하며 설치가 필요하지 않습니다.
AppImage 설정
- 릴리스 페이지에서 AppImage 파일 다운로드
- 실행 가능하게 만들기:
chmod +x sokuji-*.AppImage - 애플리케이션 실행:
./sokuji-*.AppImage
선택사항: 시스템 통합
AppImage를 시스템과 통합하려면:
mkdir -p ~/.local/bin
cp sokuji-*.AppImage ~/.local/bin/sokuji
chmod +x ~/.local/bin/sokujisokuji를 입력하여 Sokuji를 실행할 수 있습니다.단계 4: 첫 실행 구성
Sokuji를 처음 실행할 때 구성이 필요합니다:
초기 설정
- 애플리케이션 메뉴 또는 터미널에서 Sokuji 실행
- 선호하는 인터페이스 언어 선택
- AI 제공자 구성 (OpenAI, Google Gemini 등)
- 선택한 제공자의 API 키 입력
- 마이크 및 스피커 장치 선택
- 오디오를 테스트하여 모든 것이 작동하는지 확인
이제 Sokuji를 사용할 준비가 되었습니다! 마이크 버튼을 클릭하여 실시간 번역을 시작할 수 있습니다.
문제 해결
오디오 문제
오디오 문제가 발생하는 경우:
- PulseAudio 또는 PipeWire가 실행 중인지 확인:
systemctl --user status pipewire - 오디오 권한 확인:
groups $USER에 'audio'가 포함되어야 함 - 오디오 서비스 재시작:
systemctl --user restart pipewire
권한 거부
"Permission denied" 오류가 발생하면:
sudo usermod -a -G audio $USER누락된 종속성
필요한 라이브러리 설치:
sudo apt-get update
sudo apt-get install libgtk-3-0 libnotify4 libnss3 libxss1 \
libxtst6 xdg-utils libatspi2.0-0 libdrm2 libgbm1AppImage가 실행되지 않음
AppImage가 실행되지 않으면 FUSE 설치:
sudo apt-get install fuse libfuse2sudo apt-get install libfuse2t64