Repolode
alangrainger

alangrainger/immich-public-proxy

Immichサーバーを外部に公開せず、写真やアルバムを公開共有できるステートレスなプロキシ。

スター
2,420
フォーク
94
未解決の Issue
13
最終コミット
9 日前

これは何?

Immich Public Proxy(IPP)は、インターネットとImmichサーバーの間に設置します。Immich内ですでに共有したリンクへのリクエストだけを転送するため、インスタンスのほかの部分は保護されたままです。APIキーやImmichへの特権アクセスは不要で、独自のデータも保存しません。

Dockerコンテナを起動し(Kubernetesでの構成もドキュメントに記載)、ローカルのImmich URLと公開URLを指定して、Immichの外部ドメインをプロキシに設定します。以降、Immichが生成するリンクはプロキシを指し、共有の管理は引き続きImmich内で行えます。

共有アルバムには、ゲストが結婚式のアルバムに写真を追加する、といった形で、訪問者が任意で写真や動画をアップロードできます。ギャラリーの表示にはPhotoSwipeを採用しており、ズーム、スワイプ、キーボード操作によるナビゲーションに対応しています。

主な機能

  • 01明示的に共有したImmichの写真とアルバムだけを公開します。
  • 02ImmichのAPIキーや特権アクセスは必要ありません。
  • 03ステートレスで、データベースや共有キーの保存先はありません。
  • 04Docker ComposeまたはKubernetesでデプロイできます。
  • 05訪問者によるアップロードを有効にすると、ゲストが共有先に写真や動画を追加できます。

ユースケース

  • Immichサーバーをインターネットに公開せずに、家族や友人へ写真アルバムのリンクを送る。
  • 結婚式やイベントのゲストから写真を集め、共有アルバムにまとめる。
  • セルフホストのImmichライブラリから、一般公開の写真ギャラリーを公開する。

クイックスタート

  1. 1

    docker-compose.yml ファイルをダウンロードします

  2. 2

    IMMICH_URL にローカルの Immich URL を、PUBLIC_BASE_URL に公開 IPP URL を設定します

  3. 3

    Docker Compose でプロキシを起動します

    docker-compose up -d
  4. 4

    Immich のサーバー設定で、外部ドメインに IPP URL を設定します

使う前に知っておきたいこと

  • セルフホスト型の Immich サーバーと、別途デプロイしたプロキシが必要です。
  • Cloudflare を使用する場合、動画が再生されないことがあるため、動画のパスを「キャッシュをバイパス」に設定してください。

収録されている特集

トピック

よくある質問

immich-public-proxy とは?
Immichサーバーを外部に公開せず、写真やアルバムを公開共有できるステートレスなプロキシ。 Immich Public Proxy(IPP)は、インターネットとImmichサーバーの間に設置します。Immich内ですでに共有したリンクへのリクエストだけを転送するため、インスタンスのほかの部分は保護されたままです。APIキーやImmichへの特権アクセスは不要で、独自のデータも保存しません。
immich-public-proxy は無料で使えますか?ライセンスは?
immich-public-proxy は AGPL-3.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
immich-public-proxy は今もメンテナンスされていますか?
活発にメンテナンス中。immich-public-proxy の最終コミットは 2026年10月29日 です。
immich-public-proxy は何に使えますか?
Immichサーバーをインターネットに公開せずに、家族や友人へ写真アルバムのリンクを送る。 結婚式やイベントのゲストから写真を集め、共有アルバムにまとめる。 セルフホストのImmichライブラリから、一般公開の写真ギャラリーを公開する。
immich-public-proxy のインストール方法は?
docker-compose.yml ファイルをダウンロードします IMMICH_URL にローカルの Immich URL を、PUBLIC_BASE_URL に公開 IPP URL を設定します Docker Compose でプロキシを起動します: docker-compose up -d Immich のサーバー設定で、外部ドメインに IPP URL を設定します
immich-public-proxy はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/alangrainger/immich-public-proxy

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト