Q: master 브랜치에서 Cypht Docker 이미지를 빌드할 때 발생하는 "COPY <<EOF ... no source files were specified" 오류를 수정하는 방법

이 Dockerfile은 BuildKit heredoc 문법을 사용하며, 이는 레거시 `docker build` 경로에서는 지원되지 않습니다. 대신 리포지토리 루트에서 Buildx를 사용하세요: ```sh docker buildx build . --platform linux/amd64 -t dockerid/cypht:master docker ``` `dockerid/cypht:master`를 원하는 이미지 이름으로 바꾸세요. Buildx가 구성되어 있지 않은 경우, 먼저 `docker buildx create --use`로 빌더를 생성하고 선택하세요.

Q: Cypht 예약 이메일이 "Failed to authenticate to the SMTP server" 오류로 실패하고, $smtpId가 정의되지 않으며, HTML이 일반 텍스트로 전송되는 문제를 어떻게 해결하나요?

이것은 SMTP 자격 증명 문제가 아니라 Cypht 2.9.0의 예약 전송 파이프라인에 있는 버그입니다. 스케줄러는 메시지가 `X-Profile-ID` SMTP 프로필을 사용할 때 `$smtpId`를 초기화하지 않아 인증이 실패합니다. 해당 변수만 패치하면 전송이 동작할 수 있지만, 동일한 파이프라인에서 여전히 메시지를 `text/plain`으로 작성하여 HTML 태그가 노출되고 `modules/smtp/modules.php`의 1680행에 `Undefined array key 1/2`가 기록될 수 있습니다. issue #1981에 대한 수정 사항이 포함된 빌드로 Cypht/Docker 이미지를 업그레이드한 다음 컨테이너를 다시 생성하세요: `docker pull cypht/cypht:latest && docker compose up -d` (또는 `latest` 대신 수정 사항이 포함된 첫 번째 릴리스/태그를 사용하세요). 예약된 메시지가 동일한 SMTP 프로필과 `multipart/alternative`/`text/html` MIME 구조로 전송되는지 확인하세요. 즉시 업그레이드할 수 없는 경우 예약 전송 대신 즉시 전송을 사용하세요. 부분적인 `$smtpId` 패치만으로는 충분하지 않습니다.

Q: Travis CI에서 BrowserStack과 Selenium을 사용한 Safari 테스트가 왜 실패하나요?

Safari 테스트는 브라우저 창 최대화 문제로 인해 Travis에서 자주 실패하며, 이는 Selenium이나 BrowserStack 환경의 버전 차이 때문일 가능성이 높습니다. 해결 방법: 1) CI가 계속 실행되도록 Safari 테스트에 대해 'exit on error'를 비활성화합니다(이 저장소에서 수행된 방식). 2) 로컬에서 지속적으로 실패하는 5개의 테스트를 식별하고 이를 회피하는 코드를 작성합니다. 로컬 환경과 CI 환경 간의 버전을 일관되게 유지합니다.

Question 1

Cypht가 Docker에서 로그인 직후 'invalid source origin' 오류와 함께 즉시 로그아웃되는 이유는 무엇인가요?

Accepted Answer

이것은 Cypht 2.12.2의 알려진 버그로, Host와 Origin 헤더가 일치하더라도 LAN IP와 비표준 포트(예: http://192.168.1.240:8080)를 통해 Cypht에 직접 접근할 때 Origin 검증이 실패하는 문제입니다. 세션이 생성된 후 즉시 파괴됩니다.

**해결 방법:** 이 문제가 해결된 Cypht 2.13.0으로 업그레이드하세요:
```bash
docker pull cypht/cypht:2.13.0
```

**2.12.2용 우회 방법:** 환경 설정에서 Origin 검사를 비활성화하세요(인터넷에 노출되지 않는 LAN/VPN 전용 인스턴스의 경우 허용 가능):
```env
DISABLE_ORIGIN_CHECK=true
DISABLE_IP_CHECK=true
DISABLE_FINGERPRINT=false
```
그런 다음 컨테이너를 다시 시작하세요. 이 방법은 CSRF 보호 메커니즘을 비활성화하므로, 2.13.0으로 업그레이드하는 것이 권장되는 해결 방법입니다.

Question 2

Cypht Docker 컨테이너가 SQLite를 사용할 때 'Unable to connect to database' 오류로 실패하는 이유는 무엇인가요?

Accepted Answer

진입점 스크립트는 DB_HOST, DB_USER, DB_PASS가 명시적으로 설정되지 않았을 경우, DB_DRIVER=sqlite인 경우에도 기본적으로 원격 데이터베이스 연결을 확인합니다. 로컬 SQLite를 강제로 사용하려면 컨테이너 구성에서 이러한 변수를 빈 문자열로 설정하십시오: Environment=DB_HOST=, Environment=DB_USER=, Environment=DB_PASS=. 이렇게 하면 원격 연결 시도를 건너뛰고 지정된 SQLite 파일을 사용합니다.

Question 3

master 브랜치에서 Cypht Docker 이미지를 빌드할 때 발생하는 "COPY <<EOF ... no source files were specified" 오류를 수정하는 방법

Accepted Answer

이 Dockerfile은 BuildKit heredoc 문법을 사용하며, 이는 레거시 `docker build` 경로에서는 지원되지 않습니다. 대신 리포지토리 루트에서 Buildx를 사용하세요:

```sh
docker buildx build . --platform linux/amd64 -t dockerid/cypht:master docker
```

`dockerid/cypht:master`를 원하는 이미지 이름으로 바꾸세요. Buildx가 구성되어 있지 않은 경우, 먼저 `docker buildx create --use`로 빌더를 생성하고 선택하세요.

Question 4

Cypht 예약 이메일이 "Failed to authenticate to the SMTP server" 오류로 실패하고, $smtpId가 정의되지 않으며, HTML이 일반 텍스트로 전송되는 문제를 어떻게 해결하나요?

Accepted Answer

이것은 SMTP 자격 증명 문제가 아니라 Cypht 2.9.0의 예약 전송 파이프라인에 있는 버그입니다. 스케줄러는 메시지가 `X-Profile-ID` SMTP 프로필을 사용할 때 `$smtpId`를 초기화하지 않아 인증이 실패합니다. 해당 변수만 패치하면 전송이 동작할 수 있지만, 동일한 파이프라인에서 여전히 메시지를 `text/plain`으로 작성하여 HTML 태그가 노출되고 `modules/smtp/modules.php`의 1680행에 `Undefined array key 1/2`가 기록될 수 있습니다. issue #1981에 대한 수정 사항이 포함된 빌드로 Cypht/Docker 이미지를 업그레이드한 다음 컨테이너를 다시 생성하세요: `docker pull cypht/cypht:latest && docker compose up -d` (또는 `latest` 대신 수정 사항이 포함된 첫 번째 릴리스/태그를 사용하세요). 예약된 메시지가 동일한 SMTP 프로필과 `multipart/alternative`/`text/html` MIME 구조로 전송되는지 확인하세요. 즉시 업그레이드할 수 없는 경우 예약 전송 대신 즉시 전송을 사용하세요. 부분적인 `$smtpId` 패치만으로는 충분하지 않습니다.

Question 5

Travis CI에서 BrowserStack과 Selenium을 사용한 Safari 테스트가 왜 실패하나요?

Accepted Answer

Safari 테스트는 브라우저 창 최대화 문제로 인해 Travis에서 자주 실패하며, 이는 Selenium이나 BrowserStack 환경의 버전 차이 때문일 가능성이 높습니다. 해결 방법: 1) CI가 계속 실행되도록 Safari 테스트에 대해 'exit on error'를 비활성화합니다(이 저장소에서 수행된 방식). 2) 로컬에서 지속적으로 실패하는 5개의 테스트를 식별하고 이를 회피하는 코드를 작성합니다. 로컬 환경과 CI 환경 간의 버전을 일관되게 유지합니다.

Cypht

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트