Question 1

예약된 Appwrite 함수가 localhost에 대한 'connection refused' 오류로 실패하는 이유는 무엇인가요?

Accepted Answer

자체 호스팅 Appwrite 1.9.0에서는 스케줄된 함수가 실제 Appwrite 도메인 대신 https://localhost/v1에 연결을 시도할 수 있습니다. 그 이유는 스케줄러 컨테이너에 _APP_DOMAIN 환경 변수가 없기 때문입니다. 해결 방법: docker-compose.yml을 편집하고 'appwrite-task-scheduler-functions' 및 'appwrite-task-scheduler-executions' 서비스에 다음 환경 변수를 추가하세요: _APP_DOMAIN, _APP_DOMAIN_FUNCTIONS, _APP_DOMAIN_SITES, _APP_CONSOLE_DOMAIN, _APP_OPTIONS_FORCE_HTTPS, _APP_MIGRATION_HOST, _APP_CONSOLE_SCHEMA. 그런 다음 'docker compose up -d'를 실행하여 적용합니다. 이렇게 하면 스케줄된 실행이 올바른 엔드포인트를 사용하게 됩니다. 향후 릴리스에서 이러한 변수를 기본적으로 전파하는 영구적인 수정이 이루어질 예정입니다.

Question 2

Cloudflare SMTP 사용 시 Appwrite 이메일 타임아웃 'SMTP connect() failed' 오류 해결 방법

Accepted Answer

이 문제는 Swoole의 `SWOOLE_HOOK_SSL` 플래그가 Appwrite의 메일 워커에서 `ssl://` 스트림을 손상시키기 때문에 발생합니다 (Swoole 5.1.7 + PHP 8.3.17 + OpenSSL 3.3.3). 연결이 30초 동안 멈춘 후 EOF를 반환하므로, PHPMailer는 `SMTP connect() failed` / `Called QUIT without being connected` 오류를 보고합니다. Appwrite 1.7.x에 대한 해결 방법: 두 워커 파일 모두에서 `SWOOLE_HOOK_SSL`도 제외하도록 훅 플래그를 패치합니다: ``` MSG= MAIL= # Backup originals docker cp $MSG:/usr/src/code/src/Appwrite/Platform/Workers/Messaging.php ./Messaging.php.bak docker cp $MAIL:/usr/src/code/src/Appwrite/Platform/Workers/Mails.php ./Mails.php.bak # Apply patch: SWOOLE_HOOK_ALL ^ SWOOLE_HOOK_TCP ^ SWOOLE_HOOK_SSL docker exec $MSG sed -i 's/SWOOLE_HOOK_ALL ^ SWOOLE_HOOK_TCP)/SWOOLE_HOOK_ALL ^ SWOOLE_HOOK_TCP ^ SWOOLE_HOOK_SSL)/' /usr/src/code/src/Appwrite/Platform/Workers/Messaging.php docker exec $MAIL sed -i 's/SWOOLE_HOOK_ALL ^ SWOOLE_HOOK_TCP)/SWOOLE_HOOK_ALL ^ SWOOLE_HOOK_TCP ^ SWOOLE_HOOK_SSL)/' /usr/src/code/src/Appwrite/Platform/Workers/Mails.php docker restart $MSG $MAIL ``` 되돌리려면 .bak 파일을 `docker cp`로 다시 복사하고 재시작하세요. 참고: 이 문제는 `Messaging.php`(96번째 줄)와 `Mails.php`(53번째 줄) 모두에 영향을 미치므로, 수정하지 않으면 인증/비밀번호 복구 이메일도 작동하지 않습니다. 메인테이너에 따르면 Appwrite가 더 이상 PHPMailer를 사용하지 않기 때문에 main 브랜치에서는 이 문제가 수정되었으므로, 업그레이드가 영구적인 해결책입니다.

Question 3

Appwrite Sites에 Next.js 모노레포를 배포할 때 발생하는 "mv: can't rename '/usr/local/build/next.config.*': No such file or directory" 오류를 해결하는 방법

Accepted Answer

이 오류는 Next.js 앱이 저장소 루트가 아닌 모노레포 하위 디렉터리(예: `./apps/web`)에 위치할 때 SSR 번들링 중에 발생합니다. Open-runtimes가 앱의 하위 디렉터리가 아닌 빌드 루트(`/usr/local/build/`)에서 `next.config.*`를 찾았습니다. 이 문제는 open-runtimes PR #575(open-runtimes/open-runtimes#575)에서 수정되었으므로, 업데이트된 런타임으로 사이트를 다시 배포하세요. 모노레포의 올바른 빌드 설정은 다음과 같습니다: 루트 디렉터리를 `./`로 설정하고(bun/npm이 워크스페이스 종속성을 해결할 수 있도록), 출력 디렉터리를 `./apps/web/.next`로 설정하며, Next.js 앱보다 먼저 워크스페이스 종속성을 빌드하는 빌드 단계를 포함하세요.

Question 4

생성 후 Appwrite SDK README에 잘못된 서버 버전이 표시되는 문제를 어떻게 해결하나요?

Accepted Answer

배너는 스펙의 실제 info.version(예: 2.0.0) 대신 --version 스펙 폴더 이름(예: 1.9.x)에서 잘못 가져온 것입니다. 이는 PR #14305에서 수정되었습니다: SDKs::getServerVersion()은 info.version을 파싱하여 major.minor.x로 축소합니다. 예를 들어 2.0.0 → 2.0.x, 2.4.3 → 2.4.x와 같습니다. Static-spec SDK는 계속 --version을 사용합니다. SDK 생성기를 병합된 수정 사항으로 업데이트한 다음 SDK를 재생성하고 릴리스하세요. 이미 게시된 README에 대한 임시 해결 방법으로 서버 버전 배너를 수동으로 수정하세요.

Question 5

봇 가입을 차단하기 위해 Appwrite 사용자 등록에 CAPTCHA(reCAPTCHA, hCaptcha, Turnstile)를 추가하는 방법은?

Accepted Answer

Appwrite는 아직 네이티브 CAPTCHA 통합을 지원하지 않습니다(기능 요청 #5384가 아직 열려 있습니다). Appwrite Function을 사용하는 공식 우회 방법은 다음과 같습니다:

1. Appwrite Console에서 Auth > Security로 이동하여 'Users Limit'을 1로 설정합니다. 이렇게 하면 모든 클라이언트 측 계정 생성이 차단되므로 봇이 API를 통해 직접 등록할 수 없습니다.
2. 클라이언트 측 가입 양식에 CAPTCHA 위젯(Cloudflare Turnstile, hCaptcha 또는 reCAPTCHA)을 추가합니다.
3. 클라이언트로부터 CAPTCHA 토큰과 함께 이메일, 비밀번호, 이름을 받는 Appwrite Function을 만듭니다.
4. 함수 내부에서 시크릿 키를 사용해 제공업체의 siteverify 엔드포인트(예: https://challenges.cloudflare.com/turnstile/v0/siteverify 또는 https://hcaptcha.com/siteverify)에 대해 토큰을 검증합니다.
5. 검증이 통과한 경우에만 Appwrite Server SDK와 API 키를 사용하여 users.create()를 호출해 계정을 생성하고, 그렇지 않으면 요청을 거부합니다.

주의 사항: Users Limit을 1로 설정하면 모든 클라이언트 측 가입이 비활성화되므로, (역시 사용자를 생성하는) 최초 OAuth/SSO 로그인도 영향을 받을 수 있으며 마찬가지로 함수를 통해 처리해야 합니다.

Appwrite

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트