ARCHITECTURE.md: - Node version: 18+ → 22 (Alpine) - Tech stack: add helmet, express-rate-limit, cookie-parser, testing tools - Directory structure: add server/app.js, verifyCsrf.js, tokenStore.js, sanitizeError.js, tests/, docs/, .gitea/workflows/, vitest.config.js - §4.1: document app.js factory (createApp) vs index.js entry point; CSP nonce, rate limiters, CSRF middleware, trust proxy - §4.2: add CSRF Required column; document verifyCsrf; fix auth note - §4.3: add tokenStore.js and sanitizeError.js descriptions - §6 Auth flow: add rememberMe, rate limiter, stable DeviceId, server-side token store, CSRF token issuance, correct cookie TTL (session/30d not 24h) - §9 API: add csrfToken to login response, rememberMe field, 400/429 codes; add GET /api/auth/csrf endpoint; fix /me response; fix /logout CSRF note - §11 Config: add DATA_DIR, COOKIE_SECRET, TRUST_PROXY, NODE_ENV; split into Core / Emby / Service Instances / Tuning sections - §12 Deployment: update Dockerfile description to multi-stage node:22-alpine; add COOKIE_SECRET, TRUST_PROXY, named volume to compose example; add security hardening checklist; add CI/CD table diagrams/seq-auth.puml: - Add TokenStore participant - Add rememberMe, CSRF token issuance, stable DeviceId note - Add login rate limiter note - Add GET /csrf refresh flow - Add server-side token revocation on logout diagrams/class-server.puml: - Add app.js createApp() factory class - Add verifyCsrf middleware class - Add TokenStore and SanitizeError utility classes - Update auth.js routes (add GET /csrf) - Fix relationships: entry → appfn → routes diagrams/component.puml: - Add app.js factory component - Add helmet, express-rate-limit components - Add verifyCsrf middleware component - Add tokenStore.js and sanitizeError.js utility components - Fix wiring: entry → createApp() → mounts routes Dockerfile: - Fix stale comments referencing better-sqlite3 and SQLite server/routes/auth.js: - Fix stale comment: SQLite-backed → JSON file-backed
54 lines
2.0 KiB
Docker
54 lines
2.0 KiB
Docker
# ---------------------------------------------------------------------------
|
|
# Stage 1 — deps: install production dependencies only
|
|
# ---------------------------------------------------------------------------
|
|
FROM node:22-alpine AS deps
|
|
|
|
WORKDIR /app
|
|
|
|
# All dependencies are pure JavaScript — no native addons, no build tools.
|
|
COPY package.json package-lock.json ./
|
|
RUN npm ci --omit=dev
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# Stage 2 — runtime image (minimal attack surface)
|
|
# ---------------------------------------------------------------------------
|
|
FROM node:22-alpine AS runtime
|
|
|
|
LABEL org.opencontainers.image.title="sofarr"
|
|
LABEL org.opencontainers.image.description="Personal media download dashboard for *arr services"
|
|
LABEL org.opencontainers.image.authors="Gordon Bolton"
|
|
LABEL org.opencontainers.image.source="https://git.i3omb.com/Gandalf/sofarr"
|
|
LABEL org.opencontainers.image.url="https://docker.i3omb.com"
|
|
LABEL org.opencontainers.image.vendor="Gordon Bolton"
|
|
LABEL org.opencontainers.image.licenses="MIT"
|
|
LABEL custom.hardware.requirement="None - runs on any Docker-supported platform including ARM and x86_64"
|
|
|
|
# Use the built-in non-root 'node' user (UID 1000) from the official image
|
|
# The /app directory is owned by root; data directory is owned by node
|
|
WORKDIR /app
|
|
|
|
# Copy production deps from deps stage
|
|
COPY --from=deps /app/node_modules ./node_modules
|
|
|
|
# Copy application source owned by root (read-only at runtime)
|
|
COPY --chown=root:root server/ ./server/
|
|
COPY --chown=root:root public/ ./public/
|
|
COPY --chown=root:root package.json ./
|
|
|
|
# Persistent data directory owned by node user (token store, logs)
|
|
RUN mkdir -p /app/data && chown node:node /app/data
|
|
|
|
ENV NODE_ENV=production
|
|
ENV DATA_DIR=/app/data
|
|
|
|
# Drop to non-root user for all subsequent operations
|
|
USER node
|
|
|
|
EXPOSE 3001
|
|
|
|
# HEALTHCHECK — Docker will restart the container if this fails 3 times
|
|
HEALTHCHECK --interval=30s --timeout=5s --start-period=10s --retries=3 \
|
|
CMD wget -qO- http://localhost:3001/health || exit 1
|
|
|
|
CMD ["node", "server/index.js"]
|