Merge e544d06bb9 into 187cae25bf

2025-08-17 09:02:15 -06:00 · 2025-08-16 14:11:37 +02:00 · 2025-08-16 14:11:37 +02:00 · 47c1eb1c05
parent 187cae25bf e544d06bb9
commit 47c1eb1c05
5 changed files with 85 additions and 77 deletions
--- a/docs/examples/docker/basic-docker-compose/docker-compose.yml
+++ b/docs/examples/docker/basic-docker-compose/docker-compose.yml
@ -1,5 +1,6 @@
-services:
+---

+services:
  copyparty:
    image: copyparty/ac:latest
    container_name: copyparty
--- a/docs/examples/docker/idp-authelia-traefik/README.md
+++ b/docs/examples/docker/idp-authelia-traefik/README.md
@ -2,44 +2,44 @@
 > I am unable to guarantee the quality, safety, and security of anything in this folder; it is a combination of examples I found online. Please submit corrections or improvements 🙏

 to try this out with minimal adjustments:
-* specify what filesystem-path to share with copyparty, replacing the default/example value `/srv/pub` in `docker-compose.yml`
-* add `127.0.0.1 fs.example.com traefik.example.com authelia.example.com` to your `/etc/hosts`
-* `sudo docker-compose up`
-* login to https://fs.example.com/ with username `authelia` password `authelia`
+
+- specify what filesystem-path to share with copyparty, replacing the default/example value `/srv/pub` in `docker-compose.yml`
+- add `127.0.0.1 fs.example.com traefik.example.com authelia.example.com` to your `/etc/hosts`
+- `sudo docker-compose up`
+- login to https://fs.example.com/ with username `authelia` password `authelia`

 to use this in a safe and secure manner:
-* follow a guide on setting up authelia properly (TODO:link) and use the copyparty-specific parts of this folder as inspiration for your own config; namely the `cpp` subfolder and the `copyparty` service in `docker-compose.yml`
+
+- follow a guide on setting up [authelia](https://www.authelia.com/integration/proxies/traefik/#docker-compose) properly and use the copyparty-specific parts of this folder as inspiration for your own config; namely the `cpp` subfolder and the `copyparty` service in `docker-compose.yml`

 this folder is based on:
-* https://github.com/authelia/authelia/tree/39763aaed24c4abdecd884b47357a052b235942d/examples/compose/lite
+
+- https://github.com/authelia/authelia/tree/39763aaed24c4abdecd884b47357a052b235942d/examples/compose/lite

 incomplete list of modifications made:
-* support for running with podman as root on fedora (`:z` volumes, `label:disable`)
-* explicitly using authelia `v4.38.0-beta3` because config syntax changed since last stable release
-* disabled automatic letsencrypt certificate signing
-* reduced logging from debug to info
-* added a warning that traefik is given access to the docker socket (as recommended by traefik docs) which means traefik is able to break out of the container and has full root access on the host machine

+- support for running with podman as root on fedora (`:z` volumes, `label:disable`)
+- explicitly using authelia `v4.38.0-beta3` because config syntax changed since last stable release
+- reduced logging from debug to info
+- implemented a docker socket-proxy to not bind the docker.socket directly to traefik
+- using valkey instead of redis for caching

 # security

 there is probably/definitely room for improvement in this example setup. Some ideas taken from [github issue #62](https://github.com/9001/copyparty/issues/62):

-* Add in a redis password to limit attacker lateral movement in the system
-* Move redis to a private network shared with just authelia
-* Pin to image hashes (or go all in on updates and add `watchtower`)
-* Drop bridge networking for just exposing traefik's public ports
-* Configure docker for non-root access to docker socket and then move traefik to use [non-root perms](https://docs.docker.com/engine/security/rootless/)
-
-if you manage to improve on any of this, especially in a way that might be useful for other people, consider sending a PR :>
+- Move valkey to a private network shared with just authelia
+- Add `watchtower` to manage your image version updates
+- Drop bridge networking for just exposing traefik's public ports

+If you manage to improve on any of this, especially in a way that might be useful for other people, consider sending a PR :>

 # performance

 currently **not optimal,** at least when compared to running the python sfx outside of docker... some numbers from my laptop (ryzen4500u/fedora39):

 | req/s |  https D/L | http D/L | approach                                                                                                        |
-| -----:| ----------:|:--------:| -------- |
+| ----: | ---------: | :------: | --------------------------------------------------------------------------------------------------------------- |
 |  5200 | 1294 MiB/s | 5+ GiB/s | [copyparty-sfx.py](https://github.com/9001/copyparty/releases/latest/download/copyparty-sfx.py) running on host |
 |  4370 |  725 MiB/s | 4+ GiB/s | `docker run copyparty/ac`                                                                                       |
 |  2420 |  694 MiB/s |   n/a    | `copyparty/ac` behind traefik                                                                                   |
--- a/docs/examples/docker/idp-authelia-traefik/authelia/configuration.yml
+++ b/docs/examples/docker/idp-authelia-traefik/authelia/configuration.yml
@ -1,15 +1,14 @@
-# based on https://github.com/authelia/authelia/blob/39763aaed24c4abdecd884b47357a052b235942d/examples/compose/lite/authelia/configuration.yml
-
 # Authelia configuration

-# This secret can also be set using the env variables AUTHELIA_JWT_SECRET_FILE
-jwt_secret: a_very_important_secret
+identity_validation:
+  reset_password:
+    jwt_secret: 'a_very_important_secret'

 server:
  address: 'tcp://:9091'

 log:
-  level: info  # debug
+  level: info

 totp:
  issuer: authelia.com
@ -21,29 +20,26 @@ authentication_backend:
 access_control:
  default_policy: deny
  rules:
-    # Rules applied to everyone
-    - domain: traefik.example.com
-      policy: one_factor
+    - domain: auth.example.com
+      policy: bypass  # Allow access to the login UI
    - domain: fs.example.com
      policy: one_factor

 session:
-  # This secret can also be set using the env variables AUTHELIA_SESSION_SECRET_FILE
  secret: unsecure_session_secret
-
  cookies:
    - name: authelia_session
-      domain: example.com  # Should match whatever your root protected domain is
+      domain: example.com  # Root protected domain
      default_redirection_url: https://fs.example.com
      authelia_url: https://authelia.example.com/
      expiration: 3600  # 1 hour
      inactivity: 300  # 5 minutes

  redis:
-    host: redis
+    host: valkey
    port: 6379
-    # This secret can also be set using the env variables AUTHELIA_SESSION_REDIS_PASSWORD_FILE
-    # password: authelia
+    password: your_secure_password_here
+

 regulation:
  max_retries: 3
@ -58,9 +54,7 @@ storage:
 notifier:
  disable_startup_check: true
  smtp:
-    username: test
-    # This secret can also be set using the env variables AUTHELIA_NOTIFIER_SMTP_PASSWORD_FILE
-    password: password
-    host: mail.example.com
-    port: 25
-    sender: admin@example.com
+    address: 'smtp://127.0.0.1:25'
+    username: 'test'
+    password: 'password'
+    sender: "Authelia <admin@example.com>"
--- a/docs/examples/docker/idp-authelia-traefik/docker-compose.yml
+++ b/docs/examples/docker/idp-authelia-traefik/docker-compose.yml
@ -1,4 +1,4 @@
-version: '3.3'
+---

 networks:
  net:
@ -6,7 +6,7 @@ networks:

 services:
  copyparty:
-    image: copyparty/ac
+    image: copyparty/ac:1.18.8@sha256:19348cf85bf0df2f0b5b476162d73c72ef8bcbe0f12dd910d3cb05c0312641aa
    container_name: idp_copyparty
    user: "1000:1000"  # should match the user/group of your fileshare volumes
    volumes:
@ -19,19 +19,19 @@ services:
    labels:
      - 'traefik.enable=true'
      - 'traefik.http.routers.copyparty.rule=Host(`fs.example.com`)'
-      - 'traefik.http.routers.copyparty.entrypoints=https'
+      - 'traefik.http.routers.copyparty.entrypoints=websecure'
      - 'traefik.http.routers.copyparty.tls=true'
+      - 'traefik.http.routers.copyparty.tls.certresolver=letsencrypt'  # ← THIS IS CRUCIAL
      - 'traefik.http.routers.copyparty.middlewares=authelia@docker'
    stop_grace_period: 15s  # thumbnailer is allowed to continue finishing up for 10s after the shutdown signal
    environment:
      LD_PRELOAD: /usr/lib/libmimalloc-secure.so.NOPE
      # enable mimalloc by replacing "NOPE" with "2" for a nice speed-boost (will use twice as much ram)
-
      PYTHONUNBUFFERED: 1
      # ensures log-messages are not delayed (but can reduce speed a tiny bit)

  authelia:
-    image: authelia/authelia:v4.38.0-beta3  # the config files in the authelia folder use the new syntax
+    image: authelia/authelia:4.39.5@sha256:023e02e5203dfa0ebaee7a48b5bae34f393d1f9cada4a9df7fbf87eb1759c671
    container_name: idp_authelia
    volumes:
      - ./authelia:/config:z
@ -40,25 +40,23 @@ services:
    labels:
      - 'traefik.enable=true'
      - 'traefik.http.routers.authelia.rule=Host(`authelia.example.com`)'
-      - 'traefik.http.routers.authelia.entrypoints=https'
+      - 'traefik.http.routers.authelia.entrypoints=websecure'
      - 'traefik.http.routers.authelia.tls=true'
-      #- 'traefik.http.routers.authelia.tls.certresolver=letsencrypt'  # uncomment this to enable automatic certificate signing (1/2)
+      - 'traefik.http.routers.authelia.tls.certresolver=letsencrypt'
      - 'traefik.http.middlewares.authelia.forwardauth.address=http://authelia:9091/api/authz/forward-auth?authelia_url=https://authelia.example.com'
      - 'traefik.http.middlewares.authelia.forwardauth.trustForwardHeader=true'
      - 'traefik.http.middlewares.authelia.forwardauth.authResponseHeaders=Remote-User,Remote-Groups,Remote-Name,Remote-Email'
    expose:
      - 9091
    restart: unless-stopped
-    healthcheck:
-      disable: true
    environment:
      - TZ=Etc/UTC

-  redis:
-    image: redis:7.2.4-alpine3.19
-    container_name: idp_redis
+  valkey:
+    image: valkey/valkey:8.1.3-alpine3.22@sha256:0d27f0bca0249f61d060029a6aaf2e16b2c417d68d02a508e1dfb763fa2948b4
+    container_name: idp_valkey
    volumes:
-      - ./redis:/data:z
+      - ./valkey:/data:z
    networks:
      - net
    expose:
@ -66,40 +64,55 @@ services:
    restart: unless-stopped
    environment:
      - TZ=Etc/UTC
+      - VALKEY_EXTRA_FLAGS=--requirepass your_secure_password_here
+
+  socket-proxy:
+    image: lscr.io/linuxserver/socket-proxy:3.2.3@sha256:63d2e0ce6bb0d12dfdbde5c3af31d08fee343ec3801a050c8197a3f5ffae8bed
+    container_name: idp_socket_proxy
+    environment:
+      - CONTAINERS=1
+      - NETWORKS=1
+      - EVENTS=1
+      - PING=1
+      - VERSION=1
+      - LOG_LEVEL=warning
+    volumes:
+      - /var/run/docker.sock:/var/run/docker.sock:ro
+    security_opt:
+      - no-new-privileges:true
+    read_only: true
+    tmpfs:
+      - /run
+    networks:
+      - net
+    restart: unless-stopped
+    expose:
+      - 2375

  traefik:
-    image: traefik:2.11.0
+    image: traefik:3.5.0@sha256:4e7175cfe19be83c6b928cae49dde2f2788fb307189a4dc9550b67acf30c11a5
    container_name: idp_traefik
    volumes:
      - ./traefik:/etc/traefik:z
-      - /var/run/docker.sock:/var/run/docker.sock  # WARNING: this gives traefik full root-access to the host OS, but is recommended/required(?) by traefik
-    security_opt:
-      - label:disable  # disable selinux because it (rightly) blocks access to docker.sock
    networks:
      - net
    labels:
      - 'traefik.enable=true'
-      - 'traefik.http.routers.api.rule=Host(`traefik.example.com`)'
-      - 'traefik.http.routers.api.entrypoints=https'
-      - 'traefik.http.routers.api.service=api@internal'
-      - 'traefik.http.routers.api.tls=true'
-      #- 'traefik.http.routers.api.tls.certresolver=letsencrypt'  # uncomment this to enable automatic certificate signing (2/2)
      - 'traefik.http.routers.api.middlewares=authelia@docker'
    ports:
      - '80:80'
      - '443:443'
    command:
-      - '--api'
-      - '--providers.docker=true'
+      - '--global.sendAnonymousUsage=false'
+      - '--providers.docker.endpoint=tcp://socket-proxy:2375'
      - '--providers.docker.exposedByDefault=false'
-      - '--entrypoints.http=true'
-      - '--entrypoints.http.address=:80'
-      - '--entrypoints.http.http.redirections.entrypoint.to=https'
-      - '--entrypoints.http.http.redirections.entrypoint.scheme=https'
-      - '--entrypoints.https=true'
-      - '--entrypoints.https.address=:443'
+      - '--entrypoints.web.address=:80'
+      - '--entrypoints.web.http.redirections.entrypoint.to=websecure'
+      - '--entrypoints.web.http.redirections.entrypoint.scheme=https'
+      - '--entrypoints.websecure.address=:443'
      - '--certificatesResolvers.letsencrypt.acme.email=your-email@your-domain.com'
      - '--certificatesResolvers.letsencrypt.acme.storage=/etc/traefik/acme.json'
-      - '--certificatesResolvers.letsencrypt.acme.httpChallenge.entryPoint=http'
-      - '--log=true'
-      - '--log.level=WARNING'  # DEBUG
+      - '--certificatesResolvers.letsencrypt.acme.httpChallenge.entryPoint=web'
+      - '--log.level=INFO'
+    depends_on:
+      - socket-proxy
--- a/docs/examples/docker/idp-authelia-traefik/traefik/acme.json
+++ b/docs/examples/docker/idp-authelia-traefik/traefik/acme.json