Q: TT-RSS OPML 내보내기 오류 "XML declaration allowed only at the start of the document"는 어떻게 해결하나요?

내보낸 OPML 파일에 ` ` 앞에 빈 줄이 있어 유효하지 않은 XML이 됩니다. 빠른 해결 방법으로, 첫 번째 빈 줄을 제거하세요: ```bash sed -i '1{/^[[:space:]]*$/d}' /tmp/tt-rss.opml xmllint /tmp/tt-rss.opml ``` 영구적인 해결을 위해서는 내보내기 출력 전에 공백을 출력하는 PHP 파일을 찾으세요. TT-RSS 설치 환경에서 `config.php`(예: Debian/YunoHost의 경우 `/var/www/tt-rss/config.php`)와 사용자 지정 플러그인 또는 테마를 확인하세요: - 파일이 앞에 빈 줄이나 공백 없이 ` ` 태그를 제거하세요. - 원인을 파악하기 위해 사용자 지정 플러그인을 일시적으로 비활성화하세요. 파일을 수정한 후 OPML을 다시 내보내고 `xmllint`로 유효성을 검증하세요.

Question 1

TT-RSS 필터가 이미 처리한 기사에 라벨을 다시 적용하지 않도록 하려면 어떻게 해야 하나요?

Accepted Answer

TT-RSS를 최신 `main` 코드(v26.05-23e6087a 이후 버전)로 업데이트하세요. Git 기반 설치의 경우 TT-RSS 디렉터리에서 `git pull --ff-only`를 실행하고 일반적인 업데이트/마이그레이션 단계를 완료하세요. 이 버그는 라벨이 기사 해시에 포함되어 발생했습니다. 라벨을 제거하거나 추가하면 해시가 변경되어, 피드 업데이트 시 일치하는 필터가 다시 실행되면서 라벨이 다시 추가되었습니다. 이번 수정에서는 해시 계산에서 라벨을 제외합니다. 업데이트 후 잘못 복원된 라벨을 한 번 제거하세요. 이후 피드 새로 고침에서는 더 이상 다시 나타나지 않습니다. 날짜 기반 필터 조건은 추가되지 않았으며, 기존 날짜 규칙 코드는 의도적으로 제거되었습니다.

Question 2

Tiny Tiny RSS에서 "Passing the 'curl' request option to the stream handler is not supported" 오류를 해결하는 방법

Accepted Answer

이 오류는 tt-rss가 PHP의 스트림 핸들러로 폴백할 때(예: 공유 호스팅에서 cURL을 사용할 수 없는 경우) 여전히 cURL 전용 옵션을 전달하여 스트림 핸들러가 이를 거부하면서 발생합니다. 해결 방법: `classes/UrlHelper.php`를 편집하여 요청이 이루어지기 전에 `$req_options` 배열에서 `curl` 키를 제거하세요. 498번째 줄 부근에 다음 줄을 추가하세요:

```php
unset($req_options['curl']);
```

또는 같은 파일의 `$req_options` 배열에서 `curl` 옵션을 완전히 제거할 수도 있습니다. 변경 후에는 스트림 핸들러가 더 이상 지원하지 않는 옵션을 받지 않으므로 피드 업데이트가 다시 정상적으로 작동합니다. 참고: 이것은 수동 패치이므로 `git pull` 시 덮어쓰일 수 있습니다. 또한 tt-rss가 스트림 폴백 대신 cURL 핸들러를 사용할 수 있도록 PHP에 cURL이 제대로 설치/활성화되어 있는지 확인하세요(예: `php -m | grep curl`).

Question 3

TTRSS_DB_TYPE이 mysql일 때 tt-rss가 "Exception while creating PDO object: could not find driver" 오류와 함께 실패하는 이유는 무엇인가요?

Accepted Answer

MySQL 지원이 tt-rss에서 제거되었으므로 현재 버전에서는 `TTRSS_DB_TYPE=mysql`이 무시되며, 업스트림에서는 PostgreSQL만 지원됩니다. MySQL만 사용 가능한 호스팅 환경에서 실질적인 해결 방법은 데이터베이스 스키마 147을 사용하는 마지막으로 알려진 MySQL 호환 커밋으로 버전을 고정하는 것입니다:

```bash
git checkout 25d3ce4ee8f411a19c3a0e69ebb5c575c16243a8
```

스키마 148 업데이트가 실패한 경우 `60606aaa9`는 사용하지 마세요. 먼저 데이터베이스와 tt-rss 디렉터리를 백업하세요. 스키마 148 업그레이드를 이미 시도했다가 실패한 경우에는 이전 커밋을 체크아웃하기 전에 백업에서 복원하세요. 장기적인 방안으로는 고정된 해당 버전을 계속 사용하거나, 유지 관리되는 MySQL 포크가 제공되면 이를 사용하거나, 최신 tt-rss를 실행하기 위해 PostgreSQL로 마이그레이션하는 방법이 있습니다.

Question 4

postgres:18.1-alpine Docker 이미지를 사용할 때 tt-rss 데이터베이스가 초기화되는 이유는 무엇인가요?

Accepted Answer

postgres:18.1-alpine 태그(아마 Alpine 3.22 기반)에는 스키마가 최신 상태여도 시작 시 tt-rss 데이터베이스가 초기화되는 버그가 있습니다. 해결 방법: 대신 postgres:18.1-alpine3.21을 사용하세요. Debian 기반 postgres:18.1 이미지는 완전히 시작되지 않습니다. 영구적인 수정을 위해 이슈를 모니터링하세요.

Question 5

TT-RSS OPML 내보내기 오류 "XML declaration allowed only at the start of the document"는 어떻게 해결하나요?

Accepted Answer

내보낸 OPML 파일에 `` 앞에 빈 줄이 있어 유효하지 않은 XML이 됩니다. 빠른 해결 방법으로, 첫 번째 빈 줄을 제거하세요: ```bash sed -i '1{/^[[:space:]]*$/d}' /tmp/tt-rss.opml xmllint /tmp/tt-rss.opml ``` 영구적인 해결을 위해서는 내보내기 출력 전에 공백을 출력하는 PHP 파일을 찾으세요. TT-RSS 설치 환경에서 `config.php`(예: Debian/YunoHost의 경우 `/var/www/tt-rss/config.php`)와 사용자 지정 플러그인 또는 테마를 확인하세요: - 파일이 앞에 빈 줄이나 공백 없이 `` 태그를 제거하세요. - 원인을 파악하기 위해 사용자 지정 플러그인을 일시적으로 비활성화하세요. 파일을 수정한 후 OPML을 다시 내보내고 `xmllint`로 유효성을 검증하세요.

Tiny Tiny RSS

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트