Files
EvoFirewall/README.md
T
Denozordec 4fedf83078
quality / commitlint (push) Skipped
quality / changes (push) Successful in 18s
quality / docker-check (push) Skipped
quality / openapi (push) Successful in 1m31s
quality / web (push) Successful in 1m7s
quality / api (push) Failing after 40s
CD / quality (push) Failing after 3m43s
CD / publish (push) Skipped
chore: update .gitignore, remove Dockerfile, and enhance documentation
- Added .release-version, CHANGELOG.md, and deploy/docker/docker-bake.override.hcl to .gitignore.
- Removed Dockerfile as part of the cleanup.
- Updated AGENTS.md and README.md to include new documentation on CI/Docker processes and deployment instructions.
- Enhanced package.json with new devDependencies for commit linting and semantic release.
- Updated pnpm-lock.yaml to reflect new dependencies and versions.

These changes streamline the project structure and improve documentation clarity.
2026-08-19 00:02:33 +07:00

63 lines
1.6 KiB
Markdown

# EvoFirewall
Централизованный firewall controller: Linux / MikroTik agents, IP lists, allow/deny политики, статистика.
Интеграции: **auth-portal** (SSO, app id `fw`), **EvoBGP** (источник префиксов).
## Стек
- Monorepo: pnpm workspaces + turbo
- `apps/web` — Vite + React + TanStack + shadcn/ui + ReUI Frame
- `apps/api` — Fastify 5 + Drizzle + SQLite
- Packages: `@evofw/ui`, `@evofw/shared`, `@evofw/db`
## Быстрый старт
```bash
pnpm install
cp .env.example .env
pnpm --filter @evofw/db build
pnpm --filter @evofw/shared build
pnpm --filter @evofw/api dev # :8080
pnpm --filter @evofw/web dev # :5177
```
Linux agent (short link из UI `/agents` → Добавить агента):
```bash
curl -fsSL http://localhost:8080/agent-install/<id> | bash
# или:
curl -fsSL http://localhost:8080/<slug> | bash
```
Legacy one-liner:
```bash
curl -fsSL http://localhost:8080/v1/agent/install.sh | \
EVOFW_CP_URL=http://localhost:8080 \
EVOFW_SEED=dev-enroll-seed-change-me \
EVOFW_CLIENT_NAME="web-01" \
bash
```
Затем Approve в UI `/agents`.
## Docker
```bash
cd deploy/docker
docker buildx bake --allow=fs.read=../.. -f docker-bake.hcl --print default
```
Compose: [`deploy/compose/docker-compose.example.yaml`](deploy/compose/docker-compose.example.yaml). Образ: `git.shx.one/<owner>/evofw` (алиас `evofirewall`). CI/релизы: [`docs/releasing.md`](docs/releasing.md).
## Docs
См. [`docs/README.md`](docs/README.md).
## Git
```
origin https://git.shx.one/denozord/EvoFirewall.git
```