요약 Discourse Captcha 플러그인은 로컬 가입 양식에 CAPTCHA 챌린지 지원을 추가하며, hCaptcha와 reCAPTCHA를 포함한 여러 제공업체를 지원합니다.
설치 가이드 이 플러그인은 Discourse 코어에 번들로 제공됩니다 . 별도로 설치할 필요가 없습니다.
Captcha | Discourse - Civilized Discussion
지원되는 제공업체 이 플러그인은 다음 CAPTCHA 제공업체를 지원합니다:
hCaptcha — 월 최대 100만 건의 요청까지 무료 티어가 있는 프라이버시 중심의 CAPTCHA 서비스.reCAPTCHA — Google의 CAPTCHA 서비스.
두 제공업체 모두 **사이트 키(site key)**와 **비밀 키(secret key)**가 필요하며, 제공업체 대시보드에서 이를 발급받아 플러그인 설정에 입력해야 합니다.
설정
enable_local_logins 사이트 설정이 활성화되어 있어야 합니다. 로컬 로그인이 비활성화되어 있으면 플러그인이 작동하지 않습니다.
hCaptcha
hcaptcha.com 을 방문하여 계정을 생성하세요. 사이트 트래픽에 맞는 플랜을 선택합니다. 설정 과정에서 Sitekey 와 Account Secret 이 생성됩니다.
Discourse 관리자 패널에서 관리자 → 플러그인 → 설치됨 → Captcha 설정 으로 이동하거나, 사이트 설정에서 captcha를 검색하세요.
discourse_captcha_provider를 hcaptcha로 설정합니다.
Sitekey 를 hcaptcha_site_key 설정에, Account Secret 을 hcaptcha_secret_key 설정에 복사합니다.
discourse_captcha_enabled 설정을 통해 플러그인을 활성화합니다.
reCAPTCHA
google.com/recaptcha 를 방문하여 Google 계정으로 로그인합니다. 새 사이트를 등록하여 Site Key 와 Secret Key 를 발급받습니다.
Discourse 관리자 패널에서 관리자 → 플러그인 → 설치됨 → Captcha 설정 으로 이동하거나, 사이트 설정에서 captcha를 검색하세요.
discourse_captcha_provider를 recaptcha로 설정합니다.
Site Key 를 recaptcha_site_key 설정에, Secret Key 를 recaptcha_secret_key 설정에 복사합니다.
discourse_captcha_enabled 설정을 통해 플러그인을 활성화합니다.
Discourse hCaptcha에서 업그레이드 이 플러그인은 이전의 Discourse hCaptcha 플러그인을 대체합니다. 이미 hCaptcha를 사용하고 있었다면 설정이 자동으로 유지되므로 키를 다시 입력할 필요가 없습니다.
17개의 좋아요
dax
11월 22, 2024, 8:01오후
19
It seems that you’re using a plugin, theme, or theme component that is interfering with the hCaptcha plugin. Try using safe mode by disabling the themes to start, and see if the plugin works then.
5개의 좋아요
thank you for your response. we solved it with csp policy fix. but it was not opt for our site so we had to remove it and place in other security checks.
2개의 좋아요
We have made a fix for this, if you want to give it a try it should work with out any issues now
2개의 좋아요
tobiaseigen
12월 29, 2024, 7:38오후
22
Bundling more popular plugins with Discourse core . If you are self-hosting and use the plugin, you need to remove it from your app.yml before your next upgrade.
2개의 좋아요
이 플러그인은 확장된 범위를 반영하기 위해 Discourse hCaptcha 에서 Discourse Captcha 로 이름이 변경되었습니다. 이제 hCaptcha 와 reCAPTCHA 를 모두 지원하며, 향후 추가 제공업체를 수용할 수 있는 아키텍처가 갖춰져 있습니다.
첫 번째 게시글에는 두 제공업체에 대한 전체 설정 절차가 업데이트되었습니다.
사용자에게 변경된 사항:
hCaptcha 를 사용 중이셨다면 추가 조치가 필요하지 않습니다. 사이트 키, 시크릿 키 및 활성화 상태가 모두 자동으로 유지됩니다.사이트 설정 키가 captcha_ 접두사를 사용하도록 업데이트되었습니다(예: hcaptcha_site_key 대신 captcha_site_key). 이는 업그레이드 시 자동으로 마이그레이션됩니다.
자체 호스팅 사이트 : 재빌드 전에 app.yml에서 구형 discourse-hCaptcha git clone 줄을 제거하십시오. 자세한 내용은 첫 번째 게시글을 참조하세요.
8개의 좋아요
one1
7월 22, 2026, 3:10오전
28
Juan_David_Martínez:
자체 호스팅 사이트 : 재빌드하기 전에 app.yml에서 오래된 discourse-hCaptcha git clone 줄을 제거하세요. 자세한 내용은 첫 번째 게시물을 참고하세요.
이 부분이 이해가 잘 안 됩니다. 이 내용은 플러그인이 코어에 번들링되기 전부터 자체 설치하여 업그레이드를 하지 않은 사용자들에게만 해당되는 건가요?
이 작업을 위해 수고하셨습니다!
1개의 좋아요
네, 이는 자체 호스팅을 사용하는 사용자들에게만 영향을 미칩니다. 캡처를 사용 중이고 영향이 있을 수 있다고 생각되면 app.yml 파일에서 discourse-hCaptcha를 검색하세요. 해당 항목이 존재하면 해당 줄을 삭제하고 Discourse를 다시 빌드하세요.
1개의 좋아요
Lilly
7월 22, 2026, 2:48오후
30
코어에 1년 동안 번들링되어 있어 app.yml에 넣을 필요도 없습니다. 제가 사용 중인데 잘 작동합니다. 관리자->플러그인에서 활성화하기만 하면 됩니다.
3개의 좋아요
one1
7월 22, 2026, 3:02오후
31
Lilly:
1년 전부터 코어에 번들링되어 왔어요
맞아요. 저는 셀프 호스팅을 하고 있고 지난달에 활성화했어요.
셀프 호스팅을 하면서 1년 동안 업데이트를 하지 않은 경우에만 문제가 됩니다. 그렇지 않았다면 업그레이드할 때 오류가 발생했을 거라고 생각해요.
2개의 좋아요
그럼 괜찮아요. 당신의 경우 캡차 플러그인은 항상 번들링되어 있었으니, 할 일이 없어요
1개의 좋아요
우리 회사에서 호스팅을 이용하고 계신가요? 이 플러그인은 Pro, Business, Enterprise 플랜에서 사용할 수 있습니다. Captcha | Discourse - Civilized Discussion
비밀 키는 항상 비공개로 유지하세요.
This plugin is now bundled with Discourse core as part of 
