Question 1

著者名を変更した際に bookAuthors で SQLITE_CONSTRAINT が発生して Audiobookshelf がクラッシュする問題をどう修正しますか？

Accepted Answer

これは Audiobookshelf v2.35.0 のバグです。著者名を変更すると、bookAuthors への重複挿入が発生し、SQLITE_CONSTRAINT: UNIQUE constraint failed: bookAuthors.bookId, bookAuthors.authorId を引き起こしてコンテナがクラッシュすることがあります。v2.35.1 以降にアップグレードしてください。Podman の場合は、修正済みイメージを pull してコンテナを再作成します。例えば、podman pull ghcr.io/advplyr/audiobookshelf:2.35.1 を実行し、その後、既存のコンテナを停止/削除して、同じボリュームと構成で再度実行します。すぐにアップグレードできない場合は、アップデートを適用するまで著者名の変更を避けてください。

Question 2

How to fix Audiobookshelf 'Invalid refresh token' errors and unexpected logout when multiple sessions refresh tokens simultaneously?

Accepted Answer

Upgrade Audiobookshelf to **v2.35.1 or later**. In v2.35.0, two sessions for the same user could receive identical refresh tokens if they called `/auth/refresh` within the same second because the generated JWT lacked a per-session or per-token unique value. Logging out one session could then invalidate the other. As a temporary workaround on v2.35.0, avoid concurrent refresh requests from multiple devices/sessions and retry login after receiving `401 Invalid refresh token`. The fix is included in release v2.35.1.

Question 3

Audiobookshelf の RSS フィードが .m4b ファイルを Content-Type: application/octet-stream として配信し、Apple Podcasts での再生が遅くなるのをどう修正すればよいですか？

Accepted Answer

Audiobookshelf を v2.35.0 以降にアップグレードしてください。このリリースでは、RSS フィードのエピソードファイルに正しいオーディオ MIME タイプが設定されるため、.m4b は Content-Type: audio/mp4 として配信されます。

次のコマンドで確認します:
curl -sI "https://your-server/feed/your-slug/item/episode-id/media.m4b" | grep -i content-type
# 期待される出力: Content-Type: audio/mp4

すぐにアップグレードできない場合は、リバースプロキシでヘッダーを書き換えてください。Caddy の例:
reverse_proxy audiobookshelf:80 {
header_down Content-Type application/octet-stream audio/mp4
}

このプロキシ回避策は、すべてのプロキシ応答で application/octet-stream を audio/mp4 に変更するため、慎重に使用してください。

ソースレベルで修正するには、server/managers/RssFeedManager.js 内で、res.sendFile(episodePath) の前に getAudioMimeTypeFromExtname() を呼び出します:
const { getAudioMimeTypeFromExtname } = require('../utils/fileUtils')

const audioMimeType = getAudioMimeTypeFromExtname(Path.extname(episodePath))
if (audioMimeType) {
res.setHeader('Content-Type', audioMimeType)
}
res.sendFile(episodePath)

その後、Audiobookshelf を再起動または再ビルドしてください。

Question 4

Audiobookshelfでポッドキャストの画像を置き換えたのに、ポッドキャストクライアントに更新されたカバーアートが表示されないのはなぜですか？

Accepted Answer

これは、Audiobookshelfのv2.37.2より前のバージョンにおける既知のバグ（issue #5306）です。ポッドキャストフィードのカバーURL（例: `/feed/<uuid>/cover.jpg`）は常に同じファイル名が使い回されるため、Apple PodcastsやSpotifyなどのポッドキャストクライアントは古い画像をキャッシュしたまま、変更を検出しません。修正方法: Audiobookshelfサーバーをv2.37.2以降にアップグレードしてください。このバージョンでは、カバー画像がアップロードされるたびに新しい一意のファイル名が生成され、クライアントに新しいアートワークの取得を強制します。アップグレード後は、新しいURLが生成されるようにカバーをもう一度差し替え（再アップロード）し、それでも古い画像がキャッシュされたままの場合は、ポッドキャストクライアントでフィードを更新するか再追加してください。

Question 5

Debian/Ubuntuでsystemdの警告「Configuration file audiobookshelf.service is marked executable」を修正する方法

Accepted Answer

この警告は、audiobookshelf の .deb パッケージ（v2.37.1 以前）が /lib/systemd/system/audiobookshelf.service を 0644 ではなくモード 0775 で同梱しているために発生します。パッケージ内のファイルパーミッションが修正された audiobookshelf v2.37.2 以降にアップグレードすることで、恒久的に解決できます。古いバージョンでは、アップグレードによってモードがリセットされないよう、永続的な回避策を適用してください: `sudo dpkg-statoverride --update --add root root 0644 /lib/systemd/system/audiobookshelf.service` を実行し、続いて `sudo chmod 644 /lib/systemd/system/audiobookshelf.service` と `sudo systemctl daemon-reload` を実行します。単に `chmod 644` だけを実行した場合は、次回のパッケージアップグレードで 0775 に戻されるまでしか有効ではありません。

Audiobookshelf

主な機能

できないこと

使用例

タグ

はじめ方

類似プロジェクト