app.yml에서 Let's Encrypt 변수 이름 중 올바른 것은 무엇인가요?

지원 자체 호스팅
1

안녕하세요,

재빌드 중 다음 경고가 표시되었습니다:

“Let’s Encrypt 이메일이 설정되지 않았습니다”

하지만 제 app.yml 파일에는 이미 다음 줄이 있습니다:

LETSENCRYPT_ACCOUNT_EMAIL: myemail@example.com

제 인증서는 유효하며 발급이 건너뛴 상태입니다. 런처가 올바른 경고를 출력하고 있습니다.

무언가를 업데이트하기 전에 다음 사항을 확인해 주실 수 있을까요?

  • LETSENCRYPT_ACCOUNT_EMAIL은 오래된/레거시 변수인가요?

  • 현재 올바른 최신 변수 이름은 다음과 같은 것인가요?

letsencrypt_email:

경고를 피하고 자동 갱신이 정상적으로 작동하도록 하려면, 기존 변수를 제거하고 새 변수로 전환해야 하나요?

감사합니다!

2

지금까지의 답변에 감사드립니다. 조금 더 조사해 보고 제가 이 내용을 올바르게 이해했는지 확인하고 싶습니다.

제 설치는 처음에 ./discourse-setup을 통해 생성되었으며, app.yml의 env: 아래에 다음 항목이 추가되었습니다.

LETSENCRYPT_ACCOUNT_EMAIL: myemail@example.com

이후 Let’s Encrypt는 인증서를 발급하고 갱신하는 데 성공해 왔으며, 현재 web.letsencrypt.ssl.template.yml도 여전히 LETSENCRYPT_ACCOUNT_EMAIL 환경 변수에 의존하는 것으로 보입니다. 오늘 새로 테스트 설치를 진행했을 때 다음과 같은 일반적인 부트스트랩 출력을 확인했습니다:

I, [2025-12-07T12:29:22.272059 #1]  INFO -- : Replacing # after ssl with if [ -n "$LETSENCRYPT_ACCOUNT_EMAIL" ]; then
  if [[ ! "$LETSENCRYPT_ACCOUNT_EMAIL" =~ ([^@]+)@([^\.]+) ]]; then
    echo "LETSENCRYPT_ACCOUNT_EMAIL is not a valid email address"
    exit 1
  fi
  /usr/local/bin/configure-ssl
  exec /usr/local/bin/configure-letsencrypt
else
  echo "LETSENCRYPT_ACCOUNT_EMAIL ENV not set. Skipping Let's Encrypt setup."
fi
# after ssl in /etc/runit/1.d/install-ssl

이는 템플릿에 있는 내용과 일치합니다.

그러나 ./launcher rebuild app을 실행하면 "Let’s Encrypt 이메일이 설정되지 않았습니다"라는 경고를 받게 됩니다. 런처와 관련 문서를 읽어 본 결과, 이는 이전의 LETSENCRYPT_ACCOUNT_EMAIL 환경 변수가 아닌 병합된 설정에서 letsencrypt_email 키를 찾는 새로운 구성 검사에서 비롯되는 것 같습니다.

따라서 현재 상황은 다음과 같다고 생각합니다.

  1. Docker Let’s Encrypt 템플릿은 여전히 acme.sh와 갱신을 구동하는 환경 변수로 LETSENCRYPT_ACCOUNT_EMAIL을 사용합니다.
  2. 일부 새로운 검사(예: "Let’s Encrypt 이메일이 설정되지 않았습니다"를 출력하는 검사)는 설정에서 letsencrypt_email만 찾습니다.
  3. 이는 인증서 발급/갱신은 정상적으로 작동하면서 리빌드 시 여전히 경고가 출력되는 이유를 설명해 줍니다.

팀에서 확인받고 싶은 몇 가지 사항이 있습니다:

  1. 표준 ./discourse-setup 설치의 경우, app.yml에서 의도된 변수 이름은 여전히 LETSENCRYPT_ACCOUNT_EMAIL인가요, 아니면 이제 letsencrypt_email을 사용해야 하나요?
  2. LETSENCRYPT_ACCOUNT_EMAIL은 현재 “레거시이지만 지원되는” 상태로 간주되나요, 아니면 템플릿을 새로운 키로 마이그레이션할 계획이 있나요?
  3. 현재 LETSENCRYPT_ACCOUNT_EMAIL을 사용하고 갱신이 정상적으로 작동하는 기존 설치의 경우, 권장되는 접근 방식은 무엇인가요?
    • (a) 아무것도 하지 않고 런처 경고를 안전하게 무시하거나, 또는
    • (b) 새로운 검사를 충족하기 위해 env:에 letsencrypt_email: 항목(같은 주소로)을 추가하는 것인가요?

주요 목적은 설정이 “공식적인” 방향과 일치하도록 유지하고, 향후 Let’s Encrypt 통합이 리팩토링될 경우 예상치 못한 문제가 발생하지 않도록 하는 것입니다.

다시 한번 안내에 감사드리며, 여기에서 기대되는 사항이 무엇인지 확인해 주셔서 감사합니다.

3

그것이 중요하지 않다고 확신합니다. Let’s Encrypt는 더 이상 알림을 보내지 않습니다.