Question 1

MariaDB/MySQL에서 ProjectSend 마이그레이션 중 발생하는 "SQLSTATE[42000]: 1067 Invalid default value for 'created_at'" 오류를 해결하는 방법

Accepted Answer

`explicit_defaults_for_timestamp=OFF`일 때 `create_notifications_table` 마이그레이션이 MariaDB ≤10.9 또는 MySQL 5.7에서 실패합니다. 이는 Laravel의 strict mode가 `NO_ZERO_DATE`를 활성화하고 `created_at` TIMESTAMP 컬럼에 암묵적으로 '0000-00-00 00:00:00' 기본값이 설정되기 때문입니다. 해결 방법 (업스트림에 적용되었으며 ProjectSend 2.5.0 이후 릴리스에서 사용 가능): 마이그레이션 파일에서 `$table->timestamp('created_at');`을 `$table->timestamp('created_at')->useCurrent();`로 변경하여 해당 컬럼에 명시적 기본값을 지정한 다음, `php artisan migrate --force`를 다시 실행하십시오. 서버 측 우회 방법: my.cnf의 `[mysqld]` 아래에 `explicit_defaults_for_timestamp=ON`을 설정하고 데이터베이스 서버를 재시작하십시오 (참고: MariaDB ≤10.9에서는 글로벌 전용 변수이며 재시작이 필요합니다). 앱이 연결마다 이를 재정의하므로 서버 `sql_mode`를 변경해도 도움이 되지 않습니다. MySQL 8.0+/MariaDB ≥10.10은 영향을 받지 않습니다.

Question 2

./update.sh로 업데이트한 후 SELinux가 ProjectSend에 대한 액세스를 차단하는 문제(403/permission denied)를 해결하는 방법은?

Accepted Answer

./update.sh를 실행하면 SELinux가 모든 ProjectSend 파일을 `user_tmp_t`로 재레이블링하여, enforcing 모드에서는 httpd가 이 파일들을 읽을 수 없게 됩니다. ProjectSend 설치 폴더에서 올바른 SELinux 파일 컨텍스트를 복원하여 문제를 해결하세요:

```
cd /path/to/projectsend
restorecon -v -R .
```

파일은 다시 `httpd_sys_content_t`로 재레이블링되며(`ls -Z`로 확인 가능) httpd 접근이 즉시 복원됩니다. 이 방법은 업데이트 전에 해당 폴더의 기본 SELinux 컨텍스트가 올바르게 구성되어 있었다고 가정합니다. 메인테이너가 main 브랜치에서 이 문제를 패치했으므로, 향후 릴리스에서는 업데이트 후 수동으로 `restorecon`을 실행할 필요가 없습니다.

Question 3

왜 ProjectSend API는 속도 제한이 적용되었을 때 429 대신 HTTP 500을 반환하나요?

Accepted Answer

이는 ProjectSend 2.7.0의 알려진 버그입니다. 속도 제한이 초과되면 `app/Modules/Api/Support/ProblemDetails.php`(82번째 줄)가 예외의 헤더를 problem+json 응답에 복사합니다. Laravel의 `ThrottleRequestsException`은 `Retry-After` 및 `X-RateLimit-*` 헤더를 정수로 설정하지만, Symfony의 `ResponseHeaderBag::set()`은 `string|array|null`만 허용하므로 `TypeError`가 발생하여 의도한 429 응답이 500으로 바뀝니다. 수정 사항: 메인테이너가 `main` 브랜치에서 이 문제를 패치했으며, 2.7.0 이후의 다음 릴리스에 포함될 예정입니다. 우회 방법: (1) 최신 main 빌드 또는 다음 릴리스로 업데이트하세요. (2) `ProblemDetails.php`를 수동으로 패치하여 `$headers->set()`을 호출하기 전에 헤더 값을 문자열로 캐스팅하거나 배열로 감싸세요. (3) 클라이언트 측에서는 스로틀링이 적용된 엔드포인트(예: 분당 60회를 초과하는 `GET /api/v1/me`, 분당 20회를 초과하는 `PUT /api/v1/uploads/{id}/parts/{n}`)에서 발생하는 예기치 않은 500 오류를 속도 제한 신호로 간주하고 백오프 후 재시도하세요.

Question 4

import-orphans.php에서 경로 탐색 취약점을 수정하는 방법은?

Accepted Answer

'files[]' 매개변수를 정화하여 directory traversal을 차단하십시오. 최소 수정: '..'를 포함하는 파일명을 거부합니다 (예: if (strpos($_POST['files'][0], '../') !== false) { die('Invalid file'); }). 강력한 보호를 위해 basename()을 사용하여 경로를 제거하거나, realpath()로 검증하여 확인된 파일이 의도된 업로드 디렉토리 내에 있도록 하십시오. 보안 패치를 적용하거나 이 문제가 해결된 최신 버전으로 업데이트하십시오.

Question 5

ProjectSend을 r1945에서 r1994로 업그레이드한 후 FontAwesome 아이콘이 깨지는 이유는 무엇인가요?

Accepted Answer

이는 r1945에서 r1994로 업그레이드한 후 브라우저가 FontAwesome webfont를 로드하지 않아 모든 UI 아이콘이 깨지는 알려진 문제입니다. 영구적인 해결 방법은 r2002 이상으로 업그레이드하는 것입니다. 임시 해결 방법으로 r1945 설치본에서 폰트 파일(assets/fonts/fontawesome-webfont.*)을 복사하여 r1994의 파일을 교체합니다.

ProjectSend

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트