Linkwarden

Přístup

1. Otevřete http://<SERVER_IP>.
2. Klikněte na „Sign Up“.
3. Vytvořte první účet.
4. První účet se stane správcem serveru, protože NEXT_PUBLIC_ADMIN=1 je zapnuto.

Registrace

Registrace je ve výchozím stavu zapnutá.

Po vytvoření účtu správce lze registraci vypnout.

Pro vypnutí upravte /root/linkwarden/.env a nastavte:

NEXT_PUBLIC_DISABLE_REGISTRATION=true

Poté konfiguraci aplikujte:

cd /root/linkwarden
docker compose up -d

Důležité cesty

• Cesta k instalaci: /root/linkwarden
• Soubor Compose: /root/linkwarden/docker-compose.yml
• Soubor prostředí: /root/linkwarden/.env
• Data aplikace: /root/linkwarden/data
• Data PostgreSQL: /root/linkwarden/pgdata
• Data Meilisearch: /root/linkwarden/meili_data
• Konfigurace Nginx: /etc/nginx/sites-available/linkwarden

Správa Dockeru

Zkontrolujte kontejnery:

cd /root/linkwarden
docker compose ps

Zobrazit logy:

cd /root/linkwarden
docker compose logs -f

Zobrazit logy Linkwarden:

cd /root/linkwarden
docker compose logs -f linkwarden

Restartujte Linkwarden:

cd /root/linkwarden
docker compose restart linkwarden

Zastavte stack:

cd /root/linkwarden
docker compose down

Spusťte stack:

cd /root/linkwarden
docker compose up -d

Správa NGINX

Zkontrolujte NGINX:

systemctl status nginx

Otestujte konfiguraci:

nginx -t

Restartujte NGINX:

systemctl restart nginx

Znovu načtěte NGINX:

systemctl reload nginx

Domény a HTTPS

1. Vytvořte záznam A pro hostname vaší aplikace a nasměrujte jej na veřejnou IP adresu serveru (například app.example.com).

2. Nainstalujte Certbot:

apt update
apt install -y certbot python3-certbot-nginx

3. Upravte konfiguraci NGINX a nahraďte server_name _; svou doménou (například server_name app.example.com;):

vim /etc/nginx/sites-available/linkwarden

4. Otestujte konfiguraci:

nginx -t

5. Znovu načtěte NGINX:

systemctl reload nginx

6. Vydejte TLS certifikát:

certbot --nginx -d app.example.com

7. Aktualizujte proměnné prostředí Linkwarden (.env soubor):

NEXTAUTH_URL=https://app.example.com/api/v1/auth
BASE_URL=https://app.example.com

8. Po změně proměnných prostředí restartujte Linkwarden:

cd /root/linkwarden
docker compose down
docker compose up -d

9. Otevři prohlížeč a přejdi na: https://app.example.com

Poznámky

• Linkwarden je veřejně dostupný přes Nginx na portu 80.
• Samotná aplikace Linkwarden naslouchá pouze na 127.0.0.1:3000.
• PostgreSQL a Meilisearch jsou interní služby Dockeru a nejsou přímo vystaveny hostiteli.
• Při nastavování domény nezapomeňte nahradit http:// za https:// všude, kde je nastavena URL aplikace, včetně NEXTAUTH_URL a BASE_URL.
• V celé konfiguraci NGINX i Linkwarden používejte důsledně stejnou HTTPS doménu.
• BASE_URL je zvlášť užitečné, když používáte e-mailové funkce jako reset hesla nebo ověřovací e-maily.
• Upravte konfiguraci Linkwarden podle svých preferencí.