Synology NAS에 Overleaf 설치하기 > 자유게시판

[Synology NAS에 Overleaf 설치하기]

Overleaf 커뮤니티 에디션 v3.5.7 설치 가이드
Docker와 Portainer를 사용한 설치 방법을 안내드립니다.

▶ 사전 준비사항

1. Docker가 설치된 Synology NAS
2. Portainer 설치됨
3. synology.me 와일드카드 인증서
4. SMTP 설정이 완료된 Gmail 계정 (또는 다른 SMTP 서버 정보)

▶ 설치 과정

[1단계] 환경 준비
File Station에서 아래 폴더들을 생성하세요. (모두 소문자로 작성)

/docker/overleaf/
/docker/overleaf/configdb/
/docker/overleaf/db/
/docker/overleaf/redis/

[2단계] 리버스 프록시 설정

1. 제어판 → 로그인 포털 → 고급 → 리버스 프록시로 이동
2. 새 리버스 프록시 생성:
- 이름: Overleaf
- 소스:
  * 프로토콜: HTTPS
  * 호스트 이름: overleaf.yourname.synology.me
  * 포트: 443
  * HSTS 활성화 체크
- 대상:
  * 프로토콜: HTTP
  * 호스트 이름: localhost
  * 포트: 7643
3. 사용자 지정 헤더 탭에서 WebSocket 추가하기

[3단계] 시스템 설정

1. HTTP/2 활성화
- 제어판 → 네트워크 → 연결
- "HTTP/2 활성화" 체크 후 적용

2. HTTP 압축 활성화
- 제어판 → 보안 → 고급
- "HTTP 압축 활성화" 체크 후 적용

[4단계] Overleaf 스택 배포

1. Portainer에 로그인
2. 새 스택 생성 (이름: overleaf)
3. 아래 설정을 복사해서 붙여넣기 (※ 괄호 안의 내용은 본인 정보로 수정)

------------------- 여기서부터 복사 -------------------
version: '3.9'
services:
    overleaf:
     restart: on-failure:5
     image: sharelatex/sharelatex:3.5.7
     healthcheck:
      test: curl -f http://localhost:80/ || exit 1
     container_name: Overleaf
     depends_on:
       mongo:
         condition: service_healthy
       redis:
         condition: service_healthy
     ports:
         - 7643:80
     stop_grace_period: 60s
     volumes:
         - /volume1/docker/overleaf:/var/lib/sharelatex
     environment:
      SHARELATEX_APP_NAME: Overleaf Community Edition
      SHARELATEX_MONGO_URL: mongodb://mongo/sharelatex
      SHARELATEX_REDIS_HOST: redis
      REDIS_HOST: redis
      ENABLED_LINKED_FILE_TYPES: project_file,project_output_file
      ENABLE_CONVERSIONS: true
      EMAIL_CONFIRMATION_DISABLED: false
      SHARELATEX_ADMIN_EMAIL: [Gmail 주소 입력]
      TEXMFVAR: /var/lib/sharelatex/tmp/texmf-var
      SHARELATEX_SITE_URL: https://overleaf.yourname.synology.me
      SHARELATEX_NAV_TITLE: [원하는 제목 입력]
      SHARELATEX_EMAIL_SMTP_HOST: smtp.gmail.com
      SHARELATEX_EMAIL_SMTP_PORT: 587
      SHARELATEX_EMAIL_SMTP_USER: [Gmail 주소 입력]
      SHARELATEX_EMAIL_SMTP_PASS: [Gmail 앱 비밀번호 입력]
      SHARELATEX_EMAIL_SMTP_TLS_REJECT_UNAUTH: true
      SHARELATEX_EMAIL_SMTP_IGNORE_TLS: false
      SHARELATEX_EMAIL_FROM_ADDRESS: [Gmail 주소 입력]
      SHARELATEX_EMAIL_SMTP_LOGGER: true

    mongo:
     restart: on-failure:5
     image: mongo:4.4
     container_name: Overleaf-DB
     expose:
            - 27017
     volumes:
        - /volume1/docker/overleaf/db:/data/db
        - /volume1/docker/overleaf/configdb:/data/configdb
     healthcheck:
       test: echo 'db.stats().ok' | mongo localhost:27017/test --quiet
       interval: 10s
       timeout: 10s
       retries: 5

    redis:
      restart: on-failure:5
      image: redis
      mem_limit: 256m
      mem_reservation: 50m
      cpu_shares: 768
      security_opt:
       - no-new-privileges:true
      healthcheck:
       test: ["CMD-SHELL", "redis-cli ping || exit 1"]
      container_name: Overleaf-REDIS
      expose:
       - 6379
      volumes:
       - /volume1/docker/overleaf/redis:/data
      environment:
       TZ: [시간대 입력 (예: Asia/Seoul)]
------------------- 여기까지 복사 -------------------

[5단계] 관리자 계정 생성

1. Portainer에서 Overleaf 컨테이너의 터미널 접속
2. 아래 명령어 실행 (이메일 주소 변경 필수)
cd /var/www/sharelatex; grunt user:create-admin --email=본인이메일주소

3. 생성된 활성화 링크 복사

[6단계] 설치 완료 및 초기 설정

1. 복사한 활성화 링크로 접속
2. 관리자 비밀번호 설정
3. 첫 프로젝트 생성
4. 이메일 주소 인증

★ 주의사항

1. 대괄호([]) 안의 내용은 반드시 본인의 정보로 변경해야 합니다.
2. Overleaf 이미지 크기가 약 3GB이므로 충분한 시간 여유를 가지고 설치하세요.
3. 모든 폴더명은 반드시 소문자로 생성해야 합니다.
4. 이메일 기능을 사용하려면 SMTP 설정이 정확해야 합니다.

■ 문제 해결 방법

문제가 발생하면 아래 사항들을 차례로 확인하세요:

1. Portainer에서 컨테이너 로그 확인
2. 환경 변수 설정값 확인
3. 포트 접근 가능 여부 확인
4. SMTP 설정 정확성 확인