mirror of
https://github.com/alangrainger/immich-public-proxy.git
synced 2024-12-29 12:21:57 +00:00
Update docs
This commit is contained in:
parent
d05296509d
commit
48f3403543
1 changed files with 21 additions and 0 deletions
21
README.md
21
README.md
|
@ -53,6 +53,27 @@ docker-compose up -d
|
||||||
Now whenever you share an image or gallery through Immich, it will automatically create the
|
Now whenever you share an image or gallery through Immich, it will automatically create the
|
||||||
correct public path for you.
|
correct public path for you.
|
||||||
|
|
||||||
|
## How it works
|
||||||
|
|
||||||
|
You share your photos/videos as normal through Immich. Because you have set the **External domain** in Immich settings
|
||||||
|
to be the URL for your proxy app, the links that Immich generates will automaticaly have the correct URL.
|
||||||
|
|
||||||
|
When the proxy receives a request, it will come as a link like this:
|
||||||
|
|
||||||
|
```
|
||||||
|
https://your-proxy-url.com/share/ffSw63qnIYMtpmg0RNvOui0Dpio7BbxsObjvH8YZaobIjIAzl5n7zTX5d6EDHdOYEvo
|
||||||
|
```
|
||||||
|
|
||||||
|
The part after `/share/` is Immich's shared link public ID (called the `key` [in the docs](https://immich.app/docs/api/get-all-shared-links/)).
|
||||||
|
|
||||||
|
**Immich Public Proxy** takes that key and makes an API call to your Immich instance over your local network, to ask what
|
||||||
|
photos or videos are shared in that share URL.
|
||||||
|
|
||||||
|
If it is a valid share URL, the proxy fetches just those assets via local API and returns them to the visitor as an
|
||||||
|
individual image or gallery.
|
||||||
|
|
||||||
|
If the shared link is expired or any of the assets have been put in the Immich trash, it will not return those.
|
||||||
|
|
||||||
## Configuration
|
## Configuration
|
||||||
|
|
||||||
The gallery is created using [lightGallery](https://github.com/sachinchoolur/lightGallery). You can change various settings to change how your gallery displays by
|
The gallery is created using [lightGallery](https://github.com/sachinchoolur/lightGallery). You can change various settings to change how your gallery displays by
|
||||||
|
|
Loading…
Reference in a new issue