chore: switch to host network mode for accurate analytics

- Update docker-compose.yml to use host network instead of port mapping
- Install wget in Dockerfile for health check support
- Remove EXPOSE directive as it's not needed for host network mode
- Update README.md Docker deployment examples to use host network
- Add bridge network alternative for development environments
- Add warning about IP visibility in different network modes
- Improve analytics accuracy by capturing real client IP addresses

Author: DemoMacro

Dockerfile

@@ -26,6 +26,9 @@ RUN pnpx rolldown --input ./scripts/migrate.ts --format esm --file ./.output/scr
 FROM node:24-alpine AS production
 WORKDIR /app
 
+# Install wget for health check
+RUN apk add --no-cache wget
+
 # Copy .output directory (which now contains migrate.mjs)
 COPY --from=build /app/.output /app
 
@@ -34,5 +37,4 @@ ENV NODE_ENV=production
 ENV PORT=3000
 
 # run the app
-EXPOSE 3000/tcp
 ENTRYPOINT ["sh", "-c", "node /app/scripts/migrate.mjs && node /app/server/index.mjs"]

README.md

@@ -62,6 +62,8 @@ pnpm run preview
 
 #### Docker Deployment
 
+> **Note**: For accurate analytics and geolocation tracking, use `host` network mode. Bridge network mode may cause the application to receive Docker's internal IP instead of the real client IP, making analytics data less useful.
+
 ##### Option 1: Using Docker Compose (Recommended)
 
 ```bash
@@ -89,10 +91,10 @@ The application will be available at `http://localhost:3000`
 # Pull the official image
 docker pull demomacro/js.gs:latest
 
-# Run container
+# Run container with host network
 docker run -d \
   --name js-gs \
-  -p 3000:3000 \
+  --network host \
   --env-file .env \
   --restart unless-stopped \
   demomacro/js.gs:latest
@@ -111,7 +113,15 @@ docker rm js-gs
 # Build Docker image
 docker build -t js.gs .
 
-# Run container
+# Run container with host network (recommended)
+docker run -d \
+  --name js-gs \
+  --network host \
+  --env-file .env \
+  --restart unless-stopped \
+  js.gs
+
+# Or use bridge network with port mapping
 docker run -d \
   --name js-gs \
   -p 3000:3000 \

docker-compose.yml

@@ -1,10 +1,8 @@
 services:
   app:
     image: demomacro/js.gs:latest
-    container_name: js-gs-app
     restart: unless-stopped
-    ports:
-      - "3000:3000"
+    network_mode: host
     environment:
       # Better Auth Configuration
       BETTER_AUTH_URL: ${BETTER_AUTH_URL}
@@ -37,16 +35,18 @@ services:
 
       # Node Environment
       NODE_ENV: production
-    networks:
-      - js-gs-network
+      PORT: ${PORT:-3000}
     healthcheck:
-      test: ["CMD", "wget", "--no-verbose", "--tries=1", "--spider", "http://localhost:3000/api/ok"]
+      test:
+        [
+          "CMD",
+          "wget",
+          "--no-verbose",
+          "--tries=1",
+          "--spider",
+          "http://localhost:${PORT:-3000}/api/ok",
+        ]
       interval: 30s
       timeout: 10s
       retries: 3
       start_period: 40s
-
-networks:
-  js-gs-network:
-    driver: bridge
-    name: js-gs-network