0xJacky/nginx-ui

어떤 프로젝트인가요?

핵심 기능

• 01브라우저에서 Nginx 설정을 편집하고, 저장 후 자동으로 테스트 및 다시 불러오기
• 02버전 비교 및 복원이 가능한 설정 자동 백업
• 03Let's Encrypt 인증서 발급 및 자동 갱신
• 04CPU, 메모리, 부하 및 디스크 사용량을 보여주는 서버 지표
• 05멀티 노드 클러스터 관리 및 암호화된 설정 내보내기
• 06AI 에이전트가 Nginx 설정을 관리할 수 있는 MCP 인터페이스

활용 사례

• 파일을 직접 편집하지 않고 소규모 서버의 리버스 프록시와 사이트 관리
• Nginx에서 제공하는 여러 도메인의 HTTPS 인증서 자동화
• 여러 서버의 Nginx 설정 동기화
• AI 에이전트가 Nginx 설정을 통제된 방식으로 변경하도록 허용

빠른 시작

1. 1

   공식 Docker 이미지를 pull합니다

   docker pull uozi/nginx-ui:latest
2. 2

   README에 설명된 대로 포트 80과 443, Nginx 설정 볼륨을 매핑해 Docker로 컨테이너를 실행합니다

   docker run -dit --name=nginx-ui --restart=always -e TZ=Asia/Shanghai -v /mnt/user/a
3. 3

   브라우저에서 http://<your_server_ip>:<listen_port>를 열어 설정을 완료합니다

사용 전 알아둘 점

• !AGPL-3.0 라이선스가 적용됩니다. 네트워크를 통해 제공되는 수정 사항의 소스 공개를 요구하는 카피레프트 라이선스입니다.
• !Debian 계열의 Nginx 디렉터리 구조를 전제로 하므로, Debian 계열이 아닌 시스템에서는 nginx.conf를 수동으로 변경해야 할 수 있습니다.
• !README의 Docker 예제가 잘려 있으므로, 전체 실행 명령은 문서에서 확인해야 합니다.

토픽

자주 묻는 질문

nginx-ui은(는) 무엇인가요?

Go와 Vue로 만든 셀프 호스팅 웹 UI로, Nginx 사이트, 인증서, 설정, 로그 및 서버 통계를 관리합니다. Nginx UI는 Nginx용 웹 기반 제어판입니다. 브라우저에서 설정 파일을 편집하고 테스트할 수 있으며, 저장 후 Nginx를 자동으로 다시 불러오고 SSH로 로그인하지 않아도 Nginx 로그를 확인할 수 있습니다.

nginx-ui은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

nginx-ui은(는) AGPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

nginx-ui은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. nginx-ui의 마지막 커밋은 2026년 10월 21일입니다.

nginx-ui은(는) 어디에 사용할 수 있나요?

파일을 직접 편집하지 않고 소규모 서버의 리버스 프록시와 사이트 관리 Nginx에서 제공하는 여러 도메인의 HTTPS 인증서 자동화 여러 서버의 Nginx 설정 동기화 AI 에이전트가 Nginx 설정을 통제된 방식으로 변경하도록 허용

nginx-ui는 어떻게 설치하나요?

공식 Docker 이미지를 pull합니다: docker pull uozi/nginx-ui:latest README에 설명된 대로 포트 80과 443, Nginx 설정 볼륨을 매핑해 Docker로 컨테이너를 실행합니다: docker run -dit --name=nginx-ui --restart=always -e TZ=Asia/Shanghai -v /mnt/user/a 브라우저에서 http://<your_server_ip>:<listen_port>를 열어 설정을 완료합니다

nginx-ui은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/0xJacky/nginx-ui