Skip to content

A full-stack tool for remotely managing Linux /etc/hosts files to block domains, featuring secure SSH execution, audit logging, and a Dockerized Angular/Spring Boot architecture.

Notifications You must be signed in to change notification settings

mejq/Domain-Blocker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DomainBlocker

Centralized Domain Blocking System on Remote Linux Servers

This is a full-stack web application designed to manage domain-level content filtering by remotely updating the /etc/hosts file on a target Linux server. It provides system administrators and users with a centralized, secure, and user-friendly platform for controlling network access to specific domains.

Highlights & Key Features

Secure Remote Access: Uses the JSch library within the Spring Boot backend to establish a secure SSH connection and execute system commands for hosts file modification.

Intuitive Web Interface: An Angular 19 frontend allows users to easily list, add, and remove domains from the block list.

Auditable Persistence: All blocking/unblocking actions are recorded in a PostgreSQL database, ensuring full auditability. Liquibase manages database schema changes consistently.

Fully Containerized: The entire system—Frontend (Angular/Nginx), Backend (Spring Boot), and Database (PostgreSQL)—is deployed via Docker and Docker Compose for guaranteed environment consistency and fast setup.

Operational Monitoring: Integrated with Spring Actuator for health and performance metrics, supported by centralized request logging and robust Global Exception Handling.

Component,Key Technologies

  • Frontend,"Angular 19, Reactive Forms"
  • Backend,"Spring Boot, JSch (for SSH), REST API"
  • Database,"PostgreSQL, Hibernate (JPA), Liquibase"
  • Deployment,"Docker, Docker Compose"

About

A full-stack tool for remotely managing Linux /etc/hosts files to block domains, featuring secure SSH execution, audit logging, and a Dockerized Angular/Spring Boot architecture.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published