메인 콘텐츠로 건너뛰기
Ayakaleaf Pro에 관해 자주 묻는 질문에 대한 답변을 모았습니다.

기본 질문

아니요. Ayakaleaf Pro는 완전히 무료로 사용할 수 있습니다. 체험판이 아니며 라이선스도 필요하지 않습니다.
네. Ayakaleaf Pro에는 Git-Bridge 통합을 포함한 Overleaf Server Pro의 모든 기능이 포함되어 있습니다. 또한 Overleaf SaaS 플랫폼의 일부 기능도 포함되어 있습니다. 저희는 Ayakaleaf Pro를 계속 개발하고 개선하고 있습니다.
Overleaf Server Pro는 사용자당 연간 약 $300입니다. 최소 10개의 라이선스가 필요하므로 배포 비용은 연간 약 $3,000부터 시작합니다. 미국의 소규모 공공 계약에서는 사용자당 연간 약 $320–$370의 비용이 나타납니다. 따라서 Server Pro는 특히 소규모 팀에게 비쌉니다. 문서화된 구매 사례와 가격은 #information-and-price-about-overleaf-server-pro를 참조하세요.
Overleaf Server Pro는 정부 기관에서 흔히 사용됩니다. 이들은 사설 네트워크에 배포하고 접근을 엄격히 통제합니다. 민감한 데이터를 보호하기 위해 포함된 기능은 제3자 서비스와 데이터를 주고받지 않습니다. GitHub Sync, AI 또는 이와 유사한 연결 기능이 필요하다면 Overleaf는 SaaS 플랫폼 구독을 권장합니다.
Ayakaleaf Pro는 오픈 소스입니다. 저희는 Codex Security 같은 도구로 코드를 검토하여 보안과 신뢰성을 강화합니다. 제3자 데이터 동기화를 활성화하지 않으면 데이터는 사용자의 서버에 그대로 남습니다. Ayakaleaf Pro에는 데이터를 외부로 전송하는 텔레메트리가 없습니다.
저희는 이 프로젝트를 장기적으로 유지 관리하기 위해 최선을 다할 것입니다.
Ayakaleaf Pro는 커뮤니티 포크입니다. 코드와 통합된 기능은 커뮤니티 기여에서 비롯되었습니다. AGPL v3 라이선스로 배포됩니다. 배포 환경이 이 라이선스의 요구 사항을 충족하면 라이선스를 준수할 수 있습니다.
이 프로젝트는 원래 2024년에 Overleaf Pro라는 이름이었습니다. 한동안 개발이 중단되었다가 2025년 말에 재개되었습니다. 2026년 1분기에 Overleaf는 AI 기능이 포함된 구독 플랜의 이름을 Pro로 변경했습니다. 커뮤니티 피드백에서도 Overleaf Pro라는 이름이 상표 및 사칭 위험을 초래할 수 있다는 지적이 있었습니다. 사용자가 이 프로젝트를 공식 프로젝트로 오해할 수도 있었습니다.이러한 혼동을 피하기 위해 프로젝트 이름을 Ayakaleaf Pro로 변경했습니다. 이 이름은 “Ayaka-notes Overleaf Pro”로 읽을 수 있습니다. 메인테이너(ayaka라고 불러 주세요!)는 5년 이상 전인 학생 시절부터 Overleaf 커뮤니티 개발에 기여해 왔습니다. 이러한 경험이 장기적인 유지 관리 약속을 뒷받침합니다.
2026년부터 오픈 소스 커뮤니티에서는 OpenAI Prism을 비롯해 AI로 만들어진 많은 LaTeX 에디터가 출시되었습니다. Ayakaleaf Pro는 데이터와 서비스를 사용자 자신의 서버에 유지합니다. 따라서 배포와 데이터를 직접 제어할 수 있습니다.많은 실험적인 커뮤니티 에디터는 확립된 장기 유지 관리 계획이 없습니다. 제3자 LaTeX 컴파일 플랫폼도 사용자 기반이나 수익이 부족하면 운영을 중단할 수 있습니다. Ayakaleaf Pro는 모든 소스 코드를 제공하며 모든 서비스를 셀프 호스팅할 수 있게 해 줍니다. 유지 관리가 중단되더라도 기존 셀프 호스팅 서비스는 계속 실행될 수 있습니다.
프로젝트 이름 변경(Q08 참조)과 함께 ayaka-notes/ayakaleaf-pro로 이름이 바뀌었습니다. 보관되거나 대체된 것이 아니라 동일한 저장소이며, GitHub는 기존 ayaka-notes/overleaf-pro 링크와 Git 원격 저장소를 새 이름으로 리디렉션합니다. Docker 이미지는 ghcr.io/ayaka-notes/overleaf-pro라는 이름을 그대로 유지하므로 config/overleaf.rc나 config/version을 변경할 필요가 없습니다.

기능

현재 기능 목록은 문서를 확인해 주세요. 추가되기를 원하는 기능이 있다면 GitHub에 이슈(기능 요청)를 자유롭게 열어 주세요. 요청된 기능을 구현하기 위해 최선을 다하겠지만, 개발에는 시간이 걸리며 모든 기능을 즉시 제공한다고 보장할 수는 없습니다.
기여는 언제나 환영하지만 수락이 보장되지는 않습니다. 저희는 각 PR이 기반이 되는 Overleaf 코드베이스에 미치는 영향, 유지 관리 부담, 사용자에게 제공하는 가치를 기준으로 평가합니다. 가치 있는 기여는 병합하고 유지 관리하기 위해 최선을 다하겠습니다.다만 과도한 변경을 도입하는 PR, 검토되지 않았거나 충분히 이해되지 않은 AI 생성 코드(“바이브 코딩”)로 이루어진 PR, 장기적으로 유지 관리하기 어려운 기능을 추가하는 PR은 거절할 수 있습니다.
저희는 일반적으로 새 기능을 출시할 때마다 문서를 업데이트합니다. 자세한 설정 방법과 사용 가능한 환경 변수에 대한 설명은 관련 문서를 참조하세요.
Python Runner는 서버가 아니라 사용자의 브라우저에서 Pyodide 0.29.3으로 Python을 실행합니다. 코드에서 import하는 패키지는 NumPy, pandas, Matplotlib 등 Pyodide에 내장된 패키지에서 불러옵니다. pip로 설치한 패키지나 그 밖의 패키지는 사용할 수 없습니다. 서버에서 구성할 것은 없습니다.
아니요. 맞춤법 검사기에는 일본어나 중국어 사전이 없으므로 이 언어들은 맞춤법 검사 언어 목록에 없습니다. 사용자는 편집기 설정에서 프로젝트의 맞춤법 검사를 끌 수 있습니다.단어가 맞춤법 오류로 표시되지 않게 하려면 해당 단어를 마우스 오른쪽 버튼으로 클릭하고 Add to dictionary를 선택하세요. 추가된 단어는 계정에 저장되며 모든 프로젝트에 적용됩니다. 추가된 단어를 확인하거나 삭제하려면 편집기 설정을 열고 Spelling and language → Dictionary → Edit으로 이동하세요. 단어를 추가해도 새로운 맞춤법 검사 언어가 추가되지는 않습니다.
플러그인 설치 프로그램은 없습니다. 기능은 소스 코드의 services/web/modules에 있는 모듈로, Docker 이미지에 빌드되어 포함되며 이 문서의 설정으로 활성화됩니다. 직접 기능을 추가하려면 소스 코드에 모듈을 추가하고 자체 이미지를 빌드하세요.

배포

대부분의 사용자에게는 Toolkit을 사용한 배포를 권장합니다. Kubernetes 지원은 실험적입니다. Kubernetes 사용에서 하나 또는 여러 개의 레플리카로 테스트한 매니페스트를 소개하지만, 클러스터는 운영 복잡성과 유지 관리 부담을 늘립니다. Sandboxed Compiles는 Docker 소켓을 통해 컴파일 컨테이너를 생성하므로 Ayakaleaf Pro를 실행하는 모든 노드에 Docker Engine이 필요합니다. CRI-O, Podman 또는 Quadlet 구성은 제공하지 않습니다.
수평 확장 가이드를 참조하세요. 여러 Overleaf 인스턴스를 배포하고 로드 밸런서를 구성하여 트래픽을 분산할 수 있습니다.
기존 Overleaf Server Pro 인스턴스가 있다면 Ayakaleaf Pro로의 마이그레이션을 기꺼이 도와드리겠습니다. 이메일 또는 이슈로 연락해 주세요.
아니요. Ayakaleaf Pro는 도메인의 루트에서 제공되어야 합니다. https://overleaf.example.com과 같은 전용 도메인 또는 하위 도메인을 사용하세요.
네. Toolkit은 Linux, Docker Desktop을 사용하는 macOS, WSL 2 및 Docker Desktop을 사용하는 Windows에서 실행됩니다. 공유 서버 및 프로덕션 서버에는 Linux를 권장합니다. macOS 및 Windows 가이드에는 Sandboxed Compiles 설정이 포함되어 있습니다.독립형 docker-compose.yml은 제공하지 않습니다. Toolkit이 사용하는 Compose 구성을 보려면 Toolkit 디렉터리에서 bin/docker-compose config를 실행하세요.
제거 스크립트는 없습니다. Toolkit 디렉터리에서 다음을 수행하세요.
  1. bin/docker-compose down으로 컨테이너를 중지하고 삭제합니다.
  2. 데이터를 삭제합니다. 기본적으로 데이터는 Toolkit의 data/ 디렉터리에 있습니다. config/overleaf.rc에서 OVERLEAF_DATA_PATH, MONGO_DATA_PATH, REDIS_DATA_PATH 또는 GIT_BRIDGE_DATA_PATH를 변경했다면 해당 디렉터리도 삭제하세요. 이 작업은 되돌릴 수 없으므로, 데이터가 필요할 수 있다면 먼저 백업하세요.
  3. Toolkit 디렉터리를 삭제합니다.
  4. docker images로 확인할 수 있는 Docker 이미지를 삭제합니다: ghcr.io/ayaka-notes/overleaf-pro, git-bridge 이미지, mongo, redis 및 TeX Live 이미지.
Toolkit 디렉터리에서 다음을 실행하세요.
  • 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를 참조하세요.
Ayakaleaf Pro가 아니라 공급자에서 생성하는 애플리케이션에 입력합니다. 이 연동들에는 config/variables.env에 콜백 설정이 없습니다. Ayakaleaf Pro는 모든 콜백 URL을 OVERLEAF_SITE_URL로부터 구성하여 공급자에 전송하며, 공급자는 애플리케이션에 등록된 URL과 일치하지 않으면 이를 거부합니다. 따라서 공급자에만 등록하고, OVERLEAF_SITE_URL을 사용자가 여는 주소로 설정하면 됩니다.OVERLEAF_SITE_URL을 새 도메인 등으로 변경하면 모든 공급자에서도 URL을 업데이트하세요. 그렇지 않으면 연결이 실패합니다.
기본적으로 모든 데이터는 서버의 로컬 디스크, 즉 Toolkit의 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/*로 확인하세요.
네, Windows가 절전 상태로 들어가지 않고 Docker Desktop이 계속 실행되고 있다면 가능합니다. Start Docker Desktop when you sign in to your computer를 켜고, Toolkit의 restart: always 정책을 유지하고, AC 전원 사용 시 자동 절전 및 최대 절전 모드를 비활성화하세요. 화면은 꺼져도 되며, 노트북 덮개 동작은 별도의 설정입니다. bin/up -d 이후 Ubuntu 터미널을 닫아도 분리(detached) 모드로 실행 중인 컨테이너는 중지되지 않습니다. Docker Desktop을 종료하거나, 엔진을 일시 중지하거나, wsl --shutdown을 실행하면 서비스가 중단됩니다.Docker Desktop의 Resource Saver는 Windows 절전과 다릅니다. 실행 중인 컨테이너가 없을 때 적용되므로, 실행 중인 Ayakaleaf 스택은 아무도 편집하지 않는다고 해서 유휴 상태가 되지 않습니다. Windows를 재부팅한 후에는 로그인 시 시작 설정이 있더라도 누군가 로그인해야 합니다. 확인 사항과 복구 단계는 인스턴스 가용성 유지를 따르세요. 가용성이 대화형 데스크톱 로그인에 의존해서는 안 되는 경우에는 Linux를 권장합니다.
이 가이드는 WSL 2 백엔드를 사용합니다. BIOS/UEFI에서 CPU 가상화가 활성화되어 있어야 하고, Windows의 Virtual Machine Platform 기능과 정상 동작하는 WSL 2 설치가 필요합니다. 전체 Hyper-V 기능은 별도의 Docker Desktop 백엔드이며, 이 WSL 설정의 전제 조건이 아닙니다.PowerShell에서 작업 관리자 → 성능 → CPU → 가상화와 wsl --list --verbose를 확인하세요. 0x80370102와 같은 오류는 가상화, Windows 기능 또는 부팅 하이퍼바이저가 비활성화되어 있음을 의미할 수 있습니다. Microsoft와 Docker의 복구 링크가 포함된 Windows 설치 문제 해결 단계를 참조하세요. 필요한 기능을 활성화한 후 Windows를 다시 시작하세요. 시작되지 않는 Docker 엔진은 Ayakaleaf를 다시 설치해도 해결되지 않습니다.

LaTeX

Sandbox Compiles를 활성화하면 각 사용자의 컴파일은 별도의 Docker 컨테이너에서 실행되며 다른 사용자의 컴파일과 격리됩니다. Sandbox Compiles에서는 Shell Escape가 기본적으로 활성화되어 있습니다.
저희는 지난 3년간 Sandbox Compiles용 TeX Live Full 이미지를 개선해 왔습니다. 대부분의 경우 overleaf.com에서 컴파일되는 프로젝트는 Ayakaleaf Pro에서도 올바르게 컴파일됩니다. 필요한 글꼴을 사용할 수 없는 경우 해당 글꼴을 프로젝트에 직접 업로드하세요.
프로젝트를 공식 Overleaf 웹사이트에 업로드하고 읽기 전용 링크 공유를 활성화한 다음, GitHub 이슈에 해당 링크를 포함해 주세요.공식 Overleaf 웹사이트에서는 정상적으로 컴파일되지만 Ayakaleaf Pro에서는 컴파일되지 않게 만드는 버그는 조사하여 수정하겠습니다. 이 범위를 벗어나는 컴파일 문제는 지원 대상이 아닙니다.
마지막 수정일 2026년 11월 8일