서비스와 라우팅
도메인별 서비스와 별칭을 등록하고, 업스트림 프로파일을 여러 서비스에서 공유합니다. 부하 분산, 출발지별 라우팅과 점검 모드를 지원합니다.
리버스 프록시 관리 도구가칭 Portico
서비스의 입구를,
한 화면에서.
공인 IP 하나에 여러 서비스를 운영할 때, 반복되는 nginx 설정 작업을 콘솔로 옮깁니다. 서비스 등록, 접근 제어, 인증서, 정적 사이트 배포와 모니터링을 함께 다루는 자체 서버 설치형 관리 도구입니다.
Portico는 프로젝트 가칭입니다. 정식 제품명은 아직 정해지지 않았습니다.
REQUEST FLOW / 개념도
외부 요청 HTTPS
nginx라우팅 · 접근 정책 · 인증서
웹 앱API정적 사이트
콘솔과 API로 설정 · 검증 · 반영
TYPE자체 서버 설치형 관리 도구
CONTROL관리 콘솔 · API
FOCUSnginx 운영 · 정책 · 배포
01 / FROM THE FIELD
서비스가 늘어날수록,
운영은 더 일관되게.
서비스마다 설정을 복사하고, 허용 IP를 따로 관리하고, 인증서 만료와 변경 이력을 챙기는 일. 네트워크 엔지니어의 운영 경험을 바탕으로, AI와 함께 반복 작업을 하나의 도구로 연결했습니다.
이런 환경을 위한 프로젝트입니다.
- 내부 서비스를 외부에 연결하는 사내 서버·홈랩
- nginx 설정과 정책을 함께 관리하는 소규모 인프라
- 인증서 갱신과 배포를 기존 자동화에 연결하려는 운영 환경
02 / TOOLBOX
연결부터 운영 기록까지.
접근 제어와 WAF
IP·CIDR 기반 ACL 그룹과 국가별 정책을 관리합니다. ModSecurity·OWASP CRS를 연동해 서비스별 탐지·차단 모드와 규칙 예외를 설정합니다.
인증서 관리
기존 인증서 파일 참조와 업로드, Let's Encrypt 발급·갱신, 만료 경고를 지원합니다. 외부 갱신 스크립트도 API로 연결할 수 있습니다.
정적 사이트 배포
별도 업스트림 없이 nginx에서 정적 사이트를 제공합니다. ZIP 업로드, 파일 교체, Git 저장소·webhook 배포와 이전 릴리스 복귀를 지원합니다.
모니터링과 알림
업스트림 상태, 트래픽, 응답 시간과 액세스 로그를 확인합니다. 장애·복구·인증서 만료 등의 이벤트를 Slack·Discord·Telegram·webhook으로 알립니다.
API와 변경 이력
콘솔 작업을 토큰 API로 자동화합니다. 설정 버전과 감사 기록, 백업·복원, OpenAPI 문서를 통해 반복 작업과 기존 운영 도구를 연결합니다.
03 / APPLY WITH CHECKS
변경 사항을 검증하고,
운영 설정에 반영합니다.
콘솔·API로 변경
서비스, 접근 정책과 인증서를 등록하거나 수정합니다.
설정 생성
일반 계정 권한으로 적용할 설정을 준비합니다.
검사와 백업
전용 헬퍼가 내용을 검사하고 백업·설치 후 nginx 설정을 검증합니다.
반영 또는 복원
검증을 통과하면 reload하고, 실패하면 백업을 복원하는 흐름으로 구성했습니다.
04 / OPERATIONS BY DESIGN
기능만큼 중요한,
운영의 경계와 기록.
콘솔과 설정 적용 권한을 분리하고, 계정별 역할과 변경 이력을 관리합니다. 운영자가 직접 관리하는 서버에 설치하며, 필요한 외부 서비스만 선택해 연동합니다.
- 권한
- 조회·운영·관리 역할, 계정·토큰별 접근 IP 제한
- 설정 반영
- 일반 계정 콘솔과 권한을 분리한 적용 헬퍼
- 기록
- 변경·적용·자동 작업의 감사 기록과 내보내기
- 복원
- 설정 버전 롤백과 백업·복원
- 보존
- 로그와 이력의 보존 기간 설정
05 / ENVIRONMENT
직접 운영하는 서버에
설치합니다.
RPM 패키지로 설치하며 기존 nginx 설정과 함께 사용할 수 있도록 구성했습니다. 서버 환경과 사용 기능에 맞춰 필요한 모듈과 연동을 확인합니다.
도입 환경과 지원 범위는 문의를 통해 안내합니다.
- 운영체제
- Rocky Linux 9 / RHEL 9 계열 · x86_64
- 런타임
- nginx · Node.js 22 이상
- 추가 모듈
- WAF: ModSecurity / 국가 정책: geoip2
- 설치 방식
- RPM 패키지, 기존 nginx 설정 가져오기 지원
- 선택 연동
- Let's Encrypt · IP 피드 · 알림 채널
- 국가 데이터
- GeoLite2 데이터는 운영자의 MaxMind 계정으로 별도 준비