Neko Master: мониторинг сетевого трафика в реальном времени

# Сначала сгенерируйте фиксированный секрет для cookie (для сохранения сессий)
export COOKIE_SECRET="$(openssl rand -hex 32)"

# Минимальный вариант (только 3000)
docker run -d \
  --name neko-master \
  -p 3000:3000 \
  -v $(pwd)/data:/app/data \
  -e COOKIE_SECRET="$COOKIE_SECRET" \
  --restart unless-stopped \
  foru17/neko-master:latest

# Реальное время через WS (с обратным прокси)
docker run -d \
  --name neko-master \
  -p 3000:3000 \
  -p 3002:3002 \
  -v $(pwd)/data:/app/data \
  -e COOKIE_SECRET="$COOKIE_SECRET" \
  --restart unless-stopped \
  foru17/neko-master:latest

# С использованием curl
curl -fsSL https://raw.githubusercontent.com/foru17/neko-master/main/setup.sh | bash

# Или с использованием wget
wget -qO- https://raw.githubusercontent.com/foru17/neko-master/main/setup.sh | bash

# 1. Клонируйте репозиторий
git clone https://github.com/foru17/neko-master.git
cd neko-master

# 2. Установите зависимости
pnpm install

# 3. Подготовьте окружение для коллектора (в режиме исходного кода читается apps/collector/.env)
cp apps/collector/.env.example apps/collector/.env

# 4. Запустите сервисы разработки
pnpm dev

# Пример для шлюза Clash / Mihomo
curl -fsSL https://raw.githubusercontent.com/foru17/neko-master/main/apps/agent/install.sh \
  | env NEKO_SERVER='http://your-panel:3000' \
        NEKO_BACKEND_ID='1' \
        NEKO_BACKEND_TOKEN='ag_xxx' \
        NEKO_GATEWAY_TYPE='clash' \
        NEKO_GATEWAY_URL='http://127.0.0.1:9090' \
        sh

# Пример для шлюза Surge
curl -fsSL https://raw.githubusercontent.com/foru17/neko-master/main/apps/agent/install.sh \
  | env NEKO_SERVER='http://your-panel:3000' \
        NEKO_BACKEND_ID='2' \
        NEKO_BACKEND_TOKEN='ag_yyy' \
        NEKO_GATEWAY_TYPE='surge' \
        NEKO_GATEWAY_URL='http://127.0.0.1:9091' \
        sh

nekoagent list               # список всех экземпляров
nekoagent status <instance>  # проверить состояние
nekoagent logs <instance>    # просмотр логов в реальном времени
nekoagent restart <instance> # перезапуск
nekoagent upgrade            # глобальное обновление (CLI + бинарный файл)

WEB_EXTERNAL_PORT=8080    # Изменить порт Web UI
API_EXTERNAL_PORT=8081    # Изменить порт API
WS_EXTERNAL_PORT=8082     # Изменить внешний порт WebSocket (только для прямого доступа)
COOKIE_SECRET=your-long-random-secret   # Настоятельно рекомендуется зафиксировать

docker compose down
docker compose up -d

ports:
  - "8080:3000" # Внешний 8080 → Внутренний 3000
  - "8082:3002" # Внешний 8082 → Внутренний 3002 (для проброса WS через прокси/туннель)

curl -fsSL https://raw.githubusercontent.com/foru17/neko-master/main/setup.sh | bash

NODE_ENV=production
DB_PATH=/app/data/stats.db
COOKIE_SECRET=<случайная строка не менее 32 байт>
# Опционально: использовать локальный поиск по MMDB по умолчанию
# GEOIP_LOOKUP_PROVIDER=local
# В обычной работе оставьте false
# FORCE_ACCESS_CONTROL_OFF=false

BatchBuffer.flush()
    │
    ├──→ SQLite (конфигурация / метаданные, записывается всегда)
    └──→ ClickHouse (статистика трафика, двойная запись)
           └── Buffer tables → SummingMergeTree асинхронное слияние

CH_ENABLED=0
CH_WRITE_ENABLED=0
CH_ONLY_MODE=0
STATS_QUERY_SOURCE=sqlite

server {
  listen 443 ssl http2;
  server_name neko.example.com;

  location / {
    proxy_pass http://<neko-master-host>:3000;
    proxy_http_version 1.1;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
  }

  location ^~ /_cm_ws {
    proxy_pass http://<neko-master-host>:3002;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_read_timeout 86400;
    proxy_send_timeout 86400;
    proxy_buffering off;
  }
}

# По умолчанию не требуется (уже /_cm_ws)
# NEXT_PUBLIC_WS_URL=/custom_ws

tunnel: <имя-или-id-туннеля>
credentials-file: /path/to/<credentials>.json

ingress:
  - hostname: neko.example.com
    path: /_cm_ws*
    service: http://localhost:3002
  - hostname: neko.example.com
    path: /*
    service: http://localhost:3000
  - service: http_status:404

cloudflared tunnel --config ~/.cloudflared/config.yml run <имя-или-id-туннеля>

volumes:
  - ./data:/app/data

# Загрузить последний образ и перезапустить
docker compose pull
docker compose up -d

COOKIE_SECRET=<случайная строка не менее 32 байт>
# FORCE_ACCESS_CONTROL_OFF=false
# SHOWCASE_SITE_MODE=false

WEB_EXTERNAL_PORT=8080
API_EXTERNAL_PORT=8081
WS_EXTERNAL_PORT=8082

docker compose down
docker compose up -d

cp -r ./data ./data-backup-$(date +%Y%m%d)

docker compose down
cp -r ./data-backup-YYYYMMDD/. ./data/
docker compose up -d