Question 1

Cloudflare 뒤에서 XBackBone의 테마 드롭다운, 토큰 업데이트 버튼, 파일 삭제/숨기기 컨트롤이 작동하지 않는 이유는 무엇인가요?

Accepted Answer

이 문제는 XBackBone이 `http://` 기본 URL로 설치된 상태에서 Cloudflare가 사이트를 HTTPS로 제공하고 HTTP를 HTTPS로 리디렉션할 때 발생합니다. 브라우저가 웹 인터페이스 요청을 차단하거나 잘못된 스킴으로 보내기 때문에 드롭다운과 작업 버튼이 반응하지 않는 것처럼 보입니다.

XBackBone 구성에서 기본 URL을 업데이트하여 문제를 해결하세요:

1. `config/config.php`(또는 설치 환경에서 사용하는 생성된 `config.php` 경로)를 엽니다.
2. `base_url`을 HTTP에서 HTTPS로 변경합니다. 예시:

```php
'base_url' => 'https://your-domain.example',
```

3. 파일을 저장합니다.
4. Cloudflare에서 SSL/TLS 및 리디렉션 설정이 동일한 HTTPS 도메인을 제공하는지 확인합니다.
5. 브라우저를 강력 새로 고침(Ctrl+F5)하거나 브라우저 캐시를 지웁니다.

이 변경 후에는 테마 선택기, 사용자 토큰 업데이트 버튼, 갤러리/테이블의 삭제/숨기기 작업이 정상적으로 작동할 것입니다. 임시 해결 방법으로는 CLI에서 `php ./bin/theme Lumen` 명령으로 테마를 설정하거나, 토큰 생성 문제를 우회하기 위해 새 사용자를 만들 수 있지만, 이러한 방법은 근본적인 URL 불일치를 해결하지 못합니다.

Question 2

100MB보다 큰 파일 업로드가 내 사이트가 Cloudflare 뒤에 있을 때 실패하는 이유는 무엇인가요?

Accepted Answer

무료 Cloudflare 요금제는 요청당 업로드를 100MB로 제한합니다. 이를 우회하려면 Cloudflare DNS 설정에서 서브도메인에 대해 Cloudflare 프록시를 비활성화하세요(DNS 레코드를 주황색 구름에서 회색 구름으로 설정). 그러면 트래픽이 서버로 직접 라우팅되어 크기 제한이 해제됩니다. XBackBone에서는 변경이 필요 없습니다.

Question 3

XBackBone 3.8.0 업로드가 saveMedia ArgumentCountError와 함께 100%에서 멈추는 문제를 해결하는 방법은?

Accepted Answer

`app/Controllers/UploadController.php` 파일의 62번째 줄을 수정하고, 누락된 네 번째 `code` 인자를 `saveMedia()`에 전달하세요:

```php
$response = $this->saveMedia($response, $file, $user, param($request, 'code'));
```

이 문제는 PR #625에서 수정되었습니다. 가능한 경우 XBackBone 3.8.1 이상으로 업그레이드하는 것이 영구적인 해결 방법입니다.

이후 업로드가 `Impossible to create the root directory` 또는 `mkdir(): Permission denied` 오류로 실패하는 경우, 웹 서버 사용자에게 스토리지 디렉터리에 대한 쓰기 권한을 부여하세요:

```bash
sudo chown -R www-data:www-data /path/to/xbackbone/storage
sudo chmod -R u+rwX /path/to/xbackbone/storage
```

모든 상위 디렉터리에 대해서도 웹 서버가 해당 디렉터리를 탐색할 수 있도록 허용되어 있는지 확인하세요. 영구적인 해결책으로 `chmod 777`을 사용하는 것은 피하세요.

Question 4

Docker에서 테마를 변경할 때 XBackBone 500 Internal Server Error를 해결하는 방법

Accepted Answer

이 문제는 손상된 Docker 이미지 릴리스로 인해 발생했으며, 이후 이미지 업데이트에서 수정되었습니다. 최신 XBackBone Docker 이미지로 업데이트하고 컨테이너를 다시 생성하세요. Docker Compose 사용 시: ```bash docker compose pull docker compose up -d ``` 독립 실행형 컨테이너 사용 시: ```bash docker pull linuxserver/xbackbone:latest docker stop docker rm # 평소 사용하는 docker run 명령으로 컨테이너를 다시 실행하세요 ``` 애플리케이션 캐시만 삭제해서는 문제가 안정적으로 해결되지 않았습니다. 이 오류는 `applyTheme()` 실행 중 `SettingController.php`에서 `Slim\Exception\HttpInternalServerErrorException`으로 나타났습니다.

Question 5

XBackBone 설치를 데이터 손실 없이 새 호스트로 이전하려면 어떻게 해야 하나요?

Accepted Answer

구 호스트에서 모든 파일을 다운로드하여 새 호스트에 업로드하세요. 500 Internal Server Error가 발생하면 config.php 파일을 편집하여 SQLite 데이터베이스 및 저장 디렉터리의 경로를 새 서버의 absolute paths에 맞게 업데이트하세요. 그런 다음 정상적으로 로그인할 수 있습니다.

XBackBone

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트