기본 질문
Q01: Ayakaleaf Pro는 무료 체험판인가요? 라이선스가 필요한가요?
Q01: Ayakaleaf Pro는 무료 체험판인가요? 라이선스가 필요한가요?
Q02: Ayakaleaf Pro에는 Overleaf Server Pro의 모든 기능이 포함되어 있나요?
Q02: Ayakaleaf Pro에는 Overleaf Server Pro의 모든 기능이 포함되어 있나요?
Q03: Overleaf Server Pro의 비용은 얼마인가요?
Q03: Overleaf Server Pro의 비용은 얼마인가요?
Q04: Overleaf Server Pro에 GitHub Sync나 AI 기능이 포함되지 않은 이유는 무엇인가요?
Q04: Overleaf Server Pro에 GitHub Sync나 AI 기능이 포함되지 않은 이유는 무엇인가요?
Q05: Ayakaleaf Pro는 안전하고 신뢰할 수 있나요?
Q05: Ayakaleaf Pro는 안전하고 신뢰할 수 있나요?
Q06: Ayakaleaf Pro는 장기적으로 유지 관리되나요?
Q06: Ayakaleaf Pro는 장기적으로 유지 관리되나요?
Q07: Ayakaleaf Pro는 라이선스를 준수하나요?
Q07: Ayakaleaf Pro는 라이선스를 준수하나요?
Q08: 프로젝트 이름이 Ayakaleaf Pro인 이유는 무엇인가요?
Q08: 프로젝트 이름이 Ayakaleaf Pro인 이유는 무엇인가요?
Q09: Ayakaleaf Pro는 최근 AI로 만들어진 LaTeX 에디터들과 무엇이 다른가요?
Q09: Ayakaleaf Pro는 최근 AI로 만들어진 LaTeX 에디터들과 무엇이 다른가요?
Q10: GitHub 저장소 ayaka-notes/overleaf-pro는 어떻게 되었나요?
Q10: GitHub 저장소 ayaka-notes/overleaf-pro는 어떻게 되었나요?
ayaka-notes/overleaf-pro 링크와 Git 원격 저장소를 새 이름으로 리디렉션합니다. Docker 이미지는 ghcr.io/ayaka-notes/overleaf-pro라는 이름을 그대로 유지하므로 config/overleaf.rc나 config/version을 변경할 필요가 없습니다.기능
Q01: Ayakaleaf Pro는 어떤 기능을 제공하나요? 새 기능을 요청할 수 있나요?
Q01: Ayakaleaf Pro는 어떤 기능을 제공하나요? 새 기능을 요청할 수 있나요?
Q02: 몇 가지 기능을 직접 개발했습니다. PR을 제출할 수 있나요? 반드시 수락되나요?
Q02: 몇 가지 기능을 직접 개발했습니다. PR을 제출할 수 있나요? 반드시 수락되나요?
Q03: 특정 기능은 어떻게 구성하나요?
Q03: 특정 기능은 어떻게 구성하나요?
Q04: Python Runner에서 사용할 수 있는 Python 라이브러리는 무엇인가요?
Q04: Python Runner에서 사용할 수 있는 Python 라이브러리는 무엇인가요?
pip로 설치한 패키지나 그 밖의 패키지는 사용할 수 없습니다. 서버에서 구성할 것은 없습니다.Q05: 맞춤법 검사로 일본어나 중국어를 검사할 수 있나요?
Q05: 맞춤법 검사로 일본어나 중국어를 검사할 수 있나요?
Q06: 플러그인을 추가할 수 있나요?
Q06: 플러그인을 추가할 수 있나요?
services/web/modules에 있는 모듈로, Docker 이미지에 빌드되어 포함되며 이 문서의 설정으로 활성화됩니다. 직접 기능을 추가하려면 소스 코드에 모듈을 추가하고 자체 이미지를 빌드하세요.배포
Q01: Ayakaleaf Pro는 k8s에서의 분산 배포를 지원하나요?
Q01: Ayakaleaf Pro는 k8s에서의 분산 배포를 지원하나요?
Q02: 수천 명의 사용자에게 서비스할 때 가용성을 어떻게 보장할 수 있나요?
Q02: 수천 명의 사용자에게 서비스할 때 가용성을 어떻게 보장할 수 있나요?
Q03: 배포나 마이그레이션을 도와줄 수 있나요?
Q03: 배포나 마이그레이션을 도와줄 수 있나요?
Q04: https://example.com/overleaf처럼 URL 하위 경로에서 Ayakaleaf Pro를 호스팅할 수 있나요?
Q04: https://example.com/overleaf처럼 URL 하위 경로에서 Ayakaleaf Pro를 호스팅할 수 있나요?
https://overleaf.example.com과 같은 전용 도메인 또는 하위 도메인을 사용하세요.Q05: Windows나 macOS에서, 또는 Toolkit 없이 Ayakaleaf Pro를 실행할 수 있나요?
Q05: Windows나 macOS에서, 또는 Toolkit 없이 Ayakaleaf Pro를 실행할 수 있나요?
docker-compose.yml은 제공하지 않습니다. Toolkit이 사용하는 Compose 구성을 보려면 Toolkit 디렉터리에서 bin/docker-compose config를 실행하세요.Q06: Ayakaleaf Pro를 어떻게 제거하나요?
Q06: Ayakaleaf Pro를 어떻게 제거하나요?
bin/docker-compose down으로 컨테이너를 중지하고 삭제합니다.- 데이터를 삭제합니다. 기본적으로 데이터는 Toolkit의
data/디렉터리에 있습니다.config/overleaf.rc에서OVERLEAF_DATA_PATH,MONGO_DATA_PATH,REDIS_DATA_PATH또는GIT_BRIDGE_DATA_PATH를 변경했다면 해당 디렉터리도 삭제하세요. 이 작업은 되돌릴 수 없으므로, 데이터가 필요할 수 있다면 먼저 백업하세요. - Toolkit 디렉터리를 삭제합니다.
docker images로 확인할 수 있는 Docker 이미지를 삭제합니다:ghcr.io/ayaka-notes/overleaf-pro, git-bridge 이미지,mongo,redis및 TeX Live 이미지.
Q07: Ayakaleaf Pro를 어떻게 중지, 시작 또는 재시작하나요?
Q07: Ayakaleaf Pro를 어떻게 중지, 시작 또는 재시작하나요?
bin/stop은 모든 컨테이너를 중지하고,bin/start는 다시 시작합니다. 컨테이너가 유지되므로 사용자는 로그인 상태를 유지합니다.bin/up -d는 컨테이너를 생성하고 백그라운드에서 시작합니다.config/variables.env,config/overleaf.rc또는config/version을 변경한 후에 실행하세요. 구성이 변경된 컨테이너를 다시 생성하며, 그때서야 변경 사항이 적용됩니다.bin/stop과bin/start는 변경 사항을 적용하지 않습니다.bin/docker-compose restart sharelatex는 구성 변경 사항을 적용하지 않고 Overleaf 컨테이너만 재시작합니다.
bin/up이 컨테이너를 다시 생성할 때마다 사용자가 로그아웃된다면 OVERLEAF_SESSION_SECRET을 설정하세요. 환경 변수의 Q&A를 참조하세요.Q08: OAuth 콜백 URL은 어디에 입력하나요?
Q08: OAuth 콜백 URL은 어디에 입력하나요?
config/variables.env에 콜백 설정이 없습니다. Ayakaleaf Pro는 모든 콜백 URL을 OVERLEAF_SITE_URL로부터 구성하여 공급자에 전송하며, 공급자는 애플리케이션에 등록된 URL과 일치하지 않으면 이를 거부합니다. 따라서 공급자에만 등록하고, OVERLEAF_SITE_URL을 사용자가 여는 주소로 설정하면 됩니다.OVERLEAF_SITE_URL을 새 도메인 등으로 변경하면 모든 공급자에서도 URL을 업데이트하세요. 그렇지 않으면 연결이 실패합니다.Q09: 데이터는 어디에 저장되며, 디스크 공간은 얼마나 필요한가요?
Q09: 데이터는 어디에 저장되며, 디스크 공간은 얼마나 필요한가요?
data/ 디렉터리에 저장됩니다: data/overleaf(프로젝트 파일, 기록 및 컴파일 출력), data/mongo, data/redis. 사용자가 1000명 미만인 인스턴스에서는 정기적인 백업과 함께 로컬 디스크를 사용하는 것을 권장합니다.Ayakaleaf Pro 이미지는 약 5 GB를 차지합니다. 소개에 있는 최소 40 GB는 Sandboxed Compiles를 위한 것으로, texlive-full 이미지는 각각 약 28 GB를 차지합니다. Sandboxed Compiles를 사용하지 않으면 컴파일은 sharelatex 컨테이너 안에서 TeX Live basic 스킴과 latexmk, texcount, synctex, etoolbox, xetex만으로 실행되므로 많은 프로젝트가 패키지 누락으로 실패합니다. 그 후 data/ 디렉터리는 프로젝트와 그 기록에 따라 커집니다. du -sh data/*로 확인하세요.Q10: Windows에서 Ayakaleaf를 24시간 계속 실행할 수 있나요?
Q10: Windows에서 Ayakaleaf를 24시간 계속 실행할 수 있나요?
restart: always 정책을 유지하고, AC 전원 사용 시 자동 절전 및 최대 절전 모드를 비활성화하세요. 화면은 꺼져도 되며, 노트북 덮개 동작은 별도의 설정입니다. bin/up -d 이후 Ubuntu 터미널을 닫아도 분리(detached) 모드로 실행 중인 컨테이너는 중지되지 않습니다. Docker Desktop을 종료하거나, 엔진을 일시 중지하거나, wsl --shutdown을 실행하면 서비스가 중단됩니다.Docker Desktop의 Resource Saver는 Windows 절전과 다릅니다. 실행 중인 컨테이너가 없을 때 적용되므로, 실행 중인 Ayakaleaf 스택은 아무도 편집하지 않는다고 해서 유휴 상태가 되지 않습니다. Windows를 재부팅한 후에는 로그인 시 시작 설정이 있더라도 누군가 로그인해야 합니다. 확인 사항과 복구 단계는 인스턴스 가용성 유지를 따르세요. 가용성이 대화형 데스크톱 로그인에 의존해서는 안 되는 경우에는 Linux를 권장합니다.Q11: Docker Desktop에서 가상화가 비활성화되어 있다고 표시됩니다. Hyper-V가 필요한가요?
Q11: Docker Desktop에서 가상화가 비활성화되어 있다고 표시됩니다. Hyper-V가 필요한가요?
wsl --list --verbose를 확인하세요. 0x80370102와 같은 오류는 가상화, Windows 기능 또는 부팅 하이퍼바이저가 비활성화되어 있음을 의미할 수 있습니다. Microsoft와 Docker의 복구 링크가 포함된 Windows 설치 문제 해결 단계를 참조하세요. 필요한 기능을 활성화한 후 Windows를 다시 시작하세요. 시작되지 않는 Docker 엔진은 Ayakaleaf를 다시 설치해도 해결되지 않습니다.LaTeX
Q01: 사용자의 LaTeX 프로젝트 컴파일은 격리되나요? Shell Escape가 활성화되어 있나요?
Q01: 사용자의 LaTeX 프로젝트 컴파일은 격리되나요? Shell Escape가 활성화되어 있나요?
Q02: Sandbox Compiles 이미지는 신뢰할 수 있나요? 컴파일이 실패할 수 있나요?
Q02: Sandbox Compiles 이미지는 신뢰할 수 있나요? 컴파일이 실패할 수 있나요?
Q03: 프로젝트가 컴파일되지 않습니다. 문제 해결을 도와줄 수 있나요?
Q03: 프로젝트가 컴파일되지 않습니다. 문제 해결을 도와줄 수 있나요?

