remove size limit

.gitignore

@@ -1,6 +1,5 @@
 # Environment
 .env
-domains.txt
 
 # Certificates and secrets
 /nginx/certs/

README.md

@@ -1,117 +1,130 @@
-# Локальная сеть с доменами `.mikan` и HTTPS
+# Local DNS Services with Docker
 
-Система для запуска сервисов в Docker с автоматическим HTTPS, локальными доменами (`service.mikan`, `service.local`) и возможностью расширения (Tailscale, публичные домены).
+This project provides a local development infrastructure with automatic DNS resolution for custom domains (e.g., `.mikan` or `.local`) and valid HTTPS certificates.
 
-## Требования
+## Features
 
-- Docker + Docker Compose
-- `mkcert` — [инструкция по установке](https://github.com/FiloSottile/mkcert#installation)
-- `bash`, `coreutils`
+- Automatic DNS resolution for `*.yourdomain` and `*.yourdomain.local`
+- Valid HTTPS certificates for local domains using `mkcert`
+- Easy service deployment with `VIRTUAL_HOST` environment variables
+- Ready for future expansion: public domains, Let's Encrypt, Tailscale
+- Single-command service creation
 
-## Быстрый старт
+## Requirements
 
-1. **Клонируй репозиторий**
+- Docker and Docker Compose
+- `mkcert` installed on the host system
+
+## Quick Start
+
+1. Clone this repository and enter the directory:
    ```bash
-   git clone ... && cd local-dns
+   git clone <repository-url> local-dns
+   cd local-dns
    ```
 
-2. **Настрой домен (опционально)**
+2. Initialize the project:
    ```bash
-   echo "LOCAL_DOMAIN=mikan" > .env
+   ./scripts/00-init.sh
    ```
-   Замени `mikan` на желаемый суффикс (например, `home`).
+   This creates a `.env` file from `.env.example` and sets up the directory structure.
 
-3. **Инициализируй CA и базовый сертификат**
+3. Generate TLS certificates:
    ```bash
-   ./scripts/01-init-ca.sh
+   ./scripts/01-generate-cert.sh
    ```
-   - Создаст доверенный корневой сертификат (`ca/rootCA.pem`)
-   - Сгенерирует `default.crt` для nginx-proxy
+   This creates trusted certificates for your local domain.
 
-4. **Установи корневой сертификат в систему**  
-   Импортируй файл `ca/rootCA.pem` в хранилище **доверенных корневых центров сертификации**:
-   - **Linux**:  
-     ```bash
-     sudo cp ca/rootCA.pem /usr/local/share/ca-certificates/mkcert-local.crt
-     sudo update-ca-certificates
-     ```
-   - **Windows/macOS**: двойной клик по файлу → «Доверять всегда» (macOS) или импорт в «Доверенные корневые центры» (Windows)
-
-5. **Запусти инфраструктуру**
+4. Start the core infrastructure:
    ```bash
    docker compose up -d
    ```
 
-6. **Добавь сервис**
+5. Add your first service (example: Gitea on port 3000):
    ```bash
-   ./scripts/add-service.sh gitea
+   ./scripts/add-service.sh gitea 3000
    ```
-   Сервис будет доступен по:
-   - `https://gitea.mikan`
-   - `https://gitea.local`
-
-   \+ может пригодиться:
+   Then edit `services/gitea/docker-compose.yml` to set the correct image and volumes.
 
+6. Start the new service:
    ```bash
-    Add-Content -Path "C:\Windows\System32\drivers\etc\hosts" -Value "10.0.0.3 youtrack.mikan"
+   docker compose -f docker-compose.yml -f services/gitea/docker-compose.yml up -d
    ```
 
-7. **Настрой сервис в Docker Compose**  
-   Убедись, что в `docker-compose.yml` сервиса указано:
-   ```yaml
-   services:
-     gitea:
-       environment:
-         - VIRTUAL_HOST=gitea.mikan,gitea.local
-         - VIRTUAL_PORT=3000  # порт внутри контейнера
-       networks:
-         - devnet
-       dns: 10.0.0.2  # обязательно для резолвинга доменов из контейнеров
-   ```
+7. Visit `https://gitea.yourdomain` in your browser (replace `yourdomain` with your configured domain).
 
-## Важные замечания
+## Configuration
 
-### DNS из контейнеров
-Контейнеры **не могут** резолвить `*.mikan` без явного указания DNS:
-```yaml
-dns: 10.0.0.2  # IP dnsmasq
-```
-Добавляй эту строку во все сервисы, которым нужен доступ к другим по домену.
+Edit the `.env` file to customize your setup:
 
-### Обновление сертификатов
-При добавлении сервиса через `add-service.sh`:
-- Автоматически обновляется `domains.txt`
-- Генерируется новый `default.crt`
-- Перезагружается `nginx-proxy`
+- `LOCAL_DOMAIN`: Your local domain suffix (default: `mikan`)
+- `PUBLIC_DOMAIN`: Optional public domain for Let's Encrypt certificates
+- `LETSENCRYPT_EMAIL`: Email for Let's Encrypt notifications
+- Network settings (`NGINX_IP`, `DNSMASQ_IP`, etc.)
 
-### Пути
-- Сертификаты: `nginx/certs/default.crt`
-- Домены: `domains.txt`
-- Корневой CA: `ca/rootCA.pem`
+After changing `.env`, re-run the initialization and certificate scripts.
 
-## Расширение
+## DNS Setup
 
-### Tailscale
-Добавь в `docker-compose.yml` сервис `tailscale` и объявляй дополнительные домены:
-```yaml
-environment:
-  - VIRTUAL_HOST=gitea.mikan,gitea.local,gitea.yourname.ts.net
+### Linux/macOS
+
+Use the included `dnsmasq` service for automatic DNS resolution:
+
+```bash
+docker compose -f docker-compose.yml -f docker-compose.dnsmasq.yml up -d
 ```
 
-### Публичный домен
-1. Купи домен (например, `example.com`)
-2. В `.env` добавь:
-   ```env
-   PUBLIC_DOMAIN=example.com
-   ```
-3. В сервисах укажи:
-   ```yaml
-   environment:
-     - VIRTUAL_HOST=gitea.mikan,gitea.local,gitea.example.com
-     - LETSENCRYPT_HOST=gitea.example.com
-   ```
-   Сертификат для `example.com` получит `acme-companion`.
+Then configure your system to use `10.0.0.2` as the primary DNS server.
 
----
+### Windows (WSL2)
 
-Готово. Теперь все сервисы работают по HTTPS с валидными сертификатами.
+Windows reserves port 53, so `dnsmasq` cannot run on the host. Instead:
+
+1. Work inside WSL2
+2. Manually add entries to the Windows hosts file:
+   ```powershell
+   # Run PowerShell as Administrator
+   Add-Content -Path "C:\Windows\System32\drivers\etc\hosts" -Value "127.0.0.1 gitea.mikan"
+   Add-Content -Path "C:\Windows\System32\drivers\etc\hosts" -Value "127.0.0.1 gitea.mikan.local"
+   ```
+
+## Certificate Trust
+
+After running `./scripts/01-generate-cert.sh`, install the root certificate on your devices:
+
+- **Linux**: Depends on distribution (usually via `update-ca-certificates`)
+- **macOS**: 
+  ```bash
+  sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain ca/rootCA.pem
+  ```
+- **Windows**: 
+  1. Copy `ca/rootCA.pem` to Windows
+  2. Open `certmgr.msc`
+  3. Import into "Trusted Root Certification Authorities"
+
+## Adding Public Domain Support
+
+To enable Let's Encrypt certificates for a public domain:
+
+1. Set in `.env`:
+   ```ini
+   PUBLIC_DOMAIN=yourdomain.com
+   LETSENCRYPT_EMAIL=you@yourdomain.com
+   ```
+
+2. Re-run initialization:
+   ```bash
+   ./scripts/00-init.sh
+   ./scripts/01-generate-cert.sh
+   ```
+
+3. New services will automatically request Let's Encrypt certificates for the public domain.
+
+## Service Management
+
+- **Add a service**: `./scripts/add-service.sh <name> <port>`
+- **Start all**: `docker compose up -d`
+- **Start with dnsmasq**: `docker compose -f docker-compose.yml -f docker-compose.dnsmasq.yml up -d`
+- **Stop all**: `docker compose down`
+
+All service data is stored in the `services/` directory and persists between restarts.

dnsmasq/dnsmasq.conf

@@ -1,2 +1,9 @@
-# Этот файл будет перезаписан при запуске ./scripts/02-apply-config.sh
-# Не редактируйте вручную
+address=/.mikan/10.0.0.3
+address=/.mikan.local/10.0.0.3
+local=/.mikan/
+local=/.mikan.local/
+no-resolv
+server=1.1.1.1
+server=8.8.8.8
+log-queries
+log-facility=/dev/stdout

docker-compose.dnsmasq.yml

@@ -0,0 +1,26 @@
+version: '3.8'
+
+services:
+  dnsmasq:
+    image: jpillora/dnsmasq
+    container_name: dnsmasq
+    restart: unless-stopped
+    ports:
+      - "53:53/udp"
+      - "53:53/tcp"
+    volumes:
+      - ./dnsmasq/dnsmasq.conf:/etc/dnsmasq.conf:ro
+    cap_add:
+      - NET_ADMIN
+    networks:
+      devnet:
+        ipv4_address: ${DNSMASQ_IP}
+    healthcheck:
+      test: ["CMD", "nslookup", "localhost", "127.0.0.1"]
+      interval: 30s
+      timeout: 5s
+      retries: 3
+
+networks:
+  devnet:
+    external: true

docker-compose.yml

@@ -13,6 +13,7 @@ services:
       - ./nginx/certs:/etc/nginx/certs:ro
       - ./nginx/vhost.d:/etc/nginx/vhost.d:ro
       - ./nginx/html:/usr/share/nginx/html:rw
+      - ./nginx/proxy.conf:/etc/nginx/conf.d/proxy.conf
     networks:
       devnet:
         ipv4_address: ${NGINX_IP}
@@ -34,6 +35,7 @@ services:
       - ./nginx/certs:/etc/nginx/certs:rw
       - ./acme:/etc/acme.sh
       - ./nginx/vhost.d:/etc/nginx/vhost.d:rw
+      - ./nginx/proxy.conf:/etc/nginx/conf.d/proxy.conf
     networks:
       - devnet
     environment:

nginx/html/index.html

@@ -1,7 +1,8 @@
 <!DOCTYPE html>
 <html>
-<head><title>Placeholder</title></head>
+<head><title>Добро пожаловать!</title></head>
 <body>
-  <p>Run ./scripts/00-init.sh to generate content</p>
+  <h1>Сервисы .mikan</h1>
+  <p>Добавьте свои сервисы в папку <code>services/</code></p>
 </body>
 </html>

scripts/01-init-ca.sh

@@ -1,38 +0,0 @@
-#!/bin/bash
-set -e
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-ROOT_DIR="$SCRIPT_DIR/.."
-
-if [ -f "$ROOT_DIR/.env" ]; then
-  export $(grep -v '^#' "$ROOT_DIR/.env" | xargs)
-fi
-
-LOCAL_DOMAIN=${LOCAL_DOMAIN:-mikan}
-CA_DIR="$ROOT_DIR/ca"
-CERTS_DIR="$ROOT_DIR/nginx/certs"
-DOMAINS_FILE="$ROOT_DIR/domains.txt"
-
-mkdir -p "$CA_DIR" "$CERTS_DIR"
-
-if [ ! -f "$DOMAINS_FILE" ]; then
-  touch "$DOMAINS_FILE"
-fi
-
-if [ ! -f "$CA_DIR/rootCA.pem" ]; then
-  mkcert -install
-  cp "$(mkcert -CAROOT)/rootCA.pem" "$CA_DIR/rootCA.pem"
-  cp "$(mkcert -CAROOT)/rootCA-key.pem" "$CA_DIR/rootCA-key.pem"
-
-  cat > "$DOMAINS_FILE" <<EOF
-$LOCAL_DOMAIN
-welcome.$LOCAL_DOMAIN
-localhost
-127.0.0.1
-::1
-*.services.$LOCAL_DOMAIN
-*.services.local
-EOF
-fi
-
-exec "$SCRIPT_DIR/regenerate-cert.sh"

scripts/regenerate-cert.sh

@@ -1,32 +0,0 @@
-#!/bin/bash
-set -e
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-ROOT_DIR="$SCRIPT_DIR/.."
-
-if [ -f "$ROOT_DIR/.env" ]; then
-  export $(grep -v '^#' "$ROOT_DIR/.env" | xargs)
-fi
-
-DOMAINS_FILE="$ROOT_DIR/domains.txt"
-CERTS_DIR="$ROOT_DIR/nginx/certs"
-
-if [ ! -f "$DOMAINS_FILE" ]; then
-  echo "Error: $DOMAINS_FILE not found" >&2
-  exit 1
-fi
-
-mapfile -t DOMAINS < <(grep -v '^$' "$DOMAINS_FILE")
-
-if [ ${#DOMAINS[@]} -eq 0 ]; then
-  echo "Error: no domains found in $DOMAINS_FILE" >&2
-  exit 1
-fi
-
-mkcert \
-  -cert-file "$CERTS_DIR/default.crt.new" \
-  -key-file "$CERTS_DIR/default.key.new" \
-  "${DOMAINS[@]}"
-
-mv "$CERTS_DIR/default.crt.new" "$CERTS_DIR/default.crt"
-mv "$CERTS_DIR/default.key.new" "$CERTS_DIR/default.key"

scripts/reload-nginx.sh

@@ -1,11 +0,0 @@
-#!/bin/bash
-set -e
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-ROOT_DIR="$SCRIPT_DIR/.."
-
-CERTS_DIR="$ROOT_DIR/nginx/certs"
-cp "$CERTS_DIR/default.crt" "$CERTS_DIR/default.key" "$CERTS_DIR/"
-
-docker compose -f "$ROOT_DIR/docker-compose.yml" exec nginx-proxy nginx -s reload 2>/dev/null || \
-docker compose -f "$ROOT_DIR/docker-compose.yml" restart nginx-proxy