73 lines
3.2 KiB
Markdown
73 lines
3.2 KiB
Markdown
# lux.harlelux.de
|
|
|
|
Meine persönliche Website mit Portfolio. Node.js und Express, die Seiten werden mit Nunjucks auf dem Server gerendert. Inhalte liegen als YAML und Markdown auf der Platte, gepflegt werden sie über ein paar Admin-Seiten, die nur im Heimnetz erreichbar sind.
|
|
|
|
## Entwicklung
|
|
|
|
Node 24 (siehe `.nvmrc`).
|
|
|
|
```sh
|
|
npm install
|
|
ADMIN_PASSWORD=test npm run dev # Seite auf :3000, Admin auf :3001/admin
|
|
npm test
|
|
```
|
|
|
|
Im Dev-Modus sind Entwürfe auf der Seite sichtbar und bekommen ein Badge. Ohne `ADMIN_PASSWORD` bleiben die Admin-Seiten aus.
|
|
|
|
## Inhalte
|
|
|
|
Es gibt zwei Ordner:
|
|
|
|
- `content/` im Repo: Startinhalte und alles, was es im Admin nicht gibt (Texte und Kacheln der Startseite in `home.yml`).
|
|
- `data/` auf dem Server, nicht im Repo: alles, was über die Admin-Seiten bearbeitet wird.
|
|
|
|
Beim allerersten Start wird der bearbeitbare Teil von `content/` nach `data/` kopiert (Projekte, Werdegang, Profil, Homelab). Danach gilt nur noch `data/`, spätere Änderungen an diesen Dateien im Repo werden ignoriert.
|
|
|
|
```
|
|
data/
|
|
site.yml Name, Pronomen, Links, Skills, "Gerade dran"
|
|
journey.yml Stationen für den Werdegang
|
|
homelab.yml Hardware und Dienste
|
|
pages/ Werdegang und Homelab als <name>.de.md / <name>.en.md
|
|
projects/<slug>/ meta.yml, de.md, en.md und die Bilder
|
|
```
|
|
|
|
Die Dateien lassen sich auch von Hand bearbeiten, die Seite lädt sie bei Änderungen neu. Texte, die in beiden Sprachen gleich sind, stehen als einfacher String, sonst als `{ de, en }`.
|
|
|
|
## Admin-Seiten
|
|
|
|
Laufen im selben Container auf einem eigenen Port (im Container 3001, auf dem Server `ADMIN_HOST_PORT`, Standard 3051). Über `lux.harlelux.de` gibt es kein `/admin`. Der Port wird von der FRITZ!Box nicht freigegeben, ist also nur im Heimnetz erreichbar:
|
|
|
|
```
|
|
http://<server-ip>:3051/admin
|
|
```
|
|
|
|
Zusätzlich lässt die App dort nur private Adressen durch und verlangt das Passwort aus `ADMIN_PASSWORD`. Nach zehn Fehlversuchen ist der Login eine Viertelstunde gesperrt.
|
|
|
|
Unter derselben Adresse zeigt `/de/` die ganze Seite mit Entwürfen, als Vorschau.
|
|
|
|
Hochgeladene Bilder werden auf höchstens 2400 px verkleinert und neu gespeichert, dabei fallen EXIF-Daten wie der Aufnahmeort weg.
|
|
|
|
## Deployment
|
|
|
|
Läuft als Docker-Stack in Dockge hinter Nginx Proxy Manager.
|
|
|
|
```sh
|
|
cd ~/stacks
|
|
git clone https://git.harlelux.de/Harlekin/Personal-Website.git personal_website
|
|
cd personal_website
|
|
mkdir data # muss dem Container-User (UID 1000) gehören
|
|
cp .env.example .env # ADMIN_PASSWORD eintragen
|
|
docker compose up -d --build
|
|
```
|
|
|
|
Im Nginx Proxy Manager einen Proxy Host für `lux.harlelux.de` auf `personal-website:3000` anlegen, mit Let's-Encrypt-Zertifikat und Force SSL. Der Container hängt im Netzwerk `nginx_default`, ein anderer Name lässt sich über `PROXY_NETWORK` in der `.env` setzen.
|
|
|
|
Code-Updates: `git pull` und `docker compose up -d --build`. Wer statt Git mit `rsync` hochlädt, muss `data` und `.env` ausschließen, sonst sind die Inhalte weg.
|
|
|
|
**`data/` gehört ins Backup.** Dort liegt alles, was über die Admin-Seiten angelegt wurde.
|
|
|
|
## Lizenz
|
|
|
|
Der Code steht unter der MIT-Lizenz (siehe `LICENSE`). Texte und Bilder in `content/` und `data/` sind davon ausgenommen.
|